tdf#148797 improve explanation of multiple selection in add to list

Some of the options for using the Add to List command are not
available when the Ctrl key is pressed. The existing description of
how to use the Ctrl key may have contributed to confusion about
how to use the command. This patch aims to improve the
description of the workflow with multiple selection.

Also the order of the two procedures were switched, on the
assumption that the most typical use was to add some consecutive
items to a list, so now that explanation comes first.

Change-Id: I4e7c57dba4b6060fcd87eb1046b9e0788dd50b1c
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/133483
Tested-by: Jenkins
Reviewed-by: Seth Chaiklin <sdc.blanco@youmail.dk>

1 files changed, 14 insertions, 13 deletions

diff --git a/source/text/swriter/02/add_to_list.xhp b/source/text/swriter/02/add_to_list.xhp
index ff43065699..9343a62223 100644
--- a/source/text/swriter/02/add_to_list.xhp
+++ b/source/text/swriter/02/add_to_list.xhp
@@ -43,14 +43,25 @@
 </section>
 <paragraph role="paragraph" id="par_id711616001147778">The list labeling and indent formatting are applied to the selected paragraphs. The position of the paragraphs in the document does not change.</paragraph>
 
+<h2 id="hd_id441616017998739">Add Consecutive List Entries to an Immediately Prior List</h2>
+<list type="ordered">
+  <listitem>
+    <paragraph id="par_id631616018294373" role="listitem">Select one or more consecutive list entries, starting from the first entry, that you want to add to the immediately prior list.</paragraph>
+  </listitem>
+  <listitem>
+    <paragraph id="par_id621616018340980" role="listitem"><embedvar href="text/swriter/02/add_to_list.xhp#rightclick"/></paragraph>
+  </listitem>
+</list>
+<tip id="par_id811616018796902">Use this procedure to combine two lists.</tip>
+
 <h2 id="hd_id851614072896370">Add Selected Paragraphs to a List</h2>
   <list type="ordered">
     <listitem>
       <paragraph id="par_id491615988072533" role="listitem">Select paragraphs, whether in a list or not, to be added to a list.</paragraph>
-      <paragraph role="paragraph"  id="par_id271615998908234">For multiple selections, press and hold the <keycode> Ctrl</keycode> key after the first selection. The <keycode>Ctrl</keycode> key can be released without losing the selections, but must be pressed when clicking in the document.</paragraph>
+      <paragraph role="paragraph"  id="par_id271615998908234">For multiple selections, press and hold the <keycode> Ctrl</keycode> key after the first selection. Only one character needs to be selected in each paragraph to be added. The <keycode>Ctrl</keycode> key can be released without losing the selections, but must be pressed whenever clicking in the document to preserve the selection.</paragraph>
     </listitem>
     <listitem>
-      <paragraph id="par_id551615985719902" role="listitem">Press and hold the <keycode>Ctrl</keycode> key, then place cursor in the list.</paragraph>
+      <paragraph id="par_id551615985719902" role="listitem">Press and hold the <keycode>Ctrl</keycode> key, select at least one character in the list, then release the <keycode> Ctrl</keycode> key.</paragraph>
     </listitem>
     <listitem>
         <paragraph id="par_id901615999151001" role="listitem">Do one of the following:</paragraph>
@@ -64,20 +75,10 @@
       <paragraph id="par_id961614073544958" role="listitem"><embedvar href="text/swriter/02/add_to_list.xhp#toolbar"/></paragraph>
     </listitem>
     <listitem>
-      <paragraph id="par_id161615999749854" role="listitem"><variable id="rightclick">Right-click, choose <menuitem>List - Add to List</menuitem>.</variable> To preserve the selection, at least one character must be selected in the list.</paragraph>
+      <paragraph id="par_id161615999749854" role="listitem"><variable id="rightclick">Right-click anywhere in highlighted selection, choose <menuitem>List - Add to List</menuitem>.</variable></paragraph>
     </listitem>
   </list>
 <note id="par_id861614074931979">This procedure works for ordered and unordered lists.</note>
-<h2 id="hd_id441616017998739">Add Consecutive List Entries to an Immediately Prior List</h2>
-<list type="ordered">
-  <listitem>
-    <paragraph id="par_id631616018294373" role="listitem">Select one or more consecutive list entries, starting from the first entry, that you want to add to the immediately prior list.</paragraph>
-  </listitem>
-  <listitem>
-    <paragraph id="par_id621616018340980" role="listitem"><embedvar href="text/swriter/02/add_to_list.xhp#rightclick"/></paragraph>
-  </listitem>
-</list>
-<tip id="par_id811616018796902">Use this procedure to combine two lists.</tip>
 
 </body>
 </helpdocument>
\ No newline at end of file