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>
