[kde-doc-english] [kdoctools] docs/qt5options: update qt5options manpage docbook to qt 5.4

Burkhard Lück lueck at hube-lueck.de
Tue Jun 14 19:06:33 UTC 2016 

Git commit 09ee4743888fec5cf3fbbb4af1996a8e74a68d78 by Burkhard Lück.
Committed on 14/06/2016 at 19:06.
Pushed by lueck into branch 'master'.

update qt5options manpage docbook to qt 5.4

M  +115  -100  docs/qt5options/man-qt5options.7.docbook

http://commits.kde.org/kdoctools/09ee4743888fec5cf3fbbb4af1996a8e74a68d78

diff --git a/docs/qt5options/man-qt5options.7.docbook b/docs/qt5options/man-qt5options.7.docbook
index d5891eb..b082d97 100644
--- a/docs/qt5options/man-qt5options.7.docbook
+++ b/docs/qt5options/man-qt5options.7.docbook
@@ -7,8 +7,9 @@
 <refentryinfo>
 <title>qt5options User's Manual</title>
 <author>&Lauri.Watts; &Lauri.Watts.mail;</author>
-<date>2014-03-04</date>
-<releaseinfo>Frameworks 5.0</releaseinfo>
+<author>&Burkhard.Lueck; &Burkhard.Lueck.mail;</author>
+<date>2016-06-04</date>
+<releaseinfo>&Qt; 5.4</releaseinfo>
 <productname>KDE Frameworks</productname>
 </refentryinfo>
 
@@ -25,7 +26,29 @@
 <refsynopsisdiv>
 <cmdsynopsis>
 <command><replaceable>Qt application</replaceable></command>
-<arg choice="opt">Qt Generic Options</arg>
+<!--http://doc.qt.io/qt-5/qapplication.html#QApplication-->
+<arg choice="opt"><option>-style=</option> <replaceable>style</replaceable> / <option>-style</option> <replaceable>style</replaceable></arg>
+<arg choice="opt"><option>-stylesheet=</option> <replaceable>stylesheet</replaceable> / <option>-stylesheet</option> <replaceable>stylesheet</replaceable></arg>
+<arg choice="opt"><option>-widgetcount</option></arg>
+<arg choice="opt"><option>-reverse</option></arg>
+<arg choice="opt"><option>-qmljsdebugger=</option> <replaceable>port</replaceable></arg>
+<!--http://doc.qt.io/qt-5/qguiapplication.html#QGuiApplication-->
+<arg choice="opt"><option>-platform</option> <replaceable>platformName[:options]</replaceable></arg>
+<arg choice="opt"><option>-platformpluginpath</option> <replaceable>path</replaceable></arg>
+<arg choice="opt"><option>-platformtheme</option> <replaceable>platformTheme</replaceable></arg>
+<arg choice="opt"><option>-plugin</option> <replaceable>plugin</replaceable></arg>
+<arg choice="opt"><option>-qwindowgeometry</option> <replaceable>geometry</replaceable></arg>
+<arg choice="opt"><option>-qwindowicon</option> <replaceable>icon</replaceable></arg>
+<arg choice="opt"><option>-qwindowtitle</option> <replaceable>title</replaceable></arg>
+<arg choice="opt"><option>-reverse</option></arg>
+<arg choice="opt"><option>-session</option> <replaceable>session</replaceable></arg>
+<arg choice="opt"><option>-display</option> <replaceable>hostname:screen_number</replaceable></arg>
+<arg choice="opt"><option>-geometry</option> <replaceable>geometry</replaceable></arg>
+<arg choice="opt"><option>-dialogs=</option> <replaceable>[xp|none]</replaceable></arg>
+<arg choice="opt"><option>-fontengine=</option> <replaceable>freetype</replaceable></arg>
+<!--http://doc.qt.io/qt-5/qcommandlineparser.html -->
+<arg choice="opt"><option>-h, --help and -? on Windows</option></arg>
+<arg choice="opt"><option>-v --version</option></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -35,195 +58,183 @@
 
 <para>The following options apply to all &Qt; applications:</para>
 
-<variablelist> <!-- all this could be entitiesan entity -->
+<variablelist>
+<!--http://doc.qt.io/qt-5/qapplication.html#QApplication-->
 <varlistentry>
 <term>
-<option>--display</option> <parameter>displayname</parameter>
+<option>-style=</option> <replaceable>style</replaceable> / <option>-style</option> <replaceable>style</replaceable>
 </term>
-<listitem>
-<para>Use the X-server display
-<parameter>displayname</parameter>.</para>
+<listitem><para>
+Set the application GUI style. Possible values depend on the system configuration.
+If Qt is compiled with additional styles or has additional styles as plugins these will be available to the -style command line option.</para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--session</option> <parameter>sessionId</parameter>
+<option>-stylesheet=</option> <replaceable>stylesheet</replaceable> / <option>-stylesheet</option> <replaceable>stylesheet</replaceable>
 </term>
-<listitem>
-<para>Restore the application for the given
-<parameter>sessionId</parameter>.</para>
-</listitem>
+<listitem><para>
+Set the application styleSheet. The value must be a path to a file that contains the Style Sheet.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--cmap</option>
+<option>-widgetcount</option>
 </term>
-<listitem>
-<para>Causes the application to install a private color map on an
-8-bit display.</para>
-</listitem>
+<listitem><para>
+Print debug message at the end about number of widgets left undestroyed and maximum number of widgets existed at the same time.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--ncols</option> <parameter>count</parameter>
+<option>-reverse</option>
 </term>
-<listitem>
-<para>Limits the number of colors allocated in the color cube on an
-8-bit display, if the application is using the
-<methodname>QApplication::ManyColor</methodname> color
-specification.</para>
-</listitem>
+<listitem><para>
+Set the application's layout direction to <methodname>Qt::RightToLeft</methodname>.
+This option is intended to aid debugging and should not be used in production.
+The default value is automatically detected from the user's
+locale (see also <methodname>QLocale::textDirection()</methodname>).
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--nograb</option>
+<option>-qmljsdebugger=</option> <replaceable>port</replaceable>
 </term>
-<listitem>
-<para>Tells &Qt; to never grab the mouse or the keyboard.</para>
-</listitem>
+<listitem><para>
+Activate the QML/JS debugger with a specified port. The value must be of format port:1234[,block],
+where block is optional and will make the application wait until a debugger connects to it.
+</para></listitem>
 </varlistentry>
-
+<!--http://doc.qt.io/qt-5/qguiapplication.html#QGuiApplication-->
 <varlistentry>
 <term>
-<option>--dograb</option>
+<option>-platform</option> <replaceable>platformName[:options]</replaceable>
 </term>
-<listitem>
-<para>Running under a debugger can cause an implicit
-<option>--nograb</option>, use <option>--dograb</option> to
-override.</para>
-</listitem>
+<listitem><para>
+Specify the Qt Platform Abstraction (QPA) plugin.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--sync</option>
+<option>-platformpluginpath</option> <replaceable>path</replaceable>
 </term>
-<listitem>
-<para>Switches to synchronous mode for debugging.</para>
-</listitem>
+<listitem><para>
+Specify the path to platform plugins.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--fn</option>,<option>--font</option>
-<parameter>fontname</parameter>
+<option>-platformtheme</option> <replaceable>platformTheme</replaceable>
 </term>
-<listitem>
-<para>Defines the application font.</para>
-</listitem>
+<listitem><para>
+Specify the platform theme.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--bg</option>,<option>--background</option>
-<parameter>color</parameter>
+<option>-plugin</option> <replaceable>plugin</replaceable>
 </term>
-<listitem>
-<para>Sets the default background color and an application palette
-(light and dark shades are calculated).</para>
-</listitem>
+<listitem><para>
+Specify additional plugins to load. The argument may appear multiple times.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--fg</option>,<option>--foreground</option>
-<parameter>color</parameter>
+<option>-qwindowgeometry</option> <replaceable>geometry</replaceable>
 </term>
-<listitem>
-<para>Sets the default foreground color</para>
-</listitem>
+<listitem><para>
+Specify the window geometry for the main window using the X11-syntax. For example: -qwindowgeometry 100x100+50+50
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--btn</option>,<option>--button</option>
-<parameter>color</parameter>
+<option>-qwindowicon</option> <replaceable>icon</replaceable>
 </term>
-<listitem>
-<para>Sets the default button color.</para>
-</listitem>
+<listitem><para>
+Set the default window icon.
+</para></listitem>
 </varlistentry>
 
-
 <varlistentry>
 <term>
-<option>--name</option> <parameter>name</parameter>
+<option>-qwindowtitle</option> <replaceable>title</replaceable>
 </term>
-<listitem>
-<para>Sets the application name.</para>
-</listitem>
+<listitem><para>
+Set the title of the first window.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--title</option> <parameter>title</parameter>
+<option>-session</option> <replaceable>session</replaceable>
 </term>
-<listitem>
-<para>Sets the application title (caption).</para>
-</listitem>
+<listitem><para>
+Restore the application from an earlier session.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--visual</option> <parameter>TrueColor</parameter>
+<option>-display</option> <replaceable>hostname:screen_number</replaceable>
 </term>
-<listitem>
-<para>Forces the application to use a <parameter>TrueColor</parameter>
-visual on an 8-bit display.</para>
-</listitem>
+<listitem><para>
+Switch displays on X11. Overrides the DISPLAY environment variable.
+</para></listitem>
 </varlistentry>
 
-
 <varlistentry>
 <term>
-<option>--inputstyle</option> <parameter>inputstyle</parameter>
+<option>-geometry</option> <replaceable>geometry</replaceable>
 </term>
-<listitem>
-<para>Sets XIM (X Input Method) input style.  Possible values are
-<parameter>onthespot</parameter>, <parameter>overthespot</parameter>,
-<parameter>offthespot</parameter> and
-<parameter>root</parameter>.</para>
-</listitem>
+<listitem><para>
+Specify the window geometry for the main window on X11. For example: -geometry 100x100+50+50.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--im</option> <parameter>XIM server</parameter>
+<option>-dialogs=</option> <replaceable>[xp|none]</replaceable>
 </term>
-<listitem>
-<para>Set XIM server.</para>
-</listitem>
+<listitem><para>
+Only available for -platform windows.
+xp uses XP-style native dialogs and none disables them.</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--noxim</option>
+<option>-fontengine=</option> <replaceable>freetype</replaceable>
 </term>
-<listitem>
-<para>Disable XIM</para>
-</listitem>
+<listitem><para>
+Use the FreeType font engine.
+</para></listitem>
 </varlistentry>
 
+<!--http://doc.qt.io/qt-5/qcommandlineparser.html -->
 <varlistentry>
 <term>
-<option>--reverse</option>
+<option>-h, --help and -? on Windows</option>
 </term>
-<listitem>
-<para>mirrors the whole layout of widgets</para>
-</listitem>
+<listitem><para>
+Print all options and the application description.
+</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term>
-<option>--stylesheet</option> <replaceable>file.qss</replaceable>
+><option>-v --version</option>
 </term>
-<listitem>
-<para>applies the Qt stylesheet to the application widgets</para>
-</listitem>
+<listitem><para>
+Display the version string of the application.
+</para></listitem>
 </varlistentry>
 
 </variablelist>
@@ -239,7 +250,11 @@ visual on an 8-bit display.</para>
 
 <refsect1>
 <title>Authors</title>
-<para>Man page written by &Lauri.Watts; &Lauri.Watts.mail;</para>
+<para>Man page originally written by &Lauri.Watts; &Lauri.Watts.mail;</para>
+<para>Updated to Frameworks 5 by &Burkhard.Lueck; &Burkhard.Lueck.mail;</para>
+<para>The infos for this man page are from <ulink url="http://doc.qt.io/qt-5/qapplication.html#QApplication">QApplication documentation</ulink>,
+<ulink url="http://doc.qt.io/qt-5/qguiapplication.html#QGuiApplication">QGuiApplication documentation</ulink>
+and <ulink url="http://doc.qt.io/qt-5/qcommandlineparser.html">QCommandLineParser documentation</ulink>.</para>
 </refsect1>
 
 </refentry>

More information about the kde-doc-english mailing list