From 649f6cb2935b2844e99cd20f5577ac173f3ad367 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 17 Jun 2011 02:12:58 +0000 Subject: /home/texlive/karl/Master/tlpkg/bin/tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@23023 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf/doc/man/man1/tlmgr.1 | 50 +++++++++++++++++++++++++++++-- Master/texmf/doc/man/man1/tlmgr.man1.pdf | Bin 63687 -> 66399 bytes 2 files changed, 48 insertions(+), 2 deletions(-) (limited to 'Master/texmf/doc/man/man1') diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1 index a4933638ec7..d0d64ee29b9 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 "2011-06-11" "perl v5.12.3" "User Contributed Perl Documentation" +.TH TLMGR 1 "2011-06-16" "perl v5.12.3" "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 @@ -615,9 +615,10 @@ displayed. If \fIvalue\fR is present, \fIkey\fR is set to \fIvalue\fR. Possible values for \fIkey\fR are (but see \fBtlmgr option showall\fR for the definitive list): .PP -.Vb 9 +.Vb 10 \& repository (default package repository), \& formats (create formats at installation time), +\& postcode (run postinst code blobs) \& docfiles (install documentation files), \& srcfiles (install source files), \& backupdir (default directory for backups), @@ -625,6 +626,10 @@ the definitive list): \& sys_bin (directory to which executables are linked by the path action) \& sys_man (directory to which man pages are linked by the path action) \& sys_info (directory to which Info files are linked by the path action) +\& generate_updmap (call the equivalent of tlmgr generate updmap on changes) +\& desktop_integration (create Start menu shortcuts on Windows) +\& fileassocs (change file associations on Windows) +\& multiuser (install for all users on Windows) .Ve .PP One common use of \f(CW\*(C`option\*(C'\fR is to permanently change the installation to @@ -641,6 +646,18 @@ values for repository. To keep backward compatibility \f(CW\*(C`location\*(C'\fR can be used as alternative name for \f(CW\*(C`repository\*(C'\fR. .PP +If the \f(CW\*(C`formats\*(C'\fR is set (this is the default), then formats are +regenerated when either the engine or the format files have changed. +Disable that only when you know what you are doing. +.PP +The \f(CW\*(C`postcode\*(C'\fR options controls execution of package shipped postinstallation +action code. By default enabled. +.PP +The \f(CW\*(C`docfiles\*(C'\fR and \f(CW\*(C`srcfiles\*(C'\fR options control the installations of +the respective files of a package. By default the source of packages as +well as the documentation is installed. This can be disabled in case +of disk space constraints. +.PP The two options \f(CW\*(C`autobackup\*(C'\fR and \f(CW\*(C`backupdir\*(C'\fR determine defaults for the \f(CW\*(C`update\*(C'\fR, \f(CW\*(C`backup\*(C'\fR and \f(CW\*(C`restore\*(C'\fR actions. These three actions need a directory to write to or read from the backups. If @@ -669,6 +686,35 @@ Or you can use: The \f(CW\*(C`\-\-\*(C'\fR avoids having the \f(CW\*(C`\-1\*(C'\fR treated as an option. (For most programs, \f(CW\*(C`\-\-\*(C'\fR stops parsing for arguments at the point where it appears; this is a general feature of option parsing.) +.PP +The \f(CW\*(C`sys_*\*(C'\fR options are used on Unix like systems to control the +generation of links for binary files, info files and man pages. See +the action \f(CW\*(C`path\*(C'\fR for details. +.PP +By default \f(CW\*(C`tlmgr\*(C'\fR does not call the equivalent of +.PP +.Vb 1 +\& tlmgr generate updmap +.Ve +.PP +to allow for local modifications. But if you keep all your local +modifications in \f(CW\*(C`updmap\-local.cfg\*(C'\fR, then setting the option +\&\f(CW\*(C`generate_updmap\*(C'\fR will make \f(CW\*(C`tlmgr\*(C'\fR to recreate the \f(CW\*(C`updmap.cfg\*(C'\fR +file from the installed packages and \f(CW\*(C`updmap\-local.cfg\*(C'\fR every time +a change occurs. Of course, if you make manual changes to +\&\f(CW\*(C`updmap\-local.cfg\*(C'\fR you need to call \f(CW\*(C`tlmgr generate updmap\*(C'\fR manually. +This option is for those who strictly use only the \f(CW\*(C`updmap\-local.cfg\*(C'\fR +file for local adaptions, and not calls to \f(CW\*(C`updmap \-\-enableMap\*(C'\fR etc. +See \*(L"generate updmap\*(R" action's description for details. +.PP +The last three options control behaviour on Windows installations. +If \f(CW\*(C`desktop_integration\*(C'\fR is set, then some packages will install links +in a sub folder in the Start menu. These links are for the \f(CW\*(C`tlmgr gui\*(C'\fR, +documentation etc. If \f(CW\*(C`fileassocs\*(C'\fR is set then the default for +updating/adding file associations is set. Please see \f(CW\*(C`postaction\*(C'\fR action +for details on file associations handling. If \f(CW\*(C`multiuser\*(C'\fR is set, then +adaptions to the registry and the menus are done for all users on the +system. All three options are on by default. .SS "conf [texmf|tlmgr [\fIkey\fP [\fIvalue\fP]]]" .IX Subsection "conf [texmf|tlmgr [key [value]]]" With only the \f(CW\*(C`conf\*(C'\fR, show general configuration information for TeX diff --git a/Master/texmf/doc/man/man1/tlmgr.man1.pdf b/Master/texmf/doc/man/man1/tlmgr.man1.pdf index ac6500ddc21..c9acbe21344 100644 Binary files a/Master/texmf/doc/man/man1/tlmgr.man1.pdf and b/Master/texmf/doc/man/man1/tlmgr.man1.pdf differ -- cgit v1.2.3