summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-09-12 01:24:02 +0000
committerKarl Berry <karl@freefriends.org>2009-09-12 01:24:02 +0000
commit063f66a299453221b097ba084eb5ff23bd504083 (patch)
tree03fb498097dd6357ac1c71e2c86b7f3b65f088d4 /Master/texmf/doc/man
parent6bc55a675154516e0047913fd83e285e35909f81 (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@15229 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man')
-rw-r--r--Master/texmf/doc/man/man1/asy.pdfbin11139 -> 11139 bytes
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.152
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.pdfbin44526 -> 45769 bytes
3 files changed, 41 insertions, 11 deletions
diff --git a/Master/texmf/doc/man/man1/asy.pdf b/Master/texmf/doc/man/man1/asy.pdf
index 2a9e3953ce2..3aa2a6d4681 100644
--- a/Master/texmf/doc/man/man1/asy.pdf
+++ b/Master/texmf/doc/man/man1/asy.pdf
Binary files differ
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index c7b8e42f451..4cafecf108f 100644
--- a/Master/texmf/doc/man/man1/tlmgr.1
+++ b/Master/texmf/doc/man/man1/tlmgr.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "TLMGR 1"
-.TH TLMGR 1 "2009-09-10" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2009-09-12" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
tlmgr \- the TeX Live Manager
.SH "SYNOPSIS"
@@ -142,14 +142,39 @@ configuration options.
.PP
The most up-to-date version of this documentation is available at
<http://tug.org/texlive/tlmgr.html>, along with procedures for updating
-\&\f(CW\*(C`tlmgr\*(C'\fR itself, disaster recovery when it's broken, and test versions.
+\&\f(CW\*(C`tlmgr\*(C'\fR itself and information about test versions.
+.SH "EXAMPLES"
+.IX Header "EXAMPLES"
+After successfully installing TeX Live, here are a few common operations
+with \f(CW\*(C`tlmgr\*(C'\fR:
+.ie n .IP """tlmgr update \-\-all""" 4
+.el .IP "\f(CWtlmgr update \-\-all\fR" 4
+.IX Item "tlmgr update --all"
+Make your local TeX installation correspond to what is the package
+repository (typically on \s-1CTAN\s0).
+.ie n .IP """tlmgr update \-\-list""" 4
+.el .IP "\f(CWtlmgr update \-\-list\fR" 4
+.IX Item "tlmgr update --list"
+Report what would be updated without actually updating anything.
+.ie n .IP """tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet""" 4
+.el .IP "\f(CWtlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet\fR" 4
+.IX Item "tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet"
+Tell \f(CW\*(C`tlmgr\*(C'\fR to use a nearby \s-1CTAN\s0 mirror for future updates; useful if
+you installed TeX Live from the \s-1DVD\s0 image.
+.ie n .IP """tlmgr show""\fR \fIpkgname" 4
+.el .IP "\f(CWtlmgr show\fR \fIpkgname\fR" 4
+.IX Item "tlmgr show pkgname"
+Display detailed information about \fIpkgname\fR, such as the installation
+status and description.
+.PP
+For all the capabilities and details of \f(CW\*(C`tlmgr\*(C'\fR, please see the
+following voluminous information.
.SH "OPTIONS"
.IX Header "OPTIONS"
-The following options to \f(CW\*(C`tlmgr\*(C'\fR are global options not specific to
-any action. Although we present \f(CW\*(C`tlmgr\*(C'\fR invocation in the above order,
-all options can be given at any place and in arbitrary order. The first
-non-option argument will be the main action.
-In all cases, \f(CW\*(C`\-\-\*(C'\fR\fIoption\fR and
+The following options to \f(CW\*(C`tlmgr\*(C'\fR are global options, not specific to
+any action. All options, whether global or action\-specific, can be
+given at any place and in arbitrary order. The first non-option
+argument will be the main action. In all cases, \f(CW\*(C`\-\-\*(C'\fR\fIoption\fR and
\&\f(CW\*(C`\-\*(C'\fR\fIoption\fR are equivalent, and an \f(CW\*(C`=\*(C'\fR is optional between an option
name and its value.
.IP "\fB\-\-repository\fR \fIurl|path\fR" 4
@@ -160,6 +185,10 @@ installation's TeX Live Package Database (\s-1TLPDB\s0, a file named
\&\f(CW\*(C`texlive.tlpdb\*(C'\fR). The documentation for \f(CW\*(C`install\-tl\*(C'\fR has more details
about this (<http://tug.org/texlive/doc/install\-tl.html>).
.Sp
+\&\f(CW\*(C`\-\-repository\*(C'\fR changes the repository location only for the current
+run; to make a permanent change, use \f(CW\*(C`option repository\*(C'\fR (see the
+option action).
+.Sp
For backward compatibility and convenience, \f(CW\*(C`\-\-location\*(C'\fR and \f(CW\*(C`\-\-repo\*(C'\fR
are accepted as aliases for this option.
.IP "\fB\-\-gui\fR [\fIaction\fR]" 4
@@ -192,12 +221,13 @@ different file for that. This is separate from normal logging; for
that, see the option \f(CW\*(C`\-v\*(C'\fR below, and TeXLive::TLUtils.
.IP "\fB\-\-pause\fR" 4
.IX Item "--pause"
-This option make \fBtlmgr\fR wait for user input before exiting. Useful on
+This option makes \fBtlmgr\fR wait for user input before exiting. Useful on
Windows to avoid command windows disappearing.
.IP "\fB\-\-debug\-translation\fR" 4
.IX Item "--debug-translation"
-This switch will make \f(CW\*(C`tlmgr\*(C'\fR report any missing or probably
-untranslated messages in \s-1GUI\s0 mode to standard error.
+This switch makes \f(CW\*(C`tlmgr\*(C'\fR report, in \s-1GUI\s0 mode, any missing, or more
+likely untranslated, messages to standard error. Helpful for
+translators to see what remains to be done.
.PP
The standard options for TeX Live programs are also accepted:
\&\f(CW\*(C`\-\-help/\-h/\-?\*(C'\fR, \f(CW\*(C`\-\-version\*(C'\fR, \f(CW\*(C`\-q\*(C'\fR (no informational messages), \f(CW\*(C`\-v\*(C'\fR
@@ -649,7 +679,7 @@ Search the TeX Live Database of the installation medium, instead of the
local installation.
.Sh "show [\-\-list] \fIpkg\fP..."
.IX Subsection "show [--list] pkg..."
-Shows information about \fIpkg\fR: the name, category, installation status,
+Display information about \fIpkg\fR: the name, category, installation status,
short and long description. Searches in the remote installation source
for the package if it is not locally installed.
.PP
diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf
index 0a4a7dcf4b7..f08035ee15b 100644
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf
Binary files differ