summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-02-27 20:37:21 +0000
committerKarl Berry <karl@freefriends.org>2023-02-27 20:37:21 +0000
commit9bd9f0eb3a784f167cb99b83133b3141635a17d8 (patch)
treec6aed1f1dfbb3350012d41dfe6388f85ca094ce9 /Master/texmf-dist/doc/support
parentfb238fcbb22505c5581cbb88935c26f041ee72e3 (diff)
texdoc (27feb23)
git-svn-id: svn://tug.org/texlive/trunk@66227 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/texdoc/NEWS66
-rw-r--r--Master/texmf-dist/doc/support/texdoc/texdoc.pdfbin90076 -> 89738 bytes
-rw-r--r--Master/texmf-dist/doc/support/texdoc/texdoc.tex37
3 files changed, 52 insertions, 51 deletions
diff --git a/Master/texmf-dist/doc/support/texdoc/NEWS b/Master/texmf-dist/doc/support/texdoc/NEWS
index cfb10ca9322..2567cc37647 100644
--- a/Master/texmf-dist/doc/support/texdoc/NEWS
+++ b/Master/texmf-dist/doc/support/texdoc/NEWS
@@ -1,15 +1,21 @@
-NEWS for texdoc
+NEWS for Texdoc
===============
(This file public domain.)
-Version 4.0 (TeX Live 2023)
-===========================
-Released on 2023-02-20
+Version 4.0.1 (2023-02-27)
+--------------------------
+- Minor bug fixes for Windows
+- Scoring adjustments
+- Documentation tweaks
+
+Version 4.0 (2023-02-20)
+========================
+Release for TeX Live 2023.
Major changes
-- Online search feature is added:
+- Online search feature is added (by Wu Zhenyu):
users using TL without documentation will be sent to texdoc.org
-- Add new action --print-completion:
+- Add new action --print-completion (by Max Chernoff):
for the moment, only zsh is supported. Contributions welcome.
Minor fixes and tweaks
@@ -18,56 +24,62 @@ Minor fixes and tweaks
- Scoring adjustments
- Documentation tweaks
-Version 3.4.1
--------------
+Version 3.4.1 (2022-03-19)
+--------------------------
- Bug fix: give locale bonus only if "lang" is set
-Version 3.4 (TeX Live 2022)
-===========================
-- Make Data.tlpdb.lua reproducible
+Version 3.4 (2022-03-03)
+========================
+Release for TeX Live 2022.
+- Make Data.tlpdb.lua reproducible (by Vincenzo Mantova)
- Better locale handling in scoring
- Alias adjustments
-Version 3.3.1
--------------
-- Support non-ascii username on Windows (patch by A. Kakuto)
+Version 3.3.1 (2021-05-20)
+--------------------------
+- Support non-ascii username on Windows (by Akira Kakuto)
- Better support for multiple doc trees
- Alias adjustments
- Documentation tweaks
-Version 3.3 (TeX Live 2021)
-===========================
+Version 3.3 (2021-05-17)
+========================
+Release for TeX Live 2021.
- Show all possible config files for -vf
- Show diagnostic message of DISPLAY only if viewer failed
- Alias adjustments
- Documentation tweaks
-Version 3.2.2
--------------
+Version 3.2.2 (2020-09-16)
+--------------------------
- Several aliases are added
- Small documentation fixes
-Version 3.2.1
--------------
+Version 3.2.1 (2020-02-20)
+--------------------------
- Bug fix: suspend a realpath not found error
-Version 3.2 (TeX Live 2020)
-===========================
+Version 3.2 (2020-02-02)
+========================
+Release for TeX Live 2020.
- Improved the scoring scheme to prioritize the latex tree than the latex-dev
- Support invoking the program with absolute paths
- The document was entirely rewritten
- Other small improvements and bug fixes
-Version 3.1 (TeX Live 2019)
-===========================
+Version 3.1 (2019-03-28)
+========================
+Release for TeX Live 2019.
- New option -c: changing configure temporally
- New config item `texlive_tlpdb` to specify a path for texlive.tlpdb
- Fixed an issue that texdoc fails to open gzipped file in GNOME/XFCE
- Added prefixes to script files not to contaminate kpse search space
- Many other small improvements and bug fixes
-Version 3.0 (TeX Live 2018)
-===========================
+Version 3.0 (2018-06-06)
+========================
+Release for TeX Live 2018.
+
This version has two big features:
- Fuzzy search
- New option parser
@@ -85,7 +97,7 @@ Version 2.0171
- --help and --version override other specified command-line actions.
Version 2.017 (TeX Live 2017)
-============================
+=============================
- Restore user's LC_CTYPE value if possible (with this year's luatex).
- Generic system environment variables, such as BROWSER, accept
a colon-separated list of programs.
diff --git a/Master/texmf-dist/doc/support/texdoc/texdoc.pdf b/Master/texmf-dist/doc/support/texdoc/texdoc.pdf
index f648933a2e1..03cc55b3d8b 100644
--- a/Master/texmf-dist/doc/support/texdoc/texdoc.pdf
+++ b/Master/texmf-dist/doc/support/texdoc/texdoc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/texdoc/texdoc.tex b/Master/texmf-dist/doc/support/texdoc/texdoc.tex
index 0e1a0db3e80..ce01c8e3214 100644
--- a/Master/texmf-dist/doc/support/texdoc/texdoc.tex
+++ b/Master/texmf-dist/doc/support/texdoc/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{v4.0\quad \today}
+\date{v4.0.1\quad \today}
\begin{document}
@@ -764,6 +764,14 @@ Sets the \meta{url} to use for online documentation. Texdoc will replace
\section{Shell Completion}
\label{sec:completion}
+Shell completion can be used to receive assistance in entering command-line
+options and arguments (typically package names) for the |texdoc| command.
+Texdoc can provide shell completion functions via the \lopt{print-completion}
+action. Configuring the appropriate per-shell setting described below can
+enable this shell completion function.
+
+%\subsection{Bash}
+
\subsection{Zsh}
To enable completion for zsh, you need to put
@@ -772,16 +780,14 @@ To enable completion for zsh, you need to put
autoload -Uz compinit && compinit
\end{htcode}
%
-in your zsh configuration file (such as \code{\~/.zshrc}). You can install our
-completion function with either of the following two ways:
+in your zsh configuration file (such as \code{\$HOME/.zshrc}). You can install
+our completion function with either of the following two ways:
%
\begin{itemize}
-\item adding \code{eval \$(texdoc \lopt{print-completion} zsh)} to your
+\item adding \code{eval "\$(texdoc \lopt{print-completion} zsh)"} to your
zsh configuration file.
-\item adding the following file (also provided by
- \href{https://github.com/zsh-users/zsh-completions}{zsh-completions}) to \\
- \code{/usr/share/zsh/site-functions/\_texdoc}:
+\item adding a file somewhere in \code{\$fpath} with the following contents:
%
\begin{htcode}
#compdef texdoc
@@ -790,23 +796,6 @@ completion function with either of the following two ways:
\end{htcode}
\end{itemize}
-You can confirm your installation by checking whether \code{\~/.zcompdump}
-contains the following:
-%
-\begin{htcode}
-'texdoc' '_texdoc'
-\end{htcode}
-
-Note: The path \code{/usr/share} is for GNU/Linux. For other platforms, the
-path can be:
-%
-\begin{description}
-\item[macOS (homebrew, x86)] \verb|/usr/local/share|
-\item[macOS (homebrew, arm)] \verb|/opt/homebrew/share|
-\item[Android (Termux)] \verb|/data/data/com.termux/files/usr/share|
-\item[Windows (Msys2 Mingw64)] \verb|/mingw64/share|
-\end{description}
-
\section{Licence}
\label{sec:licence}