X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Ftex2lyx%2Ftex2lyx.1in;h=3f219622a4602647970234d73f6d803d18d5b2e8;hb=237193f8a888777192981136469a5d4febb8e9d8;hp=1ac5161efbf086090a1156fa385394eb2ffac121;hpb=db9e633b7f3469f6d03bdecf7850ba653dc49061;p=lyx.git diff --git a/src/tex2lyx/tex2lyx.1in b/src/tex2lyx/tex2lyx.1in index 1ac5161efb..3f219622a4 100644 --- a/src/tex2lyx/tex2lyx.1in +++ b/src/tex2lyx/tex2lyx.1in @@ -20,8 +20,12 @@ call it from the command line only if you need to use more complicated options. .PP \fBtex2lyx\fR [ \fB\-userdir\fR \fIuserdir\fR ] [ \fB\-systemdir\fR \fIsystemdir\fR ] -[ \fB\-n\fR ] [ \fB\-c\fR \fItextclass\fR ] [\ \fB\-s\fR\ \fIsfile1\fR[,\fIsfile2\fR...]] [ -\fB\-roundtrip\fR ] \fIinputfile\fR [ \fIoutputfile\fR ] +[ \fB\-f\fR ] [ \fB\-n\fR ] [ \fB\-c\fR \fItextclass\fR ] +[ \fB\-e\fR \fIencoding\fR ] +[ \fB\-fixedenc\fR \fIencoding\fR ] +[\ \fB\-m\fR \fImodule1\fR[,\fImodule2\fR...]] +[\ \fB\-s\fR\ \fIsfile1\fR[,\fIsfile2\fR...]] [ \fB\-skipchildren\fR ] [ +\fB\-roundtrip\fR ] [ \fB\-copyfiles\fR ] \fIinputfile\fR [ \fIoutputfile\fR ] .\" .PP .\" \fBtex2lyx\fR [ \fB\-userdir\fR \fIuserdir\fR ] [ \fB\-systemdir\fR \fIsystemdir\fR ] .\" [\ \fB\-r\fR\ \fIrenv1\fR[,\fIrenv2\fR...]] [\ \fB\-s\fR\ \fIsfile1\fR[,\fIsfile2\fR...]] @@ -40,22 +44,35 @@ matter or \f(CW\ebegin{document}\fR command. LyX files created by \fBtex2lyx\fR from partial files can be included in an existing LyX file using the \*[lq]Include LyX File\*[rq] command from LyX's Insert menu. .TP +.BI \-m +Module. Load the given modules. This is useful if \fBtex2lyx\fR does not +automatically detect a given module, but you know the modules that provide +some commands or environments that are used in the imported file. The modules +are loaded in the given order. If a module \fIfoo\fR depends on a module +\fIbar\fR, \fIbar\fR must be given before \fIfoo\fR. +.TP .BI \-f Force. \fBtex2lyx\fR will not run if the .lyx file it would generate already exists. Use the \fB\-f\fR option (carefully) to clobber any existing files. .TP +.BI \-e +Specify the default encoding using the LaTeX name as defined in the encodings +file. \fBtex2lyx\fR will use this encoding, but switch if it finds any encoding +changing commands in the input. +.TP +.BI \-fixedenc +Specify the encoding using the LaTeX name as defined in the encodings file. +\fBtex2lyx\fR will ignore any encoding changing commands in the input. +.TP .BI \-n Noweb. Translate a noweb (aka literate programming) file. This should be (almost?) equivalent to running \*[lq]noweb2lyx foo.tex foo.lyx\*[rq]. This option requires the \fB\-c\fR option. -.\" .TP -.\" .BI \-r -.\" Regular environments (see the section on \fISyntax Files\fR). If you give more than one -.\" environment, separate them with commas (not spaces). You'll probably need to -.\" quote the environment list, especially if it has asterisk environments (foo*) -.\" in it. If you use this command often, considering creating a personal syntax -.\" file. (\fBNOTE\fR: this feature of the older \fBreLyX\fR script has -.\" not yet been implemented in \fBtex2lyx\fR). +.TP +.BI \-skipchildren +Do not translate child documents included via \f(CW\einclude\fR and \f(CW\einput\fR. +This option is useful if the child documents are generated files and/or contain many +commands that \fBtex2lyx\fR does not understand yet. .TP .BI \-s Syntax files. Input (one or more quoted, comma-separated) syntax files to read @@ -70,12 +87,21 @@ Specify a user directory. Normally, you shouldn't need this. Your LyX user direc chosen. Cf. the section \f(CWFILES\fR for details. .TP .BI \-roundtrip -Call LyX to re-export the created output file to LaTeX. The output file name -is always determined automatically to avoid over-writing the input file by -accident: If the input file is named \fIfoo.tex\fR the output file will be +Call LyX to re-export the created output file to LaTeX. If the output file name +is not given it is determined automatically to avoid over-writing the input file +by accident: If the input file is named \fIfoo.tex\fR the output file will be named \fIfoo.lyx.lyx\fR, and the re-exported file will be named \fIfoo.lyx.tex\fR. .TP +.BI \-copyfiles +Copy all included files \fBtex2lyx\fR is +aware of to the output directory if the output file is located in a different +directory than the input file. This is useful if you want to ensure that no +included file is overwritten (either in roundtrip mode or by a later export +from LyX). Please note that the resulting document may be uncompilable. This +happens if it needs files that \fBtex2lyx\fR does not know about and therefore +does not copy to the output directory. +.TP .BI \-help Help. Print out usage information and quit. .TP @@ -404,10 +430,14 @@ is your personal LyX directory, then the following files are read by tex2lyx: User's personal layout files for document classes .IP "\fI\s-1MY_LYXDIR\s0\fR/syntax.default" 4 User's personal syntax file +.IP "\fI\s-1MY_LYXDIR\s0\fR/encodings" 4 +User's personal encoding definition file .IP "\fI\s-1LIBDIR\s0\fR/layouts/*.layout" 4 System-wide layout files for document classes .IP "\fI\s-1LIBDIR\s0\fR/lib/syntax.default" 4 System-wide LaTeX syntax file +.IP "\fI\s-1LIBDIR\s0\fR/lib/encodings" 4 +System-wide encoding definition file .SH "SEE ALSO" \fIlyx@version_suffix@\fR\|(1), \fIlatex\fR\|(1) .SH "AUTHORS"