summaryrefslogtreecommitdiff
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
parentfb238fcbb22505c5581cbb88935c26f041ee72e3 (diff)
texdoc (27feb23)
git-svn-id: svn://tug.org/texlive/trunk@66227 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/man/man1/texdoc.12
-rw-r--r--Master/texmf-dist/doc/man/man1/texdoc.man1.pdfbin25452 -> 25456 bytes
-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
-rwxr-xr-xMaster/texmf-dist/scripts/texdoc/texdoclib-config.tlu6
-rwxr-xr-xMaster/texmf-dist/scripts/texdoc/texdoclib-const.tlu4
-rw-r--r--Master/texmf-dist/texdoc/texdoc.cnf1
8 files changed, 60 insertions, 56 deletions
diff --git a/Master/texmf-dist/doc/man/man1/texdoc.1 b/Master/texmf-dist/doc/man/man1/texdoc.1
index c0a2250cc62..5dbfa0979c0 100644
--- a/Master/texmf-dist/doc/man/man1/texdoc.1
+++ b/Master/texmf-dist/doc/man/man1/texdoc.1
@@ -1,7 +1,7 @@
.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
-.TH "TEXDOC" "1" "February 2023" "Texdoc 4.0" "Texdoc manual"
+.TH "TEXDOC" "1" "February 2023" "Texdoc 4.0.1" "Texdoc manual"
.
.SH "NAME"
\fBtexdoc\fR \- find & view documentation in TeX Live
diff --git a/Master/texmf-dist/doc/man/man1/texdoc.man1.pdf b/Master/texmf-dist/doc/man/man1/texdoc.man1.pdf
index 8034eb038bc..721930be61c 100644
--- a/Master/texmf-dist/doc/man/man1/texdoc.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/texdoc.man1.pdf
Binary files differ
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}
diff --git a/Master/texmf-dist/scripts/texdoc/texdoclib-config.tlu b/Master/texmf-dist/scripts/texdoc/texdoclib-config.tlu
index cf756b7b6a1..ad9f852ea70 100755
--- a/Master/texmf-dist/scripts/texdoc/texdoclib-config.tlu
+++ b/Master/texmf-dist/scripts/texdoc/texdoclib-config.tlu
@@ -48,6 +48,7 @@ function M.get_value(key) return config[key] end
-- interpreting 'context' in this section
local function context_to_string(context)
+ local w32_path = import_function('util', 'w32_path')
if not context then return '(no context)' end
if context.src == 'cl' then
return 'from command-line option "' .. context.name .. '"'
@@ -56,7 +57,7 @@ local function context_to_string(context)
elseif context.src == 'loc' then
return 'from operating system locale'
elseif context.src == 'file' then
- return 'in file "' .. context.file .. '" on line ' .. context.line
+ return 'in file "' .. w32_path(context.file) .. '" on line ' .. context.line
elseif context.src == 'def' then
return 'from built-in defaults'
else
@@ -266,6 +267,7 @@ end
-- set config and aliases from a particular config file assumed to exist
local function read_config_file(configfile)
local err_print = import_function('util', 'err_print')
+ local w32_path = import_function('util', 'w32_path')
local confline_to_alias = import_function('alias', 'confline_to_alias')
local confline_to_score = import_function('score', 'confline_to_score')
@@ -302,7 +304,7 @@ local function read_config_file(configfile)
-- complain if it failed
if not ok then
err_print('warning',
- 'syntax error in %s at line %d.', configfile, lineno)
+ 'syntax error in %s at line %d.', w32_path(configfile), lineno)
end
::continue::
diff --git a/Master/texmf-dist/scripts/texdoc/texdoclib-const.tlu b/Master/texmf-dist/scripts/texdoc/texdoclib-const.tlu
index 16acce71aae..c551bf40ef0 100755
--- a/Master/texmf-dist/scripts/texdoc/texdoclib-const.tlu
+++ b/Master/texmf-dist/scripts/texdoc/texdoclib-const.tlu
@@ -22,8 +22,8 @@ end
-- progname and version
fullname = kpse.find_file('texdoc/texdoclib', 'lua')
progname = 'Texdoc'
-version = '4.0'
-release_date = '2023-02-20'
+version = '4.0.1'
+release_date = '2023-02-27'
-- make sure to update setup_config_from_cl() accordingly
-- and set a default value in setup_config_from_defaults() if relevant
diff --git a/Master/texmf-dist/texdoc/texdoc.cnf b/Master/texmf-dist/texdoc/texdoc.cnf
index 7ba7d538def..1f93fd34156 100644
--- a/Master/texmf-dist/texdoc/texdoc.cnf
+++ b/Master/texmf-dist/texdoc/texdoc.cnf
@@ -278,6 +278,7 @@ alias tex-live-zh-cn = texlive-zh-cn
# a few useful general documents
alias latex = latex-doc-ptr
+alias plain = gentle
# various lshort translations
adjscore(lshort) /lshort-english/ = +0.5 # original