diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex | 220 |
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} + |