doc fixes

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

1 files changed, 11 insertions, 8 deletions

diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index eed69d16d4d..9c10b06b4e5 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -5688,13 +5688,16 @@ Search for package names, descriptions, and taxonomies, but not files.
 
 =head2 show [I<options>] I<pkg>...
 
-Display information about I<pkg>: the name, category, installation status,
-short and long description.  Searches in the remote installation source
-for the package if it is not locally installed.
+Display information about I<pkg>: the name, category, short and long
+description, installation status, and TeX Live revision number.
+Searches in the remote installation source for the package if it is not
+locally installed.
 
-It also displays the information taken from the TeX Catalogue (license,
-date, version), but note that there is a high probability that this
-information is slightly off due to timing issues.
+It also displays information taken from the TeX Catalogue, namely the
+package version, date, and license.  Consider these, especially the
+package version, approximations only, due to timing skew of the updates
+of the difference pieces.  The C<revision> value, by contrast, comes
+directly from TL and is reliable.
 
 Options:
 
@@ -5732,8 +5735,8 @@ the request type.
 
 With anything else as arguments, operates as the C<show> action.
 
-If the option C<--only-installed> is given the installation source will
-not be used and only locally installed packages, collections, or schemes
+If the option C<--only-installed> is given, the installation source will
+not be used; only locally installed packages, collections, or schemes
 are listed.