Bug 115344

SVN commit 492155 by annma:

bug 115344
BUG=115344


 M  +2 -2      index.docbook  


--- branches/KDE/3.5/kdeedu/doc/kgeography/index.docbook #492154:492155
@@ -322,7 +322,7 @@
 <sect1 id="description-file">
 <title>Description file</title>
 <para>
- Its file extension is <literal role="extension">.kgm</literal> and it should begin with <sgmltag class="starttag">map</sgmltag> and end with <sgmltag class="endtag">map</sgmltag>.
+ The description file is needed and its file extension is <literal role="extension">.kgm</literal>. It should begin with <sgmltag class="starttag">map</sgmltag> and end with <sgmltag class="endtag">map</sgmltag>.
 </para>
 <para>
  Inside of those tags there should be:
@@ -348,7 +348,7 @@
   <para><sgmltag class="starttag">capital</sgmltag> and <sgmltag class="endtag">capital</sgmltag>: the name of the capital of the division, &eg; <quote>Tirana</quote>.</para>
 </listitem>
 <listitem>
-  <para><sgmltag class="starttag">ignore</sgmltag> and <sgmltag class="endtag">ignore</sgmltag>: must be <userinput>yes</userinput> if the division should be ignored when asking for divisions in that map. If it is <userinput>allowClickMode</userinput> &kgeography; will ask the division in the Click on division mode but not in others. This tag is optional: &eg; <quote>Algeria</quote> has this tag set to <userinput>yes</userinput> in the <quote>Europe</quote> map.</para>
+  <para><sgmltag class="starttag">ignore</sgmltag> and <sgmltag class="endtag">ignore</sgmltag>: can be set to <userinput>yes</userinput>,  <userinput>allowClickMode</userinput> and <userinput>no</userinput>. If this tag is set to <userinput>yes</userinput> then the division will be ignored when asking for divisions in that map. It is then as if this division does not exist in &kgeography; quiz modes. If this tag is set to <userinput>allowClickMode</userinput> then &kgeography; will ask for the division in the <guibutton>Click Division in Map...</guibutton> mode but not in other quiz modes. Setting this tag to <userinput>no</userinput> means the division will appear in all modes (browse and quizzes). This tag is optional and when there is no <sgmltag class="starttag">ignore</sgmltag> tag that means as it is set to <userinput>no</userinput>. For example <quote>Algeria</quote> has this tag set to <userinput>yes</userinput> in the <quote>Europe</quote> map which means that <quo
 te>Algeria</quote> will not be part of any quiz in the <quote>Europe</quote> map.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">flag</sgmltag> and <sgmltag class="endtag">flag</sgmltag>: the file (without any path) containing the flag of the division, &eg; <quote>albania.png</quote>. This tag is optional. Not needed for the divisions whose <sgmltag class="starttag">ignore</sgmltag> tag is set to <userinput>yes</userinput>.</para>

I did my best to explain it clearly, I hope you will understand it better!

Big thanks, now it is really clear and helpful. But you did a little mistake in button's label:
then &kgeography; will ask for the division in the 
<guibutton>Click Division in Map...</guibutton> mode but not in other quiz 
modes.

Real button's name's <guibutton>Click Division in the Map...</guibutton>.


And for make this doc even more clearly, I suggest to change this:
It is then as if this division does not exist in &kgeography; quiz modes.

to:
 It takes place when this division does not match for &kgeography; quiz modes.

I hope, that I understood this sentence correctly. Sorry for any mistakes in proposals, I'm not native English speaker.

Not sure if I can fix it further right now, anyone can advise me from kde-doc-english? 

All your suggestions are good by the way, thank you for your report and for following it up!