Skip to content

C
core
Kaydet (Commit) d78f29ab authored tarafından tagezi's avatar tagezi Kaydeden (comit) Mike Kaganski
Dosyalara gözat
Seçenekler

tdf#100836 "Starting the LibreOffice Software With Parameters" help update 

rewritten cmdHelp in accordance with the attached document in bug tdf#100836

Change-Id: I6453ee87039272388fe1bc0efd747dc706b570ff
Reviewed-on: https://gerrit.libreoffice.org/31244Reviewed-by: 's avatarMike Kaganski <mike.kaganski@collabora.com>
Tested-by: 's avatarMike Kaganski <mike.kaganski@collabora.com>
üst db7435c2
Hide whitespace changes
Inline Side-by-side
Showing with 124 additions and 69 deletions
desktop/source/app/cmdlinehelp.cxx
Dosyayı görüntüle @ d78f29ab
...@@ -38,75 +38,130 @@ namespace desktop ...@@ -38,75 +38,130 @@ namespace desktop
"%PRODUCTNAME %PRODUCTVERSION%PRODUCTEXTENSION %BUILDID\n" "%PRODUCTNAME %PRODUCTVERSION%PRODUCTEXTENSION %BUILDID\n"
"\n"; "\n";
const char aCmdLineHelp[] = const char aCmdLineHelp[] =
"Usage: %CMDNAME [options] [documents...]\n" "Usage: %CMDNAME [argument...]\n"
"\n" " argument - switches, switch parameters and document URIs (filenames).\n\n"
"Options:\n" "Getting help and information:\n"
"--minimized keep startup bitmap minimized.\n" " --help | -h | -? Shows this help and quits.\n"
"--invisible no startup screen, no default document and no UI.\n" " --helpwriter Opens built-in or online Help on Writer.\n"
"--norestore suppress restart/restore after fatal errors.\n" " --helpcalc Opens built-in or online Help on Calc.\n"
"--quickstart starts the quickstart service\n" " --helpdraw Opens built-in or online Help on Draw.\n"
"--safe-mode starts the safe mode\n" " --helpimpress Opens built-in or online Help on Impress.\n"
"--nologo don't show startup screen.\n" " --helpbase Opens built-in or online Help on Base.\n"
"--nolockcheck don't check for remote instances using the installation\n" " --helpbasic Opens built-in or online Help on Basic scripting\n"
"--nodefault don't start with an empty document\n" " language.\n"
"--headless like invisible but no user interaction at all.\n" " --helpmath Opens built-in or online Help on Math.\n"
"--help/-h/-? show this message and exit.\n" " --version Shows the version and quits.\n"
"--version display the version information.\n" " --nstemporarydirectory\n"
"--writer create new text document.\n" " (MacOS X sandbox only) Returns path of the temporary\n"
"--calc create new spreadsheet document.\n" " directory for the current user and exits. Overrides\n"
"--draw create new drawing.\n" " all other arguments.\n\n"
"--impress create new presentation.\n" "General arguments:\n"
"--base create new database.\n" " --quickstart[=no] Activates[Deactivates] the Quickstarter service.\n"
"--math create new formula.\n" " --nolockcheck Disables check for remote instances using one\n"
"--global create new global document.\n" " installation.\n"
"--web create new HTML document.\n" " --infilter={filter} Force an input filter type if possible. For example:\n"
"-o open documents regardless whether they are templates or not.\n" " --infilter=\"Calc Office Open XML\"\n"
"-n always open documents as new files (use as template).\n" " --infilter=\"Text (encoded):UTF8,LF,,,\"\n"
"--display <display>\n" " --pidfile={file} Store soffice.bin pid to {file}.\n"
" Specify X-Display to use in Unix/X11 versions.\n" " --display {display} Sets the DISPLAY environment variable on UNIX-like\n"
"-p <documents...>\n" " platforms to the value {display} (only supported by a\n"
" print the specified documents on the default printer.\n" " start script).\n\n"
"--pt <printer> <documents...>\n" "User/programmatic interface control:\n"
" print the specified documents on the specified printer.\n" " --nologo Disables the splash screen at program start.\n"
"--view <documents...>\n" " --minimized Starts minimized. The splash screen is not displayed.\n"
" open the specified documents in viewer-(readonly-)mode.\n" " --nodefault Starts without displaying anything except the splash\n"
"--show <presentation>\n" " screen (do not display initial window).\n"
" open the specified presentation and start it immediately\n" " --invisible Starts in invisible mode. Neither the start-up logo nor\n"
"--language=<language_tag>\n" " the initial program window will be visible. Application\n"
" Override the UI language with the given locale\n" " can be controlled, and documents and dialogs can be\n"
" Eg. --language=fr\n" " controlled and opened via the API. Using the parameter,\n"
"--accept=<accept-string>\n" " the process can only be ended using the taskmanager\n"
" Specify an UNO connect-string to create an UNO acceptor through which\n" " (Windows) or the kill command (UNIX-like systems). It\n"
" other programs can connect to access the API\n" " cannot be used in conjunction with --quickstart.\n"
"--unaccept=<accept-string>\n" " --headless Starts in \"headless mode\" which allows using the\n"
" Close an acceptor that was created with --accept=<accept-string>\n" " application without GUI. This special mode can be used\n"
" Use --unnaccept=all to close all open acceptors\n" " when the application is controlled by external clients\n"
"--infilter=<filter>[:filter_options]\n" " via the API.\n"
" Force an input filter type if possible\n" " --norestore Disables restart and file recovery after a system crash.\n"
" Eg. --infilter=\"Calc Office Open XML\"\n" " --safe-mode Starts in a safe mode, i.e. starts temporarily with a\n"
" --infilter=\"Text (encoded):UTF8,LF,,,\"\n" " fresh user profile and helps to restore a broken\n"
"--convert-to output_file_extension[:output_filter_name[:output_filter_options]] [--outdir output_dir] files\n" " configuration.\n"
" Batch convert files (implies --headless).\n" " --accept={UNO-URL} Specifies an UNO-URL connect-string to create an UNO\n"
" If --outdir is not specified then current working dir is used as output_dir.\n" " acceptor through which other programs can connect to\n"
" Eg. --convert-to pdf *.doc\n" " access the API. UNO-URL is string the such kind\n"
" --convert-to pdf:writer_pdf_Export --outdir /home/user *.doc\n" " uno:connection-type,params;protocol-name,params;ObjectName.\n"
" --convert-to \"html:XHTML Writer File:UTF8\" *.doc\n" " --unaccept={UNO-URL} Closes an acceptor that was created with --accept. Use\n"
" --convert-to \"txt:Text (encoded):UTF8\" *.doc\n" " --unaccept=all to close all open acceptors.\n"
"--print-to-file [-printer-name printer_name] [--outdir output_dir] files\n" " --language={lang} Uses specified language, if language is not selected\n"
" Batch print files to file.\n" " yet for UI. The lang is a tag of the language in IETF\n"
" If --outdir is not specified then current working dir is used as output_dir.\n" " language tag.\n\n"
" Eg. --print-to-file *.doc\n" "Developer arguments:\n"
" --print-to-file --printer-name nasty_lowres_printer --outdir /home/user *.doc\n" " --terminate_after_init\n"
"--cat files\n" " Exit after initialization complete (no documents loaded).\n"
" Dump text content of the files to console\n" " --eventtesting Exit after loading documents.\n\n"
" Eg. --cat *.odt\n" "New document creation arguments:\n"
"--pidfile=file\n" "The arguments create an empty document of specified kind. Only one of them may\n"
" Store soffice.bin pid to file.\n" "be used in one command line. If filenames are specified after an argument,\n"
"-env:<VAR>[=<VALUE>]\n" "then it tries to open those files in the specified component.\n"
" Set a bootstrap variable.\n" " --writer Creates an empty Writer document.\n"
" Eg. -env:UserInstallation=file:///tmp/test to set a non-default user profile path.\n" " --calc Creates an empty Calc document.\n"
"\nRemaining arguments will be treated as filenames or URLs of documents to open.\n\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] [--outdir output_dir]\n"
" Batch convert files (implies --headless). If --outdir\n"
" isn't specified, then current working directory is used\n"
" as output_dir. If --convert-to is used more than once,\n"
" last value of OutputFileExtension[:OutputFilterName] is\n"
" effective. If --outdir is used more than once, only its\n"
" last value is effective. For example:\n"
" --convert-to pdf *.doc\n"
" --convert-to pdf:writer_pdf_Export --outdir /home/user *.doc\n"
" --convert-to \"html:XHTML Writer File:UTF8\" *.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"
" -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";
#ifdef _WIN32 #ifdef _WIN32
namespace{ namespace{
class lcl_Console { class lcl_Console {
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment