[Libreoffice-commits] core.git: desktop/source
Libreoffice Gerrit user
logerrit at kemper.freedesktop.org
Tue Nov 20 18:39:14 UTC 2018
desktop/source/app/cmdlinehelp.cxx | 264 ++++++++++++++++++-------------------
1 file changed, 133 insertions(+), 131 deletions(-)
New commits:
commit 18c3d7c4d2ac72aa3ce1a7c592e227f4668bc1a4
Author: Mike Kaganski <mike.kaganski at collabora.com>
AuthorDate: Tue Nov 20 17:08:39 2018 +0100
Commit: Mike Kaganski <mike.kaganski at collabora.com>
CommitDate: Tue Nov 20 19:38:49 2018 +0100
Tidy up the --help text to properly fit into standard 80-ch terminal
Change-Id: I5b7f503e32c10b5a844817c040ab0dde27bf48f7
Reviewed-on: https://gerrit.libreoffice.org/63666
Tested-by: Jenkins
Reviewed-by: Mike Kaganski <mike.kaganski at collabora.com>
diff --git a/desktop/source/app/cmdlinehelp.cxx b/desktop/source/app/cmdlinehelp.cxx
index 0dbbe41dd660..656835082c59 100644
--- a/desktop/source/app/cmdlinehelp.cxx
+++ b/desktop/source/app/cmdlinehelp.cxx
@@ -42,143 +42,145 @@ namespace desktop
"\n";
const char aCmdLineHelp[] =
"Usage: %CMDNAME [argument...]\n"
- " argument - switches, switch parameters and document URIs (filenames).\n\n"
- "Using without special arguments:\n"
- "Opens the start center, if it is used without any arguments.\n"
- " {file} Tries to open the file (files) in the components\n"
- " suitable for them.\n"
- " {file} {macro:///Library.Module.MacroName}\n"
- " Opens the file and runs specified macros from\n"
- " the file.\n\n"
- "Getting help and information:\n"
- " --help | -h | -? Shows this help and quits.\n"
- " --helpwriter Opens built-in or online Help on Writer.\n"
- " --helpcalc Opens built-in or online Help on Calc.\n"
- " --helpdraw Opens built-in or online Help on Draw.\n"
- " --helpimpress Opens built-in or online Help on Impress.\n"
- " --helpbase Opens built-in or online Help on Base.\n"
- " --helpbasic Opens built-in or online Help on Basic scripting\n"
- " language.\n"
- " --helpmath Opens built-in or online Help on Math.\n"
- " --version Shows the version and quits.\n"
- " --nstemporarydirectory\n"
- " (MacOS X sandbox only) Returns path of the temporary\n"
- " directory for the current user and exits. Overrides\n"
- " all other arguments.\n\n"
- "General arguments:\n"
- " --quickstart[=no] Activates[Deactivates] the Quickstarter service.\n"
- " --nolockcheck Disables check for remote instances using one\n"
- " installation.\n"
- " --infilter={filter} Force an input filter type if possible. For example:\n"
- " --infilter=\"Calc Office Open XML\"\n"
- " --infilter=\"Text (encoded):UTF8,LF,,,\"\n"
- " --pidfile={file} Store soffice.bin pid to {file}.\n"
- " --display {display} Sets the DISPLAY environment variable on UNIX-like\n"
- " platforms to the value {display} (only supported by a\n"
- " start script).\n\n"
- "User/programmatic interface control:\n"
- " --nologo Disables the splash screen at program start.\n"
- " --minimized Starts minimized. The splash screen is not displayed.\n"
- " --nodefault Starts without displaying anything except the splash\n"
- " screen (do not display initial window).\n"
- " --invisible Starts in invisible mode. Neither the start-up logo nor\n"
- " the initial program window will be visible. Application\n"
- " can be controlled, and documents and dialogs can be\n"
- " controlled and opened via the API. Using the parameter,\n"
- " the process can only be ended using the taskmanager\n"
- " (Windows) or the kill command (UNIX-like systems). It\n"
- " cannot be used in conjunction with --quickstart.\n"
- " --headless Starts in \"headless mode\" which allows using the\n"
- " application without GUI. This special mode can be used\n"
- " when the application is controlled by external clients\n"
- " via the API.\n"
+ " argument - switches, switch parameters and document URIs (filenames). \n\n"
+ "Using without special arguments: \n"
+ "Opens the start center, if it is used without any arguments. \n"
+ " {file} Tries to open the file (files) in the components \n"
+ " suitable for them. \n"
+ " {file} {macro:///Library.Module.MacroName} \n"
+ " Opens the file and runs specified macros from \n"
+ " the file. \n\n"
+ "Getting help and information: \n"
+ " --help | -h | -? Shows this help and quits. \n"
+ " --helpwriter Opens built-in or online Help on Writer. \n"
+ " --helpcalc Opens built-in or online Help on Calc. \n"
+ " --helpdraw Opens built-in or online Help on Draw. \n"
+ " --helpimpress Opens built-in or online Help on Impress. \n"
+ " --helpbase Opens built-in or online Help on Base. \n"
+ " --helpbasic Opens built-in or online Help on Basic scripting \n"
+ " language. \n"
+ " --helpmath Opens built-in or online Help on Math. \n"
+ " --version Shows the version and quits. \n"
+ " --nstemporarydirectory \n"
+ " (MacOS X sandbox only) Returns path of the temporary \n"
+ " directory for the current user and exits. Overrides \n"
+ " all other arguments. \n\n"
+ "General arguments: \n"
+ " --quickstart[=no] Activates[Deactivates] the Quickstarter service. \n"
+ " --nolockcheck Disables check for remote instances using one \n"
+ " installation. \n"
+ " --infilter={filter} Force an input filter type if possible. For example: \n"
+ " --infilter=\"Calc Office Open XML\" \n"
+ " --infilter=\"Text (encoded):UTF8,LF,,,\" \n"
+ " --pidfile={file} Store soffice.bin pid to {file}. \n"
+ " --display {display} Sets the DISPLAY environment variable on UNIX-like \n"
+ " platforms to the value {display} (only supported by a \n"
+ " start script). \n\n"
+ "User/programmatic interface control: \n"
+ " --nologo Disables the splash screen at program start. \n"
+ " --minimized Starts minimized. The splash screen is not displayed. \n"
+ " --nodefault Starts without displaying anything except the splash \n"
+ " screen (do not display initial window). \n"
+ " --invisible Starts in invisible mode. Neither the start-up logo nor \n"
+ " the initial program window will be visible. Application \n"
+ " can be controlled, and documents and dialogs can be \n"
+ " controlled and opened via the API. Using the parameter, \n"
+ " the process can only be ended using the taskmanager \n"
+ " (Windows) or the kill command (UNIX-like systems). It \n"
+ " cannot be used in conjunction with --quickstart. \n"
+ " --headless Starts in \"headless mode\" which allows using the \n"
+ " application without GUI. This special mode can be used \n"
+ " when the application is controlled by external clients \n"
+ " via the API. \n"
" --norestore Disables restart and file recovery after a system crash.\n"
- " --safe-mode Starts in a safe mode, i.e. starts temporarily with a\n"
- " fresh user profile and helps to restore a broken\n"
- " configuration.\n"
- " --accept={UNO-URL} Specifies an UNO-URL connect-string to create an UNO\n"
- " acceptor through which other programs can connect to\n"
- " access the API. UNO-URL is string the such kind\n"
- " uno:connection-type,params;protocol-name,params;ObjectName.\n"
- " --unaccept={UNO-URL} Closes an acceptor that was created with --accept. Use\n"
- " --unaccept=all to close all open acceptors.\n"
- " --language={lang} Uses specified language, if language is not selected\n"
- " yet for UI. The lang is a tag of the language in IETF\n"
- " language tag.\n\n"
- "Developer arguments:\n"
- " --terminate_after_init\n"
- " Exit after initialization complete (no documents loaded).\n"
- " --eventtesting Exit after loading documents.\n\n"
- "New document creation arguments:\n"
- "The arguments create an empty document of specified kind. Only one of them may\n"
- "be used in one command line. If filenames are specified after an argument,\n"
- "then it tries to open those files in the specified component.\n"
- " --writer Creates an empty Writer document.\n"
- " --calc Creates an empty Calc document.\n"
- " --draw Creates an empty Draw document.\n"
- " --impress Creates an empty Impress document.\n"
- " --base Creates a new database.\n"
- " --global Creates an empty Writer master (global) document.\n"
- " --math Creates an empty Math document (formula).\n"
- " --web Creates an empty HTML document.\n\n"
- "File open arguments:\n"
- "The arguments define how following filenames are treated. New treatment begins\n"
- "after the argument and ends at the next argument. The default treatment is to\n"
- "open documents for editing, and create new documents from document templates.\n"
- " -n Treats following files as templates for creation of new\n"
- " documents.\n"
- " -o Opens following files for editing, regardless whether\n"
- " they are templates or not.\n"
- " --pt {Printername} Prints following files to the printer {Printername},\n"
- " after which those files are closed. The splash screen\n"
- " does not appear. If used multiple times, only last\n"
- " {Printername} is effective for all documents of all\n"
- " --pt runs. Also, --printer-name argument of\n"
- " --print-to-file switch interferes with {Printername}.\n"
- " -p Prints following files to the default printer, after\n"
- " which those files are closed. The splash screen does\n"
- " not appear. If the file name contains spaces, then it\n"
- " must be enclosed in quotation marks.\n"
- " --view Opens following files in viewer mode (read-only).\n"
- " --show Opens and starts the following presentation documents \n"
+ " --safe-mode Starts in a safe mode, i.e. starts temporarily with a \n"
+ " fresh user profile and helps to restore a broken \n"
+ " configuration. \n"
+ " --accept={UNO-URL} Specifies an UNO-URL connect-string to create an UNO \n"
+ " acceptor through which other programs can connect to \n"
+ " access the API. UNO-URL is string the such kind \n"
+ " uno:connection-type,params;protocol-name,params;ObjectName. \n"
+ " --unaccept={UNO-URL} Closes an acceptor that was created with --accept. Use \n"
+ " --unaccept=all to close all open acceptors. \n"
+ " --language={lang} Uses specified language, if language is not selected \n"
+ " yet for UI. The lang is a tag of the language in IETF \n"
+ " language tag. \n\n"
+ "Developer arguments: \n"
+ " --terminate_after_init \n"
+ " Exit after initialization complete (no documents loaded)\n"
+ " --eventtesting Exit after loading documents. \n\n"
+ "New document creation arguments: \n"
+ "The arguments create an empty document of specified kind. Only one of them may \n"
+ "be used in one command line. If filenames are specified after an argument, \n"
+ "then it tries to open those files in the specified component. \n"
+ " --writer Creates an empty Writer document. \n"
+ " --calc Creates an empty Calc document. \n"
+ " --draw Creates an empty Draw document. \n"
+ " --impress Creates an empty Impress document. \n"
+ " --base Creates a new database. \n"
+ " --global Creates an empty Writer master (global) document. \n"
+ " --math Creates an empty Math document (formula). \n"
+ " --web Creates an empty HTML document. \n\n"
+ "File open arguments: \n"
+ "The arguments define how following filenames are treated. New treatment begins \n"
+ "after the argument and ends at the next argument. The default treatment is to \n"
+ "open documents for editing, and create new documents from document templates. \n"
+ " -n Treats following files as templates for creation of new \n"
+ " documents. \n"
+ " -o Opens following files for editing, regardless whether \n"
+ " they are templates or not. \n"
+ " --pt {Printername} Prints following files to the printer {Printername}, \n"
+ " after which those files are closed. The splash screen \n"
+ " does not appear. If used multiple times, only last \n"
+ " {Printername} is effective for all documents of all \n"
+ " --pt runs. Also, --printer-name argument of \n"
+ " --print-to-file switch interferes with {Printername}. \n"
+ " -p Prints following files to the default printer, after \n"
+ " which those files are closed. The splash screen does \n"
+ " not appear. If the file name contains spaces, then it \n"
+ " must be enclosed in quotation marks. \n"
+ " --view Opens following files in viewer mode (read-only). \n"
+ " --show Opens and starts the following presentation documents \n"
" of each immediately. Files are closed after the showing.\n"
- " Files other than Impress documents are opened in\n"
- " default mode , regardless of previous mode.\n"
- " --convert-to OutputFileExtension[:OutputFilterName] \\\n"
- " [--outdir output_dir] [--convert-images-to]\n"
- " Batch convert files (implies --headless). If --outdir\n"
- " isn't specified, then current working directory is used\n"
- " as output_dir. If --convert-images-to is given, its\n"
+ " Files other than Impress documents are opened in \n"
+ " default mode , regardless of previous mode. \n"
+ " --convert-to OutputFileExtension[:OutputFilterName] \\ \n"
+ " [--outdir output_dir] [--convert-images-to] \n"
+ " Batch convert files (implies --headless). If --outdir \n"
+ " isn't specified, then current working directory is used \n"
+ " as output_dir. If --convert-images-to is given, its \n"
" parameter is taken as the target filter format for *all*\n"
- " images written to the output format. If --convert-to is\n"
- " used more than once, the last value of OutputFileExtension\n"
- " [:OutputFilterName] is effective. If --outdir is used more\n"
- " than once, only its last value is effective. For example:\n"
- " --convert-to pdf *.odt\n"
- " --convert-to epub *.doc\n"
+ " images written to the output format. If --convert-to is \n"
+ " used more than once, the last value of \n"
+ " OutputFileExtension[:OutputFilterName] is effective. If \n"
+ " --outdir is used more than once, only its last value is \n"
+ " effective. For example: \n"
+ " --convert-to pdf *.odt \n"
+ " --convert-to epub *.doc \n"
" --convert-to pdf:writer_pdf_Export --outdir /home/user *.doc\n"
- " --convert-to \"html:XHTML Writer File:UTF8\" \\\n"
- " --convert-images-to \"jpg\" *.doc\n"
- " --convert-to \"txt:Text (encoded):UTF8\" *.doc\n"
- " --print-to-file [--printer-name printer_name] [--outdir output_dir]\n"
+ " --convert-to \"html:XHTML Writer File:UTF8\" \\ \n"
+ " --convert-images-to \"jpg\" *.doc \n"
+ " --convert-to \"txt:Text (encoded):UTF8\" *.doc \n"
+ " --print-to-file [--printer-name printer_name] [--outdir output_dir] \n"
" Batch print files to file. If --outdir is not specified,\n"
- " then current working directory is used as output_dir.\n"
- " If --printer-name or --outdir used multiple times, only\n"
- " last value of each is effective. Also, {Printername} of\n"
- " --pt switch interferes with --printer-name.\n"
- " --cat Dump text content of the following files to console\n"
- " (implies --headless). Cannot be used with --convert-to.\n"
- " --script-cat Dump text content of any scripts embedded in the files to console\n"
- " (implies --headless). Cannot be used with --convert-to.\n"
- " -env:<VAR>[=<VALUE>] Set a bootstrap variable. For example: to set\n"
- " a non-default user profile path:\n"
- " -env:UserInstallation=file:///tmp/test\n\n"
- "Ignored switches:\n"
- " -psn Ignored (MacOS X only).\n"
- " -Embedding Ignored (COM+ related; Windows only).\n"
+ " then current working directory is used as output_dir. \n"
+ " If --printer-name or --outdir used multiple times, only \n"
+ " last value of each is effective. Also, {Printername} of \n"
+ " --pt switch interferes with --printer-name. \n"
+ " --cat Dump text content of the following files to console \n"
+ " (implies --headless). Cannot be used with --convert-to. \n"
+ " --script-cat Dump text content of any scripts embedded in the files \n"
+ " to console (implies --headless). Cannot be used with \n"
+ " --convert-to. \n"
+ " -env:<VAR>[=<VALUE>] Set a bootstrap variable. For example: to set \n"
+ " a non-default user profile path: \n"
+ " -env:UserInstallation=file:///tmp/test \n\n"
+ "Ignored switches: \n"
+ " -psn Ignored (MacOS X only). \n"
+ " -Embedding Ignored (COM+ related; Windows only). \n"
" --nofirststartwizard Does nothing, accepted only for backward compatibility.\n"
- " --protector {arg1} {arg2}\n"
- " Used only in unit tests and should have two arguments.\n\n";
+ " --protector {arg1} {arg2} \n"
+ " Used only in unit tests and should have two arguments. \n\n";
#ifdef _WIN32
namespace{
class lcl_Console {
More information about the Libreoffice-commits
mailing list