Starting the $[officename] Software With Parameters

start parameters command line parameters parameters;command line arguments in command line Starting the $[officename] Software With Parameters By starting the $[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. 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 the $[officename] software technology. More information on this topic can be found at www.openoffice.org. Starting the $[officename] Software From the Command Line Under Windows, select Run from the Windows Start menu, or open a Shell under UNIX® based platforms. Under Windows, type the following text in the Open text field and click OK. Under UNIX based systems, type the following line of text, then press Return: {install}\program\soffice.exe {parameter} {install}/program/soffice {parameter} Replace {install} with the path to your installation of the $[officename] software (for example, C:\Program Files\Office, or ~/office) Where required, replace {parameter} with one or more of the following command line parameters. Valid Command Line Parameters Parameter Meaning -help / -h / -? Lists the available command line parameters in a dialog box to the console. -help shows a long help text, -h shows a short help text. -writer Starts with an empty Writer document. -calc Starts with an empty Calc document. -draw Starts with an empty Draw document. -impress Starts with an empty Impress document. -math Starts with an empty Math document. -global Starts with an empty global document. -web Starts with an empty HTML document. -show {filename.odp} Starts with the Impress file {filename.odp} and starts the presentation. Enters edit mode after the presentation. -minimized Starts minimized. The splash screen is not displayed. -invisible Starts in invisible mode. Neither the start-up logo nor the initial program window will be visible. However, the $[officename] software can be controlled and documents and dialogs opened via the API. When the $[officename] software has been started with this parameter, it can only be ended using the taskmanager (Windows) or the kill command (UNIX based systems). It cannot be used in conjunction with -quickstart. More information is found in the $[officename] Developer's Guide. -nocrashreport Disables the error report tool. -norestore Disables restart and file recovery after a system crash. -quickstart Activates the Quickstarter on Windows systems. The splash screen is not displayed. -terminate_after_init Registers some UNO services and ends. The splash screen does not appear. More information is found in the $[officename] Developer's Guide. -accept={UNO string} Notifies the $[officename] software that upon the creation of "UNO Acceptor Threads", a "UNO Accept String" will be used. More information is found in the $[officename] Developer's Guide. -userid={user id} Specifies a user's directory that is used instead of the data from the soffice.ini, bootstrap.ini and sversion.ini files. More information is found in the $[officename] Developer's Guide. -p {filename1} {filename2} ... Prints the files {filename1} {filename2} ... to the default printer and ends. The splash screen does not appear. If the file name contains spaces, then it must be enclosed in quotation marks. -pt {Printername} {filename1} {filename2} ... Prints the files {filename1} {filename2} ... to the printer {Printername} and ends. The splash screen does not appear. If the file name contains spaces, then it must be enclosed in quotation marks. -o {filename} Opens {filename} for editing, even if it is a template. -view {filename} Creates a temporary copy of {filename} and opens it read-only. -n {filename} Creates a new document using {filename} as a template. -nologo Disables the splash screen at program start. -nodefault Opens the backing window. The backing window opens also when you call the program file directly without any start parameter. -display {display} Sets the DISPLAY environment variable on UNIX based platforms to the value {display}. This parameter is only supported by the start script for the $[officename] software on UNIX based platforms. -headless Starts in "headless mode" which allows using the application without user interface. This special mode can be used when the application is controlled by external clients via the API.