tdf#152605 change "heading level" to "outline level" in UI

This patch addresses extended tips in the UI that refer to a heading
or chapter level, with the aim to remove this kind of terminology.
In many cases, tooltips are added, and extended tips are corrected.
Also, add "Outline" in front of "level" in the UI for Caption
Options and AutoCaption.

Change-Id: Idcf16892599913af31372b89d180251c86945d21
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/146622
Tested-by: Jenkins
Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>

5 files changed, 17 insertions, 10 deletions

diff --git a/sw/uiconfig/swriter/ui/captionoptions.ui b/sw/uiconfig/swriter/ui/captionoptions.ui
index e4c89373ee6f..fbe32fede7b7 100644
--- a/sw/uiconfig/swriter/ui/captionoptions.ui
+++ b/sw/uiconfig/swriter/ui/captionoptions.ui
@@ -102,9 +102,10 @@
                         <property name="visible">True</property>
                         <property name="can_focus">False</property>
                         <property name="hexpand">True</property>
+                        <property name="tooltip_text" translatable="yes" context="captionoptions|tooltip_text|level">Specify the maximum outline level of the immediately prior heading number to include in the caption number.</property>
                         <child internal-child="accessible">
                           <object class="AtkObject" id="level-atkobject">
-                            <property name="AtkObject::accessible-description" translatable="yes" context="captionoptions|extended_tip|level">Select the number of outline levels from the top of the chapter hierarchy down to include in the caption label.</property>
+                            <property name="AtkObject::accessible-description" translatable="yes" context="captionoptions|extended_tip|level">Specify the maximum outline level of the immediately prior heading number to include in the caption number. For numbers to appear, the selected heading must have numbering applied.</property>
                           </object>
                         </child>
                       </object>
@@ -135,7 +136,7 @@
                       <object class="GtkLabel" id="label5">
                         <property name="visible">True</property>
                         <property name="can_focus">False</property>
-                        <property name="label" translatable="yes" context="captionoptions|label5">_Level:</property>
+                        <property name="label" translatable="yes" context="captionoptions|label5">_Outline level:</property>
                         <property name="use_underline">True</property>
                         <property name="mnemonic_widget">level</property>
                         <property name="xalign">1</property>
diff --git a/sw/uiconfig/swriter/ui/flddocumentpage.ui b/sw/uiconfig/swriter/ui/flddocumentpage.ui
index 9863c4e0b6d5..086dc0c924f0 100644
--- a/sw/uiconfig/swriter/ui/flddocumentpage.ui
+++ b/sw/uiconfig/swriter/ui/flddocumentpage.ui
@@ -345,7 +345,7 @@
               <object class="GtkLabel" id="levelft">
                 <property name="visible">True</property>
                 <property name="can_focus">False</property>
-                <property name="label" translatable="yes" context="flddocumentpage|levelft">_Level</property>
+                <property name="label" translatable="yes" context="flddocumentpage|levelft">_Outline level</property>
                 <property name="use_underline">True</property>
                 <property name="mnemonic_widget">level</property>
                 <property name="xalign">0</property>
@@ -361,9 +361,10 @@
                 <property name="can_focus">True</property>
                 <property name="adjustment">adjustment1</property>
                 <property name="truncate-multiline">True</property>
+                <property name="tooltip_text" translatable="yes" context="flddocumentpage|level|tooltip_text">Specifies the maximum outline level of the immediately prior heading to be used.</property>
                 <child internal-child="accessible">
                   <object class="AtkObject" id="level-atkobject">
-                    <property name="AtkObject::accessible-description" translatable="yes" context="flddocumentpage|extended_tip|level">Select the chapter heading level that you want to include in the selected field.</property>
+                    <property name="AtkObject::accessible-description" translatable="yes" context="flddocumentpage|extended_tip|level">The first immediately prior heading with an outline level equal or less than the specified number is selected for display. If “Chapter number” is selected, then numbering must be applied in the Chapter Numbering dialog (see Tools menu).</property>
                   </object>
                 </child>
               </object>
diff --git a/sw/uiconfig/swriter/ui/fldvarpage.ui b/sw/uiconfig/swriter/ui/fldvarpage.ui
index 78aa13b9b78f..caa033ee231c 100644
--- a/sw/uiconfig/swriter/ui/fldvarpage.ui
+++ b/sw/uiconfig/swriter/ui/fldvarpage.ui
@@ -429,12 +429,13 @@
                       <object class="GtkComboBoxText" id="level">
                         <property name="visible">True</property>
                         <property name="can_focus">False</property>
+                        <property name="tooltip_text" translatable="yes" context="fldvarpage|level|tooltip_text">Choose the maximum outline level of the heading number to prepend to the displayed field.</property>
                         <items>
                           <item translatable="yes" context="fldvarpage|level">None</item>
                         </items>
                         <child internal-child="accessible">
                           <object class="AtkObject" id="level-atkobject">
-                            <property name="AtkObject::accessible-description" translatable="yes" context="fldvarpage|extended_tip|level">Choose the heading or chapter level at which to restart numbering in the document.</property>
+                            <property name="AtkObject::accessible-description" translatable="yes" context="fldvarpage|extended_tip|level">Choose the maximum outline level of the heading number to prepend to the displayed field. The selected heading number comes from the first immediately prior heading with the specified outline level or less. No heading number is displayed if “None” is selected.</property>
                           </object>
                         </child>
                       </object>
diff --git a/sw/uiconfig/swriter/ui/optcaptionpage.ui b/sw/uiconfig/swriter/ui/optcaptionpage.ui
index 0bc7de887e73..0ad93bc4d888 100644
--- a/sw/uiconfig/swriter/ui/optcaptionpage.ui
+++ b/sw/uiconfig/swriter/ui/optcaptionpage.ui
@@ -147,10 +147,11 @@
                         <property name="valign">center</property>
                         <property name="hexpand">True</property>
                         <property name="activates_default">True</property>
+                        <property name="tooltip_text" translatable="yes" context="optcaptionpage|tooltip_text|separator">Enter optional text characters to appear after the caption category and number.</property>
                         <property name="truncate-multiline">True</property>
                         <child internal-child="accessible">
                           <object class="AtkObject" id="separator-atkobject">
-                            <property name="AtkObject::accessible-description" translatable="yes" context="extended_tip|separator">Defines the character to be displayed after the number of the heading or chapter level.</property>
+                            <property name="AtkObject::accessible-description" translatable="yes" context="extended_tip|separator">Enter optional text characters to appear after the caption category and number.</property>
                           </object>
                         </child>
                       </object>
@@ -255,7 +256,7 @@
                       <object class="GtkLabel" id="label4">
                         <property name="visible">True</property>
                         <property name="can_focus">False</property>
-                        <property name="label" translatable="yes" context="optcaptionpage|label4">Level:</property>
+                        <property name="label" translatable="yes" context="optcaptionpage|label4">Outline level:</property>
                         <property name="use_underline">True</property>
                         <property name="mnemonic_widget">level</property>
                         <property name="xalign">0</property>
@@ -287,9 +288,10 @@
                         <property name="hexpand">True</property>
                         <property name="activates_default">True</property>
                         <property name="truncate-multiline">True</property>
+                        <property name="tooltip_text" translatable="yes" context="captionoptions|tooltip_text|chapseparator">Defines the character to be displayed after the selected chapter number and before the caption number.</property>
                         <child internal-child="accessible">
                           <object class="AtkObject" id="chapseparator-atkobject">
-                            <property name="AtkObject::accessible-description" translatable="yes" context="extended_tip|chapseparator">Defines the character to be displayed after the number of the heading or chapter level.</property>
+                            <property name="AtkObject::accessible-description" translatable="yes" context="extended_tip|chapseparator">Defines the character to be displayed after the selected chapter number and before the caption number.</property>
                           </object>
                         </child>
                       </object>
@@ -304,12 +306,13 @@
                         <property name="can_focus">False</property>
                         <property name="valign">center</property>
                         <property name="hexpand">True</property>
+                        <property name="tooltip_text" translatable="yes" context="optcaptionpage|tooltip_text|level">Specify the maximum outline level of the immediately prior heading to prepend to the caption number.</property>
                         <items>
                           <item translatable="yes" context="optcaptionpage|level">None</item>
                         </items>
                         <child internal-child="accessible">
                           <object class="AtkObject" id="level-atkobject">
-                            <property name="AtkObject::accessible-description" translatable="yes" context="extended_tip|level">Specifies the headings or chapter levels where you want the numbering to start.</property>
+                            <property name="AtkObject::accessible-description" translatable="yes" context="extended_tip|level">Use this option to specify the outline level of the heading number that should be prepended to the caption number. The first immediately prior heading with an outline level no greater than the specified number here is used to supply the numbering that is prepended.</property>
                           </object>
                         </child>
                       </object>
diff --git a/sw/uiconfig/swriter/ui/tocindexpage.ui b/sw/uiconfig/swriter/ui/tocindexpage.ui
index ee381134748f..c29f0e4b384b 100644
--- a/sw/uiconfig/swriter/ui/tocindexpage.ui
+++ b/sw/uiconfig/swriter/ui/tocindexpage.ui
@@ -285,9 +285,10 @@
                         <property name="activates-default">True</property>
                         <property name="truncate-multiline">True</property>
                         <property name="adjustment">adjustment1</property>
+                        <property name="tooltip_text" translatable="yes" context="tocindexpage|level|tooltip_text">Enter the number of outline levels to include in the index.</property>
                         <child internal-child="accessible">
                           <object class="AtkObject" id="level-atkobject">
-                            <property name="AtkObject::accessible-description" translatable="yes" context="tocindexpage|extended_tip|level">Enter the number of heading levels to include in the index.</property>
+                            <property name="AtkObject::accessible-description" translatable="yes" context="tocindexpage|extended_tip|level">Enter the number of outline levels to include in the index. All headings are included that have an outline level less than or equal to the specified value.</property>
                           </object>
                         </child>
                       </object>