[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-commits
Subject: branches/work/doc/kate
From: Thomas Hollingsworth <tchollingsworth () gmail ! com>
Date: 2011-08-07 4:42:02
Message-ID: 20110807044202.619B3AC871 () svn ! kde ! org
[Download RAW message or body]
SVN commit 1245293 by hollingsworth:
there's more that needs to be copied than I thought o_O
M +1 -1 advanced.docbook
M +1 -1 regular-expressions.docbook
M +18 -18 vi.docbook
--- branches/work/doc/kate/advanced.docbook #1245292:1245293
@@ -6,7 +6,7 @@
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</chapterinfo>
-<title>Advanced Editing Tools</title>
+<title>Advanced Editing Tools &powermode;</title>
<sect1 id="advanced-editing-tools-comment">
--- branches/work/doc/kate/regular-expressions.docbook #1245292:1245293
@@ -11,7 +11,7 @@
<synopsis>This Appendix contains a brief but hopefully sufficient and
covering introduction to the world of <emphasis>regular
expressions</emphasis>. It documents regular expressions in the form
-available within &kate;, which is not compatible with the regular
+available within &kappname;, which is not compatible with the regular
expressions of perl, nor with those of for example
<command>grep</command>.</synopsis>
--- branches/work/doc/kate/vi.docbook #1245292:1245293
@@ -6,7 +6,7 @@
</authorgroup>
</chapterinfo>
-<title>The VI Input Mode</title>
+<title>The VI Input Mode &powermode;</title>
<sect1 id="vi-mode-sect1">
<title>VI Input Mode</title>
@@ -14,14 +14,14 @@
<para>The goal of the VI mode is not to be a complete replacement
for Vim and support all Vim's features. Its aim is to make
the <quote>Vim way</quote> of text editing - and the Vim habits learned -
-available for programs using the &kate; text editor as their internal editor.</para>
+available for programs using the &kappname; text editor as their internal \
editor.</para>
<para>The VI mode aims integrate nicely with the programs and deviate
from Vim's behavior where it makes sense. For example,
-<userinput><command>:w</command></userinput> will open a save dialog in &kate;'s VI \
mode.</para> +<userinput><command>:w</command></userinput> will open a save dialog in \
&kappname;'s VI mode.</para>
<para>To enable the VI input mode for all new view, go to
-<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure \
&kate;...</guimenuitem> \
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure \
&kappname;...</guimenuitem> <guimenu>Editing</guimenu><guimenuitem>VI Input \
Mode</guimenuitem></menuchoice>. On this tab you can set options for the VI Input \
Mode and define and edit the key mapping in this mode.
@@ -33,37 +33,37 @@
<sect2 id="vi-incompatibilities">
<title>Incompatibilities with Vim</title>
-<para>There are only a few features of &kate;'s VI mode which are incompatible
+<para>There are only a few features of &kappname;'s VI mode which are incompatible
with Vim (not counting things missing). They are listed below together
with the respective reasons.</para>
<itemizedlist>
<listitem>
-<para>&kate;: <keycap>U</keycap> and
+<para>&kappname;: <keycap>U</keycap> and
<keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> is redo.</para>
<para>Vim: <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> is
normal redo, <keycap>U</keycap> is used to undo all latest changes on one \
line.</para>
-<para>The reason for having <keycap>U</keycap> act as redo in &kate;'s VI mode is
+<para>The reason for having <keycap>U</keycap> act as redo in &kappname;'s VI mode \
is that the shortcut <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
-by default is taken by &kate;'s replace function (search and replace). By default,
-the VI mode won't override &kate;'s shortcuts (this can be configured in
-<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure \
&kate;...</guimenuitem> +by default is taken by &kappname;'s replace function (search \
and replace). By default, +the VI mode won't override &kappname;'s shortcuts (this \
can be configured in +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure \
&kappname;...</guimenuitem> <guimenu>Editing</guimenu><guimenuitem>Vi Input \
Mode</guimenuitem></menuchoice>), therefore a redo-action needs to be available as a \
<quote>regular</quote> key press, too. Besides, the behavior of the \
<keycap>U</keycap> command in Vim does not map well
-to &kate;'s internal undo system, so it would be non-trivial to support \
anyway.</para> +to &kappname;'s internal undo system, so it would be non-trivial to \
support anyway.</para> </listitem>
<listitem>
-<para>&kate;: <userinput><command>print</command></userinput> shows the \
<guilabel>Print</guilabel> dialog.</para> +<para>&kappname;: \
<userinput><command>print</command></userinput> shows the <guilabel>Print</guilabel> \
dialog.</para> <para>Vim: <userinput><command>print</command></userinput> prints the \
lines of the given range like its grandfather ed.</para>
<para>Commands like <userinput><command>:print</command></userinput> are available
-not only in the VI mode but for users using <quote>regular</quote> &kate;, too - \
therefore +not only in the VI mode but for users using <quote>regular</quote> \
&kappname;, too - therefore the <userinput><command>:print</command></userinput> \
command opens the print dialog - following the principle of least surprise instead \
of mimicking Vim's behavior.</para>
</listitem>
<listitem>
-<para>&kate;: <keycap>Y</keycap> yanks to end of line.</para>
+<para>&kappname;: <keycap>Y</keycap> yanks to end of line.</para>
<para>Vim: <keycap>Y</keycap> yanks whole line, just like
<keycap>y</keycap><keycap>y</keycap>.</para>
<para>VI's behavior for the <keycap>Y</keycap> command is in practice a bug.
@@ -73,13 +73,13 @@
the current line and <keycap>C</keycap>/<keycap>D</keycap> will work from the
cursor column to the end of the line. However, both
<keycap>y</keycap><keycap>y</keycap> and <keycap>Y</keycap>
-yanks the current line. In &kate;'s VI Mode <keycap>Y</keycap> will yank to the end
+yanks the current line. In &kappname;'s VI Mode <keycap>Y</keycap> will yank to the \
end of the line. This is described as <quote>more logical</quote> in the Vim
<ulink url="http://vimdoc.sourceforge.net/htmldoc/change.html#Y">documentation</ulink>.
</para>
</listitem>
<listitem>
-<para>&kate;: <keycap>O</keycap> and <keycap>o</keycap> opens \
[<replaceable>count</replaceable>] new lines +<para>&kappname;: <keycap>O</keycap> \
and <keycap>o</keycap> opens [<replaceable>count</replaceable>] new lines and puts \
you in insert mode.</para> <para>Vim: <keycap>O</keycap> and <keycap>o</keycap> \
opens a new line and inserts text [<replaceable>count</replaceable>] times when \
leaving insert mode.</para> @@ -527,14 +527,14 @@
<sect2 id="vi-missing-features">
<title>Missing Features</title>
-<para>As stated earlier, the goal of &kate;'s VI Mode is not to support 100% of
+<para>As stated earlier, the goal of &kappname;'s VI Mode is not to support 100% of
Vim's features, however, there are some features which are sorely missed:</para>
<itemizedlist>
<listitem>
<para>Visual block mode - especially the ability to prepend/append text to the
visual block selection.</para></listitem>
<listitem>
-<para>Having ex commands available in other programs than the &kate; \
application.</para></listitem> +<para>Having ex commands available in other programs \
than the &kappname; application.</para></listitem> <listitem>
<para>The search code needs improvement and the <keycap>*</keycap> and \
<keycap>#</keycap> commands should just be regular searches.</para></listitem>
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic