summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nicetext/makedoc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/nicetext/makedoc.tex')
-rw-r--r--Master/texmf-dist/source/latex/nicetext/makedoc.tex23
1 files changed, 19 insertions, 4 deletions
diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.tex b/Master/texmf-dist/source/latex/nicetext/makedoc.tex
index 88835e71e93..f09d2a5bd23 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/10/25 documenting makedoc.sty]
+\ProvidesFile{makedoc.tex}[2011/11/19 documenting makedoc.sty]
\RequirePackage{makedoc}
\documentclass[fleqn]{article} %% fleqn 2011/10/12
\input{makedoc.cfg}
@@ -251,8 +251,10 @@ and `\maketitle' etc.\ about your package.\footnote{With 'niceverb'
The documentation will be produced by running `<jobname>.tex' with
\LaTeX\ (e.g., \texttt{latex <jobname>.tex}).
-First, `<jobname>.tex' must have |\usepackage{makedoc}| in its preamble.
-There are no package options.
+First, `<jobname>.tex' must have
+\[|\usepackage{makedoc}|\quad\mbox{or}\quad
+ |\RequirePackage{makedoc}|\] %% 2011/11/05
+in its preamble. There are no package options.
Second, to typeset the commented implementation from `<jobname>.sty',
include in <jobname>.tex's `document' environment a line
@@ -464,7 +466,16 @@ general way.\footnote{%% TODO 2010/03/16
Using `\MakeDoc' \emph{instead} of `\MakeCloseDoc' allows processing
additional <input> files writing into the same <output>. Or maybe you
want to add some additional lines manually to <output> using
-`\WriteResult'.
+`\WriteResult'.---By contrast, you may want to make a single output
+file from a single input file! Therefore:
+%% <- 2011/11/05 ->
+%
+\begin{description}
+\cmdboxitem|\MakeSingleDoc[<out-ext>]{<in-output>.<in-ext>}| \
+ issues\\`\LaTeXresultFile{<in-output>.<out-ext>}'\quad
+ and\\`\MakeDocCloseDoc{<in-output>.<in-ext>}'.\\
+ The default for <out-ext> is `doc'.
+\end{description}
%% removed 2010/03/09:
% At least in the long run, using 'makedoc' should not imply commitment
@@ -567,6 +578,7 @@ and then looks thus:
% \sloppy %% 2010/03/29
\strut\hrule
\renewcommand*{\mdJobName}{mdoccorr}
+% \tracingmacros=1 \tracingonline=1 %% 2011/11/19
\MakeInputJobDoc[cfg]{0}{\ProcessInputWith{comment}}
\hrule \noindent\strut
And this is the content of the intermediate generated file:
@@ -600,6 +612,7 @@ Head of file (Legalese):
\renewcommand*{\mdJobName}{makedoc}
\ProcessLineMessage{}
\MakeInputJobDoc{22}{\ProcessInputWith{comment}}
+\enlargethispage{2\baselineskip} %% 2011/11/05
The previous empty code line is the one \TeX\ insists to add at every
end of a file it writes. %% todo TeXbook where? 2009/04/08
@@ -658,3 +671,5 @@ end of a file it writes. %% todo TeXbook where? 2009/04/08
2011/10/07 "grouping" fix(?) + \label in "Separating"
2011/10/12 fleqn
2011/10/25 without \enlargethispage
+2011/11/05 or \RequirePackage{makedoc}; \MakeSingleDoc
+2011/11/19 debugging for fifinddo v0.5