/home/texlive/karl/Master/tlpkg/bin/tl-update-auto

git-svn-id: svn://tug.org/texlive/trunk@14569 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 31 insertions, 12 deletions

diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 9437874908a..260e1966070 100644
--- a/Master/texmf/doc/man/man1/tlmgr.1
+++ b/Master/texmf/doc/man/man1/tlmgr.1
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "TLMGR 1"
-.TH TLMGR 1 "2009-07-31" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2009-08-06" "perl v5.8.8" "User Contributed Perl Documentation"
 .SH "NAME"
 tlmgr \- the TeX Live Manager
 .SH "SYNOPSIS"
@@ -205,6 +205,8 @@ Gives this help information (same as \f(CW\*(C`\-\-help\*(C'\fR).
 .Sh "version"
 .IX Subsection "version"
 Gives version information (same as \f(CW\*(C`\-\-version\*(C'\fR).
+.PP
+If \fB\-v\fR has been given the revisions of the used modules are reported, too.
 .Sh "gui"
 .IX Subsection "gui"
 Start the graphical user interface.
@@ -496,28 +498,44 @@ a general feature of option parsing.)
 .IX Subsection "conf"
 This option to tlmgr mimicks the \fBtexconfig conf\fR call, but works on
 all supported platforms.
-.Sh "path [add|remove]"
-.IX Subsection "path [add|remove]"
+.Sh "path [\-\-w32mode=user|admin] [add|remove]"
+.IX Subsection "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).
 .PP
-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
-\&\f(CW$tlpdb\fR\->option(\*(L"w32_multi_user\*(R").
-.Sh "postaction [\-w32mode=user|admin] [\-fileassocmode=1|2] [\-all] [install|remove] [shortcut|fileassoc|script] [<package> <package> ...]"
-.IX Subsection "postaction [-w32mode=user|admin] [-fileassocmode=1|2] [-all] [install|remove] [shortcut|fileassoc|script] [<package> <package> ...]"
+On W32 based systems the registry part where the binary directory is
+added or removed is determined in the following way:
+.PP
+If the user has admin rights, and the option \fB\-\-w32mode\fR is not given,
+the setting \fIw32_multi_user\fR determines the location (i.e., if it is
+on then the system path, otherwise the user path is changed).
+.PP
+If the user has admin rights, and the option \fB\-\-w32mode\fR is given, this
+option determines the path to be adjusted.
+.PP
+If the user does not have admin rights, and the option \fB\-\-w32mode\fR
+is not given, and the setting \fIw32_multi_user\fR is off, the user path
+is changed, while if the setting \fIw32_multi_user\fR is on, a warning is
+issued that the caller does not have enough privileges.
+.PP
+If the user does not have admin rights, and the option \fB\-\-w32mode\fR
+is given, it must be \fBuser\fR and the user path will be adjusted. If a
+user without admin rights uses the option \fB\-\-w32mode admin\fR a warning
+is issued that the caller does not have enough provileges.
+.Sh "postaction [\-\-w32mode=user|admin] [\-\-fileassocmode=1|2] [\-all] [install|remove] [shortcut|fileassoc|script] [<package> <package> ...]"
+.IX Subsection "postaction [--w32mode=user|admin] [--fileassocmode=1|2] [-all] [install|remove] [shortcut|fileassoc|script] [<package> <package> ...]"
 Carry out the postaction \f(CW\*(C`shortcut\*(C'\fR, \f(CW\*(C`fileassoc\*(C'\fR, or \f(CW\*(C`script\*(C'\fR as
 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 \f(CW\*(C`\-all\*(C'\fR is given.
 .PP
-The option \f(CW\*(C`\-w32mode\*(C'\fR is \f(CW\*(C`user\*(C'\fR all actions will only carried out in
+The option \f(CW\*(C`\-\-w32mode\*(C'\fR is \f(CW\*(C`user\*(C'\fR all actions will only carried out in
 the user accessible parts of the registry/filesystem, while the \f(CW\*(C`admin\*(C'\fR
 mode selects the system wide parts of the registry for the file associations.
-Note that if you do not have enough permissions using \f(CW\*(C`\-w32mode=admin\*(C'\fR
+Note that if you do not have enough permissions using \f(CW\*(C`\-\-w32mode=admin\*(C'\fR
 will not succeed.
 .PP
-For the postaction \f(CW\*(C`fileassoc\*(C'\fR the mode can be set with <\-fileassocmode>.
+For the postaction \f(CW\*(C`fileassoc\*(C'\fR 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.
 .Sh "paper"
@@ -739,7 +757,8 @@ packages that need updating or installing (which are listed subseqently).
 .PP
 Then comes a line with only the literal string \f(CW\*(C`end\-of\-header\*(C'\fR.
 .PP
-Each following line until \s-1EOF\s0 reports on one package.  The fields on
+Each following line until a line with literal string \f(CW\*(C`end\-of\-updates\*(C'\fR
+reports on one package.  The fields on
 each line are separated by a tab.  Here are the fields.
 .IP "\fIpkgname\fR" 4
 .IX Item "pkgname"
diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf
index 5f1e07a74f8..5d4137d89b1 100644
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf