From 2df65a1ff7072dc0ec866f5dfe11846c15208199 Mon Sep 17 00:00:00 2001
From: Seth Chaiklin <sdc.blanco@youmail.dk>
Date: Fri, 13 May 2022 23:19:40 +0100
Subject: tdf#149010,tdf#148941,tdf#149012,tdf#149130 update to reflect changes

   New labels were given to some controls on the Options tab for
   Image, Frame, and OLE Object in tdf#149010 and tdf#148941.
   This patch updates the relevant help page (the Options tab)
   in the Properties dialog to reflect those changes.

   Because some of the controls in the Options tab also appear
   in the Descriptions dialog, and UI changes were made in that
   dialog (tdf#148941), then the help page for that dialog is
   updated as part of this patch.

   Have also updated some access commands to OLE Object, which
   were changed in tdf#149018

 swriter/01/05060900.xhp (Options tab)
   * "Names"-> "Accessibility" (tdf#149010)
            and corrections to description
   + added an <embed> from the Description dialog page to provide
     the new control label
         "Alternate (Text Only)" -> "Text Alternative" (tdf#148941)
         and the "Description" control, as well as the  corrections
         to the control descriptions.
   + add "Sequences" section heading, in anticipation of tdf#149010
          (comment 7)
   * corrections made to descriptions of "Previous Link" and "Next Link"

 shared/01/05190100.xhp (Description dialog)
   * Corrections made to Description dialog page, and control
     descriptions embedded in the Options tab page. These corrections
     were promised in 61b4b76000bd5adca504df0966ecef3410765ab3.
   * "Title" -> "Text Alternative" (tdf#148941)
          and corrections to description
   + added separate <section>s for "Text Alternative" and "Description"
     so that they can be embedded in Options tab. By keeping them
     separate, it is possible to move their position in the embedded
     file or use separately, if necessary.
   + add <relatedtopics> and link to Options tab, so show an alternative
     way to access the Text Alternative and Description fields.

 simpress/guide/table_insert.xhp
   * move two bookmarks out of <ol>, because it disturbed formatting.
   * "Insert - Object" -> "Insert - OLE Object"
   * refactor changed items to <menuitem>
   * refactor to <h1>,<h2>,<note>

 shared/01/04150000.xhp (OLE Object menu)
   * "Object" -> "OLE Object"
   * corrections to menu contents
   * rename German id

 swriter/00/00000405.xhp  (access for Options)
   + added "right-click" instructions to howtoget

 shared/00/00040502.xhp  (access for Description)
   + added menu instructions for howtoget
   * make corrections in what objects can be accessed by context menu

 shared/00/00000404.xhp
   * "Object" -> "OLE Object" for menu access
   * "Formula" -> "Formula Object" for menu access
   * "Insert - Object - Chart" -> "Insert - Chart" for menu access
   * refactor changed items to <menuitem>
   * rename German id

Change-Id: I1ddeb8d532b81f22eba2b1e480759775ff96969f
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/134191
Tested-by: Jenkins
Reviewed-by: Seth Chaiklin <sdc.blanco@youmail.dk>
---
 source/text/shared/00/00000404.xhp | 18 +++++++++---------
 source/text/shared/00/00040502.xhp |  3 ++-
 source/text/shared/01/04150000.xhp | 10 +++++-----
 source/text/shared/01/05190100.xhp | 23 ++++++++++++++++-------
 4 files changed, 32 insertions(+), 22 deletions(-)

(limited to 'source/text/shared')

diff --git a/source/text/shared/00/00000404.xhp b/source/text/shared/00/00000404.xhp
index 24b240b6c2..727e6c7a11 100644
--- a/source/text/shared/00/00000404.xhp
+++ b/source/text/shared/00/00000404.xhp
@@ -70,10 +70,10 @@
 </table>
 </section>
 </section>
-<paragraph role="paragraph" id="par_id3147242" xml-lang="en-US"><variable id="objekteinf">Choose <emph>Insert - Object</emph>.</variable></paragraph>
+<paragraph role="paragraph" id="par_id3147242" xml-lang="en-US"><variable id="insert_objects">Choose <menuitem>Insert - OLE Object</menuitem>.</variable></paragraph>
 <section id="ole_object">
-<paragraph role="paragraph" id="par_id3152996" xml-lang="en-US">Choose <emph>Insert - Object - OLE Object</emph>.</paragraph>
-<paragraph role="paragraph" id="par_id3146806" xml-lang="en-US">On the <emph>Insert</emph> bar, click</paragraph><comment>bar or toolbar?</comment>
+<paragraph role="paragraph" id="par_id3152996" xml-lang="en-US">Choose <menuitem>Insert - OLE Object - OLE Object</menuitem>.</paragraph>
+<paragraph role="paragraph" id="par_id3146806" xml-lang="en-US">On the <emph>Insert</emph> bar, click</paragraph>
 <section id="syole">
 <table id="tbl_id3153348">
 <tablerow>
@@ -89,8 +89,8 @@
 </section>
 </section>
 <section id="math">
-<paragraph role="paragraph" id="par_id3150393" xml-lang="en-US">Choose <emph>Insert - Object - Formula</emph>.</paragraph>
-<paragraph role="paragraph" id="par_id3153056" xml-lang="en-US">On the <emph>Insert</emph> bar, click</paragraph><comment>bar or toolbar?</comment>
+<paragraph role="paragraph" id="par_id3150393" xml-lang="en-US">Choose <menuitem>Insert - OLE Object - Formula Object</menuitem>.</paragraph>
+<paragraph role="paragraph" id="par_id3153056" xml-lang="en-US">On the <emph>Insert</emph> bar, click</paragraph>
 <section id="systarmath">
 <table id="tbl_id3155432">
 <tablerow>
@@ -106,13 +106,13 @@
 </section>
 </section>
 <paragraph role="paragraph" id="par_id3153144" xml-lang="en-US">Choose <emph>Format - Chart Type</emph>.</paragraph>
-<paragraph role="paragraph" id="par_id3147578" xml-lang="en-US">Choose <emph>Insert - Object - Chart </emph>.</paragraph>
+<paragraph role="paragraph" id="par_id3147578" xml-lang="en-US">Choose <menuitem>Insert - Chart </menuitem>.</paragraph>
 <paragraph role="paragraph" id="par_id3154011" xml-lang="en-US">Choose <emph>Format - Chart Type</emph>.</paragraph>
-<paragraph role="paragraph" id="par_id3153573" xml-lang="en-US">Choose <emph>Insert - Object - Chart</emph>.</paragraph>
+<paragraph role="paragraph" id="par_id3153573" xml-lang="en-US">Choose <menuitem>Insert Chart</menuitem>.</paragraph>
 <paragraph role="paragraph" id="par_id3159179" xml-lang="en-US">Choose <emph>Format - Chart Type</emph>.</paragraph>
-<paragraph role="paragraph" id="par_id3159196" xml-lang="en-US">Choose <emph>Insert - Object - Chart</emph>.</paragraph>
+<paragraph role="paragraph" id="par_id3159196" xml-lang="en-US">Choose <menuitem>Insert - Chart</menuitem>.</paragraph>
 <section id="chart">
-<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US">Choose <emph>Insert - Object - Chart</emph>.</paragraph>
+<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US">Choose <menuitem>Insert - Chart</menuitem>.</paragraph>
 <paragraph role="paragraph" id="par_id3154921" xml-lang="en-US">On the <emph>Insert</emph> bar, click</paragraph>
 <section id="systarchart">
 <table id="tbl_id3147441">
diff --git a/source/text/shared/00/00040502.xhp b/source/text/shared/00/00040502.xhp
index 848d02199e..3620f637dc 100644
--- a/source/text/shared/00/00040502.xhp
+++ b/source/text/shared/00/00040502.xhp
@@ -206,7 +206,8 @@
         <paragraph id="par_id3148833" role="paragraph">Open the context menu for the object - choose <menuitem>Name</menuitem>.</paragraph>
     </section>
     <section id="descript">
-        <paragraph id="par_id411999" role="paragraph">Open the context menu for the object - choose <menuitem>Description</menuitem>.</paragraph>
+        <paragraph id="par_id411999" role="paragraph">Right-click on a selected image, frame, or OLE object - choose <menuitem>Properties - Options</menuitem> tab.</paragraph>
+        <paragraph role="paragraph" id="par_id301652608714795">For a selected object, choose <menuitem>Format - Description</menuitem></paragraph>
     </section>
 <section id="Shape_PositionSize">
 <paragraph role="paragraph" id="par_id921602059453828">Click on textbox or shape to select, then...</paragraph>
diff --git a/source/text/shared/01/04150000.xhp b/source/text/shared/01/04150000.xhp
index 027d8e709d..0c36757ff4 100644
--- a/source/text/shared/01/04150000.xhp
+++ b/source/text/shared/01/04150000.xhp
@@ -20,20 +20,20 @@
 
 <meta>
   <topic id="textshared0104150000xml" indexer="include" status="PUBLISH">
-    <title id="tit" xml-lang="en-US">Object</title>
+    <title id="tit" xml-lang="en-US">OLE Object (Insert Menu)</title>
     <filename>/text/shared/01/04150000.xhp</filename>
   </topic>
 </meta>
 <body>
 <section id="object_submenu">
 <bookmark xml-lang="en-US" branch="hid/.uno:ObjectMenu" id="bm_id2569353" localize="false"/>
-<h1 id="hd_id3146873"><link href="text/shared/01/04150000.xhp" name="Object">Object</link></h1>
-  <paragraph id="par_id3159079" role="paragraph" xml-lang="en-US"><ahelp hid=".">Inserts an embedded object into your document, including formulas, 3D models, charts and OLE objects.</ahelp></paragraph>
+<h1 id="hd_id3146873"><link href="text/shared/01/04150000.xhp" name="Object">OLE Object</link></h1>
+  <paragraph id="par_id3159079" role="paragraph" xml-lang="en-US"><ahelp hid=".">Inserts an embedded or linked object into your document, including formulas, QR codes, and OLE objects.</ahelp></paragraph>
 </section>
 <section id="howtoget">
-  <embed href="text/shared/00/00000404.xhp#objekteinf"/>
+  <embed href="text/shared/00/00000404.xhp#insert_objects"/>
 </section>
-<h2 id="hd_id3153577"><link href="text/shared/01/04160300.xhp" name="Formula">Formula</link></h2>
+<h2 id="hd_id3153577"><link href="text/shared/01/04160300.xhp" name="Formula">Formula Object</link></h2>
   <embed href="text/shared/01/04160300.xhp#starmath"/>
 <embed href="text/shared/guide/qrcode.xhp#qrcodeh1"/>
 <h2 id="hd_id3154894"><link href="text/shared/01/04150100.xhp" name="OLE Object">OLE Object</link></h2>
diff --git a/source/text/shared/01/05190100.xhp b/source/text/shared/01/05190100.xhp
index ee96edb0f9..43d7898f8f 100644
--- a/source/text/shared/01/05190100.xhp
+++ b/source/text/shared/01/05190100.xhp
@@ -25,25 +25,34 @@
       </topic>
 </meta>
 <body>
-<bookmark xml-lang="en-US" branch="index" id="bm_id3147366"><bookmark_value>objects;titles and descriptions</bookmark_value>
+<bookmark xml-lang="en-US" branch="index" id="bm_id3147366"><bookmark_value>objects;text alternative and description</bookmark_value>
       <bookmark_value>descriptions for objects</bookmark_value>
-      <bookmark_value>titles;objects</bookmark_value>
-</bookmark><comment>mw made one index entry out of two "objects;" entries and made "descriptions;" a one level entry</comment>
+      <bookmark_value>text alternative;objects</bookmark_value>
+</bookmark>
 <bookmark xml-lang="en-US" branch="hid/.uno:ObjectTitleDescription" id="bm_id267952" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/ObjectTitleDescDialog" id="bm_id1826227" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/@@nowidget@@" id="bm_id1826227" localize="false"/>
 <section id="description_head">
 <h1 id="hd_id1115756" xml-lang="en-US">Description</h1>
-<paragraph role="paragraph" id="par_id3140354" xml-lang="en-US"><ahelp hid=".">Assigns a title and a description to the selected object. These are accessible for accessibility tools and as alternative tags when you export the document.</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id3140354" xml-lang="en-US"><ahelp hid=".">Assigns a text alternative and a description to the selected object. These texts are available as alternative tags in your document for use by accessibility tools. They are also available as tags for images when you export the document.</ahelp></paragraph>
 </section>
 <section id="howtoget">
   <embed href="text/shared/00/00040502.xhp#descript"/>
 </section>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/object_title_entry" id="bm_id6154362" localize="false"/>
-<h2 id="hd_id2576982" xml-lang="en-US">Title</h2>
-<paragraph role="paragraph" id="par_id1283608" xml-lang="en-US"><ahelp hid=".">Enter a title text. This short name is visible as an alternative tag in HTML format. Accessibility tools can read this text.</ahelp></paragraph>
+<h2 id="hd_id2576982" xml-lang="en-US">Text Alternative</h2>
+<section id="text_alternative">
+<paragraph role="paragraph" id="par_id1283608" xml-lang="en-US"><ahelp hid=".">Enter a short description of the essential details of the selected object for a person who cannot see the object. This text is available for use by assistive technologies.</ahelp></paragraph>
+</section>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/objecttitledescdialog/desc_entry" id="bm_id6189764" localize="false"/>
+<section id="description_field">
 <h2 id="hd_id8173467" xml-lang="en-US">Description</h2>
-<paragraph role="paragraph" id="par_id693685" xml-lang="en-US"><ahelp hid=".">Enter a description text. The long description text can be entered to describe a complex object or group of objects to users with screen reader software. The description is visible as an alternative tag for accessibility tools.</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id693685" xml-lang="en-US"><ahelp hid=".">Enter a longer description of the object, especially if the object is too complex or contains too much detail to be described adequately with the short <menuitem>Text Alternative</menuitem>.</ahelp> Use <menuitem>Description</menuitem> to add additional information to the short description found in <menuitem>Text Alternative</menuitem>. This text is available for use by assistive technologies.</paragraph>
+<note id="par_id561653440782428"> For images, <menuitem>Text Alternative</menuitem> and <menuitem>Description</menuitem> are exported with an appropriate tag in HTML and PDF format (remember to enable the <link href="text/shared/01/ref_pdf_export_universal_accessibility.xhp" name="Link to PDF/UA"><menuitem>Universal Accessibility (PDF/UA)</menuitem></link> option in PDF export).</note>
+</section>
+<section id="relatedtopics">
+<paragraph role="paragraph" id="par_id731653238967459"><link href="text/swriter/01/05060900.xhp" name="Options">Options in Object Properties</link></paragraph>
+</section>
+
 </body>
 </helpdocument>
-- 
cgit