diff options
author | Karl Berry <karl@freefriends.org> | 2012-11-16 00:39:32 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-11-16 00:39:32 +0000 |
commit | d0098ed79f8feef72d604d541cd49cead7665f9d (patch) | |
tree | 3720f0088fd3dc3d56a3fef034674c1cff822ec5 /Master/texmf-dist/source/latex/nicetext | |
parent | 73197147bc73f92d052a21c519732f728e01c2ae (diff) |
nicetext (15nov12)
git-svn-id: svn://tug.org/texlive/trunk@28271 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/nicetext')
-rw-r--r-- | Master/texmf-dist/source/latex/nicetext/makedoc.tex | 59 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/nicetext/srcfiles.tex | 17 |
2 files changed, 52 insertions, 24 deletions
diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.tex b/Master/texmf-dist/source/latex/nicetext/makedoc.tex index fdf4ce95b11..47e835f5d4d 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}[2012/03/18 documenting makedoc.sty] +\ProvidesFile{makedoc.tex}[2012/11/13 documenting makedoc.sty] \RequirePackage{makedoc} \documentclass[fleqn]{article} %% fleqn 2011/10/12 \input{makedoc.cfg} @@ -393,7 +393,7 @@ script commands. With the \emph{``Wikipedia sectioning"} feature, you may change the outcome regarding levels. Assume, e.g., the package file has titles along the -scheme `== <title> ==' only, but these should become +scheme \[`== <title> =='\] only, but these should become %% \[...\] 2012/11/12 \emph{subsections} of the ``implementation" section of the corresponding `.tex' file. Then \[`\renewcommand*{\mdSectionLevelOne}{\string\subsection}'\] @@ -551,7 +551,7 @@ without modifying their files. \section{Examples}%%% (documentation of 'mdoccorr.cfg')} %% moved here 2010/03/23 -\subsection{'nicetext', especially 'mdoccorr.cfg'} +\subsection{Documenting 'nicetext''s `mdoccorr.cfg'} The documentations of 'fifinddo', 'makedoc', and 'niceverb' themselves are typeset using 'makedoc'. 'fifinddo.pdf' documents 'fifinddo.sty', typeset @@ -579,33 +579,47 @@ use this dialogue for arbitrary replacement jobs (as an application of 'fifinddo.pdf', 'makedoc.pdf', and 'niceverb.pdf' were typeset with the following typographical corrections in 'mdoccorr.cfg' that defines `\MakeDocCorrectHook': -\strut\hrule -\begingroup - \hfuzz=\textwidth \advance \hfuzz by 28pt - \MakeOther\|\MakeOther\`\MakeOther\'\MakeOther\< - \listinginput[5]{1}{mdoccorr.cfg} -\endgroup -\hrule\noindent\strut +% \strut\hrule %% rm. those struts 2012/11/12 +% \listinginput[5]{1}{mdoccorr.cfg} + %% <- 2012/11/12 > +\MDsamplecodeinput{mdoccorr.cfg} +\noindent This code also exemplifies the syntax 'niceverb' provides for writing about \LaTeX\ macros. It is typeset here with 'makedoc.sty' and then looks thus: -% \sloppy %% 2010/03/29 -\strut\hrule +\bigskip +\hrule \renewcommand*{\mdJobName}{mdoccorr} -% \tracingmacros=1 \tracingonline=1 %% 2011/11/19 \MakeInputJobDoc[cfg]{0}{\ProcessInputWith{comment}} -\hrule \noindent\strut +\hrule +\bigskip +\noindent And this is the content of the intermediate generated file: -\hrule -\begingroup - \hfuzz=\textwidth \advance \hfuzz by 28pt - \MakeOther\|\MakeOther\`\MakeOther\'\MakeOther\< - \listinginput[5]{1}{mdoccorr.doc} -\endgroup +% \listinginput[5]{1}{mdoccorr.doc} +\MDsamplecodeinput[75pt]{mdoccorr.doc} % \enlargethispage{8pt} %% 2011/09/14 keep rule on same page %% rm. 2011/10/25 -\hrule +% \hrule % \fussy %% 2010/03/29 +%% 2012/11/12: +\pagebreak +\subsection{Documenting 'nicetext''s `makedoc.cfg'} +`makedoc.cfg' once was meant to be just ``configuration," +but then I introduced some definitions there that may be +more interesting and once become a package. +Its typeset documentation first: +\pagebreak[3] +\strut\bigskip +\hrule +\smallskip +\renewcommand*{\mdJobName}{makedoc} +\MakeInputJobDoc[cfg]{0}{\ProcessInputWith{comment}} +\hrule +\bigskip +\noindent\strut +The bare code of `makedoc.cfg' is: +\MDsamplecodeinput{makedoc.cfg} + \subsection{Packages from other authors} \label{sec:otherauth} `substr.tex' should typeset a nicely formatted documentation @@ -689,3 +703,6 @@ end of a file it writes. %% todo TeXbook where? 2009/04/08 2011/11/05 or \RequirePackage{makedoc}; \MakeSingleDoc 2011/11/19 debugging for fifinddo v0.5 2012/03/18 * forms; Harald H. corrected +2012/11/12 reworked `mdoccorr' example (\MDsampleinput), + added `makedoc.cfg' documentation as sample +2012/11/13 using \MDsamplecodeinput from `makedoc.cfg' same day diff --git a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex index 15a15586bdf..2a6e935d994 100644 --- a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex +++ b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex @@ -1,8 +1,9 @@ -\ProvidesFile{srcfiles.tex}[2012/11/09 file infos -> SrcFILEs.txt] +\ProvidesFile{srcfiles.tex}[2012/11/13 file infos -> SrcFILEs.txt] +\RequirePackage{filedate} %% 2012-11-13 %% wrap, short 2012/11/09: \RequirePackage[r,wrap]{nicefilelist} \MaxBaseEmptyList{mdoccheat}[srcfiles.tex] -\ReadFileInfos{DOCSRC....} %% updsfl.sh +\ReadFileInfos{DOCSRC....} %% updsfl.sh \ReadFileInfos{README,fifinddo,makedoc,niceverb} \ReadFileInfos{mdoccheat,wikicheat} %% updsfl.sh \ReadFileInfos{srcfiles} @@ -22,4 +23,14 @@ \ReadFileInfos{BUNDLE....} %\ReadFileInfos{CHANGE.LOG} \ReadFileInfos{nicetext.RLS} -\ListInfos[SrcFILEs.txt] +\NoStopListInfos[SrcFILEs.txt] +\ModDates +\FileDateAutoChecks* +\ReadFileInfos{ + fifinddo.sty,makedoc.sty,niceverb.sty, + fifinddo, makedoc, niceverb, + mdoccorr.cfg,makedoc.cfg, + nicetext.RLS} +\DatesDiffWarnings +\CheckDateOfToday{nicetext.RLS} +\stop |