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

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

2 files changed, 53 insertions, 30 deletions

diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index f9966060505..8292c48bb79 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-26" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2010-10-28" "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
@@ -761,8 +761,8 @@ Print the TeX Live identifier for the detected platform
 .SS "search [\fIoptions\fP] \-\-characterization \fIwhat\fP"
 .IX Subsection "search [options] --characterization what"
 By default, search the names, short descriptions, and long descriptions
-of all locally installed packages for the argument \fIwhat\fR,
-interpreted as a regular expression.
+of all locally installed packages for the argument \fIwhat\fR, interpreted
+as a regular expression.
 .PP
 Options:
 .IP "\fB\-\-global\fR" 4
@@ -771,15 +771,15 @@ Search the TeX Live Database of the installation medium, instead of the
 local installation.
 .IP "\fB\-\-word\fR" 4
 .IX Item "--word"
-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.
+Restrict the search to match only full words. For example, searching for
+\&\f(CW\*(C`table\*(C'\fR with this option will not output packages containing the
+word \f(CW\*(C`tables\*(C'\fR (unless they also contain the word \f(CW\*(C`table\*(C'\fR on its own).
 .IP "\fB\-\-list\fR" 4
 .IX Item "--list"
-If a search for any (or all) taxonomies is done, by specifying
-\&\fB\-\-taxonomy\fR, \fB\-\-keyword\fR, \fB\-\-functionality\fR, or
-\&\fB\-\-characterization\fR, then instead of searching for packages, list the
-entire corresponding taxonomy.  See \*(L"\s-1TAXONOMIES\s0\*(R" below.
+If a search for any (or all) taxonomies is done, by specifying one of
+the taxonomy options below, then instead of searching for packages, list
+the entire corresponding taxonomy (or all of them).  See
+\&\*(L"\s-1TAXONOMIES\s0\*(R" below.
 .PP
 Other search options are selected by specifying one of the following:
 .IP "\fB\-\-file\fR" 4
@@ -795,8 +795,8 @@ List all filenames containing \fIwhat\fR.
 .IP "\fB\-\-characterization\fR" 4
 .IX Item "--characterization"
 .PD
-Search in the given taxonomy instead of the package descriptions.  See
-\&\*(L"\s-1TAXONOMIES\s0\*(R" below.
+Search in the corresponding taxonomy (or all) instead of the package
+descriptions.  See \*(L"\s-1TAXONOMIES\s0\*(R" below.
 .SS "show [\fIoptions\fP] \fIpkg\fP..."
 .IX Subsection "show [options] pkg..."
 Display information about \fIpkg\fR: the name, category, installation status,
@@ -811,9 +811,9 @@ 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.
+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
@@ -824,9 +824,9 @@ outputs their dependencies in a similar way.
 .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.
+In addition to the normal data displayed, also display information for
+given packages from the corresponding taxonomy (or all of them).  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
@@ -1075,10 +1075,42 @@ line options of \f(CW\*(C`tlmgr\*(C'\fR. \f(CW\*(C`gui\-expertmode\*(C'\fR switc
 \&\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.
+tlmgr allows searching and listing of various categorizations, which we
+call \fItaxonomies\fR, as provided by an enhanced TeX Catalogue (available
+for testing at <http://az.ctan.org>).  This is useful when, for
+example, you don't know a specific package name but have an idea of the
+functionality you need; or when you want to see all packages relating to
+a given area.
+.PP
+There are three different taxonomies, specified by the following
+options:
+.IP "\fB\-\-keyword\fR" 4
+.IX Item "--keyword"
+The keywords, as specified at <http://az.ctan.org/keyword>.
+.IP "\fB\-\-functionality\fR" 4
+.IX Item "--functionality"
+The ``by\-topic'' categorization created by J\e"urgen Fenn, as specified
+at <http://az.ctan.org/characterization/by\-function>.
+.IP "\fB\-\-characterization\fR" 4
+.IX Item "--characterization"
+Both the primary and secondary functionalities, as specified at
+<http://az.ctan.org/characterization/choose_dimen>.
+.IP "\fB\-\-taxonomy\fR" 4
+.IX Item "--taxonomy"
+Operate on all the taxonomies.
+.PP
+The taxonomies are updated nightly and stored within TeX Live, so
+Internet access is not required to search them.
 .PP
-\&\s-1MORE\s0 \s-1INFORMATION\s0 \s-1NEEDED\s0.
+Examples:
+.PP
+.Vb 5
+\&  tlmgr search \-\-taxonomy exercise      # check all taxonomies for "exercise"
+\&  tlmgr search \-\-taxonomy \-\-word table  # check for "table" on its own
+\&  tlmgr search \-\-list \-\-keyword         # dump entire keyword taxonomy
+\&  tlmgr show \-\-taxonomy pdftex          # show pdftex package information,
+\&                                        #   including all taxonomy entries
+.Ve
 .SH "GUI FOR TLMGR"
 .IX Header "GUI FOR TLMGR"
 The graphical user interface for \f(CW\*(C`tlmgr\*(C'\fR needs Perl/TK being installed.
@@ -1352,12 +1384,3 @@ 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 5616:" 4
-.IX Item "Around line 5616:"
-Unknown directive: =over4
-.IP "Around line 5618:" 4
-.IX Item "Around line 5618:"
-\&'=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 7ef376786ec..878741a8d55 100644
--- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf