summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-06-17 02:12:58 +0000
committerKarl Berry <karl@freefriends.org>2011-06-17 02:12:58 +0000
commit649f6cb2935b2844e99cd20f5577ac173f3ad367 (patch)
treeb47bb4422e5b342e2e700284b47d3ac8a4b95ade /Master/texmf/doc/man/man1
parent0e3199d9461437d4476cc4e80d62b0e6da7858b7 (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@23023 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man/man1')
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.150
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.man1.pdfbin63687 -> 66399 bytes
2 files changed, 48 insertions, 2 deletions
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
--- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
Binary files differ