tdf#149012 updating of Options tab for Frame, Object, Image

text/swriter/01/05060900.xhp
* corrections to control names
+ added embed to "Description" which was missing, but
an adjustment will be needed in a subsequent patch
because the embedded file header describes the command
"Description" and not the field in the Options dialog box.
But the description is close enough to be useful for now, and
another patch will be needed here because of changes to the
dialog as a result of tdf#148941, so necessary adjustments
can be made as part of that followup patch.
* identify "frame only" controls
* change position of "Content Alignment" to match dialog
* refactor to <h1>,<h2>,<h3>,<tip>

text/swriter/00/00000405.xhp
* clarify that frame styles should be used in sidebar
* refactor to <menuitem> for clarified paragraph

Change-Id: I82e62a2d2fd49c44b779ac79e102a5b8623196ba
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/134065
Tested-by: Jenkins
Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>

2 files changed, 23 insertions, 21 deletions

diff --git a/source/text/swriter/00/00000405.xhp b/source/text/swriter/00/00000405.xhp
index 4ca02f9684..efbd24b09c 100644
--- a/source/text/swriter/00/00000405.xhp
+++ b/source/text/swriter/00/00000405.xhp
@@ -150,7 +150,7 @@
       <section id="graphics_options">
          <paragraph xml-lang="en-US" id="par_id3154724" role="paragraph">Choose <emph>Format - Image - Properties - Options</emph> tab.</paragraph>
          <paragraph xml-lang="en-US" id="par_id3145636" role="paragraph">Choose <emph>Format - Frame and Object - Properties - Options</emph> tab.</paragraph>
-         <paragraph xml-lang="en-US" id="par_id3149774" role="paragraph">Choose <emph>View - Styles</emph>  -open context menu <emph>Modify/New - Options</emph> tab.</paragraph>
+         <paragraph xml-lang="en-US" id="par_id3149774" role="paragraph">Choose <menuitem>View - Styles</menuitem> - open context menu for selected <menuitem>Frame style</menuitem> - <menuitem>Modify/New - Options</menuitem> tab.</paragraph>
          <paragraph xml-lang="en-US" id="par_id3150922" role="paragraph">Choose <emph>Insert - Frame - Frame - Options</emph> tab.</paragraph>
       </section>
       <paragraph xml-lang="en-US" id="par_id3155088" role="paragraph"><variable id="grafik1">Choose <emph>Format - Image - Properties - Image</emph> tab.</variable></paragraph>
diff --git a/source/text/swriter/01/05060900.xhp b/source/text/swriter/01/05060900.xhp
index 74037541a5..c6f38e72a6 100644
--- a/source/text/swriter/01/05060900.xhp
+++ b/source/text/swriter/01/05060900.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,7 +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 .
  -->
-<helpdocument version="1.0">
+
 <meta>
 <topic id="textswriter0105060900xml" indexer="include" status="PUBLISH">
 <title id="tit" xml-lang="en-US">Options</title>
@@ -32,54 +31,57 @@
 <section id="options">
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/@@nowidget@@" id="bm_@@nowidget@@" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/FrameAddPage" id="bm_id3150016" localize="false"/>
-<paragraph role="heading" id="hd_id3149879" xml-lang="en-US" level="1"><link href="text/swriter/01/05060900.xhp" name="Options">Options</link></paragraph>
+<h1 id="hd_id3149879" xml-lang="en-US"><link href="text/swriter/01/05060900.xhp" name="Options">Options</link></h1>
 <paragraph role="paragraph" id="par_id3149708" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/FrameAddPage">Specifies properties for the selected object, graphic or frame.</ahelp></paragraph>
 </section>
 <section id="howtoget">
   <embed href="text/swriter/00/00000405.xhp#graphics_options"/>
 </section>
-<paragraph role="heading" id="hd_id3151183" xml-lang="en-US" level="2">Name</paragraph>
+<h2 id="hd_id3151183" xml-lang="en-US">Name</h2>
 <paragraph role="paragraph" id="par_id3147568" xml-lang="en-US">Specifies the name of the selected item, and associated links.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/name" id="bm_id3145419" localize="false"/>
-<paragraph role="heading" id="hd_id3151178" xml-lang="en-US" level="3">Name</paragraph>
+<h3 id="hd_id3151178" xml-lang="en-US">Name</h3>
 <paragraph role="paragraph" id="par_id3147510" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/name">Enter a name for the selected item.</ahelp></paragraph>
-<paragraph role="tip" id="par_id3154565" xml-lang="en-US">Assign an object, graphic or frame a meaningful name, so that you can quickly locate it afterwards in long documents.</paragraph>
+<tip id="par_id3154565" xml-lang="en-US">Assign an object, graphic or frame a meaningful name, so that you can quickly locate it afterwards in long documents.</tip>
 
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/altname" id="bm_id3150352" localize="false"/>
-<paragraph role="heading" id="hd_id3153674" xml-lang="en-US" level="3">Alternative text (floating frames, graphics, and objects only)</paragraph>
+<h3 id="hd_id3153674" xml-lang="en-US">Alternative text (floating frames, graphics, and objects only)</h3>
 <paragraph role="paragraph" id="par_id3150977" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/altname">Enter the text to display in a web browser when the selected item is unavailable. Alternate text is also used to assist people with disabilities.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/prev" id="bm_id3149695" localize="false"/>
-<paragraph role="heading" id="hd_id3155903" xml-lang="en-US" level="3">Previous link</paragraph>
+<embed href="text/shared/01/05190100.xhp#description_head"/>
+<h3 id="hd_id3155903" xml-lang="en-US">Previous link</h3>
 <paragraph role="paragraph" id="par_id3154192" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/prev">Displays the item (object, graphic, or frame) that comes before the current item in a linked sequence. To add or change the previous link, select a name from the list. If you are linking frames, the current frame and the target frame must be empty.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/next" id="bm_id3155185" localize="false"/>
-<paragraph role="heading" id="hd_id3159198" xml-lang="en-US" level="3">Next link</paragraph>
+<h3 id="hd_id3159198" xml-lang="en-US">Next link</h3>
 <paragraph role="paragraph" id="par_id3149485" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/next">Displays the item (object, graphic, or frame) that comes after the current item in a linked sequence. To add or change the next link, select a name from the list. If you are a linking frames, the target frame must be empty.</ahelp></paragraph>
-<paragraph role="heading" id="hd_id3143280" xml-lang="en-US" level="2">Protect</paragraph>
+<h2 id="hd_id3143280" xml-lang="en-US">Protect</h2>
 <paragraph role="paragraph" id="par_id3154834" xml-lang="en-US">Specifies protection options for the selected item.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/protectcontent" id="bm_id3149098" localize="false"/>
-<paragraph role="heading" id="hd_id3149820" xml-lang="en-US" level="3">Protect Contents</paragraph>
+<h3 id="hd_id3149820" xml-lang="en-US">Contents</h3>
 <paragraph role="paragraph" id="par_id3149105" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/protectcontent">Prevents changes to the contents of the selected item.</ahelp></paragraph>
 <paragraph role="paragraph" id="par_id3147099" xml-lang="en-US">You can still copy the contents of the selected item.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/protectframe" id="bm_id3147218" localize="false"/>
-<paragraph role="heading" id="hd_id3148979" xml-lang="en-US" level="3">Protect Position</paragraph>
+<h3 id="hd_id3148979" xml-lang="en-US">Position</h3>
 <paragraph role="paragraph" id="par_id3147225" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/protectframe">Locks the position of the selected item in the current document.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/protectsize" id="bm_id3153640" localize="false"/>
-<paragraph role="heading" id="hd_id3153629" xml-lang="en-US" level="3">Protect Size</paragraph>
+<h3 id="hd_id3153629" xml-lang="en-US">Size</h3>
 <paragraph role="paragraph" id="par_id3147576" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/protectsize">Locks the size of the selected item.</ahelp></paragraph>
-<paragraph role="heading" id="hd_id3152770" xml-lang="en-US" level="2">Properties</paragraph>
+<h2 id="hd_id3151028" xml-lang="en-US">Content alignment (frames only)</h2>
+<h3 id="hd_id671652134896150">Vertical alignment</h3>
+<paragraph role="paragraph" id="par_id3149164" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/vertalign">Specifies the vertical alignment of the frame's content. Mainly it means text content, but it also affects tables and other objects anchored to the text area (anchored as character, to character or to paragraph), for example frames, graphics or drawings.</ahelp></paragraph>
+<h2 id="hd_id3152770" xml-lang="en-US">Properties</h2>
 <paragraph role="paragraph" id="par_id3155137" xml-lang="en-US">Specifies print and text options for the selected item.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/editinreadonly" id="bm_id3153357" localize="false"/>
-<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="3">Editable in read-only document (frames only)</paragraph>
+<h3 id="hd_id3153345" xml-lang="en-US">Editable in read-only document (frames only)</h3>
 <paragraph role="paragraph" id="par_id3149167" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/editinreadonly">Allows you to edit the contents of a frame in a document that is read-only (write-protected).</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/printframe" id="bm_id3156281" localize="false"/>
-<paragraph role="heading" id="hd_id3156269" xml-lang="en-US" level="3">Print</paragraph>
+<h3 id="hd_id3156269" xml-lang="en-US">Print</h3>
 <paragraph role="paragraph" id="par_id3151028" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/printframe">Includes the selected item when you print the document.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/textflow" id="bm_id3145787" localize="false"/>
-<paragraph role="heading" id="hd_id3145776" xml-lang="en-US" level="3">Text flow</paragraph>
+<h3 id="hd_id3145776" xml-lang="en-US">Text direction (frames only)</h3>
 <paragraph role="paragraph" id="par_id3151374" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/textflow">Specifies the preferred text flow direction in a frame. To use the default text flow settings for the page, select <emph>Use superordinate object settings </emph>from the list.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmaddpage/vertalign" id="bm_id3262733" localize="false"/>
-<paragraph role="heading" id="hd_id3151028" xml-lang="en-US" level="2">Content vertical alignment</paragraph>
-<paragraph role="paragraph" id="par_id3149164" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmaddpage/vertalign">Specifies the vertical alignment of the frame's content. Mainly it means text content, but it also affects tables and other objects anchored to the text area (anchored as character, to character or to paragraph), for example frames, graphics or drawings.</ahelp></paragraph>
+
 <embed href="text/shared/00/00000004.xhp#related"/>
 <paragraph role="paragraph" id="par_id3150689" xml-lang="en-US"><link href="text/shared/01/05040200.xhp" name="Text direction">Text direction</link>.</paragraph>
 </body>