summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex')
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex220
1 files changed, 220 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex b/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex
new file mode 100644
index 00000000000..2a1874bf912
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex
@@ -0,0 +1,220 @@
+\typeout{arseneau.tex 2010/03/30 some packages by D. Arseneau}
+
+\title{A Few (just Two) Packages by Donald Arseneau}
+
+\author{Uwe L\"uck\thanks{applying \url{http://ctan.org/pkg/nicetext}}}
+
+% \listfiles
+
+
+
+%% Preprocessing:
+
+\RequirePackage{makedoc}
+
+% \CopyFDconditionFromTo{PScomment}{comment}
+
+\MainDocParser{\ProcessInputWith{PScomment}}
+
+%% nolbreaks:
+
+%% Replacements:
+
+\SetPatternCodes{\MakeOther\\\MakeOther\ }
+
+\MakeExpandableAllReplacer{LaTeX}{LaTeX }{\LaTeX{} }{LEAVE}
+
+% \MakeExpandableAllReplacer{TeX}{\TeX }{\TeX{} }{LEAVE}
+
+\PrependExpandableAllReplacer{opt}{[ragged]}{`[ragged]'}
+
+\PrependExpandableAllReplacer{braces}[\Delimiters<>]<{ }><`{ }'>
+
+\SetCorrectHookJobLast
+
+
+
+\HeaderLines{2}
+
+\LaTeXresultFile{nolbreaks.doc}
+
+\MakeCloseDoc{nolbreaks.sty}
+
+
+
+%% notoccite:
+
+\MakeExpandableAllReplacer{LaTeX}{LaTeX }{\LaTeX{} }{LEAVE}
+
+\PrependExpandableAllReplacer{caption}%
+
+{ \caption [}{\DISPLAY\caption[}
+
+\PrependExpandableAllReplacer{unsrt}{unsrt}{`unsrt'}
+
+\PrependExpandableAllReplacer{toc}{ toc}{ `.toc'}
+
+\PrependExpandableAllReplacer{lof}{lof}{`.lof'}
+
+\PrependExpandableAllReplacer{latex}{latex}{`latex'}
+
+\PrependExpandableAllReplacer{NOTE}{*NOTE*}{\textbf{NOTE:\enspace}}
+
+\PrependExpandableAllReplacer{does}{*does*}{\emph{does}}
+
+\PrependExpandableAllReplacer{bibtex}{bibtex}{`bibtex'}
+
+\ResetPatternCodes
+
+\SetCorrectHookJobLast
+
+
+
+\HeaderLines{3}
+
+\LaTeXresultFile{notoccite.doc}
+
+\MakeCloseDoc{notoccite.sty}
+
+
+
+%% Typesetting:
+
+\documentclass{article}
+
+\usepackage{hyperref,niceverb} %% niceverb after hyperref!
+
+\AddToNoVerbList{\DISPLAY\textbf\enspace\emph\LaTeX}
+
+\newcommand*{\DISPLAY}{%
+
+ \\[\smallskipamount]\leavevmode\null\hfil}
+
+\makeatletter \MakeLetter\_
+
+% {\MakeActive\"\gdef\DQcode#1"{\dqtd{\texttt{#1}}}}
+
+{\MakeActive\"\gdef\DQcode#1"{\texttt{#1}}}
+
+%% weird problems:
+
+% \newcommand*{\startDQcode}
+
+% {``\begingroup\MakeActiveLetHere\"\enddQcode\tt}
+
+% \def\endDQcode{\endgroup"}
+
+\pagestyle{headings}
+
+\usepackage{parskip}
+
+\begin{document}
+
+\maketitle
+
+
+
+\begin{abstract}\noindent
+
+ This document demonstrates the present
+
+ (i.e., 'nicetext' bundle release v0.4)
+
+ capabilities of 'makedoc' and 'niceverb'
+
+ to typeset \LaTeX\ quality documentation from
+
+ third-party package files having ASCII comments only,
+
+ without modifying such package files manually.\footnote{See
+
+ \url{http://ctan.org/pkg/nicetext}
+
+ for more on these packages.}
+
+ Such packages usually mark comments by lines starting with
+
+ \lq`% '\rq. This is somewhat difficult when the ``comment mark"
+
+ \lq`%'\rq\
+
+ may at the same time be used for ``commenting out" in place of
+
+ ``true commenting." As opposed to 'substr.sty' that conforms to the
+
+ easier \lq`%% '\rq\ style, the packages 'nolbreaks' and 'notoccite'
+
+ by Donald Arseneau exemplify the \lq`% '\rq\ commenting style.
+
+
+
+ The ASCII documentation of packages of this kind
+
+ does not always clearly indicate when switching to `\tt' is appropriate.
+
+ This problem is solved here by string replacements very specific
+
+ to the package files.
+
+ The setup for these replacements
+
+ (in the source file 'arseneau.tex')
+
+ still may be simplified.
+
+ %% <- 2010/03/29
+
+
+
+ Moreover, some similar packages cannot be properly typeset with
+
+ 'nicetext' at present because 'makedoc''s loop is too rigid to deal with
+
+ (i)~ASCII indents, displays, lists and with (ii)~instructions
+
+ after `\endinput'.
+
+
+
+ It should be clear that all the package desriptions are Donald Arseneau's,
+
+ 'nicetext' just formats them.
+
+\end{abstract}
+
+\tableofcontents
+
+\pagebreak
+
+
+
+\sloppy
+
+
+
+\section{'nolbreaks'}
+
+% \MakeActiveLet\_\textunderscore
+
+% \MakeActive\*\def*{\texttt{\string*}}
+
+% \MakeActiveLetHere\"\startDQcode
+
+\MakeActiveLetHere\"\DQcode
+
+% \errorcontextlines=6
+
+\AutoCmdInput{nolbreaks.doc}
+
+
+
+\section{'notoccite'}
+
+\ResetCodeLineNumbers
+
+\AutoCmdInput{notoccite.doc}
+
+
+
+\end{document}
+