summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-03-22 03:34:33 +0000
committerKarl Berry <karl@freefriends.org>2013-03-22 03:34:33 +0000
commit358137c9950603b767eb4d774c2a178d95bfeef8 (patch)
treeea302ccd582516471cb8564510e853b8a5d14d00 /Master/texmf/doc/man
parent2584ff2b6da00dcace579be370d2464903e93683 (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@29468 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man')
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.178
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.man1.pdfbin74356 -> 74296 bytes
2 files changed, 36 insertions, 42 deletions
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 4992d05c79a..4e136ed31fc 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-14" "perl v5.16.3" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2013-03-21" "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
@@ -773,23 +773,25 @@ user without admin rights uses the option \f(CW\*(C`\-\-w32mode admin\*(C'\fR a
is issued that the caller does not have enough privileges.
.SS "pinning"
.IX Subsection "pinning"
-The pinning action manages the pinning file, see Pinning for details.
-.IP "\fBpinning show\fR" 4
+The \f(CW\*(C`pinning\*(C'\fR action manages the pinning file, see Pinning below.
+.ie n .IP """pinning show""" 4
+.el .IP "\f(CWpinning show\fR" 4
.IX Item "pinning show"
Shows the current pinning data.
-.IP "\fBpinning check\fR" 4
-.IX Item "pinning check"
-Not implemented at the moment.
-.IP "\fBpinning add \f(BIrepo\fB \f(BIpgkglob\fB [\f(BIpkgglob\fB]\fR" 4
-.IX Item "pinning add repo pgkglob [pkgglob]"
-Pins the packages specified by \fIpkgglob\fR to the repo \fIrepo\fR.
-.IP "\fBpinning remove \f(BIrepo\fB \f(BIpgkglob\fB [\f(BIpkgglob\fB]\fR" 4
-.IX Item "pinning remove repo pgkglob [pkgglob]"
-If there is a the very package glob <pkgglob> recorded in the pinning file
-for the given repo \fIrepo\fR, it is removed.
-.IP "\fBpinning remove \f(BIrepo\fB \-\-all\fR" 4
+.ie n .IP """pinning add \f(CIrepo\f(CW \f(CIpkgglob\f(CW...""" 4
+.el .IP "\f(CWpinning add \f(CIrepo\f(CW \f(CIpkgglob\f(CW...\fR" 4
+.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..."
+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
+.el .IP "\f(CWpinning remove \f(CIrepo\f(CW \-\-all\fR" 4
.IX Item "pinning remove repo --all"
-Remove all pinning data for repo \fIrepo\fR.
+Remove all pinning data for repository \fIrepo\fR.
.SS "platform list|add|remove \fIplatform\fP..."
.IX Subsection "platform list|add|remove platform..."
.SS "platform set \fIplatform\fP"
@@ -1242,20 +1244,19 @@ Examples:
.Ve
.SH "MULTIPLE REPOSITORIES"
.IX Header "MULTIPLE REPOSITORIES"
-The main TeX Live repository includes a vast array of packages.
+The main TeX Live repository contains a vast array of packages.
Nevertheless, additional local repositories can be useful to provide
locally-installed resources, such as proprietary fonts and house styles.
Also, alternative package repositories distribute packages that cannot
-or should not be included in TeX Live, due to being under rapid
-development or for other reasons.
+or should not be included in TeX Live, for whatever reason.
.PP
-The simplest and most reliable method is simply to temporarily set the
-installation source to any repository (with the \f(CW\*(C`\-repository\*(C'\fR command
-line option or \f(CW\*(C`option repository\*(C'\fR), and perform your operations. 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.
+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.
+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.
.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
@@ -1264,29 +1265,13 @@ installation, the previously set repository will be set as the main
repository.
.PP
By default, even if multiple repositories are configured, packages are
-\&\fIonly\fR installed from the main repository. Thus, simply adding a
+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.
.SS "Pinning"
.IX Subsection "Pinning"
-Pinning a package is done by editing (creating) this file:
-.PP
-.Vb 1
-\& TEXMFLOCAL/tlpkg/pinning.txt
-.Ve
-.PP
-with lines of the form:
-.PP
-.Vb 1
-\& repo:pkg[,pkg]
-.Ve
-.PP
-In this line, the \fIrepo\fR is either a full url or repository tag that
-was added to the repository list. Each \fIpkg\fR is a shell-style glob for
-package identifiers.
-.PP
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.
@@ -1652,3 +1637,12 @@ changes would be helpful, do not hesitate to write the mailing list.
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.
+.SH "POD ERRORS"
+.IX Header "POD ERRORS"
+Hey! \fBThe above document had some coding errors, which are explained below:\fR
+.IP "Around line 6485:" 4
+.IX Item "Around line 6485:"
+Unterminated C<...> sequence
+.IP "Around line 6490:" 4
+.IX Item "Around line 6490:"
+Unterminated C<...> sequence
diff --git a/Master/texmf/doc/man/man1/tlmgr.man1.pdf b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
index 4e7a4d469d1..93c839f713b 100644
--- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
Binary files differ