tdf#148486 clarify "Vertical" and "by" controls in Position and Size

also, adjustment to "Character" in "to", to indicate when it is
available and to correct the description of its referent.

Change-Id: Ic8ff382342503091dc9334aa72d05ea322d3e420
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/134361
Tested-by: Jenkins
Reviewed-by: Rafael Lima <rafael.palma.lima@gmail.com>
Reviewed-by: Ming Hua <plateauwolf@qq.com>
Reviewed-by: Seth Chaiklin <sdc.blanco@youmail.dk>

1 files changed, 40 insertions, 6 deletions

diff --git a/source/text/swriter/01/05060100.xhp b/source/text/swriter/01/05060100.xhp
index 20224d16ce..511a48a4c3 100644
--- a/source/text/swriter/01/05060100.xhp
+++ b/source/text/swriter/01/05060100.xhp
@@ -144,14 +144,48 @@
   <section id="PositionHelp_2">
     <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/vertpos" id="bm_id3145321" localize="false"/>
     <h3 id="hd_id3145310" xml-lang="en-US">Vertical</h3>
-    <paragraph role="paragraph" id="par_id3150161" xml-lang="en-US"><ahelp hid=".">Select the vertical alignment option for the object.</ahelp></paragraph>
-    <note id="par_id3150463" xml-lang="en-US">If you anchor an object to a frame with a fixed height, only the "Bottom" and "Center" alignment options are available.</note>
+    <paragraph role="paragraph" id="par_id3150161" xml-lang="en-US"><ahelp hid=".">Select the vertical alignment option for the object.</ahelp> The selection specifies the position of the object relative to the region or reference line selected in the <menuitem>to</menuitem> dropdown list.</paragraph>
+    <embed href="text/swriter/01/05060100.xhp#preview_tip"/>
     <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/byvert" id="bm_id3156123" localize="false"/>
     <h3 id="hd_id3154724" xml-lang="en-US">by</h3>
-    <paragraph role="paragraph" id="par_id3156130" xml-lang="en-US"><ahelp hid=".">Enter the amount of space to leave between the top edge of the selected object and the reference point that you select in the <emph>To</emph> box.</ahelp> This option is only available if you select "From Top" or "From Bottom" (as character) in the <emph>Vertical</emph> box. </paragraph>
+    <paragraph role="paragraph" id="par_id911652710121127">Enter the amount of space to leave from the top edge of the object to the region or reference line selected in the <menuitem>to</menuitem> dropdown list. This option is active only when the following combinations of <menuitem>Vertical</menuitem> and <menuitem>Anchor</menuitem> are selected. For these combinations, you can specify the amount of space to leave from:</paragraph>
+
+<table id="tab_id681652926402414">
+  <tablerow>
+    <tablecell colspan="2">
+      <paragraph id="par_id101652926402414" role="tablehead">Vertical</paragraph>
+    </tablecell>
+    <tablecell>
+      <paragraph id="par_id511652926402414" role="tablehead">with Anchor</paragraph>
+    </tablecell>
+  </tablerow>
+  <tablerow>
+    <tablecell>
+      <paragraph id="par_id621652926402414" role="tablecontent"><menuitem>From top</menuitem></paragraph>
+    </tablecell>
+    <tablecell>
+      <paragraph id="par_id321652926777383" role="tablecontent">Top edge of selected region.<br/> Positive values move the object down, negative values up.</paragraph>
+    </tablecell>
+    <tablecell>
+       <paragraph id="par_id491652926402414" role="tablecontent"><menuitem>To page</menuitem>, <menuitem>To paragraph</menuitem>, <menuitem>To character</menuitem> or <menuitem>To frame</menuitem></paragraph>
+    </tablecell>
+  </tablerow>
+  <tablerow>
+    <tablecell>
+      <paragraph id="par_id561652926613710" role="tablecontent"><menuitem>From bottom</menuitem></paragraph>
+    </tablecell>
+    <tablecell>
+      <paragraph id="par_id691652964127818" role="tablecontent">Selected reference line.<br/>  Positive values move the object up, negative values down.</paragraph>
+    </tablecell>
+    <tablecell>
+      <paragraph id="par_id41652926572150" role="tablecontent"><menuitem>To character</menuitem> or <menuitem>As character</menuitem></paragraph>
+    </tablecell>
+  </tablerow>
+</table>
+
     <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/vertanchor" id="bm_id3150923" localize="false"/>
     <h3 id="hd_id3150912" xml-lang="en-US">to</h3>
-    <paragraph role="paragraph" id="par_id3155075" xml-lang="en-US"><ahelp hid=".">Select the region or reference point for the  vertical alignment.</ahelp> The object can be positioned in relation to the following regions or reference points:</paragraph>
+    <paragraph role="paragraph" id="par_id3155075" xml-lang="en-US"><ahelp hid=".">Select the region or reference line for the vertical alignment.</ahelp> The object can be positioned in relation to the following regions or reference lines:</paragraph>
     <list type="unordered">
       <listitem>
         <paragraph id="par_id551629212019498" role="listitem"><emph>Margin:</emph> Depending on the anchoring type, the object is positioned considering the space between the top margin and the character ("To character" anchoring) or bottom edge of the paragraph ("To paragraph" anchoring) where the anchor is placed.</paragraph>
@@ -170,7 +204,7 @@
   <section id="PositionHelp_3">
     <list type="unordered">
       <listitem>
-        <paragraph id="par_id951629212020860" role="listitem"><emph>Character:</emph> the object is positioned considering the vertical space used by the character.</paragraph>
+        <paragraph id="par_id951629212020860" role="listitem"><menuitem>Character</menuitem>: available only for "To character" or "As character" anchoring, the object is positioned relative to the region between the top border and bottom border of the character immediately before where the anchor is placed. A character formatted with a common border with other characters or objects uses the region for the highest character or object in the common border.</paragraph>
       </listitem>
       <listitem>
         <paragraph id="par_id631629212021233" role="listitem"><menuitem>Line of text</menuitem>: available only for "To character" anchoring, the object is positioned considering the height of the line of text where the anchor is placed.</paragraph>
@@ -189,8 +223,8 @@
       </listitem>
     </list>
     <embed href="text/swriter/01/05060100.xhp#anchor_tip"/>
-    <embed href="text/swriter/01/05060100.xhp#preview_tip"/>
     <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/followtextflow" id="bm_id611285" localize="false"/>
+<note id="par_id3150463" xml-lang="en-US">If you anchor an object to a frame with a fixed height, only the "Bottom" and "Center" alignment options are available.</note>
   </section>
 
   <section id="keep_inside_text_bnd">