Related to: tdf#138662 improve help for renaming Calc sheets

* move <tip> and <note> to better location
* move prefix explanation to better location with own <h2>
- drop links to page that does not give any help about prefixes
and add menu command sequence to get to the relevant place.
* Revise explanation about naming (drop select, add double click)
+ add explanation about single quote restrictions.
- drop warning about WindowManager (which was added in 2006)
+ add <literal> to restricted characters
+ add new <h2> headings to clarify page content
* convert one "note" to a paragraph under a new heading
* where paragraphs were changed, add <menuitem> as apppropriate
* update to <tip>,<note>,<h1>

Change-Id: I8a0e97b871331e0e3300a68252ae4096500aeeb1
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/107380
Tested-by: Jenkins
Reviewed-by: Seth Chaiklin <sdc.blanco@youmail.dk>
Reviewed-by: Ilmari Lauhakangas <ilmari.lauhakangas@libreoffice.org>
(cherry picked from commit 13cd181da4668aba0ba1e60c928d91c4892754db)
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/107491
Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>

1 files changed, 25 insertions, 28 deletions

diff --git a/source/text/scalc/guide/rename_table.xhp b/source/text/scalc/guide/rename_table.xhp
index 0cebc5bcf2..dd03da71ec 100644
--- a/source/text/scalc/guide/rename_table.xhp
+++ b/source/text/scalc/guide/rename_table.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="textscalcguiderename_tablexml" indexer="include">
          <title xml-lang="en-US" id="tit">Renaming Sheets</title>
@@ -31,16 +29,15 @@
       <bookmark_value>sheet tabs;renaming</bookmark_value>
       <bookmark_value>tables;renaming</bookmark_value>
       <bookmark_value>names; sheets</bookmark_value>
-</bookmark><comment>mw made "renaming sheets" a two level entry.</comment>
-<paragraph xml-lang="en-US" id="hd_id3150398" role="heading" level="1"><variable id="rename_table"><link href="text/scalc/guide/rename_table.xhp" name="Renaming Sheets">Renaming Sheets</link>
-</variable></paragraph>
-<paragraph role="paragraph" id="par_id701519308848244" xml-lang="en-US">Setting sheet names is an important feature to produce readable and understandable spreadsheets documents. To rename a sheet in your document:</paragraph>
+</bookmark>
+<h1 xml-lang="en-US" id="hd_id3150398"><variable id="rename_table"><link href="text/scalc/guide/rename_table.xhp" name="Renaming Sheets">Renaming Sheets</link>
+</variable></h1>
+<paragraph role="paragraph" id="par_id701519308848244" xml-lang="en-US">Setting sheet names is an important feature to produce readable and understandable spreadsheets documents.</paragraph>
+<tip xml-lang="en-US" id="par_id3155444">The name of a sheet is independent of the name of the spreadsheet. You enter the spreadsheet name when you save it for the first time as a file.</tip>
+<paragraph role="paragraph" id="par_id471607437423400">To rename a sheet in your document:</paragraph>
       <list type="ordered">
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id3155131" role="listitem">Click on the sheet tab to select it.</paragraph>
-         </listitem>
-         <listitem>
-            <paragraph xml-lang="en-US" id="par_id3146976" role="listitem">Open the context menu of the sheet tab and choose the <emph>Rename Sheet</emph> command. A dialog box appears where you can enter a new name.</paragraph>
+            <paragraph xml-lang="en-US" id="par_id3146976" role="listitem">Double-click the sheet tab or open its context menu and choose <menuitem>Rename Sheet</menuitem>. A dialog box appears where you can enter a new name.</paragraph>
          </listitem>
          <listitem>
             <paragraph xml-lang="en-US" id="par_id3149260" role="listitem">Enter a new name for the sheet and click <emph>OK</emph>.</paragraph>
@@ -48,46 +45,46 @@
          <listitem>
             <paragraph xml-lang="en-US" id="par_id3149667" role="listitem">Alternatively, hold down the <switchinline select="sys"><caseinline select="MAC">Option key
 </caseinline><defaultinline>Alt key</defaultinline></switchinline> and click on any sheet name and enter the new name directly.</paragraph>
-            <embed href="text/shared/00/00000099.xhp#winmanager"/>
          </listitem>
       </list>
+<note xml-lang="en-US" id="par_id471519308256437">The document can contain up to 10,000 individual sheets, which must have different names.</note>
+<h2 id="hd_id541607437294635">Sheet Naming Restrictions</h2>
       <paragraph xml-lang="en-US" id="par_id0909200810502833" role="paragraph">Sheet names can contain almost any character. Some naming restrictions apply, the following characters are not allowed in sheet names:</paragraph>
       <list type="unordered">
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id090920081050281" role="paragraph">colon :</paragraph>
+            <paragraph xml-lang="en-US" id="par_id090920081050281" role="paragraph">colon <literal>:</literal></paragraph>
          </listitem>
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id0909200810502897" role="paragraph">back slash \</paragraph>
+            <paragraph xml-lang="en-US" id="par_id0909200810502897" role="paragraph">back slash <literal>\</literal></paragraph>
          </listitem>
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id090920081050299" role="paragraph">forward slash /</paragraph>
+            <paragraph xml-lang="en-US" id="par_id090920081050299" role="paragraph">forward slash <literal>/</literal></paragraph>
          </listitem>
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id0909200810502913" role="paragraph">question mark ?</paragraph>
+            <paragraph xml-lang="en-US" id="par_id0909200810502913" role="paragraph">question mark <literal>?</literal></paragraph>
          </listitem>
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id090920081050298" role="paragraph">asterisk *</paragraph>
+            <paragraph xml-lang="en-US" id="par_id090920081050298" role="paragraph">asterisk <literal>*</literal></paragraph>
          </listitem>
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id0909200810502969" role="paragraph">left square bracket [</paragraph>
+            <paragraph xml-lang="en-US" id="par_id0909200810502969" role="paragraph">left square bracket <literal>[</literal></paragraph>
          </listitem>
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id0909200810502910" role="paragraph">right square bracket ]</paragraph>
+            <paragraph xml-lang="en-US" id="par_id0909200810502910" role="paragraph">right square bracket <literal>]</literal></paragraph>
          </listitem>
          <listitem>
-            <paragraph xml-lang="en-US" id="par_id0909200810502971" role="paragraph">single quote ' as the first or last character of the name</paragraph>
+            <paragraph xml-lang="en-US" id="par_id0909200810502971" role="paragraph">single quote <literal>'</literal> as the first or last character of the name</paragraph>
          </listitem>
       </list>
-      <paragraph xml-lang="en-US" id="par_id090920081050307" role="tip">In cell references, a sheet name must be enclosed in single quotes ' when the name contains other characters than alphanumeric or underscore. A single quote contained within a name has to be escaped by doubling it (two single quotes).</paragraph>
-      <paragraph role="paragraph" id="par_id321519307869857" xml-lang="en-US">For example, you want to reference the cell A1 on a sheet with the following name:</paragraph>
-      <paragraph xml-lang="en-US" id="par_id0909200810503071" role="code">This year's sheet</paragraph>
-      <paragraph xml-lang="en-US" id="par_id0909200810503054" role="paragraph">The reference must be enclosed in single quotes, and the one single quote inside the name must be doubled:</paragraph>
-      <paragraph xml-lang="en-US" id="par_id0909200810503069" role="code">'This year''s sheet'.A1</paragraph>
-      <paragraph xml-lang="en-US" id="par_id3155444" role="tip">The name of a sheet is independent of the name of the spreadsheet. You enter the spreadsheet name when you save it for the first time as a file.</paragraph>
-      <paragraph xml-lang="en-US" id="par_id471519308256437" role="note">The document can contain up to 10,000 individual sheets, which must have different names.</paragraph>
-      <paragraph role="paragraph" id="par_id81519309108908" xml-lang="en-US">You can set a prefix for the names of new sheets you create. See <link href="text/shared/optionen/01061000.xhp" name="prefix names">this page of Calc options.</link></paragraph>
+<paragraph role="paragraph" id="par_id761607437686157">The single quote is Unicode <literal>U+0027</literal>, also known as <literal>apostrophe</literal>. Other single-quote characters, similar to <literal>apostrophe</literal>, are allowed, such as <literal>ʼ</literal> <literal>‛</literal> and <literal>‚</literal>.</paragraph>
+<h2 id="hd_id251607438968588">Using a Default Prefix for Sheet Names</h2>
+     <paragraph role="paragraph" id="par_id81519309108908" xml-lang="en-US">You can set a prefix for the names of new sheets you create. Choose <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - %PRODUCTNAME Calc - Defaults</menuitem> and enter the prefix name in <emph>Prefix name for new worksheet</emph>.</paragraph>
+<h2 id="hd_id821607437571713">Referencing Sheet Names with Special Characters</h2>
+      <paragraph xml-lang="en-US" id="par_id090920081050307" role="paragraph">In cell references, a sheet name must be enclosed in single quotes <literal>'</literal> when the name contains other characters than alphanumeric or underscore. A single quote contained within a name has to be escaped by doubling it (two single quotes).</paragraph>
+      <paragraph role="paragraph" id="par_id321519307869857" xml-lang="en-US">For example, you want to reference the <literal>cell A1</literal> on a sheet named <literal>This year's sheet</literal>.</paragraph>
+      
+      <paragraph xml-lang="en-US" id="par_id0909200810503054" role="paragraph"> The reference must be enclosed in single quotes, and the one single quote inside the name must be doubled: <literal>'This year''s sheet'.A1</literal></paragraph>
       <section id="relatedtopics">
-          <paragraph role="paragraph" id="par_id81519379108908" xml-lang="en-US"><link href="text/shared/optionen/01061000.xhp" name="prefix names">New sheet names prefixing.</link></paragraph>
          <embed href="text/scalc/guide/multitables.xhp#multitables"/>
       </section>
    </body>