Partially resolves: tdf#137084 - updating "Format" menu

  - moved some controls to match current order of Format menu
  - deleted controls that no longer appear in Format menu
      (Page, AutoCorrect, Alignment (Objects), Alignment (Text Objects)
       Flip, Frame, Object)
  - add missing controls (Clone Formatting, Watermark, Name,
       Description) with <embed>
  - add "Comments" and description
  - add appropriate section to Clone Formatting, Name, and Description
       pages, so they can be embedded, and update them to <h1>,<h2>
  - for those controls that need a submenu, a heading and short
       description was added. These are: Align, Lists, Title Page,
       Textbox and Shape, Frame and Object,Rotate or Flip
  - when submenus are made for these controls, then it should be
       possible to replace these with an appropriate embed.

Change-Id: I43fda863539bb84e61a33d663e929501f82bbbf7
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/104488
Tested-by: Jenkins
Reviewed-by: Seth Chaiklin <sdc.blanco@youmail.dk>
diff --git a/source/text/shared/01/05190000.xhp b/source/text/shared/01/05190000.xhp
index 01970b1..2cf32d7 100644
--- a/source/text/shared/01/05190000.xhp
+++ b/source/text/shared/01/05190000.xhp
@@ -34,9 +34,11 @@
</bookmark><comment>ufi: changed names;for groups of objects to names;objects, in cws aw038</comment>
<bookmark xml-lang="en-US" branch="hid/.uno:NameGroup" id="bm_id539508" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/.uno:RenameObject" id="bm_id8549583" localize="false"/>
<paragraph role="heading" id="hd_id3147366" xml-lang="en-US" level="1">Name</paragraph>
<section id="name_head">
<h1 id="hd_id3147366" xml-lang="en-US">Name</h1>
<paragraph role="paragraph" id="par_id3147588" xml-lang="en-US"><variable id="name"><ahelp hid=".uno:RenameObject">Assigns a name to the selected object, so that you can quickly find the object in the Navigator.</ahelp>
</variable><comment>UFI: #i63800</comment></paragraph>
</section>
<section id="howtoget">
  <embed href="text/shared/00/00040502.xhp#adngpb"/>
</section>
@@ -45,7 +47,7 @@
<bookmark xml-lang="en-US" branch="hid/SD_HID_SD_NAMEDIALOG_OBJECT" id="bm_id3154186" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/cui/ui/objectnamedialog/ObjectNameDialog" id="bm_id8149052" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/cui/ui/objectnamedialog/@@nowidget@@" id="bm_id8149052" localize="false"/>
<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="2">Name</paragraph>
<h2 id="hd_id3156027" xml-lang="en-US">Name</h2>
<paragraph role="paragraph" id="par_id3152924" xml-lang="en-US"><ahelp hid=".">Enter a name for the selected object. The name will be visible in the Navigator.</ahelp></paragraph>
</body>
</helpdocument>
diff --git a/source/text/shared/01/05190100.xhp b/source/text/shared/01/05190100.xhp
index 8d4daac..ee96edb 100644
--- a/source/text/shared/01/05190100.xhp
+++ b/source/text/shared/01/05190100.xhp
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">

<!--
 * This file is part of the LibreOffice project.
 *
@@ -19,14 +18,13 @@
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->


<meta>
      <topic id="textshared0105190100xml" indexer="include" status="PUBLISH">
         <title xml-lang="en-US" id="tit">Description</title>
         <filename>/text/shared/01/05190100.xhp</filename>
      </topic>
   </meta>
   <body>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3147366"><bookmark_value>objects;titles and descriptions</bookmark_value>
      <bookmark_value>descriptions for objects</bookmark_value>
      <bookmark_value>titles;objects</bookmark_value>
@@ -34,14 +32,18 @@
<bookmark xml-lang="en-US" branch="hid/.uno:ObjectTitleDescription" id="bm_id267952" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/ObjectTitleDescDialog" id="bm_id1826227" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/@@nowidget@@" id="bm_id1826227" localize="false"/>
<paragraph role="heading" id="hd_id1115756" xml-lang="en-US" level="1">Description</paragraph>
<section id="description_head">
<h1 id="hd_id1115756" xml-lang="en-US">Description</h1>
<paragraph role="paragraph" id="par_id3140354" xml-lang="en-US"><ahelp hid=".">Assigns a title and a description to the selected object. These are accessible for accessibility tools and as alternative tags when you export the document.</ahelp></paragraph>
</section>
<section id="howtoget">
  <embed href="text/shared/00/00040502.xhp#descript"/>
</section>
<bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/object_title_entry" id="bm_id6154362" localize="false"/><paragraph role="heading" id="hd_id2576982" xml-lang="en-US" level="2">Title</paragraph>
<bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/object_title_entry" id="bm_id6154362" localize="false"/>
<h2 id="hd_id2576982" xml-lang="en-US">Title</h2>
<paragraph role="paragraph" id="par_id1283608" xml-lang="en-US"><ahelp hid=".">Enter a title text. This short name is visible as an alternative tag in HTML format. Accessibility tools can read this text.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/desc_entry" id="bm_id6189764" localize="false"/><paragraph role="heading" id="hd_id8173467" xml-lang="en-US" level="2">Description</paragraph>
<bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/desc_entry" id="bm_id6189764" localize="false"/>
<h2 id="hd_id8173467" xml-lang="en-US">Description</h2>
<paragraph role="paragraph" id="par_id693685" xml-lang="en-US"><ahelp hid=".">Enter a description text. The long description text can be entered to describe a complex object or group of objects to users with screen reader software. The description is visible as an alternative tag for accessibility tools.</ahelp></paragraph>
</body>
</helpdocument>
diff --git a/source/text/shared/02/paintbrush.xhp b/source/text/shared/02/paintbrush.xhp
index 7b7c662..a3029a8 100644
--- a/source/text/shared/02/paintbrush.xhp
+++ b/source/text/shared/02/paintbrush.xhp
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
	
<!--
 * This file is part of the LibreOffice project.
 *
@@ -18,8 +17,7 @@
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->
 
	

<meta>
<topic id="textshared02paintbrushxml" indexer="include">
<title id="tit" xml-lang="en-US">Clone Formatting</title>
@@ -28,13 +26,13 @@
</meta>
<body>
<section id="paintbrush">
<section id="paintbrush_head">
<bookmark xml-lang="en-US" branch="hid/.uno:FormatPaintbrush" id="bm_id1629078" localize="false"/>
<paragraph role="heading" id="par_idN1056A" xml-lang="en-US" level="1"><link href="text/shared/02/paintbrush.xhp">Clone Formatting</link></paragraph>
<h1 id="par_idN1056A" xml-lang="en-US"><link href="text/shared/02/paintbrush.xhp">Clone Formatting</link></h1>
<paragraph role="paragraph" id="par_idN1057A" xml-lang="en-US"><ahelp hid=".">First select some text or an object, then click this icon. Then click on or drag across other text or click an object to apply the same formatting.</ahelp><comment>i93691</comment></paragraph>
</section>
<section id="howtoget">
<paragraph role="paragraph" id="par_idN10617" xml-lang="en-US">Click the <emph>Clone Formatting</emph> icon 
<image id="img_id3610034" src="cmd/sc_formatpaintbrush.png" width="0.423cm" height="0.423cm"><alt id="alt_id3610034" xml-lang="en-US">Icon</alt>
	</image> on the <emph>Standard</emph> toolbar. </paragraph>
<paragraph role="paragraph" id="par_idN10617" xml-lang="en-US">Click the <emph>Clone Formatting</emph> icon <image id="img_id3610034" src="cmd/sc_formatpaintbrush.png" width="0.423cm" height="0.423cm"><alt id="alt_id3610034" xml-lang="en-US">Icon</alt></image> on the <emph>Standard</emph> toolbar. </paragraph>
</section>
<section id="sypaintbrush">
<table id="tbl_id4703817">
diff --git a/source/text/swriter/main0105.xhp b/source/text/swriter/main0105.xhp
index 64e3442..737adb3 100644
--- a/source/text/swriter/main0105.xhp
+++ b/source/text/swriter/main0105.xhp
@@ -24,10 +24,7 @@
    <filename>/text/swriter/main0105.xhp</filename>
  </topic>
</meta>

<body>


<section id="format">
<bookmark xml-lang="en-US" branch="hid/.uno:FormatMenu" id="bm_id3047160" localize="false"/>

@@ -36,42 +33,43 @@
</section>
<embed href="text/shared/submenu_text.xhp#submenu_text"/>
<embed href="text/shared/submenu_spacing.xhp#submenu_spacing"/>
<h2 id="hd_id551602974854459">Align</h2>
<paragraph role="paragraph" id="par_id741602974888780">Opens a submenu where you can align text and objects.</paragraph><comment>When a submenu is made for Align, then the heading and text can be replaed with the embed</comment>
<h2 id="hd_id951602975070826">Lists</h2>
<paragraph role="paragraph" id="par_id461602975083850">Opens a submenu where you can modify the structure of numbered and bulleted paragraphs.</paragraph><comment>When a submenu is made for Lists, then the heading and text can be replaced with the embed.</comment>
<embed href="text/shared/02/paintbrush.xhp#paintbrush_head"/>
<embed href="text/shared/01/05010000.xhp#standard"/>

<h2 id="hd_id3147261"><link href="text/shared/01/05020000.xhp" name="Character">Character</link></h2>
<embed href="text/shared/01/05020000.xhp#zeichentext"/>

<h2 id="hd_id3147286"><link href="text/shared/01/05030000.xhp" name="Paragraph">Paragraph</link></h2>
<embed href="text/shared/01/05030000.xhp#absatztext"/>

<h2 id="hd_id3145784"><link href="text/shared/01/06050000.xhp" name="Numbering/Bullets">Bullets and Numbering</link></h2>
<embed href="text/shared/01/06050000.xhp#numauftext"/>

<embed href="text/swriter/01/05040000.xhp#PageStyle"/>
<!--<h2 id="hd_id3145692"><link href="text/swriter/01/05040000.xhp" name="Page">Page</link></h2>
<embed href="text/swriter/01/05040000.xhp#seitetext"/>-->
<h2 id="hd_id871602976197055">Title Page</h2>
<paragraph role="paragraph" id="par_id471602976213270">Opens submenu where you can design a title page.</paragraph><comment>When a submenu is made for Title Page, then the heading and text can be replaced with the embed.</comment>
<h2 id="hd_id201602976343046">Comments</h2>
<paragraph role="paragraph" id="par_id61602976356685">When comments are present, the character dialog is presented. Changes to font and font formatting are applied to all comments.</paragraph>
<embed href="text/shared/01/05060000.xhp#ruby"/>

<h2 id="hd_id3145743"><link href="text/swriter/01/05040500.xhp" name="Columns">Columns</link></h2>
<embed href="text/swriter/01/05040500.xhp#spaltentext"/>

<h2 id="hd_id11602979335965">Watermark</h2>
<embed href="text/swriter/01/watermark.xhp#waterm01"/>
<h2 id="hd_id3145717"><link href="text/swriter/01/02170000.xhp" name="Sections">Sections</link></h2>
<embed href="text/swriter/01/02170000.xhp#bereichetext"/>
<embed href="text/swriter/01/05150000.xhp#autoformat"/>
<embed href="text/shared/01/05260000.xhp#verankerung"/>
<embed href="text/swriter/01/05060200.xhp#umlauf"/>
<embed href="text/shared/01/05070000.xhp#ausrichtung"/>
<embed href="text/shared/01/05080000.xhp#ausrichtung"/>
<embed href="text/shared/01/05250000.xhp#arrange"/>
<embed href="text/shared/01/05240000.xhp#legende"/>
<embed href="text/shared/01/05290000.xhp#gruppe"/>
<embed href="text/swriter/01/format_object.xhp#object"/>

<h2 id="hd_id3149910"><link href="text/swriter/01/04130000.xhp" name="Frame">Frame</link></h2>
<embed href="text/swriter/01/04130000.xhp#rahm"/>

<h2 id="hd_id3149935"><link href="text/swriter/01/05060000.xhp" name="Image">Image</link></h2>
<embed href="text/swriter/01/05060000.xhp#grafiktext"/>
<h2 id="hd_id881602977324204">Text Box and Shape</h2>
<paragraph role="paragraph" id="par_id451602977343955">Opens a submenu to modify, position, shape, line, area, text attributes, and fontwork for a selected textbox or shape.</paragraph><comment>When a submenu is made for Text Box and Shape, then the heading and text can be replaced with the embed.</comment>
<h2 id="hd_id881602977719329">Frame and Object</h2>
<paragraph role="paragraph" id="par_id951602977746649">Opens a submenu to link and unlink frames, and edit properties of a selected frame.</paragraph><comment>When a submenu is made for Frame and Object, then the heading and text can be replaced with the embed.</comment>
<embed href="text/shared/01/05190000.xhp#name_head"/>
<embed href="text/shared/01/05190100.xhp#description_head"/>
<embed href="text/shared/01/05260000.xhp#verankerung"/>
<embed href="text/swriter/01/05060200.xhp#umlauf"/>
<embed href="text/shared/01/05250000.xhp#arrange"/>
<h2 id="hd_id871602978482880">Rotate or Flip</h2>
<paragraph role="paragraph" id="par_id561602978499640">Opens a submenu where you can rotate or and flip a selected shape or image. Text boxes can only be rotated.</paragraph><comment>When a submenu is made for Rotate or Flip, then the heading and text can be replaced with the embed.</comment>
<embed href="text/shared/01/05290000.xhp#gruppe"/>
</body>

</helpdocument>