tdf#152022 Improve Edit page for Help Online

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

4 files changed, 34 insertions, 10 deletions

diff --git a/source/text/shared/01/02180000.xhp b/source/text/shared/01/02180000.xhp
index 31e3b4d656..3ac9547d3f 100644
--- a/source/text/shared/01/02180000.xhp
+++ b/source/text/shared/01/02180000.xhp
@@ -36,8 +36,9 @@
 </bookmark>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/BaseLinksDialog" id="bm_id4889980" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/@@nowidget@@" id="bm_id4889980" localize="false"/>
+
 <h1 id="hd_id3150279" xml-lang="en-US">Edit Links to External Files</h1>
-  <paragraph id="par_id3150774" role="paragraph" xml-lang="en-US"><variable id="links_text"><ahelp hid=".">You can change or remove each link to external files in the current document. You can also update the content of the current file to the most recently saved version of linked external file. This command does not apply to hyperlinks, and is not available if the current document does not contain links to other files.</ahelp></variable></paragraph>
+  <paragraph id="par_id3150774" role="paragraph" xml-lang="en-US"><variable id="links_text"><ahelp hid=".">You can change or break each link to external files in the current document. You can also update the content of the current file to the most recently saved version of linked external file. This command does not apply to hyperlinks, and is not available if the current document does not contain links to other files.</ahelp></variable></paragraph>
 <paragraph role="paragraph" id="par_id271603459179173">This command can be used with external file links to <switchinline select="appl"><caseinline  select="WRITER">sections (place cursor outside of the section), master documents,</caseinline><caseinline select="CALC">sheets linked with <menuitem>Sheet - Insert Sheet from File</menuitem> or <menuitem>Sheet - External Links</menuitem>, Function WEBSERVICE,</caseinline></switchinline> images and OLE objects (when inserted with a link to an external file).</paragraph>
 
 <section id="howtoget">
@@ -49,26 +50,34 @@
 <h2 id="hd_id3155503" xml-lang="en-US">Source file</h2>
   <paragraph id="par_id3156152" role="paragraph" xml-lang="en-US">Lists the path to the source file. If the path defines a DDE link, relative paths must be preceded with "file:". </paragraph>
 <paragraph id="par_idN10646" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/baselinksdialog/TB_LINKS">Double-click a link in the list to open a file dialog where you can select another object for this link.</ahelp></paragraph>
+
 <h2 id="hd_id3155449" xml-lang="en-US">Element</h2>
   <paragraph id="par_id3153348" role="paragraph" xml-lang="en-US">Lists the application (if known) that last saved the source file.</paragraph>
+
 <h2 id="hd_id3153061" xml-lang="en-US">Type</h2>
   <paragraph id="par_id3151384" role="paragraph" xml-lang="en-US">Lists the file type, such as graphic, of the source file.</paragraph>
+
 <h2 id="hd_id3156343" xml-lang="en-US">Status</h2>
   <paragraph id="par_id3149046" role="paragraph" xml-lang="en-US">Lists additional information about the source file.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/AUTOMATIC" id="bm_id0720200903092114" localize="false"/>
+
 <h2 id="hd_id3147264" xml-lang="en-US">Automatic</h2>
   <paragraph id="par_id3147304" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/baselinksdialog/AUTOMATIC">Automatically updates the contents of the link when you open the file. Any changes made in the source file are then displayed in the file containing the link. Linked graphic files can only be updated manually.</ahelp> This option is not available for a linked graphic file.</paragraph>
   <paragraph id="par_id3149456" role="paragraph" xml-lang="en-US">The <emph>Automatic</emph> option is only available for DDE links. You can insert a DDE link by copying the contents from one file and pasting by choosing <emph>Edit - Paste Special</emph>, and then selecting the <emph>Link</emph> box. As DDE is a text based linking system, only the displayed decimals are copied into the target sheet.<comment>removed Calc switch: this feature can be used wherever a cell area can be pasted: everywhere</comment></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/MANUAL" id="bm_id0720200903100119" localize="false"/>
+
 <h2 id="hd_id3154938" xml-lang="en-US">Manual</h2>
   <paragraph id="par_id3151210" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/baselinksdialog/MANUAL">Only updates the link when you click the <emph>Update</emph> button.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/CHANGE_SOURCE" id="bm_id0720200903111714" localize="false"/>
+
 <h2 id="hd_id3151381" xml-lang="en-US">Modify</h2>
   <paragraph id="par_id3154125" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/baselinksdialog/CHANGE_SOURCE">Change the source file for the selected link.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/BREAK_LINK" id="bm_id0720200903114311" localize="false"/>
+
 <h2 id="hd_id3147084" xml-lang="en-US">Break Link</h2>
   <paragraph id="par_id3147230" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/baselinksdialog/BREAK_LINK">Breaks the link between the source file and the current document. The most recently updated contents of the source file are kept in the current document.</ahelp></paragraph>
   <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/UPDATE_NOW" id="bm_id0720200903105198" localize="false"/>
+
 <h2 id="hd_id3156280" xml-lang="en-US">Update</h2>
 <paragraph id="par_id3157320" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/baselinksdialog/UPDATE_NOW">Updates the selected link so that the most recently saved version of the linked file is displayed in the current document.</ahelp></paragraph>
 <embed href="text/shared/00/00000001.xhp#close"/>
diff --git a/source/text/shared/02/09070000.xhp b/source/text/shared/02/09070000.xhp
index 71c4605c92..05c01e7ef5 100644
--- a/source/text/shared/02/09070000.xhp
+++ b/source/text/shared/02/09070000.xhp
@@ -25,17 +25,21 @@
   </topic>
 </meta>
 <body>
+
 <section id="hyperlink">
 <bookmark xml-lang="en-US" branch="hid/.uno:HyperlinkDialog" id="bm_id4087126" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/.uno:EditHyperlink" id="bm_id6121214" localize="false"/>
+
 <h1 xml-lang="en-US" id="hd_id3145759"><variable id="hyperdia"><link href="text/shared/02/09070000.xhp" name="Hyperlink Dialog">Hyperlink</link></variable></h1>
-<paragraph xml-lang="en-US" id="par_id3156183" role="paragraph"><variable id="hyperdiatext"><ahelp hid=".">Opens a dialog that enables you to create and edit hyperlinks.</ahelp></variable></paragraph>
+<paragraph xml-lang="en-US" id="par_id3156183" role="paragraph"><variable id="hyperdiatext"><ahelp hid=".">Opens a dialog that enables you to edit hyperlinks.</ahelp></variable></paragraph>
 </section>
+
 <section id="howtoget">
 <paragraph role="paragraph" id="par_id511616406933483">Choose <menuitem>Insert - Hyperlink</menuitem>.</paragraph>
 <paragraph role="paragraph" id="par_id771616410590648">Choose <menuitem>Edit - Hyperlink</menuitem>, when the cursor is placed in a hyperlink.</paragraph>
 <paragraph role="paragraph" id="par_id161616407054506">On <link href="text/shared/main0201.xhp" name="Standard Bar"><emph>Standard</emph></link> bar, click</paragraph>
 </section>
+
 <section id="syhyperdia">
 <table id="tbl_id3158405">
   <tablerow>
@@ -48,6 +52,7 @@
   </tablerow>
 </table>
 </section>
+
 <bookmark xml-lang="en-US" branch="hid/cui/ui/hyperlinkdialog/icon_control" id="bm_id3149177" localize="false"/>
 <paragraph xml-lang="en-US" id="par_id3155391" role="paragraph"><ahelp hid=".">Select the type of hyperlink to be inserted.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/.uno:OpenHyperlinkOnCursor" id="bm_id7868083" localize="false"/>
@@ -63,19 +68,25 @@
   <embed href="text/shared/02/09070300.xhp#document"/>
   <embed href="text/shared/02/09070400.xhp#new_document"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/hyperlinkdialog/apply" id="bm_id3149811" localize="false"/>
+
 <h3 xml-lang="en-US" id="hd_id3166410">Apply</h3>
 <paragraph xml-lang="en-US" id="par_id3147209" role="paragraph"><ahelp hid=".">Applies the data to your document.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/hyperlinkdialog/cancel" id="bm_id3159166" localize="false"/>
+
 <h3 xml-lang="en-US" id="hd_id3149398">Close</h3>
 <paragraph xml-lang="en-US" id="par_id3149734" role="paragraph"><ahelp hid=".">Closes the dialog without saving.</ahelp></paragraph>
+
 <h3 xml-lang="en-US" id="hd_id3153700">Help</h3>
 <paragraph xml-lang="en-US" id="par_id3150943" role="paragraph">Opens the Help.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/hyperlinkdialog/reset" id="bm_id3155434" localize="false"/>
+
 <h3 xml-lang="en-US" id="hd_id3156192">Reset</h3>
 <paragraph xml-lang="en-US" id="par_id3149234" role="paragraph"><ahelp hid=".">Resets the entries in the dialog to their original state.</ahelp></paragraph>
+
 <section id="relatedtopics">
   <embed href="text/shared/guide/hyperlink_insert.xhp#hyperlink_insert"/>
   <embed href="text/shared/guide/hyperlink_rel_abs.xhp#hyperlink_rel_abs"/>
 </section>
+
 </body>
 </helpdocument>
diff --git a/source/text/swriter/01/selection_mode.xhp b/source/text/swriter/01/selection_mode.xhp
index d1179b3246..62df0ec22d 100644
--- a/source/text/swriter/01/selection_mode.xhp
+++ b/source/text/swriter/01/selection_mode.xhp
@@ -16,6 +16,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="textswriter01selection_modexml" indexer="include" status="PUBLISH">
@@ -28,14 +29,17 @@
 <section id="selection_mode">
 <!-- removed HID sel_mode_id -->
 <h1 id="hd_id4177678"><link href="text/swriter/01/selection_mode.xhp">Selection Mode</link></h1>
-<paragraph role="paragraph" id="par_id2962126" xml-lang="en-US"><ahelp hid=".">Choose the selection mode from the submenu: normal selection mode, or block selection mode.</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id2962126" xml-lang="en-US"><ahelp hid=".">Choose the selection mode from the submenu: standard selection mode, or block selection mode.</ahelp></paragraph>
 </section>
+
 <section id="howtoget">
   <embed href="text/swriter/00/00000402.xhp#selection_mode"/>
 </section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:SelectionModeDefault" id="bm_id511655562660380" localize="false"/>
-<paragraph role="paragraph" id="par_id9816278" xml-lang="en-US"><ahelp hid=".">In normal selection mode, you can select multi-line text including the line ends.</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id9816278" xml-lang="en-US"><ahelp hid=".">In standard selection mode, you can select multi-line text including the line ends.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/.uno:SelectionModeBlock" id="bm_id411655562802665" localize="false"/>
 <paragraph role="paragraph" id="par_id3097323" xml-lang="en-US"><ahelp hid=".">In block selection mode, you can select a rectangular block of text.</ahelp></paragraph>
+
 </body>
 </helpdocument>
diff --git a/source/text/swriter/main0102.xhp b/source/text/swriter/main0102.xhp
index 46b53eac08..de2b49ca6a 100644
--- a/source/text/swriter/main0102.xhp
+++ b/source/text/swriter/main0102.xhp
@@ -26,14 +26,13 @@
 </meta>
 
 <body>
-
-
 <section id="edit">
 <bookmark xml-lang="en-US" branch="hid/.uno:EditMenu" id="bm_id8177739" localize="false"/>
 
 <h1 id="hd_id3149610" xml-lang="en-US"><link href="text/swriter/main0102.xhp" name="Edit">Edit</link></h1>
 <paragraph id="par_id3149626" role="paragraph" xml-lang="en-US"><ahelp hid=".">This menu contains commands for editing the contents of the current document.</ahelp></paragraph>
 </section>
+
 <embed href="text/shared/01/02010000.xhp#undo"/>
 <embed href="text/shared/01/02020000.xhp#redo"/>
 <embed href="text/shared/01/02030000.xhp#repeat"/>
@@ -46,7 +45,6 @@
 
 <h2 id="hd_id3147619" xml-lang="en-US"><link href="text/shared/02/07070000.xhp" name="Select Text">Select Text</link></h2>
 <embed href="text/shared/02/07070000.xhp#selecttext"/>
-
 <embed href="text/shared/01/menu_edit_find.xhp#find"/>
 <embed href="text/shared/01/02100000.xhp#find_and_replace"/>
 
@@ -54,22 +52,24 @@
 <paragraph id="par_id102920150120456660" role="paragraph" xml-lang="en-US">Opens a dialog box to enter which page number should be shown. (<switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline><keycode>+G</keycode>)
 </paragraph>
 <embed href="text/shared/01/02230000.xhp#track_changes"/>
+
 <h2 id="hd_id11603124968334">Comment</h2>
 <paragraph role="paragraph" id="par_id941603125587454"> Shows submenu that gives options to reply, resolve and delete comments.</paragraph><comment>When a submenu for Comment is made, then replace label and description with an embed - 19.10.20</comment>
-<embed href="text/swriter/01/edit_reference_submenu.xhp#edit_reference_head"/>
 <embed href="text/shared/02/09070000.xhp#hyperlink"/>
+<embed href="text/swriter/01/edit_reference_submenu.xhp#edit_reference_head"/>
+
 <h2 id="hd_id0914201501170124" xml-lang="en-US"><link href="text/swriter/01/02140000.xhp" name="Fields">Fields</link></h2>
 <embed href="text/swriter/01/02140000.xhp#fields_text"/>
 
 <h2 id="hd_id0914201501170171" xml-lang="en-US"><link href="text/shared/01/02180000.xhp" name="Links">Links to External Files</link></h2>
 <embed href="text/shared/01/02180000.xhp#links_text"/>
 
-<h2 id="hd_id0914201502131542" xml-lang="en-US"><link href="text/shared/01/02200000.xhp" name="Object">Object</link></h2>
+<h2 id="hd_id0914201502131542" xml-lang="en-US"><link href="text/shared/01/02200000.xhp" name="Object">OLE Object</link></h2>
 <embed href="text/shared/01/02200000.xhp#object_text"/>
 <embed href="text/swriter/01/04180400.xhp#exchange_database"/>
+
 <h2 id="hd_id102920150120456626" xml-lang="en-US"><link href="text/swriter/02/18130000.xhp" name="Direct Cursor Mode">Direct Cursor Mode</link></h2>
 <paragraph id="par_id102920150120459176" role="paragraph" xml-lang="en-US">Allows a user to click at the beginning, middle, or end of any possible text line on a page and then begin typing.</paragraph>
 <embed href="text/shared/02/07070000.xhp#edit_mode"/>
 </body>
-
 </helpdocument>