diff options
Diffstat (limited to 'support/texdoc/doc/texdoc.tex')
-rw-r--r-- | support/texdoc/doc/texdoc.tex | 42 |
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} |