summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-04-01 02:40:37 +0000
committerKarl Berry <karl@freefriends.org>2013-04-01 02:40:37 +0000
commitcab778f4ef364f1442e1e35883f98782db108ccf (patch)
treea6ef4a31fa9da1e5b59415dd09347187b36dff71 /Master/texmf/doc/man
parent20a2f6db341e41485fab78d105f61a061e46733d (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.187
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.man1.pdfbin74295 -> 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
index 7844aca2662..fdb80eb0ad2 100644
--- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
Binary files differ