summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-04-12 01:16:44 +0000
committerKarl Berry <karl@freefriends.org>2016-04-12 01:16:44 +0000
commitdd8704f13b0ef5fda3041cb07bdfc713158e958c (patch)
tree9354818d3cd94f9c7914b19849ac776c72ab15f2 /Master/texmf-dist/doc
parent567fb905dbf34dfd07e232609dfa4e519bd32452 (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@40420 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.136
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.man1.pdfbin112446 -> 112787 bytes
2 files changed, 21 insertions, 15 deletions
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index d8451234353..482f27382b9 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.1
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "TLMGR 1"
-.TH TLMGR 1 "2016-04-01" "perl v5.22.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2016-04-12" "perl v5.22.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
@@ -374,7 +374,8 @@ Check that the files referred to by \f(CW\*(C`execute\*(C'\fR directives in the
Live Database are present.
.IP "\fBrunfiles\fR" 4
.IX Item "runfiles"
-List those filenames that are occurring more than one time in the runfiles.
+List those filenames that are occurring more than one time in the
+runfiles sections.
.PP
Options:
.IP "\fB\-\-use\-svn\fR" 4
@@ -389,12 +390,13 @@ like the \f(CW\*(C`texconfig conf\*(C'\fR call, but works on all supported platf
.PP
With either \f(CW\*(C`conf texmf\*(C'\fR, \f(CW\*(C`conf tlmgr\*(C'\fR, or \f(CW\*(C`conf updmap\*(C'\fR given in
addition, shows all key/value pairs (i.e., all settings) as saved in
-\&\f(CW\*(C`ROOT/texmf.cnf\*(C'\fR, the tlmgr configuration file (see below), or the
+\&\f(CW\*(C`ROOT/texmf.cnf\*(C'\fR, the \f(CW\*(C`tlmgr\*(C'\fR configuration file (see below), or the
first found (via kpsewhich) \f(CW\*(C`updmap.cfg\*(C'\fR file, respectively.
.PP
If \fIkey\fR is given in addition, shows the value of only that \fIkey\fR in
-the respective file. If option \fI\-\-delete\fR is also given, the
-configuration file \*(-- it is removed, not just commented out!
+the respective file. If option \fI\-\-delete\fR is also given, the value in
+the given configuration file is entirely removed (not just commented
+out).
.PP
If \fIvalue\fR is given in addition, \fIkey\fR is set to \fIvalue\fR in the
respective file. \fINo error checking is done!\fR
@@ -402,9 +404,13 @@ respective file. \fINo error checking is done!\fR
In all cases the file used can be explicitly specified via the option
\&\f(CW\*(C`\-\-conffile \f(CIfile\f(CW\*(C'\fR, in case one wants to operate on a different file.
.PP
-Practical application: if the execution of (some or all) system commands
-via \f(CW\*(C`\ewrite18\*(C'\fR was left enabled during installation, you can disable
-it afterwards:
+The \s-1PATH\s0 value shown is that used by \f(CW\*(C`tlmgr\*(C'\fR. The directory in which
+the \f(CW\*(C`tlmgr\*(C'\fR executable is found is automatically prepended to the \s-1PATH\s0
+value inherited from the environment.
+.PP
+Practical application of changing configuration values: if the execution
+of (some or all) system commands via \f(CW\*(C`\ewrite18\*(C'\fR was left enabled during
+installation, you can disable it afterwards:
.PP
.Vb 1
\& tlmgr conf texmf shell_escape 0
@@ -540,7 +546,7 @@ 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
+tells \f(CW\*(C`tlmgr\*(C'\fR to run necessary programs after config files have been
regenerated. These are:
\&\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,
@@ -596,10 +602,8 @@ When given with schemes and collections, \f(CW\*(C`\-\-list\*(C'\fR outputs thei
dependencies in a similar way.
.IP "\fB\-\-only\-installed\fR" 4
.IX Item "--only-installed"
-If this options is given, the installation source will
-not be used; only locally installed packages, collections, or schemes
-are listed.
-(Does not work for listing of packages for now)
+If this option is given, the installation source will not be used; only
+locally installed packages, collections, or schemes are listed.
.SS "init-usertree"
.IX Subsection "init-usertree"
Sets up a texmf tree for so-called user mode management, either the
@@ -725,7 +729,9 @@ is not likely to be of interest except perhaps to developers.
.PP
The \f(CW\*(C`docfiles\*(C'\fR and \f(CW\*(C`srcfiles\*(C'\fR options control the installation of
their respective files of a package. By default both are enabled (1).
-This can be disabled (set to 0) if disk space is (very) limited.
+Either or both can be disabled (set to 0) if disk space is limited or
+for minimal testing installations, etc. When disabled, the respective
+files are not downloaded at all.
.PP
The options \f(CW\*(C`autobackup\*(C'\fR and \f(CW\*(C`backupdir\*(C'\fR determine the defaults for
the actions \f(CW\*(C`update\*(C'\fR, \f(CW\*(C`backup\*(C'\fR and \f(CW\*(C`restore\*(C'\fR. These three actions
@@ -964,7 +970,7 @@ Otherwise, if neither \fIpkg\fR nor \fIrev\fR are given, list the available
backup revisions for all packages. With \fIpkg\fR given but no \fIrev\fR,
list all available backup revisions of \fIpkg\fR.
.PP
-When listing available packages tlmgr shows the revision, and in
+When listing available packages, \f(CW\*(C`tlmgr\*(C'\fR shows the revision, and in
parenthesis the creation time if available (in format yyyy-mm-dd hh:mm).
.PP
If (and only if) both \fIpkg\fR and a valid revision number \fIrev\fR are
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
index b382b681f00..1085b06b350 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
Binary files differ