summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/nicetext/makedoc.sty
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/tex/latex/nicetext/makedoc.sty')
-rw-r--r--Master/texmf-dist/tex/latex/nicetext/makedoc.sty31
1 files changed, 26 insertions, 5 deletions
diff --git a/Master/texmf-dist/tex/latex/nicetext/makedoc.sty b/Master/texmf-dist/tex/latex/nicetext/makedoc.sty
index 502f1307d0b..67658845ab3 100644
--- a/Master/texmf-dist/tex/latex/nicetext/makedoc.sty
+++ b/Master/texmf-dist/tex/latex/nicetext/makedoc.sty
@@ -4,7 +4,7 @@
%% -- author-maintained in the sense of LPPL below --
%% for preparing documentations from packages.
-\def\fileversion{0.41b} \def\filedate{2011/10/12}
+\def\fileversion{0.42} \def\filedate{2011/11/19}
%% This file can be redistributed and/or modified under
%% the terms of the LaTeX Project Public License; either
@@ -379,11 +379,17 @@
%% \LaTeX, considering what is typical for a \LaTeX\ package as the
%% <input> one here:
\newcommand*{\MakeDoc}[1]{%
+ \input{mdoccorr.cfg}% %% 2011/11/05
+%% ... added for what `makedoc.tex' says about it.
+%% See `\make_doc_job' for TODOs about it.
+%% Now also wondering: \ (i)~there are other ways to get the
+%% correcting hook, so why forcing this here? \
+%% (ii)~different correcting hooks for different input files?---%
%% In case of a ``header" (see below) we change into ``code mode":
\ifnum\header_lines>\z@
\WriteResult{\string\begin{mdPackageCode}}%
- \PackageCodeTrue %% TODO both lines makedoc command!?
- %% 2009/04/08
+ \PackageCodeTrue %% TODO both lines makedoc command!?
+ %% 2009/04/08
\else \PackageCodeFalse \fi
%% The loop follows. There is a placeholder `\makd_doc_line_body'
%% that is predefined below and can be changed while processing the
@@ -406,15 +412,28 @@
% \HeaderLines{0}%
% \MainDocParser{\SectionLevelThreeParseInput}%% TODO!? 2009/04/08
}
-%% |\MakeCloseDoc{<input>}| %% 2010/03/11
-%% just is a shorthand for
+%% |\MakeCloseDoc{<input>}| %% 2010/03/11
+%% is a kind of shorthand for
%% \[`\MakeDoc{<input>}\CloseResultFile'\] %% was MakeClose 2011/10/12
%% where `\CloseResultFile' is from 'fifinddo'.
\newcommand*{\MakeCloseDoc}[1]{\MakeDoc{#1}\CloseResultFile}
+%% Reimplementation using 'fifinddo' v0.5 failed: %% 2011/11/19
+% \newcommand*{\MakeCloseDoc}{\FinalInputFiletrue\MakeDoc}
%% `\MakeDoc' and `\MakeCloseDoc' actually \emph{process}
%% the <input> file,
%% depending on certain \emph{parameters} some of which are set
%% by the commands described next.
+%%
+%% \subsubsection{Combining input and output}
+%% \[|\MakeSingleDoc[<out-ext>]{<in-output>.<in-ext>}|\] %% 2011/11/05
+%% generates `<in-output>.<out-ext>' from `<in-output>.<in-ext>',
+%% using settings like `\MakeDoc'. The default for <out-ext> is `doc'.
+%% `\MakeSingleDoc' combines `\LaTeXresultFile'
+%% and `\MakeCloseDoc' with appropriate arguments.
+%% (TODO: not so sure about dot vs.\ optional <in-ext>.)
+\newcommand*{\MakeSingleDoc}[2][doc]{\make_single_doc[#1]#2\@nil}
+\def\make_single_doc[#1]#2.#3\@nil{%
+ \LaTeXresultFile{#2.#1}\MakeCloseDoc{#2.#3}}
%%
%% \subsubsection{Preamble vs.\ main part of input file}
%% A \LaTeX\ package typically has a ``header" or ``preamble"
@@ -592,3 +611,5 @@ v0.41 2010/12/20 \ResetCodeLineNumbers defined globally
2011/01/25 updated (C)
v0.41a 2011/08/22 doc.: makedoc.cfg -> mdoccorr.cfg
v0.41b 2011/10/12 doc.: MakeClose -> MakeDoc
+v0.42 2011/11/05 \MakeDoc reads mdoccorr.cfg, \MakeSingleDoc
+ 2011/11/19 failing reimplementation of \MakeCloseDoc