texlive[47191] Master/texmf-dist: dtxdescribe (30mar18)

commits+karl at tug.org commits+karl at tug.org
Fri Mar 30 23:15:39 CEST 2018


Revision: 47191
          http://tug.org/svn/texlive?view=revision&revision=47191
Author:   karl
Date:     2018-03-30 23:15:38 +0200 (Fri, 30 Mar 2018)
Log Message:
-----------
dtxdescribe (30mar18)

Modified Paths:
--------------
    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

Added Paths:
-----------
    trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt

Removed Paths:
-------------
    trunk/Master/texmf-dist/doc/latex/dtxdescribe/README

Deleted: trunk/Master/texmf-dist/doc/latex/dtxdescribe/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/dtxdescribe/README	2018-03-30 20:51:26 UTC (rev 47190)
+++ trunk/Master/texmf-dist/doc/latex/dtxdescribe/README	2018-03-30 21:15:38 UTC (rev 47191)
@@ -1,20 +0,0 @@
-The LaTeX dtxdescribe package
-Describe additional object types in dtx source files.
-
-v0.10 — 2016/12/08
-Copyright 2016 Brian Dunn — www.BDTechConcepts.com
-LaTeX Project Public License, version 1.3
-
-The doc package includes tools for describing macros and environments in
-LATEX source dtx format. The dtxdescribe package adds additional tools for
-describing booleans, lengths, counters, keys, packages, classes, options, files,
-commands, arguments, and other objects.
-
-Each item is given a margin tag similar to \DescribeEnv, and is listed in
-the index by itself and also by category. Each item may be sorted further by
-an optional class. All index entries except code lines are hyperlinked.
-
-Descriptions are best accompanied by examples, so the environment
-dtxexample is provided. Contents are displayed verbatim along with a
-caption and cross-referencing. They are then \input and executed, and the
-result is shown.

Added: trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt
===================================================================
--- trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt	2018-03-30 21:15:38 UTC (rev 47191)
@@ -0,0 +1,20 @@
+The LaTeX dtxdescribe package
+Describe additional object types in dtx source files.
+
+v0.11 — 2018/03/30
+Copyright 2016–2018 Brian Dunn — www.BDTechConcepts.com
+LaTeX Project Public License, version 1.3
+
+The doc package includes tools for describing macros and environments in
+LATEX source dtx format. The dtxdescribe package adds additional tools for
+describing booleans, lengths, counters, keys, packages, classes, options, files,
+commands, arguments, and other objects.
+
+Each item is given a margin tag similar to \DescribeEnv, and is listed in
+the index by itself and also by category. Each item may be sorted further by
+an optional class. All index entries except code lines are hyperlinked.
+
+Descriptions are best accompanied by examples, so the environment
+dtxexample is provided. Contents are displayed verbatim along with a
+caption and cross-referencing. They are then \input and executed, and the
+result is shown.


Property changes on: trunk/Master/texmf-dist/doc/latex/dtxdescribe/README.txt
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
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	2018-03-30 20:51:26 UTC (rev 47190)
+++ trunk/Master/texmf-dist/source/latex/dtxdescribe/dtxdescribe.dtx	2018-03-30 21:15:38 UTC (rev 47191)
@@ -17,7 +17,7 @@
 % \iffalse
 %<package>\NeedsTeXFormat{LaTeX2e}
 %<package>\ProvidesPackage{dtxdescribe}
-%<package>    [2016/12/08 v0.10 Describe additional object types in dtx source files.]
+%<package>    [2018/03/30 v0.11 Describe additional object types in dtx source files.]
 %
 %<*driver>
 \documentclass{ltxdoc}
@@ -171,17 +171,10 @@
 % \usepackage{morefloats}
 % \usepackage{marginfix}
 
-\usepackage{tocloft}
-\setlength{\cftsubsecnumwidth}{3em}
-\setlength{\cftsubsubsecindent}{2.8em}
-\setlength{\cftsubsubsecnumwidth}{4em}
-\setlength{\cftbeforesubsecskip}{1ex}
 
-% \usepackage{titletoc}
 
 
 
-
 \usepackage{titleps}
 
 \newpagestyle{pageheadfoot}{
@@ -195,26 +188,14 @@
 
 
 
+\providerobustcmd*{\lmacro}[1]{\textbackslash#1}
+\providerobustcmd*{\cmds}[1]{\texttt{#1}}
+\providerobustcmd*{\env}[1]{\texttt{#1}}
+\providerobustcmd*{\ctr}[1]{\texttt{#1}}
+\providerobustcmd*{\pkg}[1]{\textsf{#1}}
+\providerobustcmd*{\prog}[1]{\texttt{#1}}
 
-\newcommand*{\lmacro}[1]{\textbackslash#1}
-\newcommand*{\cmds}[1]{\texttt{#1}}
-\newcommand*{\env}[1]{\texttt{#1}}
-\newcommand*{\pkg}[1]{\textsf{#1}}
-\newcommand*{\acro}[1]{\textsc{\lowercase{#1}}}
 
-
-
-
-
-
-
-
-% % \newcommand*{\tikz}{Ti\textit{k}z}
-% \newcommand*{\htmlfive}{\acro{HTML}\oldstylenums{5}}
-% \newcommand*{\cssthree}{\acro{CSS}\oldstylenums{3}}
-% 
-% \newcommand*{\goesto}{$\Rightarrow$}
-
 % \newenvironment{docsidebar}[1][]
 % {\par\addvspace{1.5ex}%
 % \hfill\minipage{.9\linewidth}\raggedright#1\smallskip\hrule\medskip}
@@ -271,7 +252,7 @@
 %<*package>
 % \fi
 %
-% \CheckSum{369}
+% \CheckSum{368}
 %
 % \CharacterTable
 % {Upper-case     \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -290,6 +271,7 @@
 %   Right brace   \}     Tilde         \~}
 
 % \changes{v0.10}{2016/12/08}{\ 2016/12/08 Initial ver}
+% \changes{v0.11}{2018/03/30}{\ 2018/03/30}
 
 
 
@@ -314,23 +296,12 @@
 %
 % \bigskip
 %
-% {\small\copyright{} 2016} Brian Dunn\\ \small \texttt{bd at BDTechConcepts.com}
+% {\small\copyright{} 2016--2018} Brian Dunn\\ \small \texttt{bd at BDTechConcepts.com}
 %
 % \vspace{.5in}
 %
 % {\Large \textup{\quicksummary}}
 %
-%
-% 
-% ^^A % \title{The \pkg{keyfloat} package\thanks{This document
-% ^^A %   corresponds to \pkg{keyfloat}~\fileversion,
-% ^^A %   dated \filedate.}}
-% ^^A % \author{{\small\copyright{} 2016} Brian Dunn\\ \small \texttt{bd at BDTechConcepts.com}}
-% ^^A % \published{}
-% ^^A % \subtitle{\textup{Subtitle}}
-% ^^A %
-% ^^A % \maketitle
-%
 % \vfill
 %
 %
@@ -381,7 +352,7 @@
 %
 % \pkg{dtxdescribe} extends this concept to include a number of
 % additional objects, such as booleans and keys.
-% To help identify what is being described in the margin, small tags
+% To help identify what is being described in the margin, small tags are
 % added to the name, such as ``Env'', ``Bool'', or ``Key''.
 % These new objects are also listed in the index with the same tag
 % shown after their names, and also by group.
@@ -397,7 +368,6 @@
 % This documentation and its index show examples of these macros in use.
 %
 % While the index may appear to be overkill for a small package,
-% \margintag{Too much!}
 % keep in mind that it includes a number of fictional entries from the examples.
 % Extensive cross-referencing can be useful for larger works.
 % And, of course, you need not cross-reference everything!
@@ -1140,10 +1110,11 @@
 % Index by tag and class:
 %
 % Write the tag and class as a group, under which is the name and the formatted name.
+% \changes{v0.11}{2018/02/05}{Index tag no longer plural.}
 %    \begin{macrocode}
 \begingroup%
 \DTXD at origwrindex{%
-#4s:\levelchar% index tag
+#4:\levelchar% index tag
 \ifblank{#1}{}{[#1]:\levelchar}% class
 #2\actualchar{\protect\ttfamily#2}% name
 \encapchar #5}%
@@ -1254,10 +1225,11 @@
 %	then printed and sorted by the macro name with the backslash, and the tag.
 %
 % Write indextag:>(class):>csname\verb+|usage+
+% \changes{v0.11}{2018/02/05}{Index tag no longer plural.}
 %    \begin{macrocode}
 \begingroup%
 \DTXD at origwrindex{%
-#4s:\levelchar% index tag
+#4:\levelchar% index tag
 \ifblank{#1}{}{[#1]:\levelchar}% class
 \DTXD at verbatimcmd{#2}% name
 \encapchar #5}%
@@ -1264,7 +1236,6 @@
 \@esphack%
 \ignorespaces%
 }
-
 %    \end{macrocode}
 % \end{macro}
 %
@@ -1604,11 +1575,13 @@
 % \begin{macro}{\watchout} \oarg{text}
 %
 % Prints a warning sign and optional text.
+%
+% \changes{v0.11}{2018/03/30}{Changed to \cs{raggedleft}.}
 %    \begin{macrocode}
 \newcommand{\watchout}[1][]{%
 \@ifundefined{@captype}{% not float?
 % \@bsphack%
-\marginpar{\hspace*{\fill}%
+\marginpar{\raggedleft%
 \textcolor{red!50!black}{\warningsign\normalsize\quad#1}}%
 % \@esphack%
 \ignorespaces%
@@ -1616,7 +1589,6 @@
 }
 %    \end{macrocode}
 % \end{macro}
-%
 
 
 % \subsection{The \env{dtxexample} Environment}

Modified: trunk/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty	2018-03-30 20:51:26 UTC (rev 47190)
+++ trunk/Master/texmf-dist/tex/latex/dtxdescribe/dtxdescribe.sty	2018-03-30 21:15:38 UTC (rev 47191)
@@ -19,7 +19,7 @@
 
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{dtxdescribe}
-    [2016/12/08 v0.10 Describe additional object types in dtx source files.]
+    [2018/03/30 v0.11 Describe additional object types in dtx source files.]
 
 
 
@@ -124,7 +124,7 @@
 \encapchar #5}%
 \begingroup%
 \DTXD at origwrindex{%
-#4s:\levelchar% index tag
+#4:\levelchar% index tag
 \ifblank{#1}{}{[#1]:\levelchar}% class
 #2\actualchar{\protect\ttfamily#2}% name
 \encapchar #5}%
@@ -172,7 +172,7 @@
 \encapchar #5}%
 \begingroup%
 \DTXD at origwrindex{%
-#4s:\levelchar% index tag
+#4:\levelchar% index tag
 \ifblank{#1}{}{[#1]:\levelchar}% class
 \DTXD at verbatimcmd{#2}% name
 \encapchar #5}%
@@ -181,7 +181,6 @@
 }
 
 
-
 \renewcommand*{\DescribeMacro}[2][]{%
 \@bsphack%
 \@ifundefined{@captype}{% not float?
@@ -316,7 +315,7 @@
 
 \newcommand{\watchout}[1][]{%
 \@ifundefined{@captype}{% not float?
-\marginpar{\hspace*{\fill}%
+\marginpar{\raggedleft%
 \textcolor{red!50!black}{\warningsign\normalsize\quad#1}}%
 \ignorespaces%
 }{}% not float?



More information about the tex-live-commits mailing list