tdf#128219 Extra start params for debugging

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

1 files changed, 63 insertions, 17 deletions

diff --git a/source/text/shared/guide/start_parameters.xhp b/source/text/shared/guide/start_parameters.xhp
index c6fe853549..6f767eacaf 100644
--- a/source/text/shared/guide/start_parameters.xhp
+++ b/source/text/shared/guide/start_parameters.xhp
@@ -1,5 +1,4 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
  * This file is part of the LibreOffice project.
  *
@@ -17,7 +16,6 @@
  *   except in compliance with the License. You may obtain a copy of
  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  -->
-
 <helpdocument version="1.0">
     <meta>
         <topic id="textsharedguidestart_parametersxml" indexer="include" status="PUBLISH">
@@ -33,10 +31,10 @@
             <bookmark_value>parameters;command line</bookmark_value>
             <bookmark_value>arguments in command line</bookmark_value>
         </bookmark>
-        <paragraph role="heading" id="hd_id3156410" xml-lang="en-US" level="1">Starting $[officename] Software With Parameters</paragraph>
+        <h1 id="hd_id3156410">Starting $[officename] Software With Parameters</h1>
         <paragraph role="paragraph" id="par_id3147009" xml-lang="en-US">By starting $[officename] software from the command line you can assign various parameters, with which you can influence the performance. The use of command line parameters is only recommended for experienced users.</paragraph>
-        <paragraph role="note" id="par_id3147618" xml-lang="en-US">For normal handling, the use of command line parameters is not necessary. A few of the parameters require a deeper knowledge of the technical background of $[officename] software technology.</paragraph>
-        <paragraph role="heading" id="hd_id3154898" xml-lang="en-US" level="2">Starting $[officename] Software From the Command Line</paragraph>
+        <note id="par_id3147618">For normal handling, the use of command line parameters is not necessary. A few of the parameters require a deeper knowledge of the technical background of $[officename] software technology.</note>
+        <h2 id="hd_id3154898">Starting $[officename] Software From the Command Line</h2>
         <list type="ordered">
             <listitem>
                 <paragraph role="listitem" id="par_id3156152" xml-lang="en-US">Under Windows, select <emph>Run</emph> from the Windows Start menu, or open a shell under Linux, *BSD, or macOS platforms.</paragraph>
@@ -50,8 +48,8 @@
                 <paragraph role="listitem" id="par_id3153360" xml-lang="en-US">Replace <emph>{install}</emph> with the path to your installation of $[officename] software (for example, <emph>C:\Program Files\Office</emph> in Windows, or <emph>~/office</emph> in UNIX)</paragraph>
             </listitem>
         </list>
-    <paragraph role="heading" id="hd_id3145171" xml-lang="en-US" level="2">Valid Command Line Parameters</paragraph>
-    <paragraph id="hd_id1016120408556191" role="heading" level="3" xml-lang="en-US">Using without special arguments</paragraph>
+    <h2 id="hd_id3145171">Valid Command Line Parameters</h2>
+    <h3 id="hd_id1016120408556191">Using without special arguments</h3>
     <paragraph role="paragraph" id="par_id215247284938" xml-lang="en-US">Using without any arguments opens the start center.</paragraph>
     <table id="tbl_id2016120408556132">
         <tablerow>
@@ -71,7 +69,7 @@
            </tablecell>
       </tablerow>
     </table>
-    <paragraph id="hd_id201612040855610" role="heading" level="3" xml-lang="en-US">Getting help and information</paragraph>
+    <h3 id="hd_id201612040855610">Getting help and information</h3>
     <table id="tbl_id20161204085561">
         <tablerow>
             <tablecell>
@@ -163,7 +161,7 @@
       </tablerow>
     </table>
 
-    <paragraph id="hd_id20161204094429235" role="heading" level="3" xml-lang="en-US">General arguments</paragraph>
+    <h3 id="hd_id20161204094429235">General arguments</h3>
     <table id="tbl_id201612040855">
         <tablerow>
             <tablecell>
@@ -217,7 +215,7 @@
         </tablerow>
     </table>
 
-    <paragraph id="hd_id20161204103115358" role="heading" level="3" xml-lang="en-US">User/programmatic interface control</paragraph>
+    <h3 id="hd_id20161204103115358">User/programmatic interface control</h3>
     <table id="tbl_id20170517001">
         <tablerow>
             <tablecell>
@@ -316,7 +314,7 @@
         </tablerow>
     </table>
 
-    <paragraph id="par_id201612041220386" role="heading" level="3" xml-lang="en-US">Developer arguments</paragraph>
+    <h3 id="par_id201612041220386">Developer arguments</h3>
     <table id="tbl_id20170517002">
         <tablerow>
             <tablecell>
@@ -343,9 +341,57 @@
            </tablecell>
         </tablerow>
     </table>
-
-    <paragraph id="par_id20161204122420839" role="heading" level="3" xml-lang="en-US">New document creation arguments</paragraph>
-    <paragraph id="par_id20161204122414892" role="note" xml-lang="en-US">The arguments create an empty document of specified kind. Only one of them may be used in one command line. If filenames are specified after an argument, then it tries to open those files in the specified component.</paragraph>
+    <switch select="sys">
+        <case select="UNIX">
+            <paragraph role="paragraph" id="par_id631571706947129">Unix and Linux user can invoke %PRODUCTNAME with these additional parameters for debugging purposes.</paragraph>
+            <table id="tab_id371571706970240">
+                <tablerow>
+                    <tablecell>
+                        <paragraph id="par_id491571706970241" role="tablehead">Parameter</paragraph>
+                    </tablecell>
+                    <tablecell>
+                        <paragraph id="par_id11571706970242" role="tablehead">Meaning</paragraph>
+                    </tablecell>
+                </tablerow>
+                <tablerow>
+                    <tablecell>
+                        <paragraph id="par_id51571706970244" role="paragraph"><emph>--record</emph></paragraph>
+                    </tablecell>
+                    <tablecell>
+                        <paragraph id="par_id11571706970245" role="paragraph">An enhanced debugger.</paragraph>
+                    </tablecell>
+                </tablerow>
+                <tablerow>
+                    <tablecell>
+                        <paragraph id="par_id751571707080685" role="paragraph"><emph>--backtrace</emph></paragraph>
+                    </tablecell>
+                    <tablecell>
+                        <paragraph id="par_id971571707080686" role="paragraph">Prints the backtrace of the entire stack.</paragraph>
+                    </tablecell>
+                </tablerow>
+                <tablerow>
+                    <tablecell>
+                        <paragraph id="par_id171571707097883" role="paragraph"><emph>--strace</emph></paragraph>
+                    </tablecell>
+                    <tablecell>
+                        <paragraph id="par_id621571707097884" role="paragraph">strace is a diagnostic, debugging and instructional userspace utility for Linux.</paragraph>
+                    </tablecell>
+                </tablerow>
+                <tablerow>
+                    <tablecell>
+                        <paragraph id="par_id81571707115501" role="paragraph"><emph>--valgrind</emph></paragraph>
+                    </tablecell>
+                    <tablecell>
+                        <paragraph id="par_id281571707115502" role="paragraph">Automatically detect many memory management and threading bugs, and profile the program in detail.</paragraph>
+                    </tablecell>
+                </tablerow>
+            </table>
+            <note id="par_id571571707462064">The debug options <emph>--record</emph>, <emph>--backtrace</emph>, <emph>--strace</emph> and <emph>--valgrind</emph> cannot be used together. Please use them one by one.</note>
+            </case>
+            <default></default>
+    </switch>
+    <h3 id="par_id20161204122420839">New document creation arguments</h3>
+    <note id="par_id20161204122414892">The arguments create an empty document of specified kind. Only one of them may be used in one command line. If filenames are specified after an argument, then it tries to open those files in the specified component.</note>
     <table id="tbl_id20170517003">
         <tablerow>
             <tablecell>
@@ -412,8 +458,8 @@
             </tablecell>
         </tablerow>
     </table>
-    <paragraph id="par_id20161204125123476" role="heading" level="3" xml-lang="en-US">File open arguments</paragraph>
-    <paragraph id="par_id20161204125411030" role="note" xml-lang="en-US">The arguments define how following filenames are treated. New treatment begins after the argument and ends at the next argument. The default treatment is to open documents for editing, and create new documents from document templates.</paragraph>
+    <h3 id="par_id20161204125123476">File open arguments</h3>
+    <note id="par_id20161204125411030">The arguments define how following filenames are treated. New treatment begins after the argument and ends at the next argument. The default treatment is to open documents for editing, and create new documents from document templates.</note>
     <table id="tbl_id20170517004">
         <tablerow>
             <tablecell>
@@ -518,7 +564,7 @@
            </tablecell>
         </tablerow>
     </table>
-  <paragraph id="par_id20161204014126760" role="heading" level="3" xml-lang="en-US">Ignored switches</paragraph>
+  <h3 id="par_id20161204014126760">Ignored switches</h3>
     <table id="tbl_id20170517005">
         <tablerow>
             <tablecell>