texlive[69348] Master/texmf-dist: dtxdescribe (8jan24)
commits+karl at tug.org
commits+karl at tug.org
Mon Jan 8 22:46:04 CET 2024
Revision: 69348
https://tug.org/svn/texlive?view=revision&revision=69348
Author: karl
Date: 2024-01-08 22:46:04 +0100 (Mon, 08 Jan 2024)
Log Message:
-----------
dtxdescribe (8jan24)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt
trunk/Master/texmf-dist/doc/latex/dtxdescribe/dtxdescribe.pdf
trunk/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx
trunk/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty
Modified: trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt
===================================================================
--- trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt 2024-01-08 21:45:55 UTC (rev 69347)
+++ trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt 2024-01-08 21:46:04 UTC (rev 69348)
@@ -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
Modified: trunk/Master/texmf-dist/doc/latex/dtxdescribe/dtxdescribe.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx 2024-01-08 21:45:55 UTC (rev 69347)
+++ trunk/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx 2024-01-08 21:46:04 UTC (rev 69348)
@@ -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
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\ProvidesPackage{dtxdescribe}
-%<package> [2023/01/03 v1.07 Describe additional object types in source files.]
+%<package> [2024/01/08 v1.08 Describe additional object types in source files.]
%
%<*driver>
\documentclass{ltxdoc}
@@ -187,6 +187,8 @@
% \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 @@
%
% \bigskip
%
-% {\small\textcopyright{} 2016--2023} Brian Dunn\\ \small \texttt{bd at BDTechConcepts.com}
+% {\small\textcopyright{} 2016--2024} Brian Dunn\\
+% \small \url{https://github.com/bdtc/dtxdescribe}
%
% \vspace{.5in}
%
@@ -227,7 +230,7 @@
% 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 @@
% 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 @@
% \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 @@
%
% \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 @@
% 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.
@@ -3114,6 +3139,52 @@
% \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 at 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 at margintagindex{#1}{#2}{Plug}{plug}{usage}}
+
+}% not doc
+% \end{macrocode}
+% \end{macro}
+%
+%
% \begin{macro}{\DescribeKey} \oarg{category} \marg{name}
%
% The |category| may be used to categorize keys by their kev/value group.
@@ -3366,6 +3437,28 @@
% \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}
Modified: trunk/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty 2024-01-08 21:45:55 UTC (rev 69347)
+++ trunk/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty 2024-01-08 21:46:04 UTC (rev 69348)
@@ -18,7 +18,7 @@
\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.]
@@ -105,6 +105,9 @@
+
+
+
\AtBeginDocument{
\IfPackageLoadedTF{makeidx}{}{
\IfPackageLoadedTF{splitidx}{}{
@@ -1034,6 +1037,38 @@
\NewDocElement[
macrolike=false,
toplevel=true,
+ idxtype=socket,
+ idxgroup=Sockets,
+ printtype=\textit{Socket}
+]{Socket}{socket}
+
+}{% not doc
+
+\newcommand*{\DescribeSocket}[2][]
+ {\DTXD at 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 at margintagindex{#1}{#2}{Plug}{plug}{usage}}
+
+}% not doc
+\IfPackageLoadedTF{doc}{% doc
+
+\NewDocElement[
+ macrolike=false,
+ toplevel=true,
idxtype=key,
idxgroup=Keys,
printtype=\textit{Key}
@@ -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}%
More information about the tex-live-commits
mailing list.