diff options
author | Karl Berry <karl@freefriends.org> | 2016-04-12 01:16:44 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-04-12 01:16:44 +0000 |
commit | dd8704f13b0ef5fda3041cb07bdfc713158e958c (patch) | |
tree | 9354818d3cd94f9c7914b19849ac776c72ab15f2 /Master/texmf-dist/doc/man/man1/tlmgr.1 | |
parent | 567fb905dbf34dfd07e232609dfa4e519bd32452 (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/man/man1/tlmgr.1')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.1 | 36 |
1 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 |