From fff094b6b85e20da70e1eb6f0334c36ad053f3fb Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 19 May 2019 23:39:01 +0000 Subject: tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@51170 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/tlmgr.1 | 64 +++++++++++++++----------- Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf | Bin 134915 -> 135231 bytes 2 files changed, 38 insertions(+), 26 deletions(-) (limited to 'Master') diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1 index b1ee8ca5c08..7da1eecd352 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 "2019-05-16" "perl v5.28.1" "User Contributed Perl Documentation" +.TH TLMGR 1 "2019-05-19" "perl v5.28.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 @@ -1208,8 +1208,8 @@ yourself if you are using this feature and want stale symlinks removed. .IP "\fBrepository list\fR" 4 .IX Item "repository list" .PD 0 -.IP "\fBrepository list \f(BIpath|tag\fB\fR" 4 -.IX Item "repository list path|tag" +.IP "\fBrepository list \f(BIpath|url|tag\fB\fR" 4 +.IX Item "repository list path|url|tag" .IP "\fBrepository add \f(BIpath\fB [\f(BItag\fB]\fR" 4 .IX Item "repository add path [tag]" .IP "\fBrepository remove \f(BIpath|tag\fB\fR" 4 @@ -1222,31 +1222,43 @@ yourself if you are using this feature and want stale symlinks removed. This action manages the list of repositories. See \s-1MULTIPLE REPOSITORIES\s0 below for detailed explanations. .Sp -The first form (\f(CW\*(C`list\*(C'\fR) lists all configured repositories and the -respective tags if set. If a path, url, or tag is given after the -\&\f(CW\*(C`list\*(C'\fR keyword, it is interpreted as source from where to -initialize a TeX Live Database and lists the contained packages. -This can also be an up-to-now not used repository, both locally -and remote. If one pass in addition \f(CW\*(C`\-\-with\-platforms\*(C'\fR, for each -package the available platforms (if any) are listed, too. -.Sp -The third form (\f(CW\*(C`add\*(C'\fR) adds a repository -(optionally attaching a tag) to the list of repositories. The forth -form (\f(CW\*(C`remove\*(C'\fR) removes a repository, either by full path/url, or by -tag. The fifth form (\f(CW\*(C`set\*(C'\fR) sets the list of repositories to the items -given on the command line, not keeping previous settings. -.Sp -The last form (\f(CW\*(C`status\*(C'\fR) reports the verification status of the -loaded repositories in the following format: One repository per line with -4 fields separated with a single space: The tag (which can be the same -as the \s-1URL\s0), the \s-1URL,\s0 the verification code (a number), and the -verbal description of the verification status (last field extending to -the end of line). This format is valid under machine readable output, -while in normal output the third field (numeric verification status) -is not present. +The first form, \f(CW\*(C`repository list\*(C'\fR, lists all configured repositories +and the respective tags if set. If a path, url, or tag is given after +the \f(CW\*(C`list\*(C'\fR keyword, it is interpreted as the source from which to +initialize a \s-1TL\s0 database and lists the contained packages. This can also +be an otherwise-unused repository, either local or remote. If the option +\&\f(CW\*(C`\-\-with\-platforms\*(C'\fR is spcified in addition, for each package the +available platforms (if any) are also listed. +.Sp +The form \f(CW\*(C`repository add\*(C'\fR adds a repository (optionally attaching a +tag) to the list of repositories, while \f(CW\*(C`repository remove\*(C'\fR removes a +repository, either by full path/url, or by tag. +.Sp +The form \f(CW\*(C`repository set\*(C'\fR sets the list of available repositories to +the items given on the command line, overwriting previous settings. +.Sp +The form \f(CW\*(C`repository status\*(C'\fR reports the verification status of the +loaded repositories with the format of one repository per line +with fields separated by a single space: +.RS 4 +.IP "The tag (which can be the same as the url);" 4 +.IX Item "The tag (which can be the same as the url);" += the url; +.Sp += iff machine-readable output is specified, the verification code (a +number); +.Sp += a textual description of the verification status, as the last field +extending to the end of line. +.RE +.RS 4 +.Sp +That is, in normal (not machine-readable) output, the third field +(numeric verification status) is not present. .Sp In all cases, one of the repositories must be tagged as \f(CW\*(C`main\*(C'\fR; otherwise, all operations will fail! +.RE .SS "restore" .IX Subsection "restore" .IP "\fBrestore [\f(BIoption\fB...] \f(BIpkg\fB [\f(BIrev\fB]\fR" 4 @@ -2310,4 +2322,4 @@ This script and its documentation were written for the TeX Live distribution () and both are licensed under the \&\s-1GNU\s0 General Public License Version 2 or later. .PP -\&\f(CW$Id:\fR tlmgr.pl 51141 2019\-05\-16 11:18:52Z preining $ +\&\f(CW$Id:\fR tlmgr.pl 51168 2019\-05\-19 22:36:38Z karl $ diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf index 49b22d79b32..0bddbe65986 100644 Binary files a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf and b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf differ -- cgit v1.2.3