Clarify handling of empty paragraph in TOC

Empty heading or paragraph will not display in TOC.

Change-Id: Ia7549d8f22ccf63148150140cd1ccd0bf3b3aba0
Reviewed-on: https://gerrit.libreoffice.org/83720
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>

2 files changed, 13 insertions, 9 deletions

diff --git a/source/text/swriter/guide/indices_enter.xhp b/source/text/swriter/guide/indices_enter.xhp
index 3fd81468fc..7841d0a72f 100644
--- a/source/text/swriter/guide/indices_enter.xhp
+++ b/source/text/swriter/guide/indices_enter.xhp
@@ -34,9 +34,9 @@
 </bookmark>
 
 
-<paragraph id="hd_id3149689" role="heading" level="1" xml-lang="en-US"><variable id="indices_enter"><link href="text/swriter/guide/indices_enter.xhp" name="Defining Index or Table of Contents Entries">Defining Index or Table of Contents Entries</link></variable></paragraph>
+<h1 id="hd_id3149689"><variable id="indices_enter"><link href="text/swriter/guide/indices_enter.xhp" name="Defining Index or Table of Contents Entries">Defining Index or Table of Contents Entries</link></variable></h1>
 
-<paragraph id="hd_id3155862" role="heading" level="2" xml-lang="en-US">To Define Index Entries</paragraph>
+<h2 id="hd_id3155862">To Define Index Entries</h2>
 
 <list type="ordered">
   <listitem>
@@ -58,10 +58,10 @@
     <paragraph id="par_id3155889" role="listitem" xml-lang="en-US">To add the entries to a custom index, click the <emph>New User-defined Index</emph> icon, enter the name of the index, and then click <emph>OK</emph>.</paragraph>
   </listitem></list>
 
-<paragraph id="hd_id3147119" role="heading" level="2" xml-lang="en-US">To Define Table of Contents Entries</paragraph>
+<h2 id="hd_id3147119">To Define Table of Contents Entries</h2>
 <paragraph id="par_id3147132" role="paragraph" xml-lang="en-US">The best way to generate a table of contents is to apply the predefined heading paragraph styles, such as "Heading 1", to the paragraphs that you want to include in your table of contents.</paragraph>
 
-<paragraph id="hd_id3150230" role="heading" level="3" xml-lang="en-US">To Use a Custom Paragraph Style as a Table of Contents Entry</paragraph>
+<h3 id="hd_id3150230">To Use a Custom Paragraph Style as a Table of Contents Entry</h3>
 
 <list type="ordered">
   <listitem>
@@ -77,7 +77,8 @@
     <paragraph id="par_id3153730" role="listitem" xml-lang="en-US">Click <emph>OK</emph>. You can now apply the style to headings in your document and include them in your table of contents. </paragraph>
   </listitem>
 </list>
-<embed href="text/shared/00/00000004.xhp#related"/>
+<embed href="text/swriter/guide/indices_toc.xhp#emptyentry"/>
+<section id="relatedtopics">
 <embed href="text/swriter/guide/indices_toc.xhp#indices_toc"/>
 <embed href="text/swriter/guide/indices_edit.xhp#indices_edit"/>
 <embed href="text/swriter/guide/indices_form.xhp#indices_form"/>
@@ -86,6 +87,7 @@
 <embed href="text/swriter/guide/indices_userdef.xhp#indices_userdef"/>
 <embed href="text/swriter/guide/indices_literature.xhp#indices_literature"/>
 <embed href="text/swriter/guide/indices_multidoc.xhp#indices_multidoc"/>
+</section>
 </body>
 
 </helpdocument>
diff --git a/source/text/swriter/guide/indices_toc.xhp b/source/text/swriter/guide/indices_toc.xhp
index 7689e12b48..e81e93091a 100644
--- a/source/text/swriter/guide/indices_toc.xhp
+++ b/source/text/swriter/guide/indices_toc.xhp
@@ -35,12 +35,12 @@
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/tocdialog/@@nowidget@@" id="bm_@@nowidget@@" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/tocdialog/TocDialog" id="bm_id3154749" localize="false"/>
 
-<paragraph id="hd_id3147104" role="heading" level="1" xml-lang="en-US"><variable id="indices_toc"><link href="text/swriter/guide/indices_toc.xhp" name="Creating a Table of Contents">Creating a Table of Contents</link></variable></paragraph>
+<h1 id="hd_id3147104"><variable id="indices_toc"><link href="text/swriter/guide/indices_toc.xhp" name="Creating a Table of Contents">Creating a Table of Contents</link></variable></h1>
 
 <section id="tomanual">
 <paragraph id="par_id3150942" role="paragraph" xml-lang="en-US">The best way to generate a table of contents is to apply the predefined heading paragraph styles, such as "Heading 1", to the paragraphs that you want to include in your table of contents. After you apply these styles, you can then create a table of contents.</paragraph>
 
-<paragraph id="hd_id5876949" role="heading" level="2" xml-lang="en-US">To Insert a Table of Contents</paragraph>
+<h2 id="hd_id5876949">To Insert a Table of Contents</h2>
 
 <list type="ordered">
   <listitem>
@@ -61,8 +61,10 @@
 </list>
 <paragraph id="par_id3146896" role="paragraph" xml-lang="en-US">If you want to use a different paragraph style as a table of contents entry, select the <item type="menuitem">Additional Styles</item> check box in the <item type="menuitem">Create from</item> area, and then click the <item type="menuitem">Assign styles</item> button next to the check box. In the <item type="menuitem">Assign Styles</item> dialog, click the style in the list, and then click the <item type="menuitem">&gt;&gt;</item> or the <item type="menuitem">&lt;&lt;</item> button to define the chapter level for the paragraph style.</paragraph>
 </section>
-
-<paragraph id="hd_id3153148" role="heading" level="2" xml-lang="en-US">To Update a Table of Contents</paragraph>
+<section id="emptyentry">
+<tip id="par_id1001574720273772">%PRODUCTNAME creates the table of contents entries based on the chapter level of the paragraph style and the paragraph contents. If the paragraph is empty, it will not be included in the table of contents. To force the empty paragraph to be listed in the table of contents, manually add a space or a non breaking space to the paragraph. Spaces added in the <emph>After</emph> text box of the Numbering tab in the Chapter Numbering dialog will not work for this purpose, since they are part of the paragraph numbering, not the paragraph contents.</tip>
+</section>
+<h2 id="hd_id3153148">To Update a Table of Contents</h2>
 <paragraph id="par_id3153161" role="paragraph" xml-lang="en-US">Do one of the following:</paragraph>
 
 <list type="unordered">