.\"
.\" tbl lyx.1 | nroff -man | less
.\"
-.TH LYX 1 "Sept 2008" "Version 1.6" "LyX 1.6"
+.TH LYX 1 "@LYX_DATE@" "Version @VERSION@" "LyX @VERSION@"
.SH NAME
-lyx \- A Document Processor
+LyX \- A Document Processor
.\"
.\" setup
.de Cr
.el \(co
..
.SH SYNOPSIS
-\fBlyx\fR [ \fIcommand\-line switches\fR ] [ \fIname[.lyx] ...\fR ]
+\fBlyx@version_suffix@\fR [ \fIcommand\-line switches\fR ] [ \fIname[.lyx] ...\fR ]
.br
.SH DESCRIPTION
\fBLyX\fR is too complex to be described completely in the "man" page
.TP
.BI \-dbg " feature[,feature...]"
where feature is a name or number.
-Use "\fBlyx \-dbg\fR" to see the list of available debug features.
+Use "\fBlyx@version_suffix@ \-dbg\fR" to see the list of available debug features.
.TP
\fB \-x [\-\-execute]\fP \fIcommand
where command is a lyx command.
\fB \-e [\-\-export]\fP \fIfmt
where fmt is the export format of choice.
Look on Tools->Preferences->File formats->Format to get an idea which parameters should be passed.
-Note that the order of -e and -x switches matters.
+Note that the order of \-e and \-x switches matters.
.TP
\fB \-i [\-\-import]\fP \fIfmt file.xxx
where fmt is the import format of choice and file.xxx is the file to be imported.
+.TP
+\fB \-f [\-\-force\-overwrite]\fP \fIwhat
+where what is is either "\fBall\fR", "\fBmain\fR" or "\fBnone\fR".
+Specify "\fBall\fR" to allow overwriting all files during a batch export,
+"\fBmain\fR" to allow overwriting the main file only, or "\fBnone\fR"
+to disallow overwriting any file. When this switch is followed by anything
+else other than "\fBall\fR", "\fBmain\fR" or "\fBnone\fR", the behavior is as
+if "\fBall\fR" was specified, but what follows is left on the command line for
+further processing.
+.TP
+\fB \-n [\-\-no\-remote]\fP
+open documents passed as arguments in a new instance, even if another
+instance of LyX is already running.
+.TP
+\fB \-r [\-\-remote]\fP
+by using the lyxpipe, ask an already running instance of LyX to open the
+documents passed as arguments and then exit. If the lyxpipe is not set up or
+is not working, a new instance is created and execution continues normally.
+.TP
+.BI \-batch
+causes LyX to run the given commands without opening a GUI window.
+Thus, something like:
+.br
+ lyx \-batch \-x "buffer\-print printer default dvips" myfile.lyx
+.br
+will cause LyX to print myfile.lyx to the default printer, using dvips and
+the default print settings (which, of course, have to have been configured
+already).
.SH ENVIRONMENT
.TP
.B LYX_LOCALEDIR
can be used to tell LyX where to look for the translations of its GUI
strings in other languages.
+
+.TP
+.B LYX_FORCE_OVERWRITE
+can be used to change the default behavior when exporting from command
+line.
+.PP
+By default, LyX overwrites the main file when exporting from command
+line but not the ancillary files. This behavior can be changed by setting
+this environment variable, which relieves the need of using the \-f switch.
+Allowed values are either "\fBall\fR", "\fBmain\fR" or "\fBnone\fR", with
+same meaning as for the \-f switch.
.SH FILES
.nf
.ta \w'\fILIBDIR\fR/lyxrc.in 'u
.I LIBDIR
is the system directory. This was at build time @real_pkgdatadir@.
.SH SEE ALSO
-tex2lyx(1), latex(1).
+tex2lyx@version_suffix@(1), latex(1).
Full documentation in either native \fBLyX\fR or postscript format.
.SH BUGS/LIMITATIONS
are having problems with!
\fBLaTeX\fR import is still not perfect and may produce buggy *.lyx
-files. Consult the \fBtex2lyx\fR documentation.
+files. Consult the \fBtex2lyx@version_suffix@\fR documentation.
.SH AUTHORS
-LyX is Copyright (C) 1995 by Matthias Ettrich, 1995-2008 LyX Team
+LyX is Copyright (C) 1995 by Matthias Ettrich, 1995-2010 LyX Team