[kde-doc-english] [kate] doc/kate: document most of the new scripts in 4.10

[T.C. Hollingsworth]

Git commit 32f6ef4acb2afd27b63aafcad9d571ff19f1d4d0 by T.C. Hollingsworth.
Committed on 16/02/2013 at 04:20.
Pushed by hollingsworth into branch 'master'.

document most of the new scripts in 4.10

CCMAIL: kwrite-devel at kde.org

I'm not sure what a couple of scripts do:
-Expand Abbreviation in Quick Coding
-(Go to|Select) (previous|next) edit point in Emmet

If someone could fill me in on what these do so I can document
them, that would be great.  Thanks!

M  +235  -11   doc/kate/menus.docbook

http://commits.kde.org/kate/32f6ef4acb2afd27b63aafcad9d571ff19f1d4d0

diff --git a/doc/kate/menus.docbook b/doc/kate/menus.docbook
index f2a0346..381478f 100644
--- a/doc/kate/menus.docbook
+++ b/doc/kate/menus.docbook
@@ -1368,12 +1368,233 @@ own scripts</link>. This way, &kate; can be extended with user-defined tools.
 </para>
 
 <para>The following scripts are included by default:</para>
-
 <variablelist>
-  <!--FIXME more items in 4.10 guisubmeu Navigation, Quick Coding, Editing, Emmet-->
-<varlistentry id="tools-scripts-sort">
+
+<varlistentry id="tools-scripts-emmet">
 <term><menuchoice>
 <guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu>
+<guisubmenu>Emmet</guisubmenu>
+</menuchoice></term>
+<listitem><variablelist>
+
+<varlistentry id="tools-scripts-emmet-expand-abbreviation">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Expand abbreviation</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+Converts the selected text to a pair of opening and closing &HTML; or XML tags.
+For example, if <userinput>div</userinput> is selected, this item will replace 
+that with  <computeroutput><div></div></computeroutput>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-wrap-with-tag">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Wrap with tag</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+Wraps the selected text with the tag provided on the
+<link linkend="advanced-editing-tools-scripting-command-line">command line</link>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-select-tag-inwards">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Select HTML/XML tag contents inwards</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+When the cursor is inside a pair of &HTML;/XML tags, this option will change the
+selection to include the contents of those &HTML;/XML tags, without selecting the
+tags themselves.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-select-tag-outwards">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Select &HTML;/XML tag contents outwards</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+When the cursor is inside a pair of &HTML;/XML tags, this item will change the
+selection to include the contents of those &HTML;/XML tags, including the tags
+themselves.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-move-cursor-to-matching-tag">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Move cursor to matching tag</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+If the cursor is inside an opening &HTML;/XML tag, this item will move it to the
+closing tag.  If the cursor is inside the closing tag, it will instead move it
+to the opening tag.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-toggle-comment">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Toggle Comment</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+If the selected portion is not a comment, this item will enclose that portion
+in &HTML;/XML comments (e.g. 
+<computeroutput><-- selected texxt --></computeroutput>). If the selected 
+portion is a comment, the comment tags will be removed instead.
+</para></listitem>
+</varlistentry>
+
+<!--FIXME: (Go to|Select next) (previous|next) edit point -->
+
+<varlistentry id="tools-scripts-emmet-toggle-comment">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Delete tag under cursor</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+If the cursor is presently inside a &HTML;/XML tag, this item will delete the
+entire tag.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-decrement-number-by-1">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Decrement number by 1</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+This item will subtract one from the currently selected text, if it is a number.  
+For example, if <userinput>5</userinput> is selected, it will become 
+<computeroutput>4</computeroutput>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-decrement-number-by-10">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Decrement number by 10</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+This item will subtract 10 from the currently selected text, if it is a number.  
+For example, if <userinput>15</userinput> is selected, it will become 
+<computeroutput>5</computeroutput>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-decrement-number-by-0_1">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Decrement number by 0.1</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+This item will subtract 0.1 from the currently selected text, if it is a number.  
+For example, if <userinput>4.5</userinput> is selected, it will become 
+<computeroutput>4.4</computeroutput>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-increment-number-by-1">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Increment number by 1</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+This item will add one to the currently selected text, if it is a number.  
+For example, if <userinput>5</userinput> is selected, it will become 
+<computeroutput>6</computeroutput>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-increment-number-by-1">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Increment number by 1</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+This item will add one to the currently selected text, if it is a number.  
+For example, if <userinput>5</userinput> is selected, it will become 
+<computeroutput>6</computeroutput>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-increment-number-by-10">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Increment number by 10</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+This item will add 10 to the currently selected text, if it is a number.  
+For example, if <userinput>5</userinput> is selected, it will become 
+<computeroutput>15</computeroutput>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-emmet-increment-number-by-0_1">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
+<guimenuitem>Increment number by 0.1</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+This item will add 0.1 to the currently selected text, if it is a number.  
+For example, if <userinput>4.5</userinput> is selected, it will become 
+<computeroutput>4.6</computeroutput>.
+</para></listitem>
+</varlistentry>
+
+</variablelist></listitem>
+</varlistentry>
+
+<!--FIXME: Quick Coding -> Expand Abbreviation (CTRL+ALT+#) -->
+
+<varlistentry id="tools-scripts-navigation">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu>
+<guisubmenu>Navigation</guisubmenu>
+</menuchoice></term>
+<listitem><variablelist>
+
+<varlistentry id="tools-scripts-navigation-previous-indent">
+<term><menuchoice>
+<shortcut><keycombo action="simul">&Alt;&Shift;<keysym>Up</keysym></keycombo></shortcut>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Navigation</guisubmenu>
+<guimenuitem>Move cursor to previous matching indent</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+Moves the cursor to the first line above the current line that is indented at
+the same level as the current line.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="tools-scripts-navigation-next-indent">
+<term><menuchoice>
+<shortcut><keycombo action="simul">&Alt;&Shift;<keysym>Down</keysym></keycombo></shortcut>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Navigation</guisubmenu>
+<guimenuitem>Move cursor to next matching indent</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+Moves the cursor to the first line below the current line that is indented at
+the same level as the current line.
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+</listitem></varlistentry>
+
+<varlistentry id="tools-scripts-editing">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu>
+<guisubmenu>Editing</guisubmenu>
+</menuchoice></term>
+<listitem><variablelist>
+
+<varlistentry id="tools-scripts-editing-sort">
+<term><menuchoice>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Editing</guisubmenu>
 <guimenuitem>Sort Selected Text</guimenuitem>
 </menuchoice></term>
 <listitem><para>
@@ -1381,10 +1602,10 @@ Sorts the selected text or whole document in ascending order.
 </para></listitem>
 </varlistentry>
 
-<varlistentry id="tools-scripts-move-down">
+<varlistentry id="tools-scripts-editing-move-down">
 <term><menuchoice>
 <shortcut><keycombo action="simul">&Ctrl;&Shift;<keysym>Down</keysym></keycombo></shortcut>
-<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Editing</guisubmenu>
 <guimenuitem>Move Lines Down</guimenuitem>
 </menuchoice></term>
 <listitem><para>
@@ -1392,10 +1613,10 @@ Move selected lines down.
 </para></listitem>
 </varlistentry>
 
-<varlistentry id="tools-scripts-move-up">
+<varlistentry id="tools-scripts-editing-move-up">
 <term><menuchoice>
 <shortcut><keycombo action="simul">&Ctrl;&Shift;<keysym>Up</keysym></keycombo></shortcut>
-<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Editing</guisubmenu>
 <guimenuitem>Move Lines Up</guimenuitem>
 </menuchoice></term>
 <listitem><para>
@@ -1403,10 +1624,10 @@ Move selected lines up.
 </para></listitem>
 </varlistentry>
 
-<varlistentry id="tools-scripts-dupe-down">
+<varlistentry id="tools-scripts-editing-dupe-down">
 <term><menuchoice>
 <shortcut><keycombo action="simul">&Ctrl;&Alt;<keysym>Down</keysym></keycombo></shortcut>
-<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Editing</guisubmenu>
 <guimenuitem>Duplicate Selected Lines Down</guimenuitem>
 </menuchoice></term>
 <listitem><para>
@@ -1414,10 +1635,10 @@ Duplicates the selected lines down.
 </para></listitem>
 </varlistentry>
 
-<varlistentry id="tools-scripts-dupe-up">
+<varlistentry id="tools-scripts-editing-dupe-up">
 <term><menuchoice>
 <shortcut><keycombo action="simul">&Ctrl;&Alt;<keysym>Up</keysym></keycombo></shortcut>
-<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu>
+<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Editing</guisubmenu>
 <guimenuitem>Duplicate Selected Lines Up</guimenuitem>
 </menuchoice></term>
 <listitem><para>
@@ -1425,6 +1646,9 @@ Duplicates the selected lines up.
 </para></listitem>
 </varlistentry>
 
+</variablelist></listitem>
+</varlistentry>
+
 </variablelist>
 </listitem>
 </varlistentry>