[kate] doc: sync find + replace bar from kate/menus.docbook to katepart/part.docbook
Burkhard Lück
lueck at hube-lueck.de
Sat Aug 27 17:31:26 UTC 2016
Git commit b6e0089ac859df10da4a739d7836126c0e6acdb8 by Burkhard Lück.
Committed on 27/08/2016 at 17:31.
Pushed by lueck into branch 'master'.
sync find + replace bar from kate/menus.docbook to katepart/part.docbook
M +2 -0 doc/kate/menus.docbook
M +- -- doc/katepart/arrow-down-double-22.png
M +- -- doc/katepart/arrow-up-double-22.png
M +- -- doc/katepart/configure-shortcuts-22.png
M +- -- doc/katepart/edit-select-all-22.png
M +- -- doc/katepart/format-text-superscript-22.png
M +33 -20 doc/katepart/part.docbook
http://commits.kde.org/kate/b6e0089ac859df10da4a739d7836126c0e6acdb8
diff --git a/doc/kate/menus.docbook b/doc/kate/menus.docbook
index b17f09d..93891d6 100644
--- a/doc/kate/menus.docbook
+++ b/doc/kate/menus.docbook
@@ -483,6 +483,8 @@ string in the text, this is indicated by a light red background color of the ent
<inlinemediaobject><imageobject><imagedata fileref="arrow-up-double-22.png" format="PNG"/></imageobject></inlinemediaobject> or
<inlinemediaobject><imageobject><imagedata fileref="arrow-down-double-22.png" format="PNG"/></imageobject></inlinemediaobject> button
to jump to the next or previous match in the document.</para>
+<para>Matches in the document are highlighted even when you close the search bar. To clear
+this highlighting, press the &Esc; key.</para>
<para>You can choose whether the search should be case sensitive.
Selecting <inlinemediaobject><imageobject><imagedata fileref="format-text-superscript-22.png" format="PNG"/></imageobject></inlinemediaobject>
will limit finds to entries that match the
diff --git a/doc/katepart/arrow-down-double-22.png b/doc/katepart/arrow-down-double-22.png
index 346145a..34f84ab 100644
Binary files a/doc/katepart/arrow-down-double-22.png and b/doc/katepart/arrow-down-double-22.png differ
diff --git a/doc/katepart/arrow-up-double-22.png b/doc/katepart/arrow-up-double-22.png
index 3cc2be9..abd03f0 100644
Binary files a/doc/katepart/arrow-up-double-22.png and b/doc/katepart/arrow-up-double-22.png differ
diff --git a/doc/katepart/configure-shortcuts-22.png b/doc/katepart/configure-shortcuts-22.png
index 1cdc20c..38f8365 100644
Binary files a/doc/katepart/configure-shortcuts-22.png and b/doc/katepart/configure-shortcuts-22.png differ
diff --git a/doc/katepart/edit-select-all-22.png b/doc/katepart/edit-select-all-22.png
index 3cc3552..78da930 100644
Binary files a/doc/katepart/edit-select-all-22.png and b/doc/katepart/edit-select-all-22.png differ
diff --git a/doc/katepart/format-text-superscript-22.png b/doc/katepart/format-text-superscript-22.png
index c146c65..4596756 100644
Binary files a/doc/katepart/format-text-superscript-22.png and b/doc/katepart/format-text-superscript-22.png differ
diff --git a/doc/katepart/part.docbook b/doc/katepart/part.docbook
index 93b7a68..6c51120 100644
--- a/doc/katepart/part.docbook
+++ b/doc/katepart/part.docbook
@@ -291,7 +291,7 @@ depends on some of the options described below.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>Match case</guilabel></term>
+<term><guilabel>Match case sensitive</guilabel></term>
<listitem>
<para>If enabled, the search will be limited to entries that match the
case (upper or lower) of each of the characters in the search pattern.</para>
@@ -346,7 +346,7 @@ Expressions</link> for more on these.</para>
</varlistentry>
<varlistentry>
-<term><guilabel>Selection only</guilabel></term>
+<term><guilabel>Search in the selection only</guilabel></term>
<listitem>
<para>If checked, the search and replace will be performed within
the selected text only.</para>
@@ -364,7 +364,7 @@ all matches in the document and shows the number of found matches in a small pop
</variablelist>
</sect2>
-
+<!--FIXME keep in sync with kate/menus.docbook <varlistentry id="edit-find"> -->
<sect2 id="finding-text">
<title>Finding Text</title>
@@ -378,16 +378,19 @@ box for entering the search pattern.</para>
<para>When you start entering the characters of your search pattern, the search starts
immediately. If there is a match in the text this is highlighted and the background color
of the entry field changes to light green. If the search pattern does not match any
-string in the text, this is indicated by a light red background color of the entry field
-and <guilabel>Not found</guilabel> is displayed at the right side of the bar.</para>
-<para>Use the <guilabel>Next</guilabel> or <guilabel>Previous</guilabel> button
+string in the text, this is indicated by a light red background color of the entry field.</para>
+<para>Use the
+<inlinemediaobject><imageobject><imagedata fileref="arrow-up-double-22.png" format="PNG"/></imageobject></inlinemediaobject> or
+<inlinemediaobject><imageobject><imagedata fileref="arrow-down-double-22.png" format="PNG"/></imageobject></inlinemediaobject> button
to jump to the next or previous match in the document.</para>
-<para>Matches are highlighted even when you close the search bar. To clear
+<para>Matches in the document are highlighted even when you close the search bar. To clear
this highlighting, press the &Esc; key.</para>
<para>You can choose whether the search should be case sensitive.
-Selecting <guilabel>Match Case</guilabel> will limit finds to entries that match the
+Selecting <inlinemediaobject><imageobject><imagedata fileref="format-text-superscript-22.png" format="PNG"/></imageobject></inlinemediaobject>
+will limit finds to entries that match the
case (upper or lower) of each of the characters in the search pattern.</para>
-<para>Click on the button with a green arrow icon at the right side of the incremental search bar to
+<para>Click on the <inlinemediaobject><imageobject><imagedata fileref="configure-shortcuts-22.png" format="PNG"/></imageobject></inlinemediaobject>
+button at the right side of the incremental search bar to
switch to the power search and replace bar.
</para>
<para>
@@ -402,8 +405,8 @@ or
</para>
</sect2>
-
-<sect2>
+<!--FIXME keep in sync with kate/menus.docbook <varlistentry id="edit-replace"> -->
+<sect2 id="replacing-text">
<title>Replacing Text</title>
<para>To replace text, launch the power search and replace bar
@@ -414,22 +417,32 @@ using the <menuchoice><guimenu>Edit</guimenu>
box for entering the search pattern.</para>
<para>You can control the search mode by selecting the options <guilabel>Plain Text</guilabel>,
<guilabel>Whole Words</guilabel>, <guilabel>Escape Sequences</guilabel> or
-<guilabel>Regular Expression</guilabel> described above.
+<guilabel>Regular Expression</guilabel> from the drop down box.
</para>
-<para>Use the <guilabel>Next</guilabel> or <guilabel>Previous</guilabel> button to jump
+<para>If <guilabel>Escape sequences</guilabel> or <guilabel>Regular expression</guilabel> are
+selected, the <guibutton>Add...</guibutton> menuitem at the bottom of the context menu of the text boxes will be enabled
+and allows you to add escape sequences or regular expression items to the
+search or replace pattern from predefined lists.</para>
+<para>Use the
+<inlinemediaobject><imageobject><imagedata fileref="arrow-up-double-22.png" format="PNG"/></imageobject></inlinemediaobject> or
+<inlinemediaobject><imageobject><imagedata fileref="arrow-down-double-22.png" format="PNG"/></imageobject></inlinemediaobject> button
to the next or previous match in the document.</para>
-<para>Enter the text to replace with in the text box labelled <guilabel>Replace</guilabel>
+<para>Enter the text to replace with in the text box labeled <guilabel>Replace</guilabel>
and click the <guibutton>Replace</guibutton> button to replace only the highlighted text or
the <guibutton>Replace All</guibutton> button to replace the search text in the whole document.
</para>
-<para>You can modify the search and replace behavior by selecting the different
-options at the bottom of the bar. Selecting <guilabel>Match Case</guilabel> will limit
-finds to entries that match the case (upper or lower) of each of the characters in
-the search pattern. <guilabel>Selection Only</guilabel> will search and replace
-within the current selection only. The <guilabel>Find All</guilabel> button highlights
+<para>You can modify the search and replace behavior by selecting different
+options at the bottom of the bar.
+Selecting <inlinemediaobject><imageobject><imagedata fileref="format-text-superscript-22.png" format="PNG"/></imageobject></inlinemediaobject>
+will limit finds to entries that match the
+case (upper or lower) of each of the characters in the search pattern.
+<inlinemediaobject><imageobject><imagedata fileref="edit-select-all-22.png" format="PNG"/></imageobject></inlinemediaobject>
+will search and replace within the current selection only.
+The <guilabel>Find All</guilabel> button highlights
all matches in the document and shows the number of found matches in a small popup.
</para>
-<para>Click on the button with a green arrow icon at the right side of the power search and replace bar to
+<para>Click on the <inlinemediaobject><imageobject><imagedata fileref="configure-shortcuts-22.png" format="PNG"/></imageobject></inlinemediaobject>
+button at the right side of the power search and replace bar to
switch to the incremental search bar.
</para>
<tip>
More information about the kde-doc-english
mailing list