summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-08-24 02:38:33 +0000
committerKarl Berry <karl@freefriends.org>2009-08-24 02:38:33 +0000
commit8b508e5590ee0950c4f39438dc87b75ad348d5b1 (patch)
tree72db4a1f5253a43e35666e6589d72041c6908a1a /Master
parent47a4aa1265de22e6eb01504df118a60b95f55fee (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@14838 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/doc.html68
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.187
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.pdfbin41012 -> 41300 bytes
3 files changed, 109 insertions, 46 deletions
diff --git a/Master/doc.html b/Master/doc.html
index 0b17fea9d05..8205063af99 100644
--- a/Master/doc.html
+++ b/Master/doc.html
@@ -89,6 +89,61 @@ directories), sorted by package name.
<a href="texmf-dist/doc/context/document/general/manuals/tiptrick.pdf">tiptrick.pdf</a>
</small>
+<li><b><a href="texmf-dist/doc/context/manuals/reference/en">context/manuals/reference/en</a>:</b><small>
+ <a href="texmf-dist/doc/context/manuals/reference/en/co-fonts.pdf">co-fonts.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/co-typography.pdf">co-typography.pdf</a>
+ </small>
+
+<li><b><a href="texmf-dist/doc/context/manuals/reference/en/columns">context/manuals/reference/en/columns</a>:</b><small>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-000.pdf">cols-000.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-001.pdf">cols-001.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-002.pdf">cols-002.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-003.pdf">cols-003.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-004.pdf">cols-004.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-005.pdf">cols-005.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-006.pdf">cols-006.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-007.pdf">cols-007.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-101.pdf">cols-101.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-102.pdf">cols-102.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-103.pdf">cols-103.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-200.pdf">cols-200.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-201.pdf">cols-201.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-202.pdf">cols-202.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-203.pdf">cols-203.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-204.pdf">cols-204.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-205.pdf">cols-205.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-206.pdf">cols-206.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-301.pdf">cols-301.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-401.pdf">cols-401.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-402.pdf">cols-402.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-403.pdf">cols-403.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-404.pdf">cols-404.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-405.pdf">cols-405.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-406.pdf">cols-406.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-407.pdf">cols-407.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-501.pdf">cols-501.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-701.pdf">cols-701.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-702.pdf">cols-702.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-703.pdf">cols-703.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-704.pdf">cols-704.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-801.pdf">cols-801.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-802.pdf">cols-802.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-803.pdf">cols-803.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-804.pdf">cols-804.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-805.pdf">cols-805.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cols-806.pdf">cols-806.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/columns/cow.pdf">cow.pdf</a>
+ </small>
+
+<li><b><a href="texmf-dist/doc/context/manuals/reference/en">context/manuals/reference/en</a>:</b><small>
+ <a href="texmf-dist/doc/context/manuals/reference/en/contextref.pdf">contextref.pdf</a>
+ </small>
+
+<li><b><a href="texmf-dist/doc/context/manuals/reference/en/typography">context/manuals/reference/en/typography</a>:</b><small>
+ <a href="texmf-dist/doc/context/manuals/reference/en/typography/encodings.pdf">encodings.pdf</a>
+ <a href="texmf-dist/doc/context/manuals/reference/en/typography/glyphs.pdf">glyphs.pdf</a>
+ </small>
+
<li><b><a href="texmf-dist/doc/context/scripts/perl">context/scripts/perl</a>:</b><small>
<a href="texmf-dist/doc/context/scripts/perl/texshow.html">texshow.html</a>
</small>
@@ -330,10 +385,11 @@ directories), sorted by package name.
<a href="texmf-dist/doc/fonts/blacklettert1/blacklettert1.pdf">blacklettert1.pdf</a>
</small>
-<li><b><a href="texmf-dist/doc/fonts/boisik">fonts/boisik</a>:</b><small>
- <a href="texmf-dist/doc/fonts/boisik/boisik-idiot.pdf">boisik-idiot.pdf</a>
- <a href="texmf-dist/doc/fonts/boisik/boisik.pdf">boisik.pdf</a>
- <a href="texmf-dist/doc/fonts/boisik/table.pdf">table.pdf</a>
+<li><b><a href="texmf-dist/doc/fonts/boisik/example">fonts/boisik/example</a>:</b><small>
+ <a href="texmf-dist/doc/fonts/boisik/example/boisik-idiot.pdf">boisik-idiot.pdf</a>
+ <a href="texmf-dist/doc/fonts/boisik/example/boisik.pdf">boisik.pdf</a>
+ <a href="texmf-dist/doc/fonts/boisik/example/table.pdf">table.pdf</a>
+ <a href="texmf-dist/doc/fonts/boisik/example/testfont.pdf">testfont.pdf</a>
</small>
<li><b><a href="texmf-dist/doc/fonts/burmese">fonts/burmese</a>:</b><small>
@@ -5462,6 +5518,10 @@ directories), sorted by package name.
<a href="texmf-dist/doc/latex/thmtools/thmtools.pdf">thmtools.pdf</a>
</small>
+<li><b><a href="texmf-dist/doc/latex/threeparttablex">latex/threeparttablex</a>:</b><small>
+ <a href="texmf-dist/doc/latex/threeparttablex/threeparttablex.pdf">threeparttablex.pdf</a>
+ </small>
+
<li><b><a href="texmf-dist/doc/latex/thumb">latex/thumb</a>:</b><small>
<a href="texmf-dist/doc/latex/thumb/thumb.pdf">thumb.pdf</a>
</small>
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 73a69f32582..7ba3e8ab076 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-08-23" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2009-08-24" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
tlmgr \- the TeX Live Manager
.SH "SYNOPSIS"
@@ -144,7 +144,7 @@ included and supported, but \f(CW\*(C`tlmgr\*(C'\fR is now preferred.)
.PP
The most up-to-date version of this documentation is available at
<http://tug.org/texlive/tlmgr.html>, along with procedures for updating
-tlmgr itself, disaster recovery when it's broken, and test versions.
+\&\f(CW\*(C`tlmgr\*(C'\fR itself, disaster recovery when it's broken, and test versions.
.SH "OPTIONS"
.IX Header "OPTIONS"
The following options to \f(CW\*(C`tlmgr\*(C'\fR are global options not specific to
@@ -194,8 +194,8 @@ This option make \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 tlmgr report any missing or probably
-untranslated messages in \s-1GUI\s0 mode to \s-1STDERR\s0.
+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.
.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
@@ -203,7 +203,7 @@ The standard options for TeX Live programs are also accepted:
the TeXLive::TLUtils documentation.
.PP
The \f(CW\*(C`\-\-version\*(C'\fR option shows version information about the TeX Live
-release as well as the \f(CW\*(C`tlmgr\*(C'\fR script itself. If paired with \f(CW\*(C`\-v\*(C'\fR,
+release and about the \f(CW\*(C`tlmgr\*(C'\fR script itself. If paired with \f(CW\*(C`\-v\*(C'\fR,
revision number for the used TeX Live Perl modules are shown, too.
.SH "ACTIONS"
.IX Header "ACTIONS"
@@ -248,9 +248,9 @@ Nothing is actually installed; instead, the actions to be performed are
written to the terminal.
.IP "\fB\-\-force\fR" 4
.IX Item "--force"
-If updates to the tlmgr itself (and the underlying infrastructure) are
-present tlmgr will bail out and not perform the installation unless this option
-is given.
+If updates to \f(CW\*(C`tlmgr\*(C'\fR itself (or other parts of the basic
+infrastructure) are present, \f(CW\*(C`tlmgr\*(C'\fR will bail out and not perform the
+installation unless this option is given. Not recommended.
.Sh "update [\fIoption\fP]... [\fIpkg\fP]..."
.IX Subsection "update [option]... [pkg]..."
Updates the packages given as arguments to the latest version available
@@ -258,8 +258,8 @@ at the installation source. Either \f(CW\*(C`\-\-all\*(C'\fR or at least one \f
must be specified. Options:
.IP "\fB\-\-all\fR" 4
.IX Item "--all"
-Update all installed packages except for tlmgr itself. Thus, if updates
-to tlmgr itself are present, this will simply give an error, unless also
+Update all installed packages except for \f(CW\*(C`tlmgr\*(C'\fR itself. Thus, if updates
+to \f(CW\*(C`tlmgr\*(C'\fR itself are present, this will simply give an error, unless also
the option \f(CW\*(C`\-\-force\*(C'\fR or \f(CW\*(C`\-\-self\*(C'\fR is given. (See below.)
.Sp
In addition to updating the installed packages, during the update of a
@@ -267,7 +267,7 @@ collection the local installation is (by default) synchronized to the
status of the collection on the server, for both additions and removals.
.Sp
Specifically, if a package has been removed on the server (and thus has
-also been removed from the respective collection), tlmgr will remove the
+also been removed from the respective collection), \f(CW\*(C`tlmgr\*(C'\fR will remove the
package also on the local installation. This is called ``auto\-remove''
and is announced as such when using the option \f(CW\*(C`\-\-list\*(C'\fR. This
auto-removal can be suppressed using the option \f(CW\*(C`\-\-no\-auto\-remove\*(C'\fR.
@@ -285,12 +285,12 @@ To reinstall any such forcibly removed packages use
\&\f(CW\*(C`\-\-reinstall\-forcibly\-removed\*(C'\fR.
.IP "\fB\-\-self\fR" 4
.IX Item "--self"
-Update tlmgr itself (that is, the infrastructure packages) if updates to
+Update \f(CW\*(C`tlmgr\*(C'\fR itself (that is, the infrastructure packages) if updates to
it are present. On Windows this includes updates to the private Perl
interpreter shipped inside TeX Live.
.Sp
If this option is given together with \f(CW\*(C`\-\-all\*(C'\fR or a list of packages
-then tlmgr will be updated first and, if this update the new version
+then \f(CW\*(C`tlmgr\*(C'\fR will be updated first and, if this update the new version
will be restarted to complete the rest of the updates.
.Sp
In brief:
@@ -310,18 +310,18 @@ Nothing is actually installed; instead, the actions to be performed are
written to the terminal. This is a more detailed report than \f(CW\*(C`\-\-list\*(C'\fR.
.IP "\fB\-\-force\fR" 4
.IX Item "--force"
-Force update of normal packages, without updating tlmgr itself
+Force update of normal packages, without updating \f(CW\*(C`tlmgr\*(C'\fR itself
(unless the \f(CW\*(C`\-\-self\*(C'\fR option is also given). Not recommended.
.Sp
Also, \f(CW\*(C`update \-\-list\*(C'\fR is still performed regardless of this option.
.IP "\fB\-\-no\-auto\-remove\fR" 4
.IX Item "--no-auto-remove"
-Under normal circumstances tlmgr tries to remove packages which have
+Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR tries to remove packages which have
disappeared on the server when called with \f(CW\*(C`\-\-all\*(C'\fR, as described
above. This prevents any such removals.
.IP "\fB\-\-no\-auto\-install\fR" 4
.IX Item "--no-auto-install"
-Under normal circumstances tlmgr will install packages which are
+Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will install packages which are
new on the server when called with \f(CW\*(C`\-\-all\*(C'\fR. This prevents any such
automatic installation. Note that after this the packages that
would have been auto-installed will be considered as
@@ -340,10 +340,10 @@ is equivalent to
.Ve
.IP "\fB\-\-reinstall\-forcibly\-removed\fR" 4
.IX Item "--reinstall-forcibly-removed"
-Under normal circumstances tlmgr will not install packages that it
+Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will not install packages that it
considers forcibly removed (that is, removed with `remove \-\-force' or
whose installation was prohibited by \-\-no\-auto\-install during an
-earlier update). This option makes tlmgr consider all these packages
+earlier update). This option makes \f(CW\*(C`tlmgr\*(C'\fR consider all these packages
as new and re-install them. This can be used to syncronize an
installation with the server's idea of what is available by calling
.Sp
@@ -352,24 +352,24 @@ installation with the server's idea of what is available by calling
.Ve
.IP "\fB\-\-backup\fR and \fB\-\-backupdir\fR \fIdirectory\fR" 4
.IX Item "--backup and --backupdir directory"
-These two options control the creation of backups of packages before an
-update is started; that is, the backup is of the package as it's
-installed. If neither of the two are given, no backup package will be
-saved. 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.
+These two options control the creation of backups of packages \fIbefore\fR
+updating; that is, backup of packages as currently installed. If
+neither of these options are given, no backup package will be saved. 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 create
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.
+backups. Please see the \f(CW\*(C`option\*(C'\fR action for details.
.Sp
-\&\f(CW\*(C`tlmgr\*(C'\fR always makes a temporary backup when updating packages, in case
-of download or other failure during an update. The purpose of this
-\&\f(CW\*(C`\-\-backup\*(C'\fR option is to allow you to save a persistent backup in case
-the actual \fIcontent\fR of the update causes problems, e.g., introduces an
-incompatibility.
+\&\f(CW\*(C`tlmgr\*(C'\fR unconditionally makes a temporary backup when updating
+packages, in case of download or other failure during an update. In
+contrast, the purpose of this \f(CW\*(C`\-\-backup\*(C'\fR option is to allow you to save
+a persistent backup in case the actual \fIcontent\fR of the update causes
+problems, e.g., introduces an incompatibility.
.Sp
The \f(CW\*(C`restore\*(C'\fR action explains how to restore from a backup.
.IP "\fB\-\-no\-depends\fR" 4
@@ -488,7 +488,7 @@ Possible values for \fIkey\fR are (but see \fBtlmgr option showall\fR for
the definitive list):
.PP
.Vb 9
-\& location (default installation location),
+\& location (default installation source),
\& formats (create formats at installation time),
\& docfiles (install documentation files),
\& srcfiles (install source files),
@@ -499,9 +499,9 @@ the definitive list):
\& sys_info (location where info pages are linked to by action path)
.Ve
.PP
-One common use of \f(CW\*(C`option\*(C'\fR is if you originally installed from \s-1DVD\s0, and
-want to permanently change the installation to get further updates from
-the Internet. To do this, you can run
+One common use of \f(CW\*(C`option\*(C'\fR is to permanently change the installation to
+get further updates from the Internet, after originally installing from
+\&\s-1DVD\s0. To do this, you can run
.PP
.Vb 1
\& tlmgr option location http://mirror.ctan.org/systems/texlive/tlnet
@@ -535,19 +535,22 @@ Or you can use:
\& tlmgr option -- autobackup -1
.Ve
.PP
-The \f(CW\*(C`\-\-\*(C'\fR avoids having the \f(CW\*(C`\-1\*(C'\fR treated as an option. (In general,
-\&\f(CW\*(C`\-\-\*(C'\fR stops parsing for arguments at the point where it appears; this is
-a general feature of option parsing.)
+The \f(CW\*(C`\-\-\*(C'\fR avoids having the \f(CW\*(C`\-1\*(C'\fR treated as an option. (For most
+programs, \f(CW\*(C`\-\-\*(C'\fR stops parsing for arguments at the point where it
+appears; this is a general feature of option parsing.)
.Sh "conf"
.IX Subsection "conf"
-This option to tlmgr mimicks the \fBtexconfig conf\fR call, but works on
+Show general configuration information for TeX Live, including active
+configuration files, path settings, and more.
+.PP
+This option to \f(CW\*(C`tlmgr\*(C'\fR mimics the \f(CW\*(C`texconfig conf\*(C'\fR call, but works on
all supported platforms.
.Sh "path [\-\-w32mode=user|admin] [add|remove]"
.IX Subsection "path [--w32mode=user|admin] [add|remove]"
-On unix adds or removes symlinks for binaries, man pages, and info pages
+On Unix adds or removes symlinks for binaries, man pages, and info pages
in the directories specified by the respective options (see above).
.PP
-On W32 based systems the registry part where the binary directory is
+On Windows, the registry part where the binary directory is
added or removed is determined in the following way:
.PP
If the user has admin rights, and the option \f(CW\*(C`\-\-w32mode\*(C'\fR is not given,
diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf
index 65cde3238c7..5057a2fac00 100644
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf
Binary files differ