diff options
author | Karl Berry <karl@freefriends.org> | 2011-12-05 00:23:53 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-12-05 00:23:53 +0000 |
commit | a3820a32b1f8c604520d9fcf34069b4e0a73a89a (patch) | |
tree | c70af98636c9e2fdff4f6e0b721cb93fed1b5afc /Master/texmf/doc/man | |
parent | 757da55142bf500fb11d5e9567bf1cec3b1dc18b (diff) |
mkjobtexmf 0.8 (11nov11)
git-svn-id: svn://tug.org/texlive/trunk@24758 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man')
-rw-r--r-- | Master/texmf/doc/man/man1/mkjobtexmf.1 | 190 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/mkjobtexmf.man1.pdf | bin | 13195 -> 14582 bytes |
2 files changed, 138 insertions, 52 deletions
diff --git a/Master/texmf/doc/man/man1/mkjobtexmf.1 b/Master/texmf/doc/man/man1/mkjobtexmf.1 index bba1d5d41b8..b3fa622580f 100644 --- a/Master/texmf/doc/man/man1/mkjobtexmf.1 +++ b/Master/texmf/doc/man/man1/mkjobtexmf.1 @@ -129,9 +129,12 @@ .\" ======================================================================== .\" .IX Title "MKJOBTEXMF 1" -.TH MKJOBTEXMF 1 "2008-06-28" "perl v5.8.1" "User Contributed Perl Documentation" +.TH MKJOBTEXMF 1 "2011-11-10 v0.8" "perl v5.8.1" "User Contributed Perl Documentation" .SH "NAME" mkjobtexmf \-\- Generate a texmf tree for a particular job +.SH "VERSION" +.IX Header "VERSION" +2011\-11\-10 v0.8 .SH "SYNOPSIS" .IX Header "SYNOPSIS" The progam \fBmkjobtexmf\fR runs a program and tries to @@ -160,7 +163,7 @@ instead of TeX. As method only program \fBstrace\fR is available. .PP Options: .PP -.Vb 22 +.Vb 25 \& --jobname <name> Name of the job (mandatory). \& Usually this is the TeX file \& without extension @@ -176,6 +179,8 @@ Options: \& symbol links \& --flat Junk paths, do not make directories \& inside the destination directory +\& --(no)texhash Run texhash, use --notexhash for MiKTeX +\& --exclude-ext <ext> Exclude files with extension <ext>. \& --cmd-tex <cmd> Command for the TeX compiler \& --cmd-kpsewhich <cmd> Command for kpsewhich \& --cmd-texhash <cmd> Command for texhash @@ -183,13 +188,14 @@ Options: \& --verbose Verbose output \& --help Brief help message \& --man Full documentation +\& --version Print version identification .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" .Sh "Running the program" .IX Subsection "Running the program" First \fBmkjobtexmf\fR runs a program, usually TeX. The TeX compiler -is configured by option \fB\-\-cmd\-tex\fR. Option \fB\-\-texname\fR can +is configured by option \f(CW\*(C`\-\-cmd\-tex\*(C'\fR. Option \f(CW\*(C`\-\-texname\*(C'\fR can be used, if the file name extension differs from \fI.tex\fR: .PP .Vb 1 @@ -234,61 +240,89 @@ result directory \fI\fIjobname\fI.mjt\fR. Absolute file names are not supported and neither paths with links to parent directories. .PP Symbolic links are created by default. The files are copied -if option \-\-copy is given or symbolic linking is not available. +if option \f(CW\*(C`\-\-copy\*(C'\fR is given or symbolic linking is not available. .SH "OPTIONS" .IX Header "OPTIONS" -.IP "\fB\-\-jobname\fR=\fIjobname\fR" 4 -.IX Item "--jobname=jobname" -It is the name of the job. `<jobname>.tex' serves as default for -the TeX file and <jobname> is used for naming various directories +.IP "\fB\-\fR\fB\-jobname\fR=<\fIjobname\fR>" 4 +.IX Item "--jobname=<jobname>" +It is the name of the job. `<\fIjobname\fR>.tex' serves as default for +the TeX file and <\fIjobname\fR> is used for naming various directories and files. See section \*(L"\s-1FILES\s0\*(R". -.IP "\fB\-\-texname\fR=\fIname\fR" 4 -.IX Item "--texname=name" -The name of the TeX input file, if it differs from <jobname>.tex. -.IP "\fB\-\-texopt\fR=\fIopt\fR" 4 -.IX Item "--texopt=opt" -Additional option for the TeX compiler, examples are \-\-ini or -\&\-\-shell\-escape. This option can be given more than once. -.IP "\fB\-\-destdir\fR=\fIdirectory\fR" 4 -.IX Item "--destdir=directory" +.IP "\fB\-\fR\fB\-texname\fR=<\fIname\fR>" 4 +.IX Item "--texname=<name>" +The name of the TeX input file, if it differs from <\fIjobname\fR>.tex. +.IP "\fB\-\fR\fB\-texopt\fR=<\fIopt\fR>" 4 +.IX Item "--texopt=<opt>" +Additional option for the TeX compiler, examples are \f(CW\*(C`\-\-ini\*(C'\fR or +\&\f(CW\*(C`\-\-shell\-escape\*(C'\fR. This option can be given more than once. +.IP "\fB\-\fR\fB\-destdir\fR=<\fIdirectory\fR>" 4 +.IX Item "--destdir=<directory>" Specifies the name of the destination directory where the result is collected. As default a directory is generated in the current directory with the job name and extension `.mjt'. -.IP "\fB\-\-output\fR" 4 +.IP "\fB\-\fR\fB\-output\fR" 4 .IX Item "--output" Also add output files. -.IP "\fB\-\-strace\fR" 4 +.IP "\fB\-\fR\fB\-strace\fR" 4 .IX Item "--strace" Use method with program \fBstrace\fR, see \*(L"\s-1DESCRIPTION\s0\*(R". -.IP "\fB\-\-copy\fR" 4 +.IP "\fB\-\fR\fB\-copy\fR" 4 .IX Item "--copy" Files are copied instead of creating symbolic links. -.IP "\fB\-\-flat\fR" 4 +.IP "\fB\-\fR\fB\-flat\fR" 4 .IX Item "--flat" Files are linked or copied without path elements. The destination directory will contain a flat list of files or links without directory. .Sp The files `ls\-R' and `aliases' are ignored. -.IP "\fB\-\-cmd\-tex\fR=\fIcmd\fR" 4 -.IX Item "--cmd-tex=cmd" +.IP "\fB\-\fR\fB\-exclude\-ext\fR=<\fIext\fR>" 4 +.IX Item "--exclude-ext=<ext>" +Files with extension <\fIext\fR> are excluded. The option can be +given several times or a comma separated list of extensions +can be used. Examples: +.Sp +.Vb 1 +\& --exclude-ext aux --exclude-ext log --exclude-ext toc +.Ve +.Sp +is the same as +.Sp +.Vb 1 +\& --exclude-ext aux,log,toc +.Ve +.IP "\fB\-\fR\fB\-(no)texhash\fR" 4 +.IX Item "--(no)texhash" +As default the file `ls\-R' is generated in the `texmf' tree, +because this is the file name database that might be used +in TeX Live. Because MiKTeX uses a different mechanism, its +`texhash' does not generate the `ls\-R' files and \f(CW\*(C`\-\-notexhash\*(C'\fR +suppresses the call of `texhash'. +.IP "\fB\-\fR\fB\-cmd\-tex\fR=<\fIcmd\fR>" 4 +.IX Item "--cmd-tex=<cmd>" Command for the TeX compiler. Default is pdflatex. -.IP "\fB\-\-cmd\-kpsewhich\fR=\fIcmd\fR" 4 -.IX Item "--cmd-kpsewhich=cmd" +.IP "\fB\-\fR\fB\-cmd\-kpsewhich\fR=<\fIcmd\fR>" 4 +.IX Item "--cmd-kpsewhich=<cmd>" Command for kpsewhich. -.IP "\fB\-\-cmd\-texhash\fR=\fIcmd\fR" 4 -.IX Item "--cmd-texhash=cmd" +.IP "\fB\-\fR\fB\-cmd\-texhash\fR=<\fIcmd\fR>" 4 +.IX Item "--cmd-texhash=<cmd>" Command for updating the file name database of the generated texmf tree. Default is texmf. -.IP "\fB\-\-cmd\-strace\fR=\fIcmd\fR" 4 -.IX Item "--cmd-strace=cmd" +.IP "\fB\-\fR\fB\-cmd\-strace\fR=<\fIcmd\fR>" 4 +.IX Item "--cmd-strace=<cmd>" Command for strace. -.IP "\fB\-\-verbose\fR" 4 +.IP "\fB\-\fR\fB\-verbose\fR" 4 .IX Item "--verbose" Verbose messages. -.IP "\fB\-\-help\fR" 4 +.IP "\fB\-\fR\fB\-help\fR" 4 .IX Item "--help" Display help screen. +.IP "\fB\-\fRB(\-man>" 4 +.IX Item "-B(-man>" +Print manual page. +.IP "\fB\-\fR\fB\-version\fR" 4 +.IX Item "--version" +Print version identification and exit. .SH "EXAMPLES" .IX Header "EXAMPLES" TeX file \fItest.tex\fR using TeX's recorder method: @@ -369,7 +403,7 @@ file recording (e.g. pdfTeX 1.40.3 does not record .pfb and .IX Item "<jobname>.mjt/" .PD Directory where the resulting texmf tree and symbol links -are stored. It can be changed by option \-\-destdir. +are stored. It can be changed by option \f(CW\*(C`\-\-destdir\*(C'\fR. .IP "\fI<jobname>.fls\fR" 4 .IX Item "<jobname>.fls" Name of TeX's recorder file. @@ -378,38 +412,90 @@ Name of TeX's recorder file. Log file where the result of \fBstrace\fR is stored. .SH "AUTHOR" .IX Header "AUTHOR" -Heiko Oberdiek, email: oberdiek at uni\-freiburg.de +Heiko Oberdiek, email: heiko.oberdiek at googlemail.com .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" -Copyright 2007 by Heiko Oberdiek. +Copyright 2007, 2008, 2011 by Heiko Oberdiek. .PP This library is free software; you may redistribute it and/or modify it under the same terms as Perl itself (Perl Artistic License/GNU General Public License, version 2). .SH "HISTORY" .IX Header "HISTORY" -.IP "2007/04/16 v0.1" 4 +.IP "\fB2007/04/16 v0.1\fR" 2 .IX Item "2007/04/16 v0.1" -* First experimental version. -.IP "2007/05/09 v0.2" 4 +.RS 2 +.PD 0 +.IP "* First experimental version." 2 +.IX Item "First experimental version." +.RE +.RS 2 +.RE +.IP "\fB2007/05/09 v0.2\fR" 2 .IX Item "2007/05/09 v0.2" -* Typo in option name fixed. -.IP "2007/09/03 v0.3" 4 +.RS 2 +.IP "* Typo in option name fixed." 2 +.IX Item "Typo in option name fixed." +.RE +.RS 2 +.RE +.IP "\fB2007/09/03 v0.3\fR" 2 .IX Item "2007/09/03 v0.3" -* New options: \-\-copy, \-\-flat, \-\-destdir -.IP "2007/09/04 v0.4" 4 +.RS 2 +.ie n .IP "* New options: ""\-\-copy""\fR, \f(CW""\-\-flat""\fR, \f(CW""\-\-destdir""" 2 +.el .IP "* New options: \f(CW\-\-copy\fR, \f(CW\-\-flat\fR, \f(CW\-\-destdir\fR" 2 +.IX Item "New options: --copy, --flat, --destdir" +.RE +.RS 2 +.RE +.IP "\fB2007/09/04 v0.4\fR" 2 .IX Item "2007/09/04 v0.4" -* Bug fix in map_files_texmf. -.IP "2007/09/06 v0.5" 4 +.RS 2 +.IP "* Bug fix in map_files_texmf." 2 +.IX Item "Bug fix in map_files_texmf." +.RE +.RS 2 +.RE +.IP "\fB2007/09/06 v0.5\fR" 2 .IX Item "2007/09/06 v0.5" -* Support for `configure' added. - (Thanks to Norbert Preining for writing a first version of - the configure stuff.) -.IP "2008/04/05 v0.6" 4 +.RS 2 +.IP "* Support for `configure' added. (Thanks to Norbert Preining for writing a first version of the configure stuff.)" 2 +.IX Item "Support for `configure' added. (Thanks to Norbert Preining for writing a first version of the configure stuff.)" +.RE +.RS 2 +.RE +.IP "\fB2008/04/05 v0.6\fR" 2 .IX Item "2008/04/05 v0.6" -* Tiny fix in target `uninstall' in file `Makefile.in'. - (Thanks to Karl Berry) -.IP "2008/06/28 v0.7" 4 +.RS 2 +.IP "* Tiny fix in target `uninstall' in file `Makefile.in'. (Thanks to Karl Berry)" 2 +.IX Item "Tiny fix in target `uninstall' in file `Makefile.in'. (Thanks to Karl Berry)" +.RE +.RS 2 +.RE +.IP "\fB2008/06/28 v0.7\fR" 2 .IX Item "2008/06/28 v0.7" -* Fix for unknown option `\-\-cmd\-strace'. - (Thanks to Juho Niemel"a) +.RS 2 +.ie n .IP "* Fix for unknown option `""\-\-cmd\-strace""'. (Thanks to Juho Niemelä)" 2 +.el .IP "* Fix for unknown option `\f(CW\-\-cmd\-strace\fR'. (Thanks to Juho Niemelä)" 2 +.IX Item "Fix for unknown option `--cmd-strace'. (Thanks to Juho Niemelä)" +.RE +.RS 2 +.RE +.IP "\fB2011/11/10 v0.8\fR" 2 +.IX Item "2011/11/10 v0.8" +.RS 2 +.IP "* Remove colon from drive specification when making directories." 2 +.IX Item "Remove colon from drive specification when making directories." +.ie n .IP "* Option ""\-\-(no)texhash"" added." 2 +.el .IP "* Option \f(CW\-\-(no)texhash\fR added." 2 +.IX Item "Option --(no)texhash added." +.IP "* Some support for MiKTeX (thanks Ulrike Fischer)." 2 +.IX Item "Some support for MiKTeX (thanks Ulrike Fischer)." +.IP "* Various fixes in the generation of the documentation." 2 +.IX Item "Various fixes in the generation of the documentation." +.ie n .IP "* Options ""\-\-exclude\-ext""\fR and \f(CW""\-\-version"" added." 2 +.el .IP "* Options \f(CW\-\-exclude\-ext\fR and \f(CW\-\-version\fR added." 2 +.IX Item "Options --exclude-ext and --version added." +.RE +.RS 2 +.RE diff --git a/Master/texmf/doc/man/man1/mkjobtexmf.man1.pdf b/Master/texmf/doc/man/man1/mkjobtexmf.man1.pdf Binary files differindex a1ce2a2860e..bd42549a2cf 100644 --- a/Master/texmf/doc/man/man1/mkjobtexmf.man1.pdf +++ b/Master/texmf/doc/man/man1/mkjobtexmf.man1.pdf |