[utilities/kate] doc/katepart: Add docs about multiple cursors

[Waqar Ahmed]

Git commit 4ae7c26e0b8b6b20c6e0e019d0c98d585dbd7a22 by Waqar Ahmed.
Committed on 22/03/2022 at 06:29.
Pushed by waqar into branch 'master'.

Add docs about multiple cursors

M  +2    -2    doc/katepart/configuring.docbook
M  +32   -0    doc/katepart/part.docbook

https://invent.kde.org/utilities/kate/commit/4ae7c26e0b8b6b20c6e0e019d0c98d585dbd7a22

diff --git a/doc/katepart/configuring.docbook b/doc/katepart/configuring.docbook
index 1d7cdf996..5add7220b 100644
--- a/doc/katepart/configuring.docbook
+++ b/doc/katepart/configuring.docbook
@@ -519,10 +519,10 @@ of only removing the base character. This is useful for Indic locales.</para></l
 </listitem>
 </varlistentry>
 
-<varlistentry>
+<varlistentry id="multicursor-modifier-configure">
 <term><guilabel>Multicursor modifier</guilabel></term>
 <listitem>
-<para>This option lets you set the modifier that will be used to create multiple cursors with &LMB; click. You need to press the modifiers and click &LMB; to create a cursor at the desired location.</para>
+<para>This option lets you set the modifier that will be used to create multiple cursors with &LMB; click. You need to press the modifiers and click &LMB; to create a cursor at the desired location. See <link linkend="kate-part-create-multiple-cursors">Creating multiple cursors</link> to discover other ways to create mulitple cursors.</para>
 </listitem>
 </varlistentry>
 
diff --git a/doc/katepart/part.docbook b/doc/katepart/part.docbook
index 4d77336a4..ea864a62a 100644
--- a/doc/katepart/part.docbook
+++ b/doc/katepart/part.docbook
@@ -650,4 +650,36 @@ or permanently in <link linkend="appearance-borders">the Appearance section of
 
 </sect1>
 
+<sect1 id="kate-part-multiple-cursors">
+<title>Multiple cursors</title>
+Multiple cursor support was introduced with version 5.93 of katepart.
+
+<!-- <sect3 id="kate-part-create-multiple-cursors"> -->
+<sect3 id="kate-part-create-multiple-cursors">
+<title>Creating multiple cursors</title>
+
+<varlistentry>
+<listitem><para>To create them via mouse, use &Alt; + &LMB;. The modifier is configurable, see <link linkend="multicursor-modifier-configure">Configure multicursor modifier</link></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<listitem><para>To create via keyboard, press <keycombo action="simul">&Ctrl;&Alt;&Up;</keycombo> to create cursor above primary cursor and <keycombo action="simul">&Ctrl;&Alt;&Down;</keycombo> to create cursor below. These shortucts are also configurable</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<listitem><para>To create cursors out of a selection, first select some text and then press <keycombo action="simul">&Shift;&Alt;<keycap>I</keycap></keycombo>. This will create a cursor at the end of each line in selection.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<listitem><para>Use <keycombo action="simul">&Alt;<keycap>J</keycap></keycombo> to find the next occurrence of the word under cursor and select it + create a cursor.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<listitem><para>Use <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>J</keycap></keycombo> to find all occurrences of the word under cursor and select them with a cursor at the end of each selection.</para></listitem>
+</varlistentry>
+
+</sect3>
+
+</sect1>
+
 </chapter>