summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-09-30 13:04:50 +0000
committerKarl Berry <karl@freefriends.org>2008-09-30 13:04:50 +0000
commitdf5f18b5fe80e260972768f94c403701c2e8668b (patch)
treec4b31270439d1cce96cc9633ecffe69c162396c6
parent4b04dbdaf4dc4a33b34dfb1381cc7fd2c8c39d42 (diff)
doc fixes
git-svn-id: svn://tug.org/texlive/trunk@10801 c570f23f-e606-0410-a88d-b1316a301751
-rwxr-xr-xMaster/texmf/scripts/texlive/tlmgr.pl71
1 files changed, 34 insertions, 37 deletions
diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 0cd181eb595..4802381ad1f 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -1636,7 +1636,8 @@ L<http://tug.org/texlive/tlmgr.html>.
=head1 OPTIONS
-The following options have to be given I<before> you specify the action.
+The following options to C<tlmgr> have to be given I<before> you specify
+the main action to perform.
=over 4
@@ -1712,37 +1713,38 @@ written to the terminal.
Updates the packages given as arguments to the latest version available
at the installation source. Either C<--all> or at least one I<pkg> name
-must be specified.
-
-Furthermore, it B<removes> packages which have disappeared on the server.
-To not remove any locally installed packages it does check that the
-package came from the server by checking for inclusion in collections.
-Both options C<--dry-run> and C<--list> will mention the packages
-to be removed. See <--no-remova> for a way to supress that.
-
-Options:
+must be specified. Options:
=over 8
=item B<--all>
-Update already-installed packages, and install new packages in installed
-collections. (Packages in uninstalled collections are not considered.)
-
-=item B<--list>
+Update all installed packages. For packages contained in an installed
+collection, also install new packages and remove deleted packages in
+those collections. Packages not contained in an installed collection
+are not considered for addition or removal.
-List the packages which would be updated or newly installed.
+More precisely, if both the server and the local installation have a
+collection C, and C on the server contains a package A that is not
+present locally, A will be added. Conversely, if the local collection C
+contains a package B, but B is no longer in the server's C, then B will
+be deleted.
-=item B<--no-remove>
+=item B<--list>
-Under normal circumstances tlmgr tries to remove packages which have
-disappeared on the server when called with C<--all>. This prevents
-these removals.
+Concisely list the packages which would be updated, newly installed, or
+removed, without actually changing anything.
=item B<--dry-run>
Nothing is actually installed; instead, the actions to be performed are
-written to the terminal. (A more verbose report than C<--list>.)
+written to the terminal. This is a more detailed report than C<--list>.
+
+=item B<--no-remove>
+
+Under normal circumstances tlmgr tries to remove packages which have
+disappeared on the server when called with C<--all>, as described
+above. This prevents any such removals.
=item B<--backupdir> I<directory>
@@ -1864,22 +1866,21 @@ where YYYY is the TeX Live release year.
=item B<paper letter>
-=item B<[xdvi|dvips|pdftex|dvipdfm|dvipdfmx|context] paper [help|papersize|--list]>
+=item B<[xdvi|dvips|pdftex|dvipdfm|dvipdfmx|context] paper [help|I<papersize>|--list]>
-Configures the system wide paper settings, either for all programs in
-one go, or just for the specified program. The last form with B<--list>
-outputs all known papersizes for the specified program.
+Configures the system wide paper settings, either for all programs at
+once (first two forms), or just for the specified program (third
+form). The third form with C<--list> outputs all known papersizes for the
+specified program.
-=item B<arch list>
+=item B<arch list|add> I<arch>...
-Prints the names of the architectures (C<i386-linux>, ...) available at
-the default install location.
+C<arch list> lists the TeX Live names of all the architectures
+(C<i386-linux>, ...) available at the default install location.
-=item B<arch add I<arch>...>
-
-Add executables for each given architecture I<arch> to the installation.
-Options:
+C<arch add> I<arch> adds the executables for each given architecture
+I<arch> to the installation. Options:
=over 8
@@ -1921,7 +1922,7 @@ for the package if it is not locally installed.
=item B<list [collections|schemes]>
With no argument, lists all packages available at the default install
-location, prefixing those already installed with C<i >.
+location, prefixing those already installed with "C<i>".
With an argument lists only collections or schemes, as requested.
@@ -1934,13 +1935,9 @@ Executes one (or all) check(s) on the consistency of the installation.
=item B<files>
-Checks that all files listed in the TeX Live Database (texlive.tlpdb)
+Checks that all files listed in the TeX Live Database (C<texlive.tlpdb>)
are actually present, and lists those missing.
-Note that on Windows that will not work currently, since Windows does not
-ship find. Also MacOS seems to ship a strange find implementation that does
-not support -wholename, so that will break, too.
-
=item B<collections>
Lists those packages which occur as dependencies in an installed collections,