From b2ddfab321304389582ff4e049ef73f818d12628 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 18 Feb 2011 00:16:15 +0000 Subject: ydoc (17feb11) git-svn-id: svn://tug.org/texlive/trunk@21443 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/ydoc/ydoc.pdf | Bin 533645 -> 540572 bytes Master/texmf-dist/source/latex/ydoc/ydoc.dtx | 86 ++++++++++++++++++++++++- Master/texmf-dist/tex/latex/ydoc/ydoc-code.sty | 2 +- Master/texmf-dist/tex/latex/ydoc/ydoc-desc.sty | 32 ++++++++- Master/texmf-dist/tex/latex/ydoc/ydoc-doc.sty | 2 +- Master/texmf-dist/tex/latex/ydoc/ydoc-expl.sty | 2 +- Master/texmf-dist/tex/latex/ydoc/ydoc.cls | 2 +- Master/texmf-dist/tex/latex/ydoc/ydoc.sty | 2 +- 8 files changed, 119 insertions(+), 9 deletions(-) diff --git a/Master/texmf-dist/doc/latex/ydoc/ydoc.pdf b/Master/texmf-dist/doc/latex/ydoc/ydoc.pdf index 0a617684092..0c5316c62c7 100644 Binary files a/Master/texmf-dist/doc/latex/ydoc/ydoc.pdf and b/Master/texmf-dist/doc/latex/ydoc/ydoc.pdf differ diff --git a/Master/texmf-dist/source/latex/ydoc/ydoc.dtx b/Master/texmf-dist/source/latex/ydoc/ydoc.dtx index b4cd14a106c..ff27403fa81 100644 --- a/Master/texmf-dist/source/latex/ydoc/ydoc.dtx +++ b/Master/texmf-dist/source/latex/ydoc/ydoc.dtx @@ -35,7 +35,7 @@ % [ydoc-expl] % [ydoc-doc] %<*driver|class|package|code|desc|expl|doc> - {$Id: ydoc.dtx 2073 2011-01-26 11:25:50Z martin $} + {$Id: ydoc.dtx 2163 2011-02-16 17:19:27Z martin $} [v0.4alpha] % % [ydoc class: document LaTeX class and packages] @@ -74,7 +74,7 @@ % % \fi % -% \CheckSum{1488} +% \CheckSum{1535} % % \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 @@ -227,7 +227,8 @@ % This macro can only be used inside the \meta{macro arguments} of the above macros and typesets an additional macro as part % of the syntax of the described macro. The additional macro is normally an end- or other marker of some kind. Further macro arguments may % follow. Macros which are not part of the syntax but normal arguments should be written as -% |<\textbackslash name>| (yielding \MacroArgs<\textbackslash name>) instead. +% |<\textbackslash name>| (yielding \MacroArgs<\textbackslash name>) instead. +% The `\verb+|+' character is an abbreviation of \Macro\AlsoMacro, but only at places where this can appear. % % \subsubsection*{Examples:} % |\Macro\@for<\textbackslash var> ':=' \AlsoMacro\do {}|\\ @@ -236,6 +237,22 @@ % |\Macro\pgfkeys{'='',''/.code='{}}|\\ % \Macro\pgfkeys{'='',''/.code='{}}\\ % +% \DescribeMacro\MakeShortMacroArgs*{} +% This macro is similar to \Macro\MakeShortVerb from the \pkg{shortvrb} package. +% It can be used to globally define one character to act like \Macro\MacroArgs till the same character is discovered again. +% Special characters must be escaped with an backslash for the definition. +% One additional benefit beside the shorter size is that the argument list is automatically terminated. +% For example |\MakeShortMacroArgs{\"}| will make `|"{}"|' act like `|\MacroArgs{}\relax|'. +% One side-effect is that should the argument list be terminated, e.g. by an unknown element or macro, then the rest of the +% text till the end-character is typeset as normal, but inside a group. +% +% The starred version will define the character equal to \Macro\Macro instead. +% +% \DescribeMacro\DeleteShortMacroArgs{} +% Globally removes the special meaning from \meta{char} given to him by \Macro\MakeShortMacroArgs. +% +% Note that special characters like |`| are +% best defined |\AtBeginDocument| and deleted again |\AtEndDocument| to avoid issues if they are written to the |aux| file by some package. % % \begin{DescribeEnv}{DescribeMacros} % \Macro\Macro<\textbackslash name>\\ @@ -295,6 +312,7 @@ % Space (explicit macro) & |\space| & \\ % \midrule % Second macro (e.g.\ endmarker) & |\AlsoMacro\macro| & \MacroArgs\AlsoMacro\macro \\ +% \hfill short version: & \verb+|\macro+ & \MacroArgs|\macro \\ % \bottomrule % \multicolumn{4}{l}{{\Large\strut}$^{a}$) As alternative to be used inside normal text.} \\ % \multicolumn{4}{l}{Note that `|args|' can itself be further macro arguments except true verbatim.} @@ -955,6 +973,11 @@ \hypersetup{colorlinks=true,pdfborder=0 0 0,pdfborderstyle={}} % \end{macrocode} % +% The short verbatim code is required for the similar macros provided here. +% \begin{macrocode} +\RequirePackage{shortvrb} +% \end{macrocode} +% % \subsubsection{Color and style definitions} % \begin{macrocode} \RequirePackage{xcolor} @@ -1450,12 +1473,54 @@ \hbox\y@bgroup \@ifundefined{href@impl@\name}{}{\hyperlink{impl:\name}}% {\hypertarget{desc:\name}{\PrintMacroName{#1}}}% + \ydoc@macrocatcodes \macroargsstyle \read@Macro@arg } % \end{macrocode} % \end{macro} % +% \begin{macro}{\ydoc@macrocatcodes} +% Sets the catcodes inside for |read@Macro@arg| material. +% \begin{macrocode} +\def\ydoc@macrocatcodes{% + \ydoc@short@AlsoMacro +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\MakeShortMacroArgs} +% Defines the given character as short version for |\MacroArgs|. +% It is first define to be a short verbatim character to take +% advantage of the house-keeping (save \& restore of the original +% catcode and definition) of |shortvrb|. +% +% The starred version define the character to act like |\Macro| instead. +% \begin{macrocode} +\newcommand*\MakeShortMacroArgs{% + \@ifstar + {\@MakeShortMacroArgs\Macro}% + {\@MakeShortMacroArgs\MacroArgs}% +} +\def\@MakeShortMacroArgs#1#2{% + \MakeShortVerb{#2} + \catcode`#2\active + \begingroup + \catcode`\~\active + \lccode`\~`#2\relax + \lowercase{\endgroup\gdef~{\bgroup\let~\egroup#1}}% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\DeleteShortMacroArgs} +% \begin{macrocode} +\newcommand*\DeleteShortMacroArgs[1]{% + \DeleteShortVerb{#1}% +} +% \end{macrocode} +% \end{macro} +% % \begin{macro}{\Macro} % Simply uses the two macros below. % \begin{macrocode} @@ -1489,6 +1554,19 @@ % \end{macrocode} % \end{macro} % +% \begin{macro}{\ydoc@short@AlsoMacro} +% Makes |&| an alias for |\AlsoMacro|. +% \begin{macrocode} +\begingroup +\catcode`\|\active +\gdef\ydoc@short@AlsoMacro{% + \catcode`\|\active + \let|\AlsoMacro +} +\endgroup +% \end{macrocode} +% \end{macro} +% % \begin{macro}{\MacroArgs} % Uses the normal macro argument reading mechanism from \cs{DescribeMacro}. % Instead of a box a simple group is added. @@ -1496,6 +1574,7 @@ \newcommand*\MacroArgs{% \begingroup \def\end@Macro@args{\endgroup\xspace}% + \ydoc@macrocatcodes \macroargsstyle \read@Macro@arg } @@ -1636,6 +1715,7 @@ \let\PrintEnv\PrintSubEnv \hbox\y@bgroup \PrintEnvName{\begin}{\DescribeEnv@name}% + \ydoc@macrocatcodes \macroargsstyle \read@Macro@arg } diff --git a/Master/texmf-dist/tex/latex/ydoc/ydoc-code.sty b/Master/texmf-dist/tex/latex/ydoc/ydoc-code.sty index 4034d1fc43d..dbac15c6a3b 100644 --- a/Master/texmf-dist/tex/latex/ydoc/ydoc-code.sty +++ b/Master/texmf-dist/tex/latex/ydoc/ydoc-code.sty @@ -29,7 +29,7 @@ \NeedsTeXFormat{LaTeX2e}[1999/12/01] \ProvidesPackageSVN [ydoc-code] - {$Id: ydoc.dtx 2073 2011-01-26 11:25:50Z martin $} + {$Id: ydoc.dtx 2163 2011-02-16 17:19:27Z martin $} [v0.4alpha] [ydoc package to document macro code] \RequirePackage{hyperref} diff --git a/Master/texmf-dist/tex/latex/ydoc/ydoc-desc.sty b/Master/texmf-dist/tex/latex/ydoc/ydoc-desc.sty index 607efc48538..43d9be9330c 100644 --- a/Master/texmf-dist/tex/latex/ydoc/ydoc-desc.sty +++ b/Master/texmf-dist/tex/latex/ydoc/ydoc-desc.sty @@ -29,11 +29,12 @@ \NeedsTeXFormat{LaTeX2e}[1999/12/01] \ProvidesPackageSVN [ydoc-desc] - {$Id: ydoc.dtx 2073 2011-01-26 11:25:50Z martin $} + {$Id: ydoc.dtx 2163 2011-02-16 17:19:27Z martin $} [v0.4alpha] [ydoc package to describe macros, environments, options etc.] \RequirePackage{hyperref} \hypersetup{colorlinks=true,pdfborder=0 0 0,pdfborderstyle={}} +\RequirePackage{shortvrb} \RequirePackage{xcolor} \definecolor{macrodesc}{rgb}{0.0,0.0,0.8} \definecolor{macroimpl}{rgb}{0.0,0.0,0.4} @@ -237,9 +238,29 @@ \hbox\y@bgroup \@ifundefined{href@impl@\name}{}{\hyperlink{impl:\name}}% {\hypertarget{desc:\name}{\PrintMacroName{#1}}}% + \ydoc@macrocatcodes \macroargsstyle \read@Macro@arg } +\def\ydoc@macrocatcodes{% + \ydoc@short@AlsoMacro +} +\newcommand*\MakeShortMacroArgs{% + \@ifstar + {\@MakeShortMacroArgs\Macro}% + {\@MakeShortMacroArgs\MacroArgs}% +} +\def\@MakeShortMacroArgs#1#2{% + \MakeShortVerb{#2} + \catcode`#2\active + \begingroup + \catcode`\~\active + \lccode`\~`#2\relax + \lowercase{\endgroup\gdef~{\bgroup\let~\egroup#1}}% +} +\newcommand*\DeleteShortMacroArgs[1]{% + \DeleteShortVerb{#1}% +} \newcommand*\Macro{\MacroArgs\AlsoMacro} \def\@Macro{% \begingroup\makeatletter @@ -254,9 +275,17 @@ \PrintMacroName{#1}% \read@Macro@arg } +\begingroup +\catcode`\|\active +\gdef\ydoc@short@AlsoMacro{% + \catcode`\|\active + \let|\AlsoMacro +} +\endgroup \newcommand*\MacroArgs{% \begingroup \def\end@Macro@args{\endgroup\xspace}% + \ydoc@macrocatcodes \macroargsstyle \read@Macro@arg } @@ -338,6 +367,7 @@ \let\PrintEnv\PrintSubEnv \hbox\y@bgroup \PrintEnvName{\begin}{\DescribeEnv@name}% + \ydoc@macrocatcodes \macroargsstyle \read@Macro@arg } diff --git a/Master/texmf-dist/tex/latex/ydoc/ydoc-doc.sty b/Master/texmf-dist/tex/latex/ydoc/ydoc-doc.sty index aae0b73166f..ba8407ddd98 100644 --- a/Master/texmf-dist/tex/latex/ydoc/ydoc-doc.sty +++ b/Master/texmf-dist/tex/latex/ydoc/ydoc-doc.sty @@ -29,7 +29,7 @@ \NeedsTeXFormat{LaTeX2e}[1999/12/01] \ProvidesPackageSVN [ydoc-doc] - {$Id: ydoc.dtx 2073 2011-01-26 11:25:50Z martin $} + {$Id: ydoc.dtx 2163 2011-02-16 17:19:27Z martin $} [v0.4alpha] [ydoc package to provide 'doc' macros] \newcount\ydoc@bslashcnt diff --git a/Master/texmf-dist/tex/latex/ydoc/ydoc-expl.sty b/Master/texmf-dist/tex/latex/ydoc/ydoc-expl.sty index cdb13c65bf7..25f45d7ed7d 100644 --- a/Master/texmf-dist/tex/latex/ydoc/ydoc-expl.sty +++ b/Master/texmf-dist/tex/latex/ydoc/ydoc-expl.sty @@ -29,7 +29,7 @@ \NeedsTeXFormat{LaTeX2e}[1999/12/01] \ProvidesPackageSVN [ydoc-expl] - {$Id: ydoc.dtx 2073 2011-01-26 11:25:50Z martin $} + {$Id: ydoc.dtx 2163 2011-02-16 17:19:27Z martin $} [v0.4alpha] [ydoc package to insert live examples of LaTeX code] \RequirePackage{listings} diff --git a/Master/texmf-dist/tex/latex/ydoc/ydoc.cls b/Master/texmf-dist/tex/latex/ydoc/ydoc.cls index 97223c97fbf..a800783768c 100644 --- a/Master/texmf-dist/tex/latex/ydoc/ydoc.cls +++ b/Master/texmf-dist/tex/latex/ydoc/ydoc.cls @@ -27,7 +27,7 @@ %% \RequirePackage{svn-prov}[2010/04/03] \ProvidesClassSVN - {$Id: ydoc.dtx 2073 2011-01-26 11:25:50Z martin $} + {$Id: ydoc.dtx 2163 2011-02-16 17:19:27Z martin $} [v0.4alpha] [ydoc class: document LaTeX class and packages] \LoadClassWithOptions{article} diff --git a/Master/texmf-dist/tex/latex/ydoc/ydoc.sty b/Master/texmf-dist/tex/latex/ydoc/ydoc.sty index 2b1cca878b2..3a30527ef8d 100644 --- a/Master/texmf-dist/tex/latex/ydoc/ydoc.sty +++ b/Master/texmf-dist/tex/latex/ydoc/ydoc.sty @@ -28,7 +28,7 @@ \RequirePackage{svn-prov}[2010/04/03] \NeedsTeXFormat{LaTeX2e}[1999/12/01] \ProvidesPackageSVN - {$Id: ydoc.dtx 2073 2011-01-26 11:25:50Z martin $} + {$Id: ydoc.dtx 2163 2011-02-16 17:19:27Z martin $} [v0.4alpha] [ydoc package: document LaTeX class and packages] \RequirePackage{ydoc-code} -- cgit v1.2.3