summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nicetext
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-12-05 23:59:28 +0000
committerKarl Berry <karl@freefriends.org>2011-12-05 23:59:28 +0000
commit649482075a5882440e6ed9b1e530122baa49fb5b (patch)
tree3d0483b6174d317a4b3cf36b19b20db5d62f9206 /Master/texmf-dist/source/latex/nicetext
parent447c1d22bf02017dfb91166824a5d15cb643ed04 (diff)
nicetext 044 (5dec11)
git-svn-id: svn://tug.org/texlive/trunk@24771 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/nicetext')
-rw-r--r--Master/texmf-dist/source/latex/nicetext/fifinddo.tex24
-rw-r--r--Master/texmf-dist/source/latex/nicetext/makedoc.tex23
-rw-r--r--Master/texmf-dist/source/latex/nicetext/niceverb.tex7
-rw-r--r--Master/texmf-dist/source/latex/nicetext/srcfiles.tex4
4 files changed, 41 insertions, 17 deletions
diff --git a/Master/texmf-dist/source/latex/nicetext/fifinddo.tex b/Master/texmf-dist/source/latex/nicetext/fifinddo.tex
index 5417ee4c02b..e026929dbfc 100644
--- a/Master/texmf-dist/source/latex/nicetext/fifinddo.tex
+++ b/Master/texmf-dist/source/latex/nicetext/fifinddo.tex
@@ -1,9 +1,9 @@
-\ProvidesFile{fifinddo.tex}[2011/08/22 documenting fifinddo.sty]
+\ProvidesFile{fifinddo.tex}[2011/11/19 documenting fifinddo.sty]
\title{\textsf{fifinddo}\\---\\Filtering \TeX(t) Files by
\TeX\thanks{This file describes
version \fileversion\ of \textsf{\filename} as of \filedate.}}
% \listfiles
-\documentclass{article}
+\documentclass[fleqn]{article}
\usepackage{makedoc}
% \usepackage{substr} %% for failure examples TODO 2010/03/17
\input{makedoc.cfg}
@@ -40,6 +40,7 @@ and \LaTeX's internal `\in@'.
\end{MDabstract}
\tableofcontents
+\pagebreak %% 2011/11/19
\section{Introduction: The Gnome of the Aim}
\subsection{Parsing by \TeX---are you mad?}
The package name 'fifinddo' is a &\listfiles-compatible abbreviation
@@ -82,17 +83,20 @@ At least the first item is just the philosophy of the 'docstrip' program,
standard for installing \TeX\ packages;
and while I am typing this, I find at least 14 other similar packages
in J\"urgen Fenn's \emph{Topic Index} of the \emph{\TeX\ Catalogue:}
+\begin{center} %% 2011/11/13
% \begin{quote}\small
-\[\texttt{%
-% \hbox\bgroup\url{% %% \url impossible!? 2010/03/19
+% \[\texttt{%
+% \hbox\bgroup\url{% %% \url impossible!? 2010/03/19
+ \url{%
http://mirror.ctan.org/help/Catalogue/bytopic.html\string#parsingfiles}%
- \footnotemark
+% \footnotemark
% \egroup\]
-\]
-\footnotetext{%
- \href{http://mirror.ctan.org/help/Catalogue/bytopic.html\string#parsingfiles}%
- {Click here!}}
+% \]
+% \footnotetext{%
+% \href{http://mirror.ctan.org/help/Catalogue/bytopic.html\string#parsingfiles}%
+% {Click here!}}
% \end{quote}
+\end{center}
(Some of them may have been \emph{reactance} to 'texhax' and other
postings urging not to try something like this; some seem just to be
celebrations of the power of \TeX---yes, celebrate!)
@@ -340,3 +344,5 @@ TODO cf. Kastrup 'makematch' and others 2009/04/09,
2010/11/25f. using readprov.sty
2010/11/27 reworked \ProvidesFile
2011/08/22 PDF metadata; adjusting to makedoc.cfg
+2011/11/13 [fleqn]
+2011/11/19 \pagebreak
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
diff --git a/Master/texmf-dist/source/latex/nicetext/niceverb.tex b/Master/texmf-dist/source/latex/nicetext/niceverb.tex
index 738d05f34f9..e62a028eabf 100644
--- a/Master/texmf-dist/source/latex/nicetext/niceverb.tex
+++ b/Master/texmf-dist/source/latex/nicetext/niceverb.tex
@@ -1,4 +1,4 @@
-\ProvidesFile{niceverb.tex}[2011/10/07 documenting niceverb.sty]
+\ProvidesFile{niceverb.tex}[2011/11/05 documenting niceverb.sty]
\title{\textsf{niceverb.sty}\\---\\Minimizing
Markup\\for Documenting \LaTeX\ packages\thanks{This
document describes version
@@ -14,7 +14,9 @@
\MDkeywords{literate programming, syntactic sugar,
.txt to .tex enhancement, macro programming}
\hypersetup{%% was `syntacic' 2011/10/07:
- pdftitle=syntactic sugar for LaTeX documentation by niceverb.sty,
+% pdftitle=syntactic sugar for LaTeX documentation by niceverb.sty,
+ %% <- 2011/11/05 ->
+ pdftitle=niceverb.sty: syntactic sugar for LaTeX documentation,
pdfsubject=documenting niceverb.sty
}%% /2011/08/22
\begin{document}
@@ -458,3 +460,4 @@ HISTORY
2011/05/09 undoubled lines about `&'
2011/08/22 using new makedoc.cfg features
2011/10/07 `syntacic'
+2011/11/05 modified pdftitle
diff --git a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
index e674df5a1d5..46fbf40b8f0 100644
--- a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
+++ b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
@@ -1,11 +1,11 @@
\RequirePackage{myfilist}
-\ProvidesFile{srcfiles.tex}[2011/09/13 collect file infos]
+\ProvidesFile{srcfiles.tex}[2011/12/05 file infos -> SrcFILEs.txt]
\EmptyFileList %%% [readprov.sty,myfilist.sty]
% \ReadPackageInfos{readprov,myfilist}
\ReadFileInfos{DOCSRC.} %% updsfl.sh
-\ReadFileInfos{srcfiles}
\ReadFileInfos{README,fifinddo,makedoc,niceverb}
\ReadFileInfos{mdoccheat,wikicheat} %% updsfl.sh
+\ReadFileInfos{srcfiles}
\ReadFileInfos{RUN.}
\ReadFileInfos{arseneau,substr}
\ReadFileInfos{copyfile,fdtxttex}