summaryrefslogtreecommitdiff
path: root/support/texdoc/doc/texdoc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'support/texdoc/doc/texdoc.tex')
-rw-r--r--support/texdoc/doc/texdoc.tex42
1 files changed, 21 insertions, 21 deletions
diff --git a/support/texdoc/doc/texdoc.tex b/support/texdoc/doc/texdoc.tex
index 7b9a259008..c3607b4d61 100644
--- a/support/texdoc/doc/texdoc.tex
+++ b/support/texdoc/doc/texdoc.tex
@@ -8,7 +8,7 @@
\subtitle{Find \& view documentation in \TL}
\pkgurl{https://tug.org/texdoc/}
\author{Manuel Pégourié-Gonnard\and Takuto Asakura}
-\date{v3.2.1\quad \today}
+\date{v3.2.2\quad \today}
\begin{document}
@@ -208,7 +208,7 @@ invoked by the program. Internally, this sets \ci{verbosity\_level} to maximum.
\begin{clopt}{%
\code{\sopt{d} \meta{list}}, \code{\lopt{debug}=\meta{list}},
\sopt{D}, \lopt{debug}}
-This sets \ci{debug\_list} to show dubbging information in the specified
+This sets \ci{debug\_list} to show debugging information in the specified
category. You can specify multiple categories with a comma-separated list. If
you specify |-D| or |--debug| without specifying a list, it activates all
available debug categories.
@@ -236,7 +236,7 @@ program using |TEXMF| search path. In addition, Texdoc uses |TEXMFROOT| and
|TEXMFVAR| to look for the tlpdb database and the cache respectively.
Second, the viewers for opening documents can be controlled by some environment
-variables. They all correspond to some \ci{viewer\_\meta{ext}}
+variables. They all correspond to some \ci{viewer\_\meta{ext}}
setting.\footnote{Old names of environment variables, namely
|TEXDOCVIEW_\{html,dvi,md,txt,pdf,ps\}| and
|TEXDOC_VIEWER_\{HTML,DVI,MD,TXT,PDF,PS\}|, are deprecated but still work.} You
@@ -465,8 +465,8 @@ in the future.
File extensions regarded as documents by Texdoc can be specified with the
configuration item \ci{ext\_list}. By default, files with extensions |pdf|,
-|html|, |htm|, |txt|, |md|, |ps|, and |dvi| and files without extension are
-recognized as documents.
+|html|, |htm|, |txt|, |dat|, |md|, |ps|, and |dvi| and files without extension
+are recognized as documents.
During the scoring process, the configuration item |badext_list| is also used:
files with a ``bad'' extension appearing in this list will get a lesser score.
@@ -564,7 +564,7 @@ shipped configuration file for more.
\end{confitem}
\begin{confitem}{ext\_list}
- {\meta{list}}[default: \code{pdf, html, htm, txt, md, dvi, ps,}]
+ {\meta{list}}[default: \code{pdf, html, htm, txt, dat, md, dvi, ps,}]
Set the list of recognised extensions to |«list»|. This list is used to filter
and sort the results that have the same score (with the default value: pdf
first, etc). Two special values are recognised:
@@ -600,7 +600,7 @@ similarly, if it is |htm| the |html| viewer is used. Otherwise, the |txt|
viewer is used and a warning is issued.
\end{confitem}
-\begin{confitem}{badext\_list}{\meta{list}}[default: \code{txt}]
+\begin{confitem}{badext\_list}{\meta{list}}[default: \code{txt, dat,}]
Set the list of ``bad'' extensions to |«list»|. Files with those extensions get
a malus of |1| on their heuristic score if it was previously positive.
\end{confitem}
@@ -662,7 +662,7 @@ where |«argument»| is the name of the argument to which the results correspond
(mainly useful if there were many arguments), {\metatab} is the tab (ASCII \#9)
character, and the other entries are pretty self-explanatory. Nothing else is
printed on stdout, except if an internal error occurs (in which case exit code
-will be 1). In the future, more tab-separated fields may be added at the end
+will be |1|). In the future, more tab-separated fields may be added at the end
of the line, but the first 3 fields will remain unchanged.
Currently, there are two additional fields: a two-letter language code, and an
@@ -673,25 +673,25 @@ same meaning in future versions of Texdoc.
\begin{confitem}{zipext\_list}{\meta{list}}[default: empty]
List of supported extensions for zipped files. Allows compressed files with
-names like |foobar.«zip»|, with |«zip»| in the given |«list»|, to be found and
-unzipped before the viewer is started (the temporary file will be destroyed
-right after).
+names like |foobar.«zipext»|, where |«zipext»| is an element in the given
+|«list»|, to be found and unzipped before the viewer is started (the temporary
+file will be destroyed right after).
Warning: Support for zipped documentation is not meant to work on windows, a
Unix shell is assumed! If you add anything to this list, please make sure that
-you also set a corresponding |unzip=«ext»| value for each |«ext»| in the list.
-At the same time, make sure you are using blocking (i.e., not returning
-immediately) viewers.
+you also set the corresponding \ci{unzip\_\meta{zipext}} item for each
+|«zipext»| in the list. At the same time, make sure you are using blocking
+(i.e., not returning immediately) viewers.
-Remark: {\TL} doesn't ship compressed documentation files, so this option is
-mainly useful with re-packaged version of {\TL} that do, for example in Linux
-distributions.
+Remark: {\TL} does not ship any compressed documentation file, so this option
+is mainly useful with re-packaged versions of {\TL} that do, for example one in
+Linux distributions.
\end{confitem}
\begin{confitem}{unzip\_\meta{zipext}}{\meta{command}}[no default]
-The unzipping command for compressed files with extension |«zipext»|. Define
-one for each item in \ci{zipext\_list}. The command must print the result on
-stdout, like |gzip -d -c| does.
+The unzipping command for compressed files with extension |«zipext»|. You
+should set one for each item in the \ci{zipext\_list}. The command must print
+the result on stdout, like |gzip -d -c| does.
\end{confitem}
\begin{confitem}{rm\_file}{\meta{command}}[default: \code{rm -f}]
@@ -713,7 +713,7 @@ default configuration file from older versions to be used (see the
so).
\end{confitem}
-\begin{confitem}{fuzzy\_level}{\meta{number}}[default: \code{5}]
+\begin{confitem}{fuzzy\_level}{\meta{number}}[default: \code{3}]
Set the allowance of Levenshtein distance to |«number»| for fuzzy search. At
level~|0|, the fuzzy search feature is disabled.
\end{confitem}