summaryrefslogtreecommitdiff
path: root/Master/texmf
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2009-08-06 13:18:16 +0000
committerNorbert Preining <preining@logic.at>2009-08-06 13:18:16 +0000
commitae1173ec6fdb5824665e5f5917f725549147df85 (patch)
tree5fea82e16a44ace3b4d71894fe84206347da7fc2 /Master/texmf
parent523a3a5a8496779171b512dc7787aa75d8864e71 (diff)
tlmgr: add documentation for --w32mode in action path
all modules: add MODULE->module_revision function tlmgr: if action version is called with -v, also issue the revision of the modules used (eg TLPDB->module_revision()) git-svn-id: svn://tug.org/texlive/trunk@14552 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
-rwxr-xr-xMaster/texmf/scripts/texlive/tlmgr.pl55
1 files changed, 43 insertions, 12 deletions
diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 407860f3e13..17ffb660f10 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -6,9 +6,6 @@
# or any later version.
#
# TODO:
-# - in GUI mode updating texlive.infra DOES work without
-# the warning, but it does NOT force to restart the GUI. THAT IS BAD!!!
-#
# - tlmgr should have a "progress" bar for the update --all and install
# etc options, echoing number of total packages etc etc.
#
@@ -164,6 +161,7 @@ sub main {
"arch" => { "dry-run|n" => 1 },
"generate" => { "localcfg" => "=s",
"dest" => "=s" },
+ "path" => { "w32mode" => "=s" },
"postaction" => {"w32mode" => "=s",
"all" => 1,
"fileassocmode" => "=i" },
@@ -322,6 +320,19 @@ sub give_version {
close (REL_TL);
}
}
+ #
+ # add the list of revisions
+ if ($::opt_verbosity > 0) {
+ $::version_string .= "Revision of modules:";
+ $::version_string .= "\nTLConfig: " . TeXLive::TLConfig->module_revision();
+ $::version_string .= "\nTLUtils: " . TeXLive::TLUtils->module_revision();
+ $::version_string .= "\nTLPOBJ: " . TeXLive::TLPOBJ->module_revision();
+ $::version_string .= "\nTLPDB: " . TeXLive::TLPDB->module_revision();
+ $::version_string .= "\nTLMedia: " . TeXLive::TLMedia->module_revision();
+ $::version_string .= "\nTLPaper: " . TeXLive::TLPaper->module_revision();
+ $::version_string .= "\nTLWinGoo: " . TeXLive::TLWinGoo->module_revision();
+ $::version_string .= "\n";
+ }
return $::version_string;
}
@@ -3618,6 +3629,8 @@ Gives this help information (same as C<--help>).
Gives version information (same as C<--version>).
+If B<-v> has been given the revisions of the used modules are reported, too.
+
=head2 gui
Start the graphical user interface.
@@ -3960,16 +3973,33 @@ a general feature of option parsing.)
This option to tlmgr mimicks the B<texconfig conf> call, but works on
all supported platforms.
-=head2 path [add|remove]
+=head2 path [--w32mode=user|admin] [add|remove]
On unix adds or removes symlinks for binaries, man pages, and info pages
in the directories specified by the respective options (see above).
-On W32 based systems it adds or removes the binary dir to the system or
-user registry path entry, depending on being admin and the setting
-$tlpdb->option("w32_multi_user").
+On W32 based systems the registry part where the binary directory is
+added or removed is determined in the following way:
+
+If the user has admin rights, and the option B<--w32mode> is not given,
+the setting I<w32_multi_user> determines the location (i.e., if it is
+on then the system path, otherwise the user path is changed).
+
+If the user has admin rights, and the option B<--w32mode> is given, this
+option determines the path to be adjusted.
+
+If the user does not have admin rights, and the option B<--w32mode>
+is not given, and the setting I<w32_multi_user> is off, the user path
+is changed, while if the setting I<w32_multi_user> is on, a warning is
+issued that the caller does not have enough privileges.
+
+If the user does not have admin rights, and the option B<--w32mode>
+is given, it must be B<user> and the user path will be adjusted. If a
+user without admin rights uses the option B<--w32mode admin> a warning
+is issued that the caller does not have enough provileges.
+
-=head2 postaction [-w32mode=user|admin] [-fileassocmode=1|2] [-all]
+=head2 postaction [--w32mode=user|admin] [--fileassocmode=1|2] [-all]
[install|remove] [shortcut|fileassoc|script] [<package> <package> ...]
Carry out the postaction C<shortcut>, C<fileassoc>, or C<script> as
@@ -3977,13 +4007,13 @@ given as second obligatory argument in install or remove mode (first
obligatory argument), for either the packages given on the command line,
or for all if C<-all> is given.
-The option C<-w32mode> is C<user> all actions will only carried out in
+The option C<--w32mode> is C<user> all actions will only carried out in
the user accessible parts of the registry/filesystem, while the C<admin>
mode selects the system wide parts of the registry for the file associations.
-Note that if you do not have enough permissions using C<-w32mode=admin>
+Note that if you do not have enough permissions using C<--w32mode=admin>
will not succeed.
-For the postaction C<fileassoc> the mode can be set with <-fileassocmode>.
+For the postaction C<fileassoc> the mode can be set with <--fileassocmode>.
If it is set to 1, only new assocations are added, if it is set to 2,
all associations are set to the TeX Live programs.
@@ -4260,7 +4290,8 @@ packages that need updating or installing (which are listed subseqently).
Then comes a line with only the literal string C<end-of-header>.
-Each following line until EOF reports on one package. The fields on
+Each following line until a line with literal string C<end-of-updates>
+reports on one package. The fields on
each line are separated by a tab. Here are the fields.
=over 4