sysui/desktop/man/libreoffice.1

   1 .TH libreoffice "1" "2010-12-18" "LibreOffice" "User Commands"
   2 .SH Name
   3 libreoffice \- LibreOffice office suite
   4
   5 .SH SYNOPSIS
   6 .B libreoffice
   7 [\fB\-\-accept\=\fIaccept\-string\fR] [\fB\-\-base\fR] [\fB\-\-calc\fR]
   8 [\fB\-\-convert\-to\fR output_file_extension[:output_filter_name] [\-\-outdir output_dir] \fIfile\fR]...
   9 [\fB\-\-display \fIdisplay\fR] [\fB\-\-draw\fR] [\fB\-\-global\fR] [\fB\-\-headless\fR]
  10 [\fB\-\-help\fR|\fB\-h\fR|\fB\-?\fR] [\fB\-\-impress\fR] [\fB\-\-invisible\fR] [\fB\-\-infilter="<filter>"\fR]
  11 [\fB\-\-math\fR] [\fB\-\-minimized\fR] [\fB\-n \fIfile\fR]... [\fB\-\-nodefault\fR]
  12 [\fB\-\-nolockcheck\fR] [\fB\-\-nologo\fR] [\fB\-\-norestore\fR]
  13 [\fB\-o \fIfile\fR]... [\fB\-p \fIfile\fR...]
  14 [\fB\-\-print\-to\-file [\-\-printer\-name printer_name] [\-\-outdir output_dir] file]...
  15 [\fB\-\-pt \fIprintername\fR \fIfile\fR...]
  16 [\fB\-\-show \fIImpress file\fR]... [\fB\-\-unaccept=\fIaccept\-string\fR]
  17 [\fB\-\-terminate_after_init\fR] [\fB\-\-view \fIfile\fR]... [\fB\-\-web\fR]
  18 [\fB\-\-writer\fR]  [\fIfile\fR...]
  19 .br
  20 .B lobase
  21 .br
  22 .B localc
  23 .br
  24 .B lodraw
  25 .br
  26 .B lofromtemplate
  27 .br
  28 .B loimpress
  29 .br
  30 .B lomath
  31 .br
  32 .B loweb
  33 .br
  34 .B lowriter
  35 .br
  36
  37 .SH DESCRIPTION
  38 LibreOffice (LO for short) is a multi-platform office productivity suite.
  39 It was derived from OpenOffice.org 3.3 Beta on September 28, 2010.
  40
  41 \fBlibreoffice\fR is a shell script that sets up the environment and
  42 passes the command line arguments to the \fBsoffice.bin\fR binary.
  43
  44 Alternatively, the following helper scripts start the respective module:
  45
  46 sbase, scalc, sdraw, simpress, smath, sofficerc, swriter
  47
  48 .SH OPTIONS
  49 .TP
  50 \fB\-\-accept=\fIaccept\-string\fR
  51 Specifies a UNO-URL connect-string to create a UNO acceptor through which other
  52 programs can connect to access the API. Note that API access allows execution
  53 of arbitrary commands.
  54 The syntax of a UNO-URL connect-string is:
  55 \fIuno:connection-type,params;protocol-name,params;ObjectName\fR
  56
  57 .TP
  58 \fB\-\-base\fR
  59 Starts the wizard for a new Base document.
  60
  61 .TP
  62 \fB\-\-calc\fR
  63 Starts with a new Calc document.
  64
  65 .TP
  66 \fB\-\-convert\-to\fR output_file_extension[:output_filter_name] [\-\-outdir output_dir] \fIfile\fR...
  67 Batch converts files.
  68 If \fI\-\-outdir\fR is not specified then the current working directory is used as the output directory
  69 for the converted files. It implies \fI\-\-headless\fR.
  70
  71 Examples:
  72
  73 \fB\-\-convert\-to\fR pdf *.doc
  74
  75 Converts all .doc files to PDFs.
  76
  77 \fB\-\-convert\-to\fR pdf:writer_pdf_Export \-\-outdir /home/user *.doc
  78
  79 Converts all .doc files to PDFs using the settings in the Writer PDF export dialog and saving them
  80 in /home/user.
  81
  82 .TP
  83 \fB\-\-display \fIdisplay\fR
  84 This option specifies the X server to use; see \fBX\fR(7)
  85
  86 .TP
  87 \fB\-\-draw\fR
  88 Starts with a new Draw document.
  89
  90 .TP
  91 \fB\-\-global\fR
  92 Starts with a new Global document.
  93
  94 .TP
  95 \fB\-\-headless\fR
  96 Starts in "headless mode", which allows using the application without user a
  97 interface.
  98
  99 This special mode can be used when the application is controlled by external
 100 clients via the API.
 101
 102 It implies \-\-invisible and strictly ignores any GUI environment.
 103 \-\-quickstart does not work with this parameter.
 104
 105 .TP
 106 \fB\-\-help\fR|\fB\-h\fR|\fB\-?\fR
 107 Lists LibreOffice command line parameters.
 108
 109 .TP
 110 \fB\-\-impress\fR
 111 Starts with a new Impress document.
 112
 113 .TP
 114 \fB\-\-invisible\fR
 115 Starts in invisible mode.
 116
 117 Neither the start\-up logo nor the initial program window will be visible.
 118 LO can be controlled and documents and dialogs can be opened via the API.
 119
 120 When started with this parameter, it can only be quit using the taskmanager (Windows)
 121 or the kill command (UNIX based systems).
 122
 123 \-\-quickstart does not work with this parameter.
 124
 125 .TP
 126 \fB\-\-infilter="<filter>"\fR
 127 Force an input filter type if possible.
 128 For example \-\-infilter="Calc Office Open XML" only
 129
 130 .TP
 131 \fB\-\-math\fR
 132 Starts with a new Math document.
 133
 134 .TP
 135 \fB\-\-minimized\fR
 136 Keeps the splash screen minimized.
 137
 138 .TP
 139 \fB\-n \fItemplate\fR...
 140 Creates the a new document from the given templates.
 141
 142 .TP
 143 \fB\-\-nodefault\fR
 144 Starts LO without creating a new document.
 145 The next time you start LO, the welcome screen is shown.
 146
 147 It's used together with \fB\-\-nologo\fR by quick starters. Note that \fB\-\-quickstart\fR
 148 has no longer been supported since OpenOffice.org 2.0.0.
 149
 150 .TP
 151 \fB\-\-nolockcheck\fR
 152 Disables the check for remote instances using the installation.
 153
 154 .TP
 155 \fB\-\-nologo\fR
 156 Disables the splash screen at program start.
 157
 158 .TP
 159 \fB\-\-norestore\fR
 160 Disables restart and file recovery after a system crash. It is possible that LO
 161 will try to restore a file it keeps crashing on, if that happens \fB\-\-norestore\fR
 162 is the only way to start LO.
 163
 164 .TP
 165 \fB\-\-nosplash\fR
 166 Disables the splash screen at program start.
 167
 168 .TP
 169 \fB\-o \fIfile\fR...
 170 Opens the given files for editing, even templates.
 171
 172 Without \fB\-o\fR a template file would create a new document derived from that template.
 173
 174 .TP
 175 \fB\-p \fIfile\fR...
 176 Prints the given files to the default printer and ends. The splash screen
 177 does not appear.
 178
 179 If the file name contains spaces, then it must be enclosed in quotation marks.
 180
 181 .TP
 182 \fB\-\-print\-to\-file [\-\-printer\-name printer_name] [\-\-outdir output_dir] file...
 183 Batch print files to file.
 184 If \-\-printer\-name is not specified the default printer is used.
 185 If \-\-outdir is not specified then the current working directory is used as the output directory
 186 for the converted files.
 187
 188 Examples:
 189
 190 \-\-print\-to\-file *.doc
 191
 192 Prints all .doc files to the current working directory using the default printer.
 193
 194 \-\-print\-to\-file \-\-printer\-name nasty_lowres_printer \-\-outdir /home/user *.doc
 195
 196 Prints all .doc files to /home/user directory using the nasty_lowres_printer.
 197
 198 .TP
 199 \fB\-\-pt \fIprintername\fR \fIfile\fR...
 200 Prints the given files to the printer \fIprintername\fR and ends. The splash
 201 screen does not appear.
 202
 203 If a file name contains spaces, then it must be enclosed in quotation marks.
 204
 205 .TP
 206 \fB\-\-quickstart \fB\-\-quickstart=no
 207 Starts LO with its quick starter.
 208 \fB\-\-quickstart disable the quick starter.
 209
 210 Does not work with \-\-invisible or \-\-headless.
 211
 212 .TP
 213 \fB\-\-show \fIImpress file\fR...
 214 Opens the given Impress files, starts the presentation and quits after they have finished.
 215
 216 .TP
 217 \fB\-\-unaccept=\fIaccept\-string\fR
 218 Closes an acceptor that was created with \fB\-\-accept\fR option.
 219
 220 Use \fB\-\-unaccept\fR=\fIall\fR to close all open acceptors.
 221
 222 .TP
 223 \fB\-\-terminate_after_init\fR
 224 Starts LO and terminates after it registers some UNO services.
 225 Doesn't show the splash during startup.
 226
 227 .TP
 228 \fB\-\-view \fIfile\fR...
 229 Opens the given files read-only creating a temporary copy of them at $TMPDIR.
 230
 231 .TP
 232 \fB\-\-web\fR
 233 Starts with a new HTML document.
 234
 235 .TP
 236 \fB\-\-writer\fR
 237 Starts with a new Writer document.
 238
 239 .SH TROUBLESHOOTING PROBLEMS
 240 See \fBhttp://wiki.documentfoundation.org/BugReport\fR for more details on how to report
 241 bugs in LibreOffice.
 242 .SH SEE ALSO
 243 .BR http://www.documentfoundation.org/
 244
 245 .SH AUTHOR
 246 This manual page was created by Rene Engelhard <rene@debian.org> for
 247 the Debian GNU/Linux Distribution, because the original package does not have
 248 one. It was updated for Novell by Petr Mladek <petr.mladek@novell.com> and
 249 adapted for LibreOffice by Philipp Weissenbacher <philipp.weissenbacher@gmail.com>.