update help page for Edit - Links to External Files

- updated "generic" explanation used by all modules with "links_text"
variable.
This explanation is now embedded in the overview of the Edit menu
help page for all modules.
- added module switch (after generic explanation), to indicate which
specific kinds of links can be edited. (Kudos to Mike Kaganski
for essential help)
- change label: Links --> Links to External Files
- also in access command in edit_menu
- reorganize controls to correspond to dialog order
- move paragraph about double-click to under "Source" heading
- move <notes> to end of page -- they are not directly relevant
to the command, but the information is generally relevant to those
who would use this command, and not found currently elsewhere.
- remove sys-specific warning about local cache (thanks again Mike)
- add embed about "Close" command
- removed "verknuepfungentext" variable and updated sdraw to use
"links_text" like other modules (this was only place where
that variable was used).
- update to: <h1>,<h2>,<warning>,<note>
- add some <keycode> to edit_menu

Change-Id: Idea3c38569f139a8d2e51de3c75a238c5fc35cf8
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/104677
Tested-by: Jenkins
Reviewed-by: Seth Chaiklin <sdc.blanco@youmail.dk>

3 files changed, 26 insertions, 29 deletions

diff --git a/source/text/sdraw/main_edit.xhp b/source/text/sdraw/main_edit.xhp
index d1e013766e..45a5216e41 100644
--- a/source/text/sdraw/main_edit.xhp
+++ b/source/text/sdraw/main_edit.xhp
@@ -19,7 +19,6 @@
  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  -->
 
-
 <meta>
 <topic id="textsdrawmain_editxml" indexer="include">
 <title id="tit" xml-lang="en-US">Edit</title>
@@ -52,7 +51,7 @@
 <embed href="text/simpress/01/02160000.xhp#feldbefehltext"/>
 <embed href="text/simpress/01/02130000.xhp#delete_slide"/><comment>UFI removed Layer command (as I did in zillion CWSs before...)</comment>
 <h2 id="hd_id3156446"><link href="text/shared/01/02180000.xhp" name="Links">Links</link></h2>
-<embed href="text/shared/01/02180000.xhp#verknuepfungentext"/>
+<embed href="text/shared/01/02180000.xhp#links_text"/>
 <embed href="text/shared/01/02200000.xhp#object"/>
 <h2 id="hd_id3157867"><link href="text/shared/02/09070000.xhp" name="Hyperlink">Hyperlink</link></h2>
 <embed href="text/shared/02/09070000.xhp#hyperdiatext"/>
diff --git a/source/text/shared/00/edit_menu.xhp b/source/text/shared/00/edit_menu.xhp
index 5087a78eec..eba2b1b085 100644
--- a/source/text/shared/00/edit_menu.xhp
+++ b/source/text/shared/00/edit_menu.xhp
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <helpdocument version="1.0">
-
 <!--
  * This file is part of the LibreOffice project.
  *
@@ -19,7 +18,6 @@
  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  -->
 
-
 <meta>
 <topic id="textsharededit_menuxml" indexer="exclude">
 <title id="tit" xml-lang="en-US">Edit Menu</title>
@@ -147,7 +145,7 @@
 
 <section id="alles">
 <paragraph role="paragraph" id="par_id3148555" xml-lang="en-US">Choose <menuitem>Edit - Select All</menuitem>.</paragraph>
-<paragraph role="paragraph" id="par_id3152417" xml-lang="en-US"><switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline><keycode>+A</keycode><keycode></keycode></paragraph>
+<paragraph role="paragraph" id="par_id3152417" xml-lang="en-US"><switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline><keycode>+A</keycode></paragraph>
 <section id="syallesau">
 <table id="tbl_id3145271">
 <tablerow>
@@ -180,7 +178,7 @@
 </section>
 <section id="find">
 <paragraph role="paragraph" id="par_id31562971" xml-lang="en-US">Choose <menuitem>Edit - Find</menuitem>.</paragraph>
-<paragraph role="paragraph" id="par_id31545031" xml-lang="en-US"><switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+F</paragraph>
+<paragraph role="paragraph" id="par_id31545031" xml-lang="en-US"><switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline><keycode>+F</keycode></paragraph>
 </section>
 <section id="suchen">
 <paragraph role="paragraph" id="par_id3156297" xml-lang="en-US">Choose <menuitem>Edit - Find &amp; Replace</menuitem>.</paragraph>
@@ -249,7 +247,7 @@
 
 </section>
 <paragraph role="paragraph" id="par_id3147338" xml-lang="en-US"><variable id="litdat">Choose <menuitem>Tools - Bibliography Database</menuitem>.</variable></paragraph>
-<paragraph role="paragraph" id="par_id3149281" xml-lang="en-US"><variable id="link">Choose <menuitem>Edit - Links</menuitem>.</variable></paragraph>
+<paragraph role="paragraph" id="par_id3149281" xml-lang="en-US"><variable id="link">Choose <menuitem>Edit - Links to External Files</menuitem>.</variable></paragraph>
 <paragraph role="paragraph" id="par_id3159339" xml-lang="en-US"><variable id="linkae">Choose <menuitem>Edit - Links to External Files - Modify...</menuitem> (DDE links only).</variable></paragraph>
 <section id="rahmeneigenschaften">
 <paragraph role="paragraph" id="par_id3148927" xml-lang="en-US">Select a frame, then choose <menuitem>Edit - Object - Properties</menuitem>.</paragraph>
diff --git a/source/text/shared/01/02180000.xhp b/source/text/shared/01/02180000.xhp
index be791019c4..3841cedf44 100644
--- a/source/text/shared/01/02180000.xhp
+++ b/source/text/shared/01/02180000.xhp
@@ -20,7 +20,7 @@
 
 <meta>
   <topic id="textshared0102180000xml" indexer="include" status="PUBLISH">
-    <title id="tit" xml-lang="en-US">Edit Links</title>
+    <title id="tit" xml-lang="en-US">Edit Links to External Files</title>
     <filename>/text/shared/01/02180000.xhp</filename>
   </topic>
 </meta>
@@ -36,43 +36,43 @@
 </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"/>
-<paragraph id="hd_id3150279" role="heading" level="1" xml-lang="en-US">Edit Links</paragraph>
-  <paragraph id="par_id3150774" role="paragraph" xml-lang="en-US"><variable id="links_text"><variable id="verknuepfungentext"><ahelp hid=".">Lets you edit the properties of each link in the current document, including the path to the source file. This command is not available if the current document does not contain links to other files.</ahelp></variable></variable></paragraph>
+<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 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 - Link Sheet from File</menuitem> or <menuitem>Sheet - Link to External Data</menuitem>, Function WEBSERVICE,</caseinline></switchinline> images and OLE objects (when inserted with a link to an external file).</paragraph>
+
 <section id="howtoget">
   <embed href="text/shared/00/edit_menu.xhp#link"/>
 </section>
-<paragraph id="par_id3156156" role="note" xml-lang="en-US">When you open a file that contains links, you are prompted to update the links. Depending on where the linked files are stored, the update process can take several minutes to complete.</paragraph>
-<paragraph id="par_id3143270" role="note" xml-lang="en-US">If you are loading a file that contains DDE links, you are prompted to update the links. Decline the update if you do not want to establish a connection to the DDE server.</paragraph>
+
 <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/TB_LINKS" id="bm_id48899801" localize="false"/>
-<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>
-<switch select="sys">
-<case select="WIN">
-<paragraph id="par_idN1099856" role="warning" xml-lang="en-US">When you open a file by an URL from the Windows file dialog, Windows will open a local copy of the file, located in the Internet Explorer cache. The %PRODUCTNAME file dialog opens the remote file.</paragraph>
-</case>
-</switch>
-<paragraph id="hd_id3155503" role="heading" level="2" xml-lang="en-US">Source file</paragraph>
+
+<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="hd_id3155449" role="heading" level="2" xml-lang="en-US">Element</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>
-<paragraph id="hd_id3153061" role="heading" level="2" xml-lang="en-US">Type</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>
-<paragraph id="hd_id3156343" role="heading" level="2" xml-lang="en-US">Status</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"/>
-<paragraph id="hd_id3147264" role="heading" level="2" xml-lang="en-US">Automatic</paragraph>
+<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"/>
-<paragraph id="hd_id3154938" role="heading" level="2" xml-lang="en-US">Manual</paragraph>
+<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/UPDATE_NOW" id="bm_id0720200903105198" localize="false"/>
-<paragraph id="hd_id3156280" role="heading" level="2" xml-lang="en-US">Update</paragraph>
-  <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>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/baselinksdialog/CHANGE_SOURCE" id="bm_id0720200903111714" localize="false"/>
-<paragraph id="hd_id3151381" role="heading" level="2" xml-lang="en-US">Modify</paragraph>
+<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"/>
-<paragraph id="hd_id3147084" role="heading" level="2" xml-lang="en-US">Break Link</paragraph>
+<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#schliessen"/>
+<note id="par_id3156156" xml-lang="en-US">When you open a file that contains links, you are prompted to update the links. Depending on where the linked files are stored, the update process can take several minutes to complete.</note>
+<note id="par_id3143270"  xml-lang="en-US">If you are loading a file that contains DDE links, you are prompted to update the links. Decline the update if you do not want to establish a connection to the DDE server.</note>
 </body>
 </helpdocument>