diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/mkjobtexmf/mkjobtexmf.txt')
-rw-r--r-- | Master/texmf-dist/doc/generic/mkjobtexmf/mkjobtexmf.txt | 102 |
1 files changed, 74 insertions, 28 deletions
diff --git a/Master/texmf-dist/doc/generic/mkjobtexmf/mkjobtexmf.txt b/Master/texmf-dist/doc/generic/mkjobtexmf/mkjobtexmf.txt index b091141ec1b..e64edeec071 100644 --- a/Master/texmf-dist/doc/generic/mkjobtexmf/mkjobtexmf.txt +++ b/Master/texmf-dist/doc/generic/mkjobtexmf/mkjobtexmf.txt @@ -2,6 +2,10 @@ NAME mkjobtexmf -- Generate a texmf tree for a particular job +VERSION + + 2011-11-10 v0.8 + SYNOPSIS The progam mkjobtexmf runs a program and tries to find the used file @@ -40,6 +44,8 @@ SYNOPSIS 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 @@ -47,13 +53,14 @@ SYNOPSIS --verbose Verbose output --help Brief help message --man Full documentation + --version Print version identification DESCRIPTION Running the program First mkjobtexmf runs a program, usually TeX. The TeX compiler is - configured by option --cmd-tex. Option --texname can be used, if the + configured by option "--cmd-tex". Option "--texname" can be used, if the file name extension differs from .tex: mkjobtexmf --jobname foo --texname foo.ltx @@ -93,23 +100,23 @@ DESCRIPTION with links to parent directories. Symbolic links are created by default. The files are copied if option - --copy is given or symbolic linking is not available. + "--copy" is given or symbolic linking is not available. OPTIONS - --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 and - files. See section "FILES". + --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 + and files. See section "FILES". - --texname=*name* - The name of the TeX input file, if it differs from <jobname>.tex. + --texname=<*name*> + The name of the TeX input file, if it differs from <*jobname*>.tex. - --texopt=*opt* - Additional option for the TeX compiler, examples are --ini or - --shell-escape. This option can be given more than once. + --texopt=<*opt*> + Additional option for the TeX compiler, examples are "--ini" or + "--shell-escape". This option can be given more than once. - --destdir=*directory* + --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'. @@ -130,17 +137,35 @@ OPTIONS The files `ls-R' and `aliases' are ignored. - --cmd-tex=*cmd* + --exclude-ext=<*ext*> + Files with extension <*ext*> are excluded. The option can be given + several times or a comma separated list of extensions can be used. + Examples: + + --exclude-ext aux --exclude-ext log --exclude-ext toc + + is the same as + + --exclude-ext aux,log,toc + + --(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 "--notexhash" suppresses the call of + `texhash'. + + --cmd-tex=<*cmd*> Command for the TeX compiler. Default is pdflatex. - --cmd-kpsewhich=*cmd* + --cmd-kpsewhich=<*cmd*> Command for kpsewhich. - --cmd-texhash=*cmd* + --cmd-texhash=<*cmd*> Command for updating the file name database of the generated texmf tree. Default is texmf. - --cmd-strace=*cmd* + --cmd-strace=<*cmd*> Command for strace. --verbose @@ -149,6 +174,12 @@ OPTIONS --help Display help screen. + -B(-man> + Print manual page. + + --version + Print version identification and exit. + EXAMPLES TeX file test.tex using TeX's recorder method: @@ -215,7 +246,7 @@ FILES <jobname>.mjt/ Directory where the resulting texmf tree and symbol links are - stored. It can be changed by option --destdir. + stored. It can be changed by option "--destdir". <jobname>.fls Name of TeX's recorder file. @@ -225,11 +256,11 @@ FILES AUTHOR - Heiko Oberdiek, email: oberdiek at uni-freiburg.de + Heiko Oberdiek, email: heiko.oberdiek at googlemail.com COPYRIGHT AND LICENSE - Copyright 2007 by Heiko Oberdiek. + Copyright 2007, 2008, 2011 by Heiko Oberdiek. 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 @@ -238,25 +269,40 @@ COPYRIGHT AND LICENSE HISTORY 2007/04/16 v0.1 - * First experimental version. + + * First experimental version. 2007/05/09 v0.2 - * Typo in option name fixed. + + * Typo in option name fixed. 2007/09/03 v0.3 - * New options: --copy, --flat, --destdir + + * New options: "--copy", "--flat", "--destdir" 2007/09/04 v0.4 - * Bug fix in map_files_texmf. + + * Bug fix in map_files_texmf. 2007/09/06 v0.5 - * Support for `configure' added. (Thanks to Norbert Preining for - writing a first version of the configure stuff.) + + * Support for `configure' added. (Thanks to Norbert Preining for + writing a first version of the configure stuff.) 2008/04/05 v0.6 - * Tiny fix in target `uninstall' in file `Makefile.in'. (Thanks to - Karl Berry) + + * Tiny fix in target `uninstall' in file `Makefile.in'. (Thanks to + Karl Berry) 2008/06/28 v0.7 - * Fix for unknown option `--cmd-strace'. (Thanks to Juho Niemel"a) + + * Fix for unknown option `"--cmd-strace"'. (Thanks to Juho Niemelä) + + 2011/11/10 v0.8 + + * Remove colon from drive specification when making directories. + * Option "--(no)texhash" added. + * Some support for MiKTeX (thanks Ulrike Fischer). + * Various fixes in the generation of the documentation. + * Options "--exclude-ext" and "--version" added. |