update help pages for customizing menus and context menus

( shared/01/06140100.xhp )

Change label: "Function" --> "Available Commands"
Change "function" -- "command" in Function description
Change "function" --> "command" in "Right Arrow" to
be consistent with "Left Arrow" and "Available Commands"
Add label and description for "Assigned Commands"
Remove redundant sentence from "Target" now that
"Assigned Commands" is added.
Reduce hierarchical level for submenu items "Add", "Remove"
Add image for "gear" icon
update to: <h1>,<h2>,<menuitem>

( shared/01/06140300.xhp )

Replace "Function" label (and description) with embed
from ( shared/01/06140100.xhp )
Add "Assigned Commands" label and description with embed
from ( shared/01/06140100.xhp )
Add "Right Arrow" label and description with embed
from ( shared/01/06140100.xhp )
Remove redundant sentence from "Target" now that
"Assigned Commands" is added.
update to: <h1>,<menuitem>

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

2 files changed, 49 insertions, 29 deletions

diff --git a/source/text/shared/01/06140100.xhp b/source/text/shared/01/06140100.xhp
index 1bb9aff8f8..c68cdf2b59 100644
--- a/source/text/shared/01/06140100.xhp
+++ b/source/text/shared/01/06140100.xhp
@@ -11,7 +11,7 @@
 
     <meta>
         <topic id="menu06140100xhp" indexer="include" status="PUBLISH">
-            <title id="tit" xml-lang="en-US">Menus</title>
+            <title id="tit" xml-lang="en-US">Menus (Customizing)</title>
             <filename>/text/shared/01/06140100.xhp</filename>
         </topic>
     </meta>
@@ -24,43 +24,64 @@
         </bookmark>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/MenuAssignPage" id="bm_id714740" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/@@nowidget@@" id="bm_id714740" localize="false"/>
-        <paragraph id="hd_id431514298399070" role="heading" level="1" xml-lang="en-US"><link href="text/shared/01/06140100.xhp" name="Menus">Menus</link></paragraph>
+        <h1 id="hd_id431514298399070" xml-lang="en-US"><link href="text/shared/01/06140100.xhp" name="Menus">Menus</link></h1>
         <paragraph id="par_id991514298399076" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/menuassignpage/MenuAssignPage">Lets you customize %PRODUCTNAME menus for all modules.</ahelp></paragraph>
     </section>
     <paragraph role="paragraph" id="par_id3146873" xml-lang="en-US">You can add new commands, modify existing commands, or rearrange the menu items. You can also add commands executed by macros and apply all kind of styles directly from the menu.</paragraph>
     <section id="howtoget">
-        <paragraph role="paragraph" id="par_id621514299131013" xml-lang="en-US">Choose <item type="menuitem">Tools - Customize - Menus</item> tab.</paragraph>
+        <paragraph role="paragraph" id="par_id621514299131013" xml-lang="en-US">Choose <menuitem>Tools - Customize - Menus</menuitem> tab.</paragraph>
     </section>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/searchEntry" id="bm_id714741" localize="false"/>
-    <paragraph role="heading" id="hd_id611514302475667" level="2" xml-lang="en-US">Search</paragraph>
+    <h2 id="hd_id611514302475667" xml-lang="en-US">Search</h2>
     <paragraph role="paragraph" id="par_id771514302498290" xml-lang="en-US"><ahelp hid=".">Enter a string in the text box to narrow the search of commands.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/commandcategorylist" id="bm_id714742" localize="false"/>
-    <paragraph role="heading" id="hd_id441514302482125" level="2" xml-lang="en-US">Category</paragraph>
+    <h2 id="hd_id441514302482125" xml-lang="en-US">Category</h2>
     <paragraph role="paragraph" id="par_id811514302506979" xml-lang="en-US"><ahelp hid=".">Select the menu command category in the drop-down list to restrict the search of commands or scroll the list below. Macros and styles commands are in the bottom of the list.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/functions" id="bm_id714743" localize="false"/>
-    <paragraph role="heading" id="hd_id551514302487751" level="2" xml-lang="en-US">Function</paragraph>
-    <paragraph role="paragraph" id="par_id831514302518564" xml-lang="en-US"><ahelp hid=".">Displays the results of the combination of the search string and category of the desired function.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/desc" id="bm_id714744" localize="false"/>
-    <paragraph role="heading" id="hd_id221514304363862" level="2" xml-lang="en-US">Description</paragraph>
+<section id="available_commands">
+<h2 id="hd_id551514302487751" xml-lang="en-US">Available Commands</h2>
+    <paragraph role="paragraph" id="par_id831514302518564" xml-lang="en-US"><ahelp hid=".">Displays the results of the combination of the search string and category of the desired command.</ahelp></paragraph>
+</section>
+     <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/desc" id="bm_id714744" localize="false"/>
+    <h2 id="hd_id221514304363862" xml-lang="en-US">Description</h2>
     <paragraph role="paragraph" id="par_id841514304376338" xml-lang="en-US"><ahelp hid=".">The text box contains a short description of the selected command.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/savein" id="bm_id714745" localize="false"/>
-    <paragraph role="heading" id="hd_id541514303919911" level="2" xml-lang="en-US">Scope</paragraph>
+    <h2 id="hd_id541514303919911" xml-lang="en-US">Scope</h2>
     <paragraph role="paragraph" id="hd_id231514303933476" xml-lang="en-US"><ahelp hid=".">Select the location where the menu is to be attached. If attached to a %PRODUCTNAME module, the menu is available for all files opened in that module. If attached to the file, the menu will be available only when that file is opened and active.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/toplevellist" id="bm_id714746" localize="false"/>
-    <paragraph role="heading" id="hd_id581514303962835" level="2" xml-lang="en-US">Target</paragraph>
-    <paragraph role="paragraph" id="par_id921514303969718" xml-lang="en-US"><ahelp hid=".">Select the menu where the customization is to be applied. The current set of functions is displayed in the box below.</ahelp></paragraph>
+    <h2 id="hd_id581514303962835" xml-lang="en-US">Target</h2>
+    <paragraph role="paragraph" id="par_id921514303969718" xml-lang="en-US"><ahelp hid=".">Select the menu where the customization is to be applied.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/plusbtn" id="bm_id714747" localize="false"/>
-    <paragraph role="heading" id="hd_id351514304283480" level="2" xml-lang="en-US">Add</paragraph>
+    <h3 id="hd_id351514304283480" xml-lang="en-US">Add</h3>
     <paragraph role="paragraph" id="par_id151514304300251" xml-lang="en-US"><ahelp hid=".">Click on the gear icon and then choose Add to add a new menu.</ahelp></paragraph>
+<table id="tab_id41604400309745">
+    <tablerow>
+        <tablecell>
+            <paragraph role="paragraph" id="par_id811604400309745">
+<image src="cmd/lc_config.svg" id="img_id381604400309745" width="1cm" height="1cm"><alt id="alt_id131604400309745">Gear Icon</alt></image>
+            </paragraph>
+       </tablecell>
+       <tablecell>
+           <paragraph id="par_id421604400309745" role="paragraph">Gear icon</paragraph>
+       </tablecell>
+    </tablerow>
+</table>
+
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/minusbtn" id="bm_id714748" localize="false"/>
-    <paragraph role="heading" id="hd_id651514304289436" level="2" xml-lang="en-US">Remove</paragraph>
+    <h3 id="hd_id651514304289436" xml-lang="en-US">Remove</h3>
     <paragraph role="paragraph" id="par_id61514304306614" xml-lang="en-US"><ahelp hid=".">Click on the gear icon and then choose Delete to delete the menu.</ahelp></paragraph>
     <note id="par_idN10910">You can only delete custom menus and custom menu entries.</note>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/add" id="bm_id714749" localize="false"/>
-    <paragraph role="heading" id="hd_id961514303975994" level="2" xml-lang="en-US">Right Arrow button</paragraph>
-    <paragraph role="paragraph" id="par_id941514303982378" xml-lang="en-US"><ahelp hid=".">Click on the right arrow button to select a function on the left display box and copy to the right display box. This will add the function to the selected menu.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/remove" id="bm_id7147410" localize="false"/>
-    <paragraph role="heading" id="hd_id161514303992615" level="2" xml-lang="en-US">Left Arrow button</paragraph>
+<section id="assigned_commands">
+<h2 id="hd_id331604401016431">Assigned Commands</h2>
+<paragraph role="paragraph" id="par_id211604401156006">Displays the commands that will be shown in the target menu.</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/add" id="bm_id714749" localize="false"/>
+</section>
+<section id="right_arrow">
+    <h2 id="hd_id961514303975994" xml-lang="en-US">Right Arrow button</h2>
+    <paragraph role="paragraph" id="par_id941514303982378" xml-lang="en-US"><ahelp hid=".">Click on the right arrow button to select a command on the left display box and copy to the right display box. This will add the command to the selected menu.</ahelp></paragraph>
+</section>
+    <h2 id="hd_id161514303992615" xml-lang="en-US">Left Arrow button</h2>
     <paragraph role="paragraph" id="par_id361514304000470" xml-lang="en-US"><ahelp hid=".">Click on the left arrow button to remove the selected command from the current menu.</ahelp></paragraph>
     <section id="updown">
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/up" id="bm_id7147411" localize="false"/>
@@ -70,7 +91,7 @@
     <tip id="par_id301514305066046">You can drag and drop the selected command to move it to the position you want.</tip>
 </section>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/insert" id="bm_id7147413" localize="false"/>
-    <paragraph role="heading" id="hd_id321514310951605" level="2" xml-lang="en-US">Insert</paragraph>
+    <h2 id="hd_id321514310951605" xml-lang="en-US">Insert</h2>
     <list type="unordered">
         <listitem>
             <paragraph id="par_id981514310786648"  role="listitem" xml-lang="en-US"><emph>Insert Separator</emph>: Add a separator mark to improve menu readability and to group commands by subject.</paragraph>
@@ -80,14 +101,14 @@
         </listitem>
     </list>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/modify" id="bm_id7147414" localize="false"/>
-    <paragraph role="heading" id="hd_id341514311059169" level="2" xml-lang="en-US">Modify</paragraph>
+    <h2 id="hd_id341514311059169" xml-lang="en-US">Modify</h2>
     <list type="unordered">
         <listitem>
             <paragraph id="par_id111514311020590"  role="listitem" xml-lang="en-US"><emph>Rename</emph>: Rename the entry.</paragraph>
         </listitem>
     </list>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/menuassignpage/defaultsbtn" id="bm_id7147415" localize="false"/>
-    <paragraph role="heading" id="hd_id641514311180774" level="2" xml-lang="en-US">Defaults</paragraph>
+    <h2 id="hd_id641514311180774" xml-lang="en-US">Defaults</h2>
     <paragraph id="par_id851514311086417"  role="listitem" xml-lang="en-US"><ahelp hid="cui/ui/menuassignpage/defaultsbtn">Deletes all changes previously made to this menu.</ahelp></paragraph>
     <section id="relatedtopics">
         <paragraph role="paragraph" id="par_id481514299760750" xml-lang="en-US"><link href="text/shared/01/06140300.xhp" name="linkname">Customizing %PRODUCTNAME context menus</link></paragraph>
diff --git a/source/text/shared/01/06140300.xhp b/source/text/shared/01/06140300.xhp
index c40678dad7..9b42826222 100644
--- a/source/text/shared/01/06140300.xhp
+++ b/source/text/shared/01/06140300.xhp
@@ -11,7 +11,7 @@
 
     <meta>
         <topic id="contextmenu06140300xhp" indexer="include" status="PUBLISH">
-            <title id="tit" xml-lang="en-US">Context Menus</title>
+            <title id="tit" xml-lang="en-US">Context Menus (Customizing)</title>
             <filename>/text/shared/01/06140300.xhp</filename>
         </topic>
     </meta>
@@ -22,27 +22,26 @@
             <bookmark_value>customizing;context menus</bookmark_value>
             <bookmark_value>editing;context menus</bookmark_value>
         </bookmark>
-        <paragraph id="hd_id431514298399070" role="heading" level="1" xml-lang="en-US"><link href="text/shared/01/06140300.xhp" name="Context Menus">Context Menus</link></paragraph>
+        <h1 id="hd_id431514298399070" xml-lang="en-US"><link href="text/shared/01/06140300.xhp" name="Context Menus">Context Menus</link></h1>
         <paragraph id="par_id991514298399076" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/menuassignpage/MenuAssignPage">Lets you customize %PRODUCTNAME context menus for all modules.</ahelp></paragraph>
     </section>
     <paragraph role="paragraph" id="par_id3146873" xml-lang="en-US">You can add new commands, modify existing commands, or rearrange the context menu items. You can also add commands executed by macros and apply all kind of styles directly from the context menu.</paragraph>
     <section id="howtoget">
-        <paragraph role="paragraph" id="par_id621514299131013" xml-lang="en-US">Choose <item type="menuitem">Tools - Customize - Context Menus</item> tab.</paragraph>
+        <paragraph role="paragraph" id="par_id621514299131013" xml-lang="en-US">Choose <menuitem>Tools - Customize - Context Menus</menuitem> tab.</paragraph>
     </section>
     <paragraph role="heading" id="hd_id611514302475667" level="2" xml-lang="en-US">Search</paragraph>
     <paragraph role="paragraph" id="par_id771514302498290" xml-lang="en-US">Enter a string in the text box to narrow the search of commands.</paragraph>
     <paragraph role="heading" id="hd_id441514302482125" level="2" xml-lang="en-US">Category</paragraph>
     <paragraph role="paragraph" id="par_id811514302506979" xml-lang="en-US">Select the menu command category in the drop-down list to restrict the search of commands or scroll the list below. Macros and styles commands are in the bottom of the list.</paragraph>
-    <paragraph role="heading" id="hd_id551514302487751" level="2" xml-lang="en-US">Function</paragraph>
-    <paragraph role="paragraph" id="par_id831514302518564" xml-lang="en-US">Displays the results of the combination of the search string and category of the desired function.</paragraph>
+<embed href="text/shared/01/06140100.xhp#available_commands"/>
     <paragraph role="heading" id="hd_id221514304363862" level="2" xml-lang="en-US">Description</paragraph>
     <paragraph role="paragraph" id="par_id841514304376338" xml-lang="en-US">The text box contains a short description of the selected command.</paragraph>
     <paragraph role="heading" id="hd_id541514303919911" level="2" xml-lang="en-US">Scope</paragraph>
     <paragraph role="paragraph" id="hd_id231514303933476" xml-lang="en-US">Select the location where the context menu is to be attached. If attached to a %PRODUCTNAME module, the context menu is available for all files opened in that module. If attached to the file, the context menu will be available only when that file is opened and active.</paragraph>
     <paragraph role="heading" id="hd_id581514303962835" level="2" xml-lang="en-US">Target</paragraph>
-    <paragraph role="paragraph" id="par_id921514303969718" xml-lang="en-US">Select the Context Menu where the customization is to be applied. The current set of functions is displayed in the box below.</paragraph>
-    <paragraph role="heading" id="hd_id961514303975994" level="2" xml-lang="en-US">Right Arrow button</paragraph>
-    <paragraph role="paragraph" id="par_id941514303982378" xml-lang="en-US">Click on the right arrow button to select a function on the left display box and copy to the right display box. This will add the function to the selected context menu.</paragraph>
+    <paragraph role="paragraph" id="par_id921514303969718" xml-lang="en-US">Select the Context Menu where the customization is to be applied.</paragraph>
+<embed href="text/shared/01/06140100.xhp#assigned_commands"/>
+<embed href="text/shared/01/06140100.xhp#right_arrow"/>
     <paragraph role="heading" id="hd_id161514303992615" level="2" xml-lang="en-US">Left Arrow button</paragraph>
     <paragraph role="paragraph" id="par_id361514304000470" xml-lang="en-US">Click on the left arrow button to remove the selected command from the current context menu.</paragraph>
     <paragraph role="heading" id="hd_id761514304005994" level="2" xml-lang="en-US">Up and Down arrow buttons</paragraph>