AllLangHelp_shared.mk                      |    1 
 source/text/shared/01/05270000.xhp         |    8 ++
 source/text/shared/02/eliminate_points.xhp |   52 ++++++++++++++++
 source/text/shared/main0227.xhp            |   94 ++++++++++++++++++++++++-----
 source/text/simpress/02/10080000.xhp       |    6 -
 5 files changed, 143 insertions(+), 18 deletions(-)

New commits:
commit 35c331d42654a28c9852187474b102db1c987e53
Author:     Dione Maddern <dionemadd...@gmail.com>
AuthorDate: Thu May 23 16:57:19 2024 +0200
Commit:     Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Thu May 23 22:54:02 2024 +0200

    tdf#105988  tdf#130024 Update Edit Points Bar help page
    
    Created new file text/shared/02/eliminate_points.xhp so that more detailed 
information on "Eliminate Points" mode is on its own page.
    - Updated the description of the "Eliminate Points" feature to more 
accurately describe how the feature works.
    
    In AllLangHelp_shared.mk
    - Added new page text/shared/02/eliminate_points.xhp
    
    In source/text/shared/01/05270000.xhp
    - Added section and variable tags to allow content to be easily embedded in 
other pages.
    
    In source/text/shared/main0227.xhp
    - Added section and variable tags to allow content to be easily embedded in 
other pages.
    - Moved the link to "Converting 2D Objects to Curves, Polygons, and 3D 
Objects" to a new Related Topics section
    - Replaced "Edit Points" section with an embedded link to the description 
in text/shared/01/05270000 (Edit Points mode) to avoid repetition
    - Replaced "Edit Points" section with an embedded link to the description 
in text/shared/02/eliminate_points.xhp to avoid repetition.
    - Created a Related Topics section
    
    In text/simpress/02/10080000.xhp
    - Added variable tags to allow the page to be easily linked from other pages
    - Changed the Title and Heading 1 from "Curve" to "Curves and Polygons" to 
reflect current menu options.
    
    Change-Id: Ib9038f35b97b4177e11171bfdedd10c0a4149dd2
    Reviewed-on: https://gerrit.libreoffice.org/c/help/+/167939
    Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
    Tested-by: Jenkins

diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index f8b46c1e10..71002db590 100644
--- a/AllLangHelp_shared.mk
+++ b/AllLangHelp_shared.mk
@@ -581,6 +581,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\
     helpcontent2/source/text/shared/02/blockarrows \
     helpcontent2/source/text/shared/02/callouts \
     helpcontent2/source/text/shared/02/colortoolbar \
+    helpcontent2/source/text/shared/02/eliminate_points \
     helpcontent2/source/text/shared/02/flowcharts \
     helpcontent2/source/text/shared/02/fontwork \
     helpcontent2/source/text/shared/02/gridtofront \
diff --git a/source/text/shared/01/05270000.xhp 
b/source/text/shared/01/05270000.xhp
index c158001e0f..35a24d4cad 100644
--- a/source/text/shared/01/05270000.xhp
+++ b/source/text/shared/01/05270000.xhp
@@ -27,9 +27,15 @@
 </history>
 </meta>
 <body>
+<bookmark branch="index" id="bm_id911716062352822">
+<bookmark_value>polygons; edit points mode</bookmark_value>
+<bookmark_value>bezier; edit points mode</bookmark_value>
+<bookmark_value>curves; edit points mode</bookmark_value>
+<bookmark_value>edit points mode; toggle</bookmark_value>
+</bookmark>
 <bookmark branch="hid/.uno:ToggleObjectBezierMode" id="bm_id3155620" 
localize="false"/>
 <section id="edit_points">
-<h1 id="hd_id3155271"><link href="text/shared/01/05270000.xhp">Edit 
Points</link></h1>
+<h1 id="hd_id3155271"><variable id="edit_points_h1"><link 
href="text/shared/01/05270000.xhp">Edit Points</link></variable></h1>
 <paragraph role="paragraph" id="par_id3153391"><ahelp 
hid=".uno:ToggleObjectBezierMode">Lets you change the shape of the selected 
drawing object.</ahelp></paragraph>
 </section>
 <section id="howtoget">
diff --git a/source/text/shared/02/eliminate_points.xhp 
b/source/text/shared/02/eliminate_points.xhp
new file mode 100644
index 0000000000..264526c294
--- /dev/null
+++ b/source/text/shared/02/eliminate_points.xhp
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<helpdocument version="1.0">
+<!--
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+-->
+
+<meta>
+  <topic id="textshared02eliminate_pointsxhp" indexer="include" 
status="PUBLISH">
+    <title id="tit" >Eliminate Points</title>
+    <filename>/text/shared/02/eliminate_points.xhp</filename>
+  </topic>
+</meta>
+<body>
+
+<bookmark branch="index" id="bm_id911716062352822">
+<bookmark_value>bezier; eliminate points</bookmark_value>
+<bookmark_value>polygon; eliminate points</bookmark_value>
+<bookmark_value>curves; eliminate points</bookmark_value>
+</bookmark>
+
+<bookmark xml-lang="en-US" branch="hid/.uno:BezierEliminatePoints" 
id="bm_id3240924" localize="false"/>
+  
+<section id="eliminate_points_head">
+<h1 id="hd_id3156351"><variable id="eliminate_points_h1"><link 
href="text/shared/02/eliminate_points.xhp">Eliminate 
Points</link></variable></h1>
+<paragraph role="paragraph" id="par_id3149441" xml-lang="en-US">
+Enables <menuitem>Eliminate Points</menuitem> mode. If this mode is enabled, 
you can remove a point by dragging and dropping it onto a space directly 
between two points that adjoin the point you are eliminating.</paragraph>
+</section>
+
+<section id="howtoget">
+<embed href="text/shared/00/00000004.xhp#from_tabUI"/>
+<paragraph role="paragraph" id="par_id71716404636053">Choose <menuitem>Draw - 
Eliminate points</menuitem>.</paragraph>
+<embed href="text/shared/00/00000004.xhp#from_toolbars"/>
+<embed href="text/shared/main0227.xhp#eliminate_points_icon"/>
+</section>
+
+<paragraph role="paragraph" id="par_id7165910943528020">To remove a point, 
left-click on the shape you want to edit, the left-click on the point you want 
to remove, and drag it to a place directly between the two adjoining points 
until it snaps into place.</paragraph>
+
+<paragraph role="paragraph" id="par_id311716400141144">You can adjust how 
close the point needs to be before it snaps into place by adjusting the <link 
href="text/shared/optionen/01070300.xhp#bm_id3153839"><menuitem>Point 
reduction</menuitem></link> angle in the <menuitem>Grid</menuitem> settings 
dialog. The lower the angle, the closer the point needs to be before it snaps 
into place.</paragraph>
+
+<section id="relatedtopics">
+<embed href="text/simpress/02/10080000.xhp#curves_and_polygons_h1"/>
+<embed href="text/shared/01/05270000.xhp#edit_points_h1"/>
+<embed href="text/shared/main0227.xhp#edit_points_bar_h1"/>
+</section>
+  
+</body>
+</helpdocument>
\ No newline at end of file
diff --git a/source/text/shared/main0227.xhp b/source/text/shared/main0227.xhp
index 63cdadfeee..e410bb18bb 100644
--- a/source/text/shared/main0227.xhp
+++ b/source/text/shared/main0227.xhp
@@ -31,19 +31,13 @@
 <bookmark_value>Edit Points bar</bookmark_value>
 </bookmark>
 <bookmark branch="hid/.uno:AvailableToolbars?Toolbar:string=bezierobjectbar" 
id="bm_id791690935896728" localize="false"/>
-<h1 id="hd_id3149987"><link href="text/shared/main0227.xhp">Edit Points 
Bar</link></h1>
+<h1 id="hd_id3149987"><variable id="edit_points_bar_h1"><link 
href="text/shared/main0227.xhp">Edit Points Bar</link></variable></h1>
 <paragraph role="paragraph" id="par_id3150402" xml-lang="en-US">The <emph>Edit 
Points </emph>Bar appears when you select a polygon object and click <emph>Edit 
Points</emph>.</paragraph>
-</section>
-<switch select="appl">
-<case select="IMPRESS"><embed 
href="text/simpress/guide/3d_create.xhp#3d_create"/>
-</case>
-<case select="DRAW"><embed href="text/simpress/guide/3d_create.xhp#3d_create"/>
-</case>
-</switch>
 <paragraph role="paragraph" id="par_id3144762" xml-lang="en-US">The functions 
provided allow you to edit the points of a curve or an object converted to a 
curve. The following icons are available:</paragraph>
-<h2 id="hd_id3153105">Edit Points</h2>
-<paragraph role="paragraph" id="par_id3159151" xml-lang="en-US">The <link 
href="text/shared/01/05270000.xhp"><emph>Edit Points</emph></link> icon allows 
you to activate or deactivate the edit mode for Bézier objects. In the edit 
mode, individual points of the drawing object can be selected.</paragraph>
-<table id="tbl_id3149664">
+</section>
+
+<embed href="text/shared/01/05270000.xhp#edit_points"/>
+<section id="edit_points_icon"><table id="tbl_id3149664">
 <tablerow>
 <tablecell>
 <paragraph role="paragraph" id="par_id3145366" xml-lang="en-US">
@@ -54,10 +48,17 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierMove" id="bm_id4528551" 
localize="false"/>
+
+<section id="move_points">
 <h2 id="hd_id3146976">Move Points</h2>
 <paragraph role="paragraph" id="par_id3147435" xml-lang="en-US"><ahelp 
hid=".uno:BezierMove">Activates a mode in which you can move points.</ahelp> 
The mouse pointer displays a small empty square when resting on a point. Drag 
that point to another location. The curve on both sides of the point follows 
the movement; the section of the curve between the next points changes 
shape.</paragraph>
 <paragraph role="paragraph" id="par_id3149481" xml-lang="en-US">Point at the 
curve between two points or within a closed curve and drag the mouse to shift 
the entire curve without distorting the form.</paragraph>
+</section>
+
+<section id="move_points_icon">
 <table id="tbl_id3152940">
 <tablerow>
 <tablecell>
@@ -69,10 +70,17 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierInsert" id="bm_id3061552" 
localize="false"/>
+
+<section id="insert_points">
 <h2 id="hd_id3150115">Insert Points</h2>
 <paragraph role="paragraph" id="par_id3160478" xml-lang="en-US"><ahelp 
hid=".uno:BezierInsert">Activates the insert mode. This mode allows you to 
insert points.</ahelp> You can also move points, just as in the move mode. If, 
however, you click at the curve between two points and move the mouse a little 
while holding down the mouse button you insert a new point. The point is a 
smooth point, and the lines to the control points are parallel and remain so 
when moved.</paragraph>
 <paragraph role="paragraph" id="par_id3157846" xml-lang="en-US">If you wish to 
create a corner point you must first insert either a smooth or a symmetrical 
point which is then converted to a corner point by using <emph>Corner 
Point</emph>.</paragraph>
+</section>
+
+<section id="insert_points_icon">
 <table id="tbl_id3156180">
 <tablerow>
 <tablecell>
@@ -84,10 +92,17 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierDelete" id="bm_id7852235" 
localize="false"/>
+
+<section id="delete_points">
 <h2 id="hd_id3149020">Delete Points</h2>
 <paragraph role="paragraph" id="par_id3148917" xml-lang="en-US"><ahelp 
hid=".uno:BezierDelete">Use the <emph>Delete Points</emph> icon to delete one 
or several selected points. If you wish to select several points click the 
appropriate points while holding down the Shift key.</ahelp></paragraph>
 <paragraph role="paragraph" id="par_id3153766" xml-lang="en-US">First select 
the points to be deleted, and then click this icon, or press Del.</paragraph>
+</section>
+
+<section id="delete_points_icon">
 <table id="tbl_id3159266">
 <tablerow>
 <tablecell>
@@ -99,9 +114,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierCutLine" id="bm_id1077279" 
localize="false"/>
+
+<section id="split_curve">
 <h2 id="hd_id3147361">Split Curve</h2>
 <paragraph role="paragraph" id="par_id3151248" xml-lang="en-US"><ahelp 
hid=".uno:BezierCutLine">The<emph> Split Curve </emph>icon splits a curve. 
Select the point or points where you want to split the curve, then click the 
icon</ahelp>.</paragraph>
+</section>
+
+<section id="split_curve_icon">
 <table id="tbl_id3145766">
 <tablerow>
 <tablecell>
@@ -113,10 +135,17 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierConvert" id="bm_id2868052" 
localize="false"/>
+
+<section id="convert_to_curve">
 <h2 id="hd_id3150345">Convert To Curve</h2>
 <paragraph role="paragraph" id="par_id3148420" xml-lang="en-US"><ahelp 
hid=".uno:BezierConvert">Converts a curve into a straight line or converts a 
straight line into a curve.</ahelp> If you select a single point, the curve 
before the point will be converted. If two points are selected, the curve 
between both points will be converted. If you select more than two points, each 
time you click this icon, a different portion of the curve will be converted. 
If necessary, round points are converted into corner points and corner points 
are converted into round points.</paragraph>
 <paragraph role="paragraph" id="par_id3150304" xml-lang="en-US">If a certain 
section of the curve is straight, the end points of the line have a maximum of 
one control point each. They cannot be modified to round points unless the 
straight line is converted back to a curve.</paragraph>
+</section>
+
+<section id="convert_to_curve_icon">
 <table id="tbl_id3147132">
 <tablerow>
 <tablecell>
@@ -128,9 +157,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierEdge" id="bm_id1940216" 
localize="false"/>
+
+<section id="corner_point">
 <h2 id="hd_id3153199">Corner Point</h2>
 <paragraph role="paragraph" id="par_id3148460" xml-lang="en-US"><ahelp 
hid=".uno:BezierEdge">Converts the selected point or points into corner 
points.</ahelp> Corner points have two movable control points, which are 
independent from each other. A curved line, therefore, does not go straight 
through a corner point, but forms a corner.</paragraph>
+</section>
+
+<section id="convert_to_curve_icon">
 <table id="tbl_id3150982">
 <tablerow>
 <tablecell>
@@ -142,9 +178,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierSmooth" id="bm_id4189903" 
localize="false"/>
+
+<section id="smooth_transition">
 <h2 id="hd_id3166436">Smooth Transition</h2>
 <paragraph role="paragraph" id="par_id3155510" xml-lang="en-US"><ahelp 
hid=".uno:BezierSmooth">Converts a corner point or symmetrical point into a 
smooth point.</ahelp> Both control points of the corner point are aligned in 
parallel, and can only be moved simultaneously. The control points may 
differentiate in length, allowing you to vary the degree of 
curvature.</paragraph>
+</section>
+
+<section id="smooth_transition_icon">
 <table id="tbl_id3154371">
 <tablerow>
 <tablecell>
@@ -156,9 +199,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierSymmetric" id="bm_id184203" 
localize="false"/>
+
+<section id="symmetric_transiton">
 <h2 id="hd_id3159622">Symmetric Transition</h2>
 <paragraph role="paragraph" id="par_id3155812" xml-lang="en-US"><ahelp 
hid=".uno:BezierSymmetric">This icon converts a corner point or a smooth point 
into a symmetrical point.</ahelp> Both control points of the corner point are 
aligned in parallel and have the same length. They can only be moved 
simultaneously and the degree of curvature is the same in both 
directions.</paragraph>
+</section>
+
+<section id="symmetric_transiton_icon">
 <table id="tbl_id3148599">
 <tablerow>
 <tablecell>
@@ -170,9 +220,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierClose" id="bm_id4041301" 
localize="false"/>
+
+<section id="close_bezier">
 <h2 id="hd_id3146786">Close Bézier</h2>
 <paragraph role="paragraph" id="par_id3156032" xml-lang="en-US"><ahelp 
hid=".uno:BezierClose">Closes a line or a curve.</ahelp> A line is closed by 
connecting the last point with the first point, indicated by an enlarged 
square.</paragraph>
+</section>
+
+<section id="close_bezier_icon">
 <table id="tbl_id3144508">
 <tablerow>
 <tablecell>
@@ -184,9 +241,11 @@
 </tablecell>
 </tablerow>
 </table>
-<bookmark xml-lang="en-US" branch="hid/.uno:BezierEliminatePoints" 
id="bm_id3240924" localize="false"/>
-<h2 id="hd_id3156351">Eliminate Points</h2>
-<paragraph role="paragraph" id="par_id3149441" xml-lang="en-US"><ahelp 
hid=".uno:BezierEliminatePoints">Marks the current point or the selected points 
for deletion.</ahelp> This happens in the event that the point is located on a 
straight line. If you convert a curve or a polygon with the <emph>Convert to 
Curve </emph>icon into a straight line or you change a curve with the mouse so 
that a point lies on the straight line, it is removed. The angle from which the 
point reduction is to take place <switchinline select="appl"><caseinline 
select="DRAW">can be set by choosing <link 
href="text/shared/optionen/01070300.xhp"><emph>%PRODUCTNAME Draw - 
Grid</emph></link> in the Options dialog box</caseinline><caseinline 
select="IMPRESS">can be set by choosing <link 
href="text/shared/optionen/01070300.xhp"><emph>%PRODUCTNAME Impress - 
Grid</emph></link> in the Options dialog box</caseinline><defaultinline>is 15° 
by default.</defaultinline></switchinline></paragraph>
+</section>
+
+<embed href="text/shared/02/eliminate_points.xhp#eliminate_points_head"/>
+
+<section id="eliminate_points_icon">
 <table id="tbl_id3150892">
 <tablerow>
 <tablecell>
@@ -198,5 +257,12 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
+<section id="relatedtopics">
+<embed href="text/simpress/guide/3d_create.xhp#3d_create"/>
+<embed href="text/simpress/02/10080000.xhp#curves_and_polygons_h1"/>
+<embed href="text/sdraw/main0200.xhp#main0200"/>
+</section>
 </body>
 </helpdocument>
diff --git a/source/text/simpress/02/10080000.xhp 
b/source/text/simpress/02/10080000.xhp
index a83fc39e9f..16d1b45b0c 100644
--- a/source/text/simpress/02/10080000.xhp
+++ b/source/text/simpress/02/10080000.xhp
@@ -22,7 +22,7 @@
 <helpdocument version="1.0">
 <meta>
 <topic id="textsimpress0210080000xml" indexer="include" status="PUBLISH">
-<title id="tit" xml-lang="en-US">Curve</title>
+<title id="tit" xml-lang="en-US">Curves and Polygons</title>
 <filename>/text/simpress/02/10080000.xhp</filename>
 </topic>
 <history>
@@ -40,8 +40,8 @@
 <paragraph role="paragraph" id="par_id3149050" xml-lang="en-US" 
localize="false"/>
 <section id="curve">
 <bookmark xml-lang="en-US" branch="hid/.uno:LineToolbox" id="bm_id3145114" 
localize="false"/>
-<h1 id="hd_id3149875"><link 
href="text/simpress/02/10080000.xhp">Curve</link></h1>
-<paragraph role="paragraph" id="par_id3147301" xml-lang="en-US"><ahelp 
hid=".uno:LineToolbox">The Curve icon on the Drawing bar opens the 
<emph>Lines</emph> toolbar, where you can add lines and shapes to the current 
slide.</ahelp></paragraph>
+<h1 id="hd_id3149875"><variable id="curves_and_polygons_h1"><link 
href="text/simpress/02/10080000.xhp">Curves and Polygons</link></variable></h1>
+<paragraph role="paragraph" id="par_id3147301" xml-lang="en-US"><ahelp 
hid=".uno:LineToolbox">The <menuitem>Curves and Polygons</menuitem> icon on the 
Drawing bar opens the <emph>Lines</emph> toolbar, where you can add lines and 
shapes to the current slide.</ahelp></paragraph>
 </section>
 <paragraph role="paragraph" id="par_id3157873" xml-lang="en-US">If you hold 
the Shift key down, the movement of the mouse is limited to multiples of 45 
degrees. If you hold down the <switchinline select="sys"><caseinline 
select="MAC">Options</caseinline><defaultinline>Alt</defaultinline></switchinline>
 key, the new point will not be connected to the last point. This allows you to 
create objects that consist of curves that are not connected together. If you 
draw a smaller object while holding down the <switchinline 
select="sys"><caseinline 
select="MAC">Option</caseinline><defaultinline>Alt</defaultinline></switchinline>
 key into a larger object that you have not closed yet, the smaller object is 
subtracted from the larger one, thus appearing as a hole in the larger 
one.</paragraph>
 <paragraph role="paragraph" id="par_id3153083" xml-lang="en-US">Closed shapes 
automatically receive the fill that is displayed in the <emph>Area 
Style/Filling</emph> box on <emph>Line and Filling</emph> bar. </paragraph>

Reply via email to