diff options
author | Karl Berry <karl@freefriends.org> | 2010-01-09 02:25:20 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-01-09 02:25:20 +0000 |
commit | 1a3e4e82c7adf1f9b2d8fe8a210915b102265ec9 (patch) | |
tree | c06e4350558c7e3699f7190ea38387e7bd6103df /Master/texmf | |
parent | 6cc09b6f974471c8c85962bba8a1ba9eb87c463b (diff) |
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@16647 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
-rw-r--r-- | Master/texmf/doc/man/man1/tlmgr.1 | 55 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/tlmgr.man1.pdf | bin | 52940 -> 53781 bytes |
2 files changed, 37 insertions, 18 deletions
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1 index 1af20caf69a..f0bcbd35709 100644 --- a/Master/texmf/doc/man/man1/tlmgr.1 +++ b/Master/texmf/doc/man/man1/tlmgr.1 @@ -124,7 +124,7 @@ .\" ======================================================================== .\" .IX Title "TLMGR 1" -.TH TLMGR 1 "2010-01-04" "perl v5.10.1" "User Contributed Perl Documentation" +.TH TLMGR 1 "2010-01-09" "perl v5.10.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -814,12 +814,12 @@ The \f(CW\*(C`generate\*(C'\fR action overwrites any manual changes made in the respective files: it recreates them from scratch. .PP For \f(CW\*(C`fmtutil\*(C'\fR and the language files, this is normal, and both the TeX -Live installer and \f(CW\*(C`tlmgr\*(C'\fR routinely call \fIgenerate\fR for them. +Live installer and \f(CW\*(C`tlmgr\*(C'\fR routinely call \f(CW\*(C`generate\*(C'\fR for them. .PP For \f(CW\*(C`updmap\*(C'\fR, however, \f(CW\*(C`tlmgr\*(C'\fR does \fInot\fR use \&\f(CW\*(C`generate\*(C'\fR, because the result would be to disable all maps which have been manually installed via \f(CW\*(C`updmap\-sys\ \-\-enable\*(C'\fR, e.g., for -proprietary or local fonts. The \fIgenerate\fR action only incorporates +proprietary or local fonts. The \f(CW\*(C`generate\*(C'\fR action only incorporates the changes in the \f(CW\*(C`\-\-localcfg\*(C'\fR file mentioned below. Furthermore, \&\f(CW\*(C`tlmgr\*(C'\fR updates and maintains the final \f(CW\*(C`updmap.cfg\*(C'\fR in \&\f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR (while the other files are in \f(CW\*(C`TEXMFSYSVAR\*(C'\fR), because @@ -852,7 +852,7 @@ Local files specify entries to be disabled with a comment line like this: .PP where \f(CW\*(C`fmtutil.cnf\*(C'\fR and \f(CW\*(C`updmap.cfg\*(C'\fR use \f(CW\*(C`#\*(C'\fR, and \f(CW\*(C`language.dat\*(C'\fR and \&\f(CW\*(C`language.def\*(C'\fR use \f(CW\*(C`%\*(C'\fR. In any case, the \fIname\fR is the respective -format name, map file name (include the \f(CW\*(C`.map\*(C'\fR extension),or +format name, map file name (include the \f(CW\*(C`.map\*(C'\fR extension), or hyphenation pattern identifier. Examples: .PP .Vb 3 @@ -865,7 +865,9 @@ hyphenation pattern identifier. Examples: particular items. They're just examples.) .PP After such a disabling line, the local file can include another entry -for the same item, if a different definition is desired. +for the same item, if a different definition is desired. In general, +except for the special disabling lines, the local files follow the same +syntax as the master files. .PP The form \f(CW\*(C`generate language\*(C'\fR recreates both the \f(CW\*(C`language.dat\*(C'\fR and the \&\f(CW\*(C`language.def\*(C'\fR files, while the forms with extension recreates only @@ -878,7 +880,11 @@ this file specifies the setting of five options: \f(CW\*(C`dvipsPreferOutline\*( \&\f(CW\*(C`updmap\-hdr.cfg\*(C'\fR are usually fine. If you want to change them, you can include changed settings for any or all of these five options in your \&\f(CW\*(C`updmap\-local.cfg\*(C'\fR file and they will be respected by \f(CW\*(C`generate -updmap\*(C'\fR. +updmap\*(C'\fR, for example: +.PP +.Vb 1 +\& dvipsDownloadBase35 true +.Ve .PP Options: .IP "\fB\-\-dest\fR \fIoutput file\fR" 4 @@ -894,6 +900,19 @@ output file, we recommend invoking \f(CW\*(C`tlmgr\*(C'\fR twice.) .IX Item "--localcfg local conf file" specifies the (optional) local additions (defaults to the respective location in \f(CW\*(C`TEXMFLOCAL\*(C'\fR). +.IP "\fB\-\-rebuild\-sys\fR" 4 +.IX Item "--rebuild-sys" +tells tlmgr to run necessary programs after config files have been +regenerated. These are: \f(CW\*(C`updmap\-sys\*(C'\fR after \f(CW\*(C`generate updmap\*(C'\fR, +\&\f(CW\*(C`fmtutil\-sys \-\-all\*(C'\fR after \f(CW\*(C`generate fmtutil\*(C'\fR, +\&\f(CW\*(C`fmtutil\-sys \-\-byhyphen .../language.dat\*(C'\fR after \f(CW\*(C`generate language.dat\*(C'\fR, +and +\&\f(CW\*(C`fmtutil\-sys \-\-byhyphen .../language.def\*(C'\fR after \f(CW\*(C`generate language.def\*(C'\fR. +.Sp +These subsequent calls cause the newly-generated files to actually take +effect. This is not done by default since those calls are lengthy +processes and one might want to made several related changes in +succession before invoking these programs. .PP The respective locations are as follows: .PP @@ -936,25 +955,25 @@ the repository specified on the command line, and an arbitrary other one. Furthermore is allows to quit \f(CW\*(C`tlmgr\*(C'\fR. .IP "\fBOptions\fR" 4 .IX Item "Options" -Provides access to three groups of options, \fBGeneral\fR (for almost all -options), \fBPaper\fR (configuration of default paper sizes), -\&\fBArchitectures\fR (only on Unix, configuration of the supported/installed -architectures), as well as a toggle to turn on and off Debug mode. +Provides access to three groups of options, \fIGeneral\fR (for almost all +options), \fIPaper\fR (configuration of default paper sizes), +\&\fIArchitectures\fR (only on Unix, configuration of the supported/installed +architectures), as well as a toggle to turn on and off debugging mode. .IP "\fBActions\fR" 4 .IX Item "Actions" -Provides access to some useful items, like updating the filename database -(ls-R, mktexlsr, texhash), rebuilding of all formats (fmtutil-sys \-\-all), -updating the font map database (updmap-sys), and handling of symbolic -links in system directories (only Unix), as well as removal of the -full TeX Live installation (only Unix). +Provides access to a variety of items, such as updating the filename +database (aka ls-R, mktexlsr, texhash), rebuilding of all formats +(\f(CW\*(C`fmtutil\-sys \-\-all\*(C'\fR), updating the font map database (\f(CW\*(C`updmap\-sys\*(C'\fR), +and handling of symbolic links in system directories (only Unix), as +well as removal of the full TeX Live installation (only Unix). .IP "\fBHelp\fR" 4 .IX Item "Help" Currently only gives basic information on the installed version, authors, license. .SS "Main display" .IX Subsection "Main display" -The main display lists all packages, installed and \- if a repository is -loaded \- also those that are available but not installed. +The main display lists all packages, installed and, if a repository is +loaded, also those that are available but not installed. .PP Each line of the package list contains of the following items: .IP "a checkbox" 4 @@ -1031,7 +1050,7 @@ packages). .IP "Backup" 4 .IX Item "Backup" makes a backup of the selected packages, acts like \f(CW\*(C`tlmgr backup\*(C'\fR. This -action needs the options \fBbackupdir\fR set (see Options \-> General). +action needs the option \f(CW\*(C`backupdir\*(C'\fR set (see Options \-> General). .PP Finally, the status area at the bottom of the window gives additional information what is going on. diff --git a/Master/texmf/doc/man/man1/tlmgr.man1.pdf b/Master/texmf/doc/man/man1/tlmgr.man1.pdf Binary files differindex 46b447b50c0..b1f76f5efd9 100644 --- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf +++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf |