[kde-doc-english] [kate/KDE/4.10] doc/kate: fix build error caused by broken xml file + add some comments for documentation

[T.C. Hollingsworth]

Git commit 0b28c281b12a78309148831fd85865837c7d00e3 by T.C. Hollingsworth, on behalf of Burkhard Lück.
Committed on 03/02/2013 at 09:48.
Pushed by hollingsworth into branch 'KDE/4.10'.

fix build error caused by broken xml file + add some comments for documentation
(cherry picked from commit 24f61bc76fa9b5865d9d03f565b7b58a31005109)

M  +3    -2    doc/kate/menus.docbook
M  +2    -2    doc/kate/plugins.docbook

http://commits.kde.org/kate/0b28c281b12a78309148831fd85865837c7d00e3

diff --git a/doc/kate/menus.docbook b/doc/kate/menus.docbook
index a0fe2c7..dba41ed 100644
--- a/doc/kate/menus.docbook
+++ b/doc/kate/menus.docbook
@@ -312,6 +312,7 @@ all to work with the currently active document.</para>
 </term>
 <listitem>
 <para>Undo the last editing command (typing, copying, cutting etc.)</para>
+<!-- FIXME how/where to enable/disable grouped undo ?-->
 <note><para>If grouped undo is enabled, this may undo several editing commands of the same type, like typing in characters.</para></note>
 </listitem>
 </varlistentry>
@@ -1017,7 +1018,7 @@ Code Folding</link>.</para></listitem>
 <guimenuitem>Fold Multiline Comments</guimenuitem></menuchoice>
 </term>
 <listitem><para>Fold all multiline comments in the document.  (For example,
-this will fold all comments that use <code>/* comment */</code> syntax in C-like
+this will fold all comments that use <quote>/* comment */</quote> syntax in C-like
 programming languages.)</para></listitem>
 </varlistentry>
 
@@ -1369,7 +1370,7 @@ own scripts</link>. This way, &kate; can be extended with user-defined tools.
 <para>The following scripts are included by default:</para>
 
 <variablelist>
-  <!--FIXME more items in 4.10 -->
+  <!--FIXME more items in 4.10 guisubmeu Navigation, Quick Coding, Editing, Emmet-->
 <varlistentry id="tools-scripts-sort">
 <term><menuchoice>
 <guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu>
diff --git a/doc/kate/plugins.docbook b/doc/kate/plugins.docbook
index 80a9ff9..1fb91aa 100644
--- a/doc/kate/plugins.docbook
+++ b/doc/kate/plugins.docbook
@@ -674,7 +674,7 @@ You will have to repeat it when you start &kate; the next time.</para></listitem
 </sect2>
 
 </sect1>
-
+<!--FIXME this belongs to Extensions, it is an editor plugin-->
 <sect1 id="kate-editor-plugin-exporter">
 <!--<sect1info>
 <authorgroup><author>
@@ -1356,7 +1356,7 @@ that are for the currently opened file type.</para></listitem>
 <sect2 id="snippets-panel">
 <title>Snippets panel</title>
 
-<screenshot id="screenshot-snippets-config">
+<screenshot id="screenshot-snippets-panel">
 <screeninfo>Kate Snippets Panel</screeninfo>
 <mediaobject>
 <imageobject><imagedata fileref="snippets-panel.png" format="PNG"/></imageobject>