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

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

2 files changed, 20 insertions, 28 deletions

diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index f30bf7aca92..ebd032dac80 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.1
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.1
@@ -124,7 +124,7 @@
 .\" ========================================================================
 .\"
 .IX Title "TLMGR 1"
-.TH TLMGR 1 "2013-04-10" "perl v5.16.3" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2013-04-12" "perl v5.16.3" "User Contributed Perl Documentation"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -778,13 +778,13 @@ The \f(CW\*(C`pinning\*(C'\fR action manages the pinning file, see Pinning below
 .el .IP "\f(CWpinning show\fR" 4
 .IX Item "pinning show"
 Shows the current pinning data.
-.ie n .IP """pinning add \f(CIrepo\f(CW \f(CIpkgglob\f(CW...""" 4
-.el .IP "\f(CWpinning add \f(CIrepo\f(CW \f(CIpkgglob\f(CW...\fR" 4
+.ie n .IP """pinning add"" \fIrepo\fR \fIpkgglob\fR..." 4
+.el .IP "\f(CWpinning add\fR \fIrepo\fR \fIpkgglob\fR..." 4
 .IX Item "pinning add repo pkgglob..."
 Pins the packages matching the \fIpkgglob\fR(s) to the repository
 \&\fIrepo\fR.
-.ie n .IP """pinning remove \f(CIrepo\f(CW \f(CIpkgglob\f(CW...""" 4
-.el .IP "\f(CWpinning remove \f(CIrepo\f(CW \f(CIpkgglob\f(CW...\fR" 4
+.ie n .IP """pinning remove"" \fIrepo\fR \fIpkgglob\fR..." 4
+.el .IP "\f(CWpinning remove\fR \fIrepo\fR \fIpkgglob\fR..." 4
 .IX Item "pinning remove repo pkgglob..."
 Any packages recorded in the pinning file matching the <pkgglob>s for
 the given repository \fIrepo\fR are removed.
@@ -1027,7 +1027,7 @@ has also been removed from the respective collection), \f(CW\*(C`tlmgr\*(C'\fR w
 remove the package in the local installation.  This is called
 ``auto\-remove'' and is announced as such when using the option
 \&\f(CW\*(C`\-\-list\*(C'\fR.  This auto-removal can be suppressed using the option
-\&\f(CW\*(C`\-\-no\-auto\-remove\*(C'\fR.
+\&\f(CW\*(C`\-\-no\-auto\-remove\*(C'\fR (not recommended, see option description).
 .Sp
 Analogously, if a package has been added to a collection on the server
 that is also installed locally, it will be added to the local
@@ -1100,10 +1100,12 @@ removed package, \f(CW\*(C`tlmgr\*(C'\fR quits with an error message.  Excludes
 supported in these circumstances.
 .IP "\fB\-\-no\-auto\-remove\fR [\fIpkg\fR]..." 4
 .IX Item "--no-auto-remove [pkg]..."
-Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR tries to remove packages which have
-disappeared on the server, as described above under \f(CW\*(C`\-\-all\*(C'\fR.  This
-option prevents any such removals, either for all packages (with
-\&\f(CW\*(C`\-\-all\*(C'\fR), or the given \fIpkg\fR names.
+By default, \f(CW\*(C`tlmgr\*(C'\fR tries to remove packages which have disappeared on
+the server, as described above under \f(CW\*(C`\-\-all\*(C'\fR.  This option prevents
+such removals, either for all packages (with \f(CW\*(C`\-\-all\*(C'\fR), or for just the
+given \fIpkg\fR names.  This can lead to an inconsistent TeX installation,
+since packages are not infrequently renamed or replaced by their
+authors.  Therefore this is not recommend.
 .IP "\fB\-\-no\-auto\-install\fR [\fIpkg\fR]..." 4
 .IX Item "--no-auto-install [pkg]..."
 Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will install packages which are new
@@ -1195,15 +1197,14 @@ other lines must look like
 \&  key = value
 .Ve
 .PP
-where the allowed keys are 
-\&\f(CW\*(C`gui\-expertmode\*(C'\fR (values 0 or 1), 
-\&\f(CW\*(C`persistent\-downloads\*(C'\fR (values 0 or 1), \f(CW\*(C`auto\-remove\*(C'\fR (values 0 or 1),
-and \f(CW\*(C`gui\-lang\*(C'\fR (values like the command line arguments).  
-\&\f(CW\*(C`persistent\-downloads\*(C'\fR, \f(CW\*(C`gui\-lang\*(C'\fR, and \f(CW\*(C`auto\-remove\*(C'\fR correspond to the 
-respective command line options of the same name.  
-\&\f(CW\*(C`gui\-expertmode\*(C'\fR switches between the full
-\&\s-1GUI\s0 and a simplified \s-1GUI\s0 with only the important and mostly used
-settings.
+where the allowed keys are \f(CW\*(C`gui\-expertmode\*(C'\fR (value 0 or 1),
+\&\f(CW\*(C`persistent\-downloads\*(C'\fR (value 0 or 1), \f(CW\*(C`auto\-remove\*(C'\fR (value 0 or 1),
+and \f(CW\*(C`gui\-lang\*(C'\fR (value like in the command line option).
+.PP
+\&\f(CW\*(C`persistent\-downloads\*(C'\fR, \f(CW\*(C`gui\-lang\*(C'\fR, and \f(CW\*(C`auto\-remove\*(C'\fR correspond to
+the respective command line options of the same name.  \f(CW\*(C`gui\-expertmode\*(C'\fR
+switches between the full \s-1GUI\s0 and a simplified \s-1GUI\s0 with only the
+important and mostly used settings.
 .SH "TAXONOMIES"
 .IX Header "TAXONOMIES"
 tlmgr allows searching and listing of various categorizations, which we
@@ -1644,12 +1645,3 @@ changes would be helpful, do not hesitate to write the mailing list.
 This script and its documentation were written for the TeX Live
 distribution (<http://tug.org/texlive>) and both are licensed under the
 \&\s-1GNU\s0 General Public License Version 2 or later.
-.SH "POD ERRORS"
-.IX Header "POD ERRORS"
-Hey! \fBThe above document had some coding errors, which are explained below:\fR
-.IP "Around line 6504:" 4
-.IX Item "Around line 6504:"
-Unterminated C<...> sequence
-.IP "Around line 6509:" 4
-.IX Item "Around line 6509:"
-Unterminated C<...> sequence
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
index ae12a45b351..c3faa41b8c4 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf