diff options
| -rw-r--r-- | Master/doc.html | 29 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.1 | 226 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf | bin | 125820 -> 135801 bytes |
3 files changed, 239 insertions, 16 deletions
diff --git a/Master/doc.html b/Master/doc.html index af60e83ee00..17f8a669d77 100644 --- a/Master/doc.html +++ b/Master/doc.html @@ -11716,6 +11716,11 @@ Adaptable tables <a href="texmf-dist/doc/latex/nox/nox.pdf">nox.pdf</a>. </small></li> +<li><b><a href="texmf-dist/doc/context/third/npp-for-context/doc">npp-for-context</a></b>:<small> +ConTeXt plugin for Notepad++ +<a href="texmf-dist/doc/context/third/npp-for-context/doc/npp-context-manual.pdf">npp-context-manual.pdf</a>. +</small></li> + <li><b><a href="texmf-dist/doc/latex/nrc">nrc</a></b>:<small> Class for the NRC technical journals <a href="texmf-dist/doc/latex/nrc/userguide.pdf">userguide.pdf</a>. @@ -11800,7 +11805,7 @@ Support for the journal "North-Western European Journal of Mathematics" <h2 id="letter-O">O</h2> -<ol start="1823"> +<ol start="1824"> <li><b><a href="texmf-dist/doc/latex/oberdiek">oberdiek</a></b>:<small> A bundle of packages submitted by Heiko Oberdiek @@ -12119,7 +12124,7 @@ Combine LaTeX commands over included graphics <h2 id="letter-P">P</h2> -<ol start="1861"> +<ol start="1862"> <li><b><a href="texmf-dist/doc/latex/pagecolor">pagecolor</a></b>:<small> Interrogate page colour @@ -13882,7 +13887,7 @@ Run Python from within a document, typesetting the results <h2 id="letter-Q">Q</h2> -<ol start="2143"> +<ol start="2144"> <li><b><a href="texmf-dist/doc/latex/qcircuit">qcircuit</a></b>:<small> Macros to generate quantum ciruits @@ -13957,7 +13962,7 @@ An easy way to typeset any part of The Holy Quran <h2 id="letter-R">R</h2> -<ol start="2155"> +<ol start="2156"> <li><b><a href="texmf-dist/doc/latex/raleway">raleway</a></b>:<small> Use Raleway with TeX(-alike) systems @@ -14401,7 +14406,7 @@ Class for Ryerson Unversity Graduate School requirements <h2 id="letter-S">S</h2> -<ol start="2221"> +<ol start="2222"> <li><b><a href="texmf-dist/doc/latex/sa-tikz">sa-tikz</a></b>:<small> TikZ library to draw switching architectures @@ -15706,7 +15711,7 @@ Format systems of equations <h2 id="letter-T">T</h2> -<ol start="2427"> +<ol start="2428"> <li><b><a href="texmf-dist/doc/latex/t-angles">t-angles</a></b>:<small> Draw tangles, trees, Hopf algebra operations and other pictures @@ -17431,7 +17436,7 @@ Print a typographic grid <h2 id="letter-U">U</h2> -<ol start="2661"> +<ol start="2662"> <li><b><a href="texmf-dist/doc/latex/uaclasses">uaclasses</a></b>:<small> University of Arizona thesis and dissertation format @@ -17784,7 +17789,7 @@ University of Washington thesis class <h2 id="letter-V">V</h2> -<ol start="2720"> +<ol start="2721"> <li><b><a href="texmf-dist/doc/bibtex/vancouver">vancouver</a></b>:<small> Bibliographic style file for Biomedical Journals @@ -17988,7 +17993,7 @@ Variable-width multiple text columns <h2 id="letter-W">W</h2> -<ol start="2754"> +<ol start="2755"> <li><b><a href="texmf-dist/doc/fonts/wadalab">wadalab</a></b>:<small> Wadalab (Japanese) font packages @@ -18142,7 +18147,7 @@ Extend LaTeX's cross-reference system <h2 id="letter-X">X</h2> -<ol start="2773"> +<ol start="2774"> <li><b><a href="texmf-dist/doc/latex/xargs">xargs</a></b>:<small> Define commands with many optional arguments @@ -18582,7 +18587,7 @@ Tree macros using XY-Pic <h2 id="letter-Y">Y</h2> -<ol start="2834"> +<ol start="2835"> <li><b><a href="texmf-dist/doc/latex/yafoot">yafoot</a></b>:<small> A bundle of miscellaneous footnote packages @@ -18651,7 +18656,7 @@ Many-featured Young tableaux and Young diagrams <h2 id="letter-Z">Z</h2> -<ol start="2845"> +<ol start="2846"> <li><b><a href="texmf-dist/doc/latex/zed-csp">zed-csp</a></b>:<small> Typesetting Z and CSP format specifications diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1 index cd612119d6b..3bb62d22138 100644 --- a/Master/texmf-dist/doc/man/man1/tlmgr.1 +++ b/Master/texmf-dist/doc/man/man1/tlmgr.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "TLMGR 1" -.TH TLMGR 1 "2018-03-23" "perl v5.26.1" "User Contributed Perl Documentation" +.TH TLMGR 1 "2018-03-26" "perl v5.26.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 @@ -746,6 +746,9 @@ local keyring \f(CW\*(C`GNUPGHOME/repository\-keys.gpg\*(C'\fR, which is normall .PP The \f(CW\*(C`remove\*(C'\fR argument requires a key id and removes the requested id from the local keyring. +.SS "list" +.IX Subsection "list" +Synonym for info. .SS "option" .IX Subsection "option" .IP "\fBoption [\-\-json] [show]\fR" 4 @@ -1005,7 +1008,8 @@ collection dependencies of that collection. However, when removing a package, dependencies are never removed. Options: .IP "\fB\-\-all\fR" 4 .IX Item "--all" -Uninstalls all of TeX Live. +Uninstalls all of TeX Live, asking for confirmation unless \f(CW\*(C`\-\-force\*(C'\fR is +also specified. .IP "\fB\-\-backup\fR" 4 .IX Item "--backup" .PD 0 @@ -1201,9 +1205,223 @@ repository location. The \f(CW\*(C`prompt\*(C'\fR variable takes a string, and s current default prompt. .Sp If \fIvar\fR or then \fIval\fR is not specified, it is prompted for. +.PP +ym. +.SS "print-platform-info" +.IX Subsection "print-platform-info" +Print the TeX Live platform identifier, \s-1TL\s0 platform long name, and +original output from guess. +.SS "remove [\fIoption\fP]... \fIpkg\fP..." +.IX Subsection "remove [option]... pkg..." +Remove each \fIpkg\fR specified. Removing a collection removes all package +dependencies (unless \f(CW\*(C`\-\-no\-depends\*(C'\fR is specified), but not any +collection dependencies of that collection. However, when removing a +package, dependencies are never removed. Options: +.IP "\fB\-\-all\fR" 4 +.IX Item "--all" +Uninstalls all of TeX Live, asking for confirmation unless \f(CW\*(C`\-\-force\*(C'\fR is +also specified. +.IP "\fB\-\-backup\fR" 4 +.IX Item "--backup" +.PD 0 +.IP "\fB\-\-backupdir\fR \fIdirectory\fR" 4 +.IX Item "--backupdir directory" +.PD +These options behave just as with the \*(L"update\*(R" action (q.v.), except +they apply to making backups of packages before they are removed. The +default is to make such a backup, that is, to save a copy of packages +before removal. +.Sp +See \*(L"update\*(R" action for more. +.Sp +neither option is given, no backup will be made. If \f(CW\*(C`\-\-backupdir\*(C'\fR is +given and specifies a writable directory then a backup will be made in +that location. If only \f(CW\*(C`\-\-backup\*(C'\fR is given, then a backup will be made +to the directory previously set via the \f(CW\*(C`option\*(C'\fR action (see below). If +both are given then a backup will be made to the specified \fIdirectory\fR. +.Sp +You can set options via the \f(CW\*(C`option\*(C'\fR action to automatically make +backups for all packages, and/or keep only a certain number of backups. +Please see the \f(CW\*(C`option\*(C'\fR action for details. The default is to make one +backup. +.Sp +The \f(CW\*(C`restore\*(C'\fR action explains how to restore from a backup. +.IP "\fB\-\-no\-depends\fR" 4 +.IX Item "--no-depends" +Do not remove dependent packages. +.IP "\fB\-\-no\-depends\-at\-all\fR" 4 +.IX Item "--no-depends-at-all" +See above under \fBinstall\fR (and beware). +.IP "\fB\-\-force\fR" 4 +.IX Item "--force" +By default, removal of a package or collection that is a dependency of +another collection or scheme is not allowed. With this option, the +package will be removed unconditionally. Use with care. +.Sp +A package that has been removed using the \f(CW\*(C`\-\-force\*(C'\fR option because it +is still listed in an installed collection or scheme will not be +updated, and will be mentioned as \fBforcibly removed\fR in the output of +\&\fBtlmgr update \-\-list\fR. +.IP "\fB\-\-dry\-run\fR" 4 +.IX Item "--dry-run" +Nothing is actually removed; instead, the actions to be performed are +written to the terminal. +.SS "repository" +.IX Subsection "repository" +.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 add \f(BIpath\fB [\f(BItag\fB]\fR" 4 +.IX Item "repository add path [tag]" +.IP "\fBrepository remove \f(BIpath|tag\fB\fR" 4 +.IX Item "repository remove path|tag" +.IP "\fBrepository set \f(BIpath\fB[#\f(BItag\fB] [\f(BIpath\fB[#\f(BItag\fB] ...]\fR" 4 +.IX Item "repository set path[#tag] [path[#tag] ...]" +.PD +This action manages the list of repositories. See \*(L"\s-1MULTIPLE +REPOSITORIES\*(R"\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 last 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 +In all cases, one of the repositories must be tagged as \f(CW\*(C`main\*(C'\fR; +otherwise, all operations will fail! +.SS "restore [\-\-json] [\-\-backupdir \fIdir\fP] [\-\-all | \fIpkg\fP [\fIrev\fP]]" +.IX Subsection "restore [--json] [--backupdir dir] [--all | pkg [rev]]" +Restore a package from a previously-made backup. +.PP +If \f(CW\*(C`\-\-all\*(C'\fR is given, try to restore the latest revision of all +package backups found in the backup directory. +.PP +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, \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 +specified, try to restore the package from the specified backup. +.PP +Options: +.IP "\fB\-\-all\fR" 4 +.IX Item "--all" +Try to restore the latest revision of all package backups found in the +backup directory. Additional non-option arguments (like \fIpkg\fR) are not +allowed. +.IP "\fB\-\-backupdir\fR \fIdirectory\fR" 4 +.IX Item "--backupdir directory" +Specify the directory where the backups are to be found. If not given it +will be taken from the configuration setting in the \s-1TLPDB.\s0 +.IP "\fB\-\-dry\-run\fR" 4 +.IX Item "--dry-run" +Nothing is actually restored; instead, the actions to be performed are +written to the terminal. +.IP "\fB\-\-force\fR" 4 +.IX Item "--force" +Don't ask questions. +.IP "\fB\-\-json\fR" 4 +.IX Item "--json" +When listing backups, the option \f(CW\*(C`\-\-json\*(C'\fR turn on \s-1JSON\s0 output. +The format is an array of \s-1JSON\s0 objects (\f(CW\*(C`name\*(C'\fR, \f(CW\*(C`rev\*(C'\fR, \f(CW\*(C`date\*(C'\fR). +For details see \f(CW\*(C`tlpkg/doc/JSON\-formats.txt\*(C'\fR, format definition: \f(CW\*(C`TLBACKUPS\*(C'\fR. +If both \f(CW\*(C`\-\-json\*(C'\fR and \f(CW\*(C`\-\-data\*(C'\fR are given, \f(CW\*(C`\-\-json\*(C'\fR takes precedence. +.SS "search [\fIoption\fP...] \fIwhat\fP" +.IX Subsection "search [option...] what" +\fIsearch [\fIoption\fI...] \-\-file \fIwhat\fI\fR +.IX Subsection "search [option...] --file what" +.PP +\fIsearch [\fIoption\fI...] \-\-all \fIwhat\fI\fR +.IX Subsection "search [option...] --all what" +.PP +By default, search the names, short descriptions, and long descriptions +of all locally installed packages for the argument \fIwhat\fR, interpreted +as a (Perl) regular expression. +.PP +Options: +.IP "\fB\-\-file\fR" 4 +.IX Item "--file" +List all filenames containing \fIwhat\fR. +.IP "\fB\-\-all\fR" 4 +.IX Item "--all" +Search everything: package names, descriptions and filenames. +.IP "\fB\-\-global\fR" 4 +.IX Item "--global" +Search the TeX Live Database of the installation medium, instead of the +local installation. +.IP "\fB\-\-word\fR" 4 +.IX Item "--word" +Restrict the search of package names and descriptions (but not +filenames) to match only full words. For example, searching for +\&\f(CW\*(C`table\*(C'\fR with this option will not output packages containing the word +\&\f(CW\*(C`tables\*(C'\fR (unless they also contain the word \f(CW\*(C`table\*(C'\fR on its own). +.SS "shell" +.IX Subsection "shell" +Starts an interactive mode, where tlmgr prompts for commands. This can +be used directly, or for scripting. The first line of output is +\&\f(CW\*(C`protocol\*(C'\fR \fIn\fR, where \fIn\fR is an unsigned number identifying the +protocol version (currently 1). +.PP +In general, tlmgr actions that can be given on the command line +translate to commands in this shell mode. For example, you can say +\&\f(CW\*(C`update \-\-list\*(C'\fR to see what would be updated. The \s-1TLPDB\s0 is loaded the +first time it is needed (not at the beginning), and used for the rest of +the session. +.PP +Besides these actions, a few commands are specific to shell mode: +.IP "protocol" 4 +.IX Item "protocol" +Print \f(CW\*(C`protocol \f(CIn\f(CW\*(C'\fR, the current protocol version. +.IP "help" 4 +.IX Item "help" +Print pointers to this documentation. +.IP "version" 4 +.IX Item "version" +Print tlmgr version information. +.IP "quit, end, bye, byebye, \s-1EOF\s0" 4 +.IX Item "quit, end, bye, byebye, EOF" +Exit. +.IP "restart" 4 +.IX Item "restart" +Restart \f(CW\*(C`tlmgr shell\*(C'\fR with the original command line; most useful when +developing \f(CW\*(C`tlmgr\*(C'\fR. +.IP "load [local|remote]" 4 +.IX Item "load [local|remote]" +Explicitly load the local or remote, respectively, \s-1TLPDB.\s0 +.IP "save" 4 +.IX Item "save" +Save the local \s-1TLPDB,\s0 presumably after other operations have changed it. +.IP "get [\fIvar\fR] =item set [\fIvar\fR [\fIval\fR]]" 4 +.IX Item "get [var] =item set [var [val]]" +Get the value of \fIvar\fR, or set it to \fIval\fR. Possible \fIvar\fR names: +\&\f(CW\*(C`debug\-translation\*(C'\fR, \f(CW\*(C`machine\-readable\*(C'\fR, \f(CW\*(C`no\-execute\-actions\*(C'\fR, +\&\f(CW\*(C`require\-verification\*(C'\fR, \f(CW\*(C`verify\-downloads\*(C'\fR, \f(CW\*(C`repository\*(C'\fR, and +\&\f(CW\*(C`prompt\*(C'\fR. All except \f(CW\*(C`repository\*(C'\fR and \f(CW\*(C`prompt\*(C'\fR are booleans, taking +values 0 and 1, and behave like the corresponding command line option. +The \f(CW\*(C`repository\*(C'\fR variable takes a string, and sets the remote +repository location. The \f(CW\*(C`prompt\*(C'\fR variable takes a string, and sets the +current default prompt. +.Sp +If \fIvar\fR or then \fIval\fR is not specified, it is prompted for. +.SS "show" +.IX Subsection "show" +Synonym for info. .SS "uninstall" .IX Subsection "uninstall" -Synonym for \f(CW\*(C`remove\*(C'\fR. +Synonym for remove. .SS "update [\fIoption\fP]... [\fIpkg\fP]..." .IX Subsection "update [option]... [pkg]..." Updates the packages given as arguments to the latest version available @@ -2030,4 +2248,4 @@ This script and its documentation were written for the TeX Live distribution (<http://tug.org/texlive>) and both are licensed under the \&\s-1GNU\s0 General Public License Version 2 or later. .PP -\&\f(CW$Id:\fR tlmgr.pl 47092 2018\-03\-23 22:22:46Z preining $ +\&\f(CW$Id:\fR tlmgr.pl 47132 2018\-03\-26 17:19:25Z karl $ diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf Binary files differindex 94fd055b10a..2dc9db82489 100644 --- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf |