From c036240d48a7cce4186d6429da3a747348b68362 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 19 Mar 2012 23:17:29 +0000 Subject: nicetext (19mar12) git-svn-id: svn://tug.org/texlive/trunk@25699 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/source/latex/nicetext/makedoc.tex | 20 ++++++++++++++++++-- .../texmf-dist/source/latex/nicetext/mdoccheat.tex | 15 ++++++++++++--- Master/texmf-dist/source/latex/nicetext/srcfiles.tex | 3 +++ 3 files changed, 33 insertions(+), 5 deletions(-) (limited to 'Master/texmf-dist/source') diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.tex b/Master/texmf-dist/source/latex/nicetext/makedoc.tex index f09d2a5bd23..fdf4ce95b11 100644 --- a/Master/texmf-dist/source/latex/nicetext/makedoc.tex +++ b/Master/texmf-dist/source/latex/nicetext/makedoc.tex @@ -1,4 +1,4 @@ -\ProvidesFile{makedoc.tex}[2011/11/19 documenting makedoc.sty] +\ProvidesFile{makedoc.tex}[2012/03/18 documenting makedoc.sty] \RequirePackage{makedoc} \documentclass[fleqn]{article} %% fleqn 2011/10/12 \input{makedoc.cfg} @@ -189,6 +189,7 @@ or you can switch to it by \[`\CopyFDconditionFromTo{PScomment}{comment}'\] \subsection{Markup in comments} +\label{sec:mdoccorr-tex} %% 2012/03/18 Packages using the 'doc'\slash '.dtx' system as well as alternative highly developed systems mentioned above use (enhanced) usual \emph{\LaTeX} syntax for markup of comments. Other packages just use @@ -534,6 +535,19 @@ file from a single input file! Therefore: % difficult---its parsing and that from 'verbatim' cannot % distinguish between markup code and typeset code.} % \end{enumerate} +\subsection{Star avoids &\input{mdoccorrhook}} +All the preprocessing commands described above---apart from the +'fifinddo' command `\ProcessFileWith'---input the file +'mdoccorr.cfg' with (typographical) replacement rules +(Sec.~\ref{sec:mdoccorr-tex}, Sec.~\ref{sec:mdoccorr}) +automatically. They have star variants that don't: +|\MakeInputJobDoc*|, |\MakeJobDoc*|, |\MakeDoc*|, +|\MakeCloseDoc*|, and |\MakeSingleDoc*|. +This is useful when rules very specific to a certain package +must be applied instead of the usual ones. +The examples named in Sec.~\ref{sec:otherauth} use this feature +for formatting other author's plain text documentation +without modifying their files. \section{Examples}%%% (documentation of 'mdoccorr.cfg')} %% moved here 2010/03/23 @@ -593,8 +607,9 @@ And this is the content of the intermediate generated file: % \fussy %% 2010/03/29 \subsection{Packages from other authors} +\label{sec:otherauth} `substr.tex' should typeset a nicely formatted documentation -of Harald Har\-der's 'substr.sty', see my own result `substr.pdf'. +of Harald Har\-ders' 'substr.sty', see my own result `substr.pdf'. 'substr.sty' is a rare case of the \lq`%% '\rq\ commenting style that 'nicetext' has used itself. @@ -673,3 +688,4 @@ end of a file it writes. %% todo TeXbook where? 2009/04/08 2011/10/25 without \enlargethispage 2011/11/05 or \RequirePackage{makedoc}; \MakeSingleDoc 2011/11/19 debugging for fifinddo v0.5 +2012/03/18 * forms; Harald H. corrected diff --git a/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex b/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex index 1fcbc68beda..4063fc275a1 100644 --- a/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex +++ b/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex @@ -16,10 +16,11 @@ \let\@listI\@listi \makeatother \newcommand*{\defto}[2]{$#1\to_{\mathit{default}}#2$} +\usepackage[margin=3cm]{geometry} %% 2012/03/18 % \sfcode`/=1001 %% TODO makedoc.cfg!? 2010/03/15 \sloppy \begin{document} - \enlargethispage{1\baselineskip} %% 2010/03/29 +% \enlargethispage{1\baselineskip} %% 2010/03/29 %% rm. 2012/03/18 % \null\kern-1\baselineskip \begin{center} \bfseries \Large @@ -42,8 +43,7 @@ in `.tex' \emph{after} &\begin{document} `\MakeInputJobDoc[][]{}{}' \end{displines} documents `\mdJobName.' via `\mdJobName.', -\defto{}{`sty'}, \defto{&\mdJobName}{}, -\defto{}{`doc'}, +\defto{}{`sty'}, \defto{}{`doc'}, \defto{&\mdJobName}{} \par\kern-5pt \begin{center} %% Parsers: \begin{tabular}{@{}l@{\hskip4pt }l@{\hskip4pt }l@{}} @@ -93,12 +93,21 @@ documents `\mdJobName.' via `\mdJobName.', reads each line to macro |\fdInputLine|, applies \cmdboxitem|\MakeDoc{}| + inputs `mdoccorr.cfg' copies from to , applies \cmdboxitem|\CloseResultFile| closes \cmdboxitem|\MakeCloseDoc{}| issues `\MakeDoc{}\CloseResultFile' +\cmdboxitem|\MakeSingleDoc[]{.}| + issues `\LaTeXresultFile{.}' + and `\MakeDocCloseDoc{.}', + \defto{}{`doc'}, \end{description} +%% 2012/03/18: +\textbf{d.~Avoid &\input{mdoccorr.cfg} by} +|\MakeInputJobDoc*|, |\MakeJobDoc*|, |\MakeDoc*|, +|\MakeCloseDoc*|, or |\MakeSingleDoc*| \end{document} diff --git a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex index 46fbf40b8f0..6b35a87464b 100644 --- a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex +++ b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex @@ -1,3 +1,6 @@ +\ProvidesFile{srcfiles.tex}[2012/03/18] +\RequirePackage{longnamefilelist} +\listfiles[9] \RequirePackage{myfilist} \ProvidesFile{srcfiles.tex}[2011/12/05 file infos -> SrcFILEs.txt] \EmptyFileList %%% [readprov.sty,myfilist.sty] -- cgit v1.2.3