tdf#145135 - Writer object positioning help page fixes

1) Describe relationships between anchor, reference point and
object.

2) Expand the description of "to character" to highlight that the
reference point is the start of the paragraph containing the
character, not the character to which the anchor is attached.
Give examples.

The Guidebook is correct but this help page wasn't.

3) Attempt to explain the difference in the effect of moving the
anchor compared to moving the object itself. Remind users that
an objects wrap and alignment settings constrain this movement
and final positioning.

Change-Id: Ia4bfc0e7273d3d09a65cab0cec7d78bd45b7a2bf
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/123653
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>

1 files changed, 10 insertions, 6 deletions

diff --git a/source/text/swriter/guide/anchor_object.xhp b/source/text/swriter/guide/anchor_object.xhp
index 0d5284dfb8..e72096cd0b 100644
--- a/source/text/swriter/guide/anchor_object.xhp
+++ b/source/text/swriter/guide/anchor_object.xhp
@@ -38,7 +38,10 @@
 
 
 <paragraph id="hd_id3147828" role="heading" level="1" xml-lang="en-US"><variable id="anchor_object"><link href="text/swriter/guide/anchor_object.xhp" name="Positioning Objects">Positioning Objects</link></variable></paragraph>
-<paragraph id="par_id3147251" role="paragraph" xml-lang="en-US">You can use anchors to position an object, graphic, or frame in a document. An anchored item remains in place, or moves when you modify the document. The following anchoring options are available:</paragraph>
+<paragraph id="par_id181634295881266" role="paragraph" xml-lang="en-US">An object, such as an image, is positioned within a document using anchors attached to other elements.</paragraph>
+<paragraph id="par_id41634291500513" role="paragraph" xml-lang="en-US">An anchor determines the reference point for an object. The reference point could be the page or frame where the object is, a paragraph, or even a character. An image always has an anchor and therefore a reference point.</paragraph>
+<paragraph id="par_id3147251" role="paragraph" xml-lang="en-US">An anchor moves with the element it is attached to as the document is edited. An object retains it's position relative to the reference point determined by it's anchor, such that, whenever the reference point moves or changes, the object moves relative to it.</paragraph>
+<paragraph id="par_id441634291545244" role="paragraph" xml-lang="en-US">The following anchoring options are available:</paragraph>
 
 <table id="tbl_id3147268">
   <tablerow>
@@ -54,7 +57,7 @@
       <paragraph id="par_id3145650" role="tablecontent" xml-lang="en-US">As character</paragraph>
     </tablecell>
     <tablecell>
-      <paragraph id="par_id3151181" role="tablecontent" xml-lang="en-US">Anchors the selected item as a character in the current text. If the height of the selected item is greater than the current font size, the height of the line containing the item is increased.</paragraph>
+      <paragraph id="par_id3151181" role="tablecontent" xml-lang="en-US">Anchors the selected object as a character in the current text. If the height of the selected object is greater than the current font size, the height of the line containing the object is increased.</paragraph>
       <paragraph id="par_idN10674" role="tablecontent" xml-lang="en-US">To center an image on an HTML page, insert the image, anchor it "as character", then center the paragraph.</paragraph>
     </tablecell>
   </tablerow>
@@ -63,7 +66,8 @@
       <paragraph id="par_id3151212" role="tablecontent" xml-lang="en-US">To character</paragraph>
     </tablecell>
     <tablecell>
-      <paragraph id="par_id3151235" role="tablecontent" xml-lang="en-US">Anchors the selected item to a character.</paragraph>
+      <paragraph id="par_id3151235" role="tablecontent" xml-lang="en-US">Anchors the selected object to the paragraph that contains the character to which the anchor is attached. The reference point for the object is the start of the paragraph that contains the character.</paragraph>
+      <paragraph id="par_id261634292505179" role="tablecontent" xml-lang="en-US">For example, if you split the paragraph at a point before the anchor, the reference point moves to the start of the new paragraph and the object moves relative to that point. If you join the paragraph to the one before it, the reference point moves to the start of the combined paragraph and the object moves to a position relative to that.</paragraph>
     </tablecell>
   </tablerow>
   <tablerow>
@@ -71,7 +75,7 @@
       <paragraph id="par_id3155071" role="tablecontent" xml-lang="en-US">To paragraph</paragraph>
     </tablecell>
     <tablecell>
-      <paragraph id="par_id3155094" role="tablecontent" xml-lang="en-US">Anchors the selected item to the current paragraph.</paragraph>
+      <paragraph id="par_id3155094" role="tablecontent" xml-lang="en-US">Anchors the selected object to the current paragraph.</paragraph>
     </tablecell>
   </tablerow>
   <tablerow>
@@ -79,7 +83,7 @@
       <paragraph id="par_id3155122" role="tablecontent" xml-lang="en-US">To page</paragraph>
     </tablecell>
     <tablecell>
-      <paragraph id="par_id3155144" role="tablecontent" xml-lang="en-US">Anchors the selected item to the current page.</paragraph>
+      <paragraph id="par_id3155144" role="tablecontent" xml-lang="en-US">Anchors the selected object to the current page.</paragraph>
     </tablecell>
   </tablerow>
   <tablerow>
@@ -92,7 +96,7 @@
   </tablerow>
 </table>
 
-<paragraph id="par_id3145715" role="paragraph" xml-lang="en-US">When you insert an object, graphic, or frame, an anchor icon appears where the item is anchored. You can position an anchored item by dragging the item to another location. To change the anchoring options of an item, right-click the item, and then choose an option from the <item type="menuitem">Anchor</item> submenu.</paragraph>
+<paragraph id="par_id3145715" role="paragraph" xml-lang="en-US">When you insert an object, graphic, or frame, an anchor icon appears where the object is anchored. You can move an anchor or, keeping other object constraints in mind, position an object relative to the anchor's reference point by dragging the object. To change the anchoring options of an item, right-click the item, and then choose an option from the <item type="menuitem">Anchor</item> submenu.</paragraph>
 
 <section id="relatedtopics">
 <embed href="text/swriter/guide/text_frame.xhp#text_frame"/>