summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nicetext
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-03-19 23:17:29 +0000
committerKarl Berry <karl@freefriends.org>2012-03-19 23:17:29 +0000
commitc036240d48a7cce4186d6429da3a747348b68362 (patch)
tree5f541777c8583dac417190b5eff04bde0c52bf06 /Master/texmf-dist/source/latex/nicetext
parent2fa6e82bbf186df35bebbbc6c32c8f2c4587014f (diff)
nicetext (19mar12)
git-svn-id: svn://tug.org/texlive/trunk@25699 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/nicetext')
-rw-r--r--Master/texmf-dist/source/latex/nicetext/makedoc.tex20
-rw-r--r--Master/texmf-dist/source/latex/nicetext/mdoccheat.tex15
-rw-r--r--Master/texmf-dist/source/latex/nicetext/srcfiles.tex3
3 files changed, 33 insertions, 5 deletions
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 `<jobname>.tex' \emph{after} &\begin{document}
`\MakeInputJobDoc[<out-ext>][<in-ext>]{<header-lines>}{<main-parser>}'
\end{displines}
documents `\mdJobName.<in-ext>' via `\mdJobName.<out-ext>',
-\defto{<in-ext>}{`sty'}, \defto{&\mdJobName}{<jobname>},
-\defto{<out-ext>}{`doc'},
+\defto{<in-ext>}{`sty'}, \defto{<out-ext>}{`doc'}, \defto{&\mdJobName}{<jobname>}
\par\kern-5pt
\begin{center} %% Parsers:
\begin{tabular}{@{}l@{\hskip4pt }l@{\hskip4pt }l@{}}
@@ -93,12 +93,21 @@ documents `\mdJobName.<in-ext>' via `\mdJobName.<out-ext>',
reads each <input> line to macro |\fdInputLine|,
applies <loop-body>
\cmdboxitem|\MakeDoc{<input>}|
+ inputs `mdoccorr.cfg'
copies <header-lines> from <input> to <output>,
applies <main-parser>
\cmdboxitem|\CloseResultFile| closes <output>
\cmdboxitem|\MakeCloseDoc{<input>}| issues
`\MakeDoc{<input>}\CloseResultFile'
+\cmdboxitem|\MakeSingleDoc[<out-ext>]{<in-output>.<in-ext>}|
+ issues `\LaTeXresultFile{<in-output>.<out-ext>}'
+ and `\MakeDocCloseDoc{<in-output>.<in-ext>}',
+ \defto{<out-ext>}{`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]