summaryrefslogtreecommitdiff
path: root/Master/texmf/scripts
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-07-29 00:35:25 +0000
committerKarl Berry <karl@freefriends.org>2008-07-29 00:35:25 +0000
commit856bf4e5b0a99d0f5aad165f7949d8e914413646 (patch)
tree7954f739e0b2491c0722c5f294a7d25ae246536a /Master/texmf/scripts
parent355de3beede346fad727685a079d21e7aed1c7db (diff)
some (incomplete) help formatting, for the sake of
http://tug.org/texlive/tlmgr.html, although pod2html is apparently sadly insufficient. git-svn-id: svn://tug.org/texlive/trunk@9859 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/scripts')
-rwxr-xr-xMaster/texmf/scripts/texlive/tlmgr.pl49
1 files changed, 25 insertions, 24 deletions
diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 80859c5e7c9..0c0ca5b4cf8 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -1247,7 +1247,9 @@ tlmgr [I<option>]... I<action> [I<option>]... [I<operand>]...
=head1 DESCRIPTION
B<tlmgr> manages an existing TeX Live installation, both packages and
-configurations options.
+configuration options. It performs many of the same actions as
+B<texconfig>(1), and more besides. (texconfig continues to included and
+supported, but tlmgr is now preferred.)
=head1 OPTIONS
@@ -1262,9 +1264,8 @@ updated, overriding the location found in the installation's TLPDB.
=item B<--gui>
-Instead of starting the GUI via the B<gui> action, you can also give this
-option together with an action from above and will be brought directly
-into the respective screen of the GUI. So calling
+You can give this option together with an action to be brought directly
+into the respective screen of the GUI. For example, calling
tlmgr --gui update
@@ -1281,7 +1282,7 @@ language code.
The standard options are also accepted: B<--help/-h/-?>, B<--version>,
B<-q> (no informational messages), B<-v> (debugging messages, can be
-repeated). For more information about the latter, see the
+repeated). For the details about the latter, see the
TeXLive::TLUtils documentation.
=head1 ACTIONS
@@ -1296,16 +1297,16 @@ Gives this help page.
Start the graphical user interface.
-=item B<install [I<option>]... I<pkg>...>
+=item B<install> [I<option>]... I<pkg>...
Install all I<pkg>s given on the command line. By default this installs
all packages that the given I<pkg>s are dependent on, also. Options:
-=over 8
+=over 16
=item B<--no-depends>
-Do not install dependencies. Bydefault, installing a package ensures
+Do not install dependencies. By default, installing a package ensures
that all dependencies of this package are fulfilled.
=item B<--dry-run>
@@ -1316,7 +1317,7 @@ written to the terminal.
=back
-=item B<update [I<option>] [pkg [pkg ...]]>
+=item B<update> [I<option>] [I<pkg>...]
Updates the packages given as arguments to the latest version available
at the installation source. Options:
@@ -1336,7 +1337,7 @@ Update all package.
Nothing is actually installed; instead, the actions to be performed are
written to the terminal.
-=item B<--backupdir directory>
+=item B<--backupdir> I<directory>
If this option is given it must specify an existing directory where a
snapshot of the current package as installed will be saved before
@@ -1345,7 +1346,7 @@ turned out as not working. See the action B<restore> for details.
=back
-=item B<backup --backupdir dir [--all] [pkg [pkg]]>
+=item B<backup> --backupdir I<dir> [B<--all>] [I<pkg>...]
Makes a backup of the given packages (or all packages with B<--all>) to
the directory specified with B<--backupdir> (must exist and be a writable).
@@ -1357,31 +1358,31 @@ Options:
=over 8
-=item B<--backupdir directory>
+=item B<--backupdir> I<directory>
-This is an obligatory argument and has to specify a directory where
-backups are to be found.
+The I<directory> is an obligatory argument and has to specify a
+directory where backups are to be found.
=item B<--all>
-Make a backup of all packages in the texlive.tlpdb
+Make a backup of all packages in the TeX Live installation.
=back
-=item B<restore --backupdir dir [pkg [rev]]>
+=item B<restore --backupdir> I<dir> [I<pkg> [I<rev>]]
-If no B<pkg> and B<rev> is given list all packages the available
-backup revisions.
+If no I<pkg> and I<rev> is given, list the available
+backup revisions for all packages.
-With B<pkg> given but without B<rev> lists all available backup revisions
-of B<pkg>.
+With I<pkg> given but no I<rev>, list all available backup revisions of
+I<pkg>.
-With both B<pkg> an B<rev> given tries to restore the package from its
-backup.
+With both I<pkg> and I<rev>, tries to restore the package from the
+specified backup.
-The option B<--backupdir dir> is obligatory and has to specify a directory
-with backups.
+The option B<--backupdir> I<dir> is obligatory and has to specify a
+directory with backups.
Options: