source/text/shared/guide/start_parameters.xhp | 80 ++++++++++++++++++++------
1 file changed, 63 insertions(+), 17 deletions(-)
New commits:
commit 4ee056ae84bb0a30a64c43afda7f4d3f0bce522d
Author: Olivier Hallot <olivier.hal...@libreoffice.org>
AuthorDate: Mon Oct 21 22:52:40 2019 -0300
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Thu Nov 7 14:33:15 2019 +0100
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.hal...@libreoffice.org>
diff --git a/source/text/shared/guide/start_parameters.xhp
b/source/text/shared/guide/start_parameters.xhp
index c6fe85354..6f767eaca 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>
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
