diff options
author | Karl Berry <karl@freefriends.org> | 2008-09-30 13:04:50 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2008-09-30 13:04:50 +0000 |
commit | df5f18b5fe80e260972768f94c403701c2e8668b (patch) | |
tree | c4b31270439d1cce96cc9633ecffe69c162396c6 /Master | |
parent | 4b04dbdaf4dc4a33b34dfb1381cc7fd2c8c39d42 (diff) |
doc fixes
git-svn-id: svn://tug.org/texlive/trunk@10801 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rwxr-xr-x | Master/texmf/scripts/texlive/tlmgr.pl | 71 |
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, |