diff options
author | Karl Berry <karl@freefriends.org> | 2013-04-01 02:40:37 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-04-01 02:40:37 +0000 |
commit | cab778f4ef364f1442e1e35883f98782db108ccf (patch) | |
tree | a6ef4a31fa9da1e5b59415dd09347187b36dff71 /Master/texmf/doc/man | |
parent | 20a2f6db341e41485fab78d105f61a061e46733d (diff) |
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@29584 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man')
-rw-r--r-- | Master/texmf/doc/man/man1/tlmgr.1 | 87 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/tlmgr.man1.pdf | bin | 74295 -> 74571 bytes |
2 files changed, 47 insertions, 40 deletions
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1 index d6c67b8a638..c2b93d792a9 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 "2013-03-31" "perl v5.16.3" "User Contributed Perl Documentation" +.TH TLMGR 1 "2013-04-01" "perl v5.16.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 @@ -783,9 +783,9 @@ Shows the current pinning data. .IX Item "pinning add repo pkgglob..." Pins the packages matching the \fIpkgglob\fR(s) to the repository \&\fIrepo\fR. -.ie n .IP """pinning remove \f(CIrepo\f(CW \f(CIpgkglob\f(CW...""" 4 -.el .IP "\f(CWpinning remove \f(CIrepo\f(CW \f(CIpgkglob\f(CW...\fR" 4 -.IX Item "pinning remove repo pgkglob..." +.ie n .IP """pinning remove \f(CIrepo\f(CW \f(CIpkgglob\f(CW...""" 4 +.el .IP "\f(CWpinning remove \f(CIrepo\f(CW \f(CIpkgglob\f(CW...\fR" 4 +.IX Item "pinning remove repo pkgglob..." Any packages recorded in the pinning file matching the <pkgglob>s for the given repository \fIrepo\fR are removed. .ie n .IP """pinning remove \f(CIrepo\f(CW \-\-all""" 4 @@ -1253,37 +1253,35 @@ or should not be included in TeX Live, for whatever reason. The simplest and most reliable method is to temporarily set the installation source to any repository (with the \f(CW\*(C`\-repository\*(C'\fR or \&\f(CW\*(C`option repository\*(C'\fR command line options), and perform your operations. +.PP When you are using multiple repositories over a sustained time, however, -this is inconvenient. Thus, it's possible to tell \f(CW\*(C`tlmgr\*(C'\fR about -additional repositories you want to use. The basic command is \f(CW\*(C`tlmgr -repository add\*(C'\fR. The rest of this section explains further. +explicitly switching between them becomes inconvenient. Thus, it's +possible to tell \f(CW\*(C`tlmgr\*(C'\fR about additional repositories you want to use. +The basic command is \f(CW\*(C`tlmgr repository add\*(C'\fR. The rest of this section +explains further. .PP When using multiple repositories, one of them has to be set as the main -repository, which distributes most of the installed packages. If you +repository, which distributes most of the installed packages. When you switch from a single repository installation to a multiple repository -installation, the previously set repository will be set as the main +installation, the previous sole repository will be set as the main repository. .PP By default, even if multiple repositories are configured, packages are -still \fIonly\fR installed from the main repository. Thus, simply adding a -second repository does not actually enable installation of anything from -there. You also have to specify which packages should be taken from a -different repository by specifying so-called ``pinning'' rules, -described next. +\&\fIstill\fR \fIonly\fR installed from the main repository. Thus, simply +adding a second repository does not actually enable installation of +anything from there. You also have to specify which packages should be +taken from the new repository, by specifying so-called ``pinning'' +rules, described next. .SS "Pinning" .IX Subsection "Pinning" When a package \f(CW\*(C`foo\*(C'\fR is pinned to a repository, a package \f(CW\*(C`foo\*(C'\fR in any other repository, even if it has a higher revision number, will not be considered an installable candidate. .PP -By default, everything is pinned to the main repository, -as if the last line of \f(CW\*(C`pinning.txt\*(C'\fR was +As mentioned above, by default everything is pinned to the main +repository. Let's now go through an example of setting up a second +repository and enabling updates of a package from it. .PP -.Vb 1 -\& main:* -.Ve -.SS "Multiple repository example with tlcontrib" -.IX Subsection "Multiple repository example with tlcontrib" First, check that we have support for multiple repositories, and have only one enabled (as is the case by default): .PP @@ -1293,8 +1291,9 @@ only one enabled (as is the case by default): \& /var/www/norbert/tlnet .Ve .PP -Let's add the \f(CW\*(C`tlcontrib\*(C'\fR repository (<http://tlcontrib.metatex.org>, -maintained by Taco Hoekwater et al.), with the tag \f(CW\*(C`tlcontrib\*(C'\fR: +Ok. Let's add the \f(CW\*(C`tlcontrib\*(C'\fR repository (this is a real +repository, hosted at <http://tlcontrib.metatex.org>, maintained by +Taco Hoekwater et al.), with the tag \f(CW\*(C`tlcontrib\*(C'\fR: .PP .Vb 1 \& $ tlmgr repository add http://tlcontrib.metatex.org/2012 tlcontrib @@ -1309,37 +1308,45 @@ Check the repository list again: \& /var/www/norbert/tlnet (main) .Ve .PP -Specify a pinning entry to get the package \f(CW\*(C`context\*(C'\fR from \f(CW\*(C`tlcontrib\*(C'\fR: +Now we specify a pinning entry to get the package \f(CW\*(C`context\*(C'\fR from +\&\f(CW\*(C`tlcontrib\*(C'\fR: .PP -.Vb 2 -\& $ tlocal=\`kpsewhich \-var\-value TEXMFLOCAL\` -\& $ echo "tlcontrib:context" > $tlocal/tlpkg/pinning.txt +.Vb 1 +\& $ tlmgr pinning add tlcontrib context .Ve .PP Check that we can find \f(CW\*(C`context\*(C'\fR: .PP -.Vb 7 -\& $ tlmgr show microtype -\& tlmgr: using pinning file .../tlpkg/pinning.txt +.Vb 6 +\& $ tlmgr show context \& tlmgr: package repositories: \& ... -\& package: microtype -\& category: Package +\& package: context +\& repository: tlcontrib/26867 \& ... .Ve .PP \&\- install \f(CW\*(C`context\*(C'\fR: .PP -.Vb 5 +.Vb 4 \& $ tlmgr install context -\& tlmgr: using pinning file .../tlpkg/pinning.txt \& tlmgr: package repositories: \& ... -\& [1/1, ??:??/??:??] install: context @tlcontrib [39k] +\& [1/1, ??:??/??:??] install: context @tlcontrib [ .Ve .PP -In the output here you can see that the \f(CW\*(C`context\*(C'\fR package is now +In the output here you can see that the \f(CW\*(C`context\*(C'\fR package has been installed from the \f(CW\*(C`tlcontrib\*(C'\fR repository (\f(CW@tlcontrib\fR). +.PP +Finally, \f(CW\*(C`tlmgr pinning\*(C'\fR also supports removing certain or all packages +from a given repository: +.PP +.Vb 2 +\& $ tlmgr pinning remove tlcontrib context # remove just context +\& $ tlmgr pinning remove tlcontrib \-\-all # take nothing from tlcontrib +.Ve +.PP +A summary of the \f(CW\*(C`tlmgr pinning\*(C'\fR actions is given above. .SH "GUI FOR TLMGR" .IX Header "GUI FOR TLMGR" The graphical user interface for \f(CW\*(C`tlmgr\*(C'\fR needs Perl/Tk to be installed. @@ -1640,9 +1647,9 @@ distribution (<http://tug.org/texlive>) and both are licensed under the .SH "POD ERRORS" .IX Header "POD ERRORS" Hey! \fBThe above document had some coding errors, which are explained below:\fR -.IP "Around line 6492:" 4 -.IX Item "Around line 6492:" +.IP "Around line 6507:" 4 +.IX Item "Around line 6507:" Unterminated C<...> sequence -.IP "Around line 6497:" 4 -.IX Item "Around line 6497:" +.IP "Around line 6512:" 4 +.IX Item "Around line 6512:" Unterminated C<...> sequence diff --git a/Master/texmf/doc/man/man1/tlmgr.man1.pdf b/Master/texmf/doc/man/man1/tlmgr.man1.pdf Binary files differindex 7844aca2662..fdb80eb0ad2 100644 --- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf +++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf |