/home/texlive/karl/Master/tlpkg/bin/tl-update-auto

git-svn-id: svn://tug.org/texlive/trunk@20158 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 59 insertions, 6 deletions

diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 7059de58ae2..77ffd8d5040 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 "2010-10-19" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2010-10-22" "perl v5.10.1" "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
@@ -754,6 +754,12 @@ Print the TeX Live identifier for the detected platform
 .IX Subsection "search [options] --file what"
 .SS "search [\fIoptions\fP] \-\-taxonomy \fIwhat\fP"
 .IX Subsection "search [options] --taxonomy what"
+.SS "search [\fIoptions\fP] \-\-keyword \fIwhat\fP"
+.IX Subsection "search [options] --keyword what"
+.SS "search [\fIoptions\fP] \-\-functionality \fIwhat\fP"
+.IX Subsection "search [options] --functionality what"
+.SS "search [\fIoptions\fP] \-\-characterization \fIwhat\fP"
+.IX Subsection "search [options] --characterization what"
 By default searches the names, short and long descriptions of all
 locally installed packages for the given argument (interpreted as
 regexp).
@@ -768,20 +774,36 @@ local installation.
 Restrict the search to match only full words. As an example searching
 for \f(CW\*(C`table\*(C'\fR with this option will not output packages containing
 the the word \f(CW\*(C`tables\*(C'\fR unless they also contain the word \f(CW\*(C`table\*(C'\fR.
-.PP
-Other search options are selected by adding either \fB\-\-file\fR or \fB\-\-taxonomy\fR.
+.IP "\fB\-\-list\fR" 4
+.IX Item "--list"
+If a search for any (or all) taxonomies is done by given either
+\&\fB\-\-taxonomy\fR, \fB\-\-keyword\fR, \fB\-\-functionality\fR, or \fB\-\-characterization\fR,
+then instead of actually searching for packages, simply lists the
+keywords, functionalities, characterizations, or all of them.
+.PP
+Other search options are selected by adding either \fB\-\-file\fR, \fB\-\-taxonomy\fR,
+\&\fB\-\-keyword\fR, \fB\-\-functionality\fR, or \fB\-\-characterization\fR.
 .IP "\fB\-\-file\fR" 4
 .IX Item "--file"
 List all filenames containing \fIwhat\fR.
 .IP "\fB\-\-taxonomy\fR" 4
 .IX Item "--taxonomy"
+.PD 0
+.IP "\fB\-\-keyword\fR" 4
+.IX Item "--keyword"
+.IP "\fB\-\-functionality\fR" 4
+.IX Item "--functionality"
+.IP "\fB\-\-characterization\fR" 4
+.IX Item "--characterization"
+.PD
 Searches in the list of keywords, and its characterization and functional
-specifications (\s-1MORE\s0 \s-1DETAILS\s0 \s-1NEEDED\s0) instead of the package descriptions.
+specifications instead of the package descriptions.
+See \*(L"\s-1TAXONOMIES\s0\*(R" below for details.
 .IP "\fB\-\-extended\fR" 4
 .IX Item "--extended"
 Not implemented yet.
-.SS "show [\-\-list] \fIpkg\fP..."
-.IX Subsection "show [--list] pkg..."
+.SS "show [\fIoptions\fP] \fIpkg\fP..."
+.IX Subsection "show [options] pkg..."
 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.
@@ -790,10 +812,26 @@ It also displays the information taken from the TeX Catalogue (license,
 date, version), but note that there is a high probability that this
 information is slightly off due to timing issues.
 .PP
+Options:
+.IP "\fB\-\-list\fR" 4
+.IX Item "--list"
 If the option \f(CW\*(C`\-\-list\*(C'\fR is given with a package, the list of contained
 files is also shown, including those for platform-specific
 dependencies.  When given with schemes and collections, \f(CW\*(C`\-\-list\*(C'\fR
 outputs their dependencies in a similar way.
+.IP "\fB\-\-taxonomy\fR" 4
+.IX Item "--taxonomy"
+.PD 0
+.IP "\fB\-\-keyword\fR" 4
+.IX Item "--keyword"
+.IP "\fB\-\-functionality\fR" 4
+.IX Item "--functionality"
+.IP "\fB\-\-characterization\fR" 4
+.IX Item "--characterization"
+.PD
+In addition to the normal data displayed, also display the various
+taxonomies. 
+See \*(L"\s-1TAXONOMIES\s0\*(R" below for details.
 .SS "list [\-\-only\-installed] [collections|schemes|\fIpkg\fP...]"
 .IX Subsection "list [--only-installed] [collections|schemes|pkg...]"
 With no argument, lists all packages available at the package
@@ -1041,6 +1079,12 @@ The values can only be 0 or 1 for those settings.
 command line options of \f(CW\*(C`tlmgr\*(C'\fR. \f(CW\*(C`gui_expertmode\*(C'\fR switches between
 the full \s-1GUI\s0 and a simplified with only the important and mostly used
 settings.
+.SH "TAXONOMIES"
+.IX Header "TAXONOMIES"
+tlmgr allows searching and listing of various taxonomies as provided
+by newer version of the TeX Catalogue.
+.PP
+\&\s-1MORE\s0 \s-1INFORMATION\s0 \s-1NEEDED\s0.
 .SH "GUI"
 .IX Header "GUI"
 The graphical user interface for \f(CW\*(C`tlmgr\*(C'\fR needs Perl/TK being installed.
@@ -1315,3 +1359,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 5612:" 4
+.IX Item "Around line 5612:"
+Unknown directive: =over4
+.IP "Around line 5614:" 4
+.IX Item "Around line 5614:"
+\&'=item' outside of any '=over'
diff --git a/Master/texmf/doc/man/man1/tlmgr.man1.pdf b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
index b7dd2dc1fdb..2d0af565cb7 100644
--- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf