summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nicetext
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-11-16 00:39:32 +0000
committerKarl Berry <karl@freefriends.org>2012-11-16 00:39:32 +0000
commitd0098ed79f8feef72d604d541cd49cead7665f9d (patch)
tree3720f0088fd3dc3d56a3fef034674c1cff822ec5 /Master/texmf-dist/source/latex/nicetext
parent73197147bc73f92d052a21c519732f728e01c2ae (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.tex59
-rw-r--r--Master/texmf-dist/source/latex/nicetext/srcfiles.tex17
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