summaryrefslogtreecommitdiff
path: root/Master/texmf
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-10-29 02:12:16 +0000
committerKarl Berry <karl@freefriends.org>2010-10-29 02:12:16 +0000
commit3e02eb67f0a7d51f6816d18471feb5afa0d114cb (patch)
treeb20c468dc1d5acca150544dc8bf13b9fa0e01e4b /Master/texmf
parent3f0bfcca18e48dba552ba1daf72cf33408197b7f (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@20240 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.183
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.man1.pdfbin61046 -> 61610 bytes
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
Binary files differ