Texdoc 0.66 addressing various problems.

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

3 files changed, 36 insertions, 16 deletions

diff --git a/Master/texmf/doc/texdoc/News b/Master/texmf/doc/texdoc/News
index 4111da6b1ca..faca951b308 100644
--- a/Master/texmf/doc/texdoc/News
+++ b/Master/texmf/doc/texdoc/News
@@ -1,3 +1,17 @@
+Version 0.66
+------------
+
+Turn the -v=N, --verbosity=N command-line option into a pair of related options
+-v, --verbose and -q, --quiet (more standard, Karl's suggestion). Also remove
+uselessly verbose debug items so --debug is usable again.
+
+Rework help text (Karl's suggestion).
+
+Issue a warning about DISPLAY not being set on generic Unix before trying to
+start a viewer.
+
+Small internal clean-ups.
+
 Version 0.65
 ------------
 
@@ -27,7 +41,7 @@ Version 0.61
 Detect desktop environments (KDE4, KDE, GNOME, XFCE) for viewer selection.
 
 Version 0.60
-------------
+============
 
 Changed the search/alias/score logic. See section 2 of the manual for details,
 but here is a primer:
@@ -36,10 +50,10 @@ but here is a primer:
 
 The beginning of the manual has been completely rewritten.
 
-Bug have been fixed as usual, and probably some others introduced...
+Bugs have been fixed as usual, and probably some others introduced...
 
 Version 0.50
-------------
+============
 
 - New option for machine-readable output.
 - Bugfixes (esp. for zipped file support (Unix only)).
@@ -102,7 +116,7 @@ Documentation update.  Alias additions and fixes as usual. Various bugfixes.
 License switched to GPL.
 
 Version 0.4 (TeX Live 2008)
----------------------------
+===========================
 
 Use our own configuration files, not texmf.cnf. Rework the way viewers are
 handled, and add a few configuration options.
diff --git a/Master/texmf/doc/texdoc/texdoc.pdf b/Master/texmf/doc/texdoc/texdoc.pdf
index 0fa9b3c942e..7eff49cd9a1 100644
--- a/Master/texmf/doc/texdoc/texdoc.pdf
+++ b/Master/texmf/doc/texdoc/texdoc.pdf
diff --git a/Master/texmf/doc/texdoc/texdoc.tex b/Master/texmf/doc/texdoc/texdoc.tex
index 7cc3748fe7c..47d92faf292 100644
--- a/Master/texmf/doc/texdoc/texdoc.tex
+++ b/Master/texmf/doc/texdoc/texdoc.tex
@@ -163,7 +163,7 @@
 \subtitle{Find \& view documentation in \TeX\ Live}
 \author{\url{http://tug.org/texdoc/}\\
   Manuel Pégourié-Gonnard}
-\date{v0.62 2010-01-05}
+\date{v0.66 2010-02-22}
 
 \begin{document}
 \VerbatimFootnotes
@@ -501,12 +501,17 @@ option is deprecated and will likely be removed soon. It is recommended to set
 ©ext_list© in a configuration file instead. Please protest on the \tdml if you
 want to keep this command-line option.
 
-\begin{cmdsubsub}{-v, --verbosity}{cl-v}
-  -v=«n», --verbosity=«n»
+\begin{cmdsubsub}{-q, --quiet}{cl-q}
+  -q, --quiet
 \end{cmdsubsub}
 
-Set ©verbosity_level© to ©«n»©, see~\ref{cf-verbosity_level}. Be aware that you
-must avoid spaces on the command line, and the ©=© sign is optional.
+Set ©verbosity_level© to minimum, see~\ref{cf-verbosity_level}.
+
+\begin{cmdsubsub}{-v, --verbose}{cl-v}
+  -v, --verbose
+\end{cmdsubsub}
+
+Set ©verbosity_level© to maximum, see~\ref{cf-verbosity_level}.
 
 \begin{cmdsubsub}{-d, --debug}{cl-d}
   -d, -d=«list», --debug, --debug=«list»
@@ -661,17 +666,18 @@ shell construct.
   verbosity_level = «n»
 \end{cmdsubsub}
 
-Set the verbosity level to ©«n»©. 3 means errors, warnings and informational
-message will be printed (on stdout); 2 means only errors and warnings, 1 only
-errors and 0 nothing (not recommended).
+Set the verbosity level to ©«n»© (default: 2). 3 means errors, warnings and
+informational messages will be printed (on stderr); 2 means only errors and
+warnings, 1 only errors and 0 nothing except internal errors (obviously not
+recommended).
 
 \begin{cmdsubsub}{debug_list}{cf-debug_list}
   debug_list = «list»
 \end{cmdsubsub}
 
-Set the list of activated debug items (default: none). For a list of available
-items, see the source code, file ©constants.tlu©, variable ©known_debugs©.
-Debug information is printed on standard error.
+Set the list of activated debug items (default: none; if the option is used
+without arguments, the list defaults to all known debug items). Implies
+©--verbose©. Debug information is printed on standard error.
 
 \begin{cmdsubsub}{machine_switch}{cf-machine_switch}
   machine_switch = «true, false»
@@ -694,7 +700,7 @@ of the line, but the first 3 fields will remain unchanged.
   zipext_list = «list»
 \end{cmdsubsub}
 
-List of supported extension for zipped files (default: empty).  Allows
+List of supported extensions for zipped files (default: empty).  Allows
 compressed files with names like ©foobar.«zip»©, with ©«zip»© in the given
 ©«list»©, to be found and unzipped before the viewer is launched (the
 temporary file will be destroyed right after).