From 6c97120fe03260761ded1988f52b1b546f1bd2c4 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 8 Jan 2024 21:46:04 +0000 Subject: dtxdescribe (8jan24) git-svn-id: svn://tug.org/texlive/trunk@69348 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/dtxdescribe/README.txt | 4 +- .../doc/latex/dtxdescribe/dtxdescribe.pdf | Bin 467890 -> 470587 bytes .../source/latex/dtxdescribe/dtxdescribe.dtx | 105 +++++++++++++++++++-- .../tex/latex/dtxdescribe/dtxdescribe.sty | 49 +++++++++- 4 files changed, 149 insertions(+), 9 deletions(-) (limited to 'Master') diff --git a/Master/texmf-dist/doc/latex/dtxdescribe/README.txt b/Master/texmf-dist/doc/latex/dtxdescribe/README.txt index 24e6caa67fd..7338088697b 100644 --- a/Master/texmf-dist/doc/latex/dtxdescribe/README.txt +++ b/Master/texmf-dist/doc/latex/dtxdescribe/README.txt @@ -1,8 +1,8 @@ The LaTeX dtxdescribe package Describe additional object types in dtx source files. -v1.07 — 2023/01/03 -Copyright 2016–2023 Brian Dunn — www.BDTechConcepts.com +v1.08 — 2024/01/08 +Copyright 2016–2024 Brian Dunn — https://github.com/bdtc/dtxdescribe LaTeX Project Public License, version 1.3 diff --git a/Master/texmf-dist/doc/latex/dtxdescribe/dtxdescribe.pdf b/Master/texmf-dist/doc/latex/dtxdescribe/dtxdescribe.pdf index 1267977d0b1..1712382523b 100644 Binary files a/Master/texmf-dist/doc/latex/dtxdescribe/dtxdescribe.pdf and b/Master/texmf-dist/doc/latex/dtxdescribe/dtxdescribe.pdf differ diff --git a/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx b/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx index e271465c21b..3fb7205f407 100644 --- a/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx +++ b/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx @@ -1,7 +1,7 @@ % \iffalse meta-comment % -% Copyright 2016-2023 Brian Dunn +% Copyright 2016-2024 Brian Dunn % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 @@ -17,7 +17,7 @@ % \iffalse %\NeedsTeXFormat{LaTeX2e} %\ProvidesPackage{dtxdescribe} -% [2023/01/03 v1.07 Describe additional object types in source files.] +% [2024/01/08 v1.08 Describe additional object types in source files.] % %<*driver> \documentclass{ltxdoc} @@ -187,6 +187,8 @@ pageanchor=true, % \changes{v1.05}{2022/09/08}{\ 2022/09/08} % \changes{v1.06}{2022/12/07}{\ 2022/12/07} % \changes{v1.07}{2023/01/03}{\ 2023/01/03} +% \changes{v1.08}{2024/01/08}{\ 2024/01/08} +% \changes{v1.08}{2024/01/08}{\ Updated contact info.} @@ -211,7 +213,8 @@ pageanchor=true, % % \bigskip % -% {\small\textcopyright{} 2016--2023} Brian Dunn\\ \small \texttt{bd@BDTechConcepts.com} +% {\small\textcopyright{} 2016--2024} Brian Dunn\\ +% \small \url{https://github.com/bdtc/dtxdescribe} % % \vspace{.5in} % @@ -227,7 +230,7 @@ pageanchor=true, % The \pkg{doc} package includes tools for describing macros and environments % in \LaTeX\ source \filenm{.dtx} format. % The \pkg{dtxdescribe} package adds additional tools for describing -% booleans, lengths, counters, hooks, keys, packages, classes, options, +% booleans, lengths, counters, hooks, sockets, plugs, keys, packages, classes, options, % files, commands, arguments, and other objects. % \pkg{dtxdescribe} also works with the regular document classes, for those % who do not wish to use the \pkg{ltxdoc} class and \filenm{.dtx} files. @@ -472,7 +475,7 @@ pageanchor=true, % See \cref{ex:arguments} on \cpageref{ex:arguments}. -% \subsection{Booleans, lengths, counters, hooks, keys} +% \subsection{Booleans, lengths, counters, hooks, sockets, plugs, keys} % % See \cref{ex:common} on \cpageref{ex:common}. % @@ -503,6 +506,19 @@ pageanchor=true, % \end{sourceverb} % % +% \DescribeMacro{\DescribeSocket} \oarg{category} \marg{name} +% +% \DescribeMacro{\DescribePlug} \oarg{category} \marg{name} +% +% Describes a socket or plug. Given a `Socket' or 'Plug' tag in the margin and index. +% The |category| may be used to categorize sockets and plugs by package. +% Example: +% \begin{sourceverb} +% \DescribeSocket{socketname} +% \DescribePlug{plugname} +% \end{sourceverb} +% +% % \DescribeMacro{\DescribeKey} \oarg{category} \marg{name} % % Describes a key. Given a `Key' tag in the margin and index. @@ -591,6 +607,10 @@ pageanchor=true, % % \DescribeMacro{\ItemDescribeHook} \oarg{category} \marg{name} A description. % +% \DescribeMacro{\ItemDescribeSocket} \oarg{category} \marg{name} A description. +% +% \DescribeMacro{\ItemDescribePlug} \oarg{category} \marg{name} A description. +% % \DescribeMacro{\ItemDescribeKey} \oarg{category} \marg{name} A description. % % \DescribeMacro{\ItemDescribePackage} \oarg{category} \marg{package\_name} With underscores. @@ -1079,10 +1099,15 @@ pageanchor=true, % the same as the rest of the objects. -% \begin{dtxexample}{Hooks\label{ex:hook}} +% \begin{dtxexample}{Hooks and Sockets\label{ex:hook}} % \DescribeHook{\hookname} A hook with a backslash. % \DescribeHook{para/begin} A hook without a backslash. + +% \DescribeSocket{socketname} A socket. + +% \DescribePlug{plugname} A socket plug. + % \end{dtxexample} % Hooks may or may not have a leading backslash. @@ -3109,6 +3134,52 @@ pageanchor=true, \newcommand*{\DescribeHook}[2][] {\DTXD@margintagindex{#1}{#2}{Hook}{hook}{usage}} +}% not doc +% \end{macrocode} +% \end{macro} +% +% +% \begin{macro}{\DescribeSocket} \oarg{category} \marg{name} +% \changes{v1.08}{2024/01/08}{Added.} +% \begin{macrocode} +\IfPackageLoadedTF{doc}{% doc + +\NewDocElement[ + macrolike=false, + toplevel=true, + idxtype=socket, + idxgroup=Sockets, + printtype=\textit{Socket} +]{Socket}{socket} + +}{% not doc + +\newcommand*{\DescribeSocket}[2][] + {\DTXD@margintagindex{#1}{#2}{Socket}{socket}{usage}} + +}% not doc +% \end{macrocode} +% \end{macro} +% +% +% \begin{macro}{\DescribePlug} \oarg{category} \marg{name} +% \changes{v1.08}{2024/01/08}{Added.} +% \begin{macrocode} +\IfPackageLoadedTF{doc}{% doc + +\NewDocElement[ + macrolike=false, + toplevel=true, + idxtype=plug, + idxgroup=Plugs, + printtype=\textit{Plug} +]{Plug}{plug} + +}{% not doc + +\newcommand*{\DescribePlug}[2][] + {\DTXD@margintagindex{#1}{#2}{Plug}{plug}{usage}} + }% not doc % \end{macrocode} % \end{macro} @@ -3366,6 +3437,28 @@ pageanchor=true, % \end{macrocode} % \end{macro} +% \begin{macro}{\ItemDescribeSocket} \oarg{category} \marg{name} +% \changes{v1.08}{2024/01/08}{Added.} +% \begin{macrocode} +\newcommand{\ItemDescribeSocket}[2][]{% + \item[\texttt{#2}:]% + \setlength{\parskip}{1.5ex}% + \DescribeSocket[#1]{#2}% +} +% \end{macrocode} +% \end{macro} + +% \begin{macro}{\ItemDescribePlug} \oarg{category} \marg{name} +% \changes{v1.08}{2024/01/08}{Added.} +% \begin{macrocode} +\newcommand{\ItemDescribePlug}[2][]{% + \item[\texttt{#2}:]% + \setlength{\parskip}{1.5ex}% + \DescribePlug[#1]{#2}% +} +% \end{macrocode} +% \end{macro} + % \begin{macro}{\ItemDescribeKey} \oarg{category} \marg{name} % \changes{v1.00}{2019/01/09}{Added.} % \begin{macrocode} diff --git a/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty b/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty index a2d97463fb5..bc5b4b95d5b 100644 --- a/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty +++ b/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty @@ -18,7 +18,10 @@ \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{dtxdescribe} - [2023/01/03 v1.07 Describe additional object types in source files.] + [2024/01/08 v1.08 Describe additional object types in source files.] + + + @@ -1031,6 +1034,38 @@ }% not doc \IfPackageLoadedTF{doc}{% doc +\NewDocElement[ + macrolike=false, + toplevel=true, + idxtype=socket, + idxgroup=Sockets, + printtype=\textit{Socket} +]{Socket}{socket} + +}{% not doc + +\newcommand*{\DescribeSocket}[2][] + {\DTXD@margintagindex{#1}{#2}{Socket}{socket}{usage}} + +}% not doc +\IfPackageLoadedTF{doc}{% doc + +\NewDocElement[ + macrolike=false, + toplevel=true, + idxtype=plug, + idxgroup=Plugs, + printtype=\textit{Plug} +]{Plug}{plug} + +}{% not doc + +\newcommand*{\DescribePlug}[2][] + {\DTXD@margintagindex{#1}{#2}{Plug}{plug}{usage}} + +}% not doc +\IfPackageLoadedTF{doc}{% doc + \NewDocElement[ macrolike=false, toplevel=true, @@ -1189,6 +1224,18 @@ \DescribeHook[#1]{#2}% } +\newcommand{\ItemDescribeSocket}[2][]{% + \item[\texttt{#2}:]% + \setlength{\parskip}{1.5ex}% + \DescribeSocket[#1]{#2}% +} + +\newcommand{\ItemDescribePlug}[2][]{% + \item[\texttt{#2}:]% + \setlength{\parskip}{1.5ex}% + \DescribePlug[#1]{#2}% +} + \newcommand{\ItemDescribeKey}[2][]{% \item[\texttt{#2}:]% \setlength{\parskip}{1.5ex}% -- cgit v1.2.3