summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-12-05 00:23:53 +0000
committerKarl Berry <karl@freefriends.org>2011-12-05 00:23:53 +0000
commita3820a32b1f8c604520d9fcf34069b4e0a73a89a (patch)
treec70af98636c9e2fdff4f6e0b721cb93fed1b5afc /Master/texmf/doc/man/man1
parent757da55142bf500fb11d5e9567bf1cec3b1dc18b (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/man1')
-rw-r--r--Master/texmf/doc/man/man1/mkjobtexmf.1190
-rw-r--r--Master/texmf/doc/man/man1/mkjobtexmf.man1.pdfbin13195 -> 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
index a1ce2a2860e..bd42549a2cf 100644
--- a/Master/texmf/doc/man/man1/mkjobtexmf.man1.pdf
+++ b/Master/texmf/doc/man/man1/mkjobtexmf.man1.pdf
Binary files differ