diff options
Diffstat (limited to 'Master/texmf-dist/tex/latex/nicetext/makedoc.sty')
| -rw-r--r-- | Master/texmf-dist/tex/latex/nicetext/makedoc.sty | 31 |
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 |