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 | |
parent | 73197147bc73f92d052a21c519732f728e01c2ae (diff) |
nicetext (15nov12)
git-svn-id: svn://tug.org/texlive/trunk@28271 c570f23f-e606-0410-a88d-b1316a301751
23 files changed, 779 insertions, 66 deletions
diff --git a/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG b/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG index f699c6c6ba7..60cedfdbee2 100644 --- a/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG +++ b/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG @@ -1,5 +1,25 @@ -nicetext RELEEASE 0.61 2012/11/09 makedoc/mdoccorr.cfg +nicetext RELEASE 0.62 2012/11/13 `makedoc.cfg' enhanced + (`filedate', code input), + documented in `makedoc.pdf' + + CHANGE.LOG 2012/11/13 updated + SrcFILEs.txt 2012/11/13 updated + makedoc.cfg 2012/11/13 \MDdocnewline, + \MDfinaldatechecks, + \MDsamplecodeinput, + documentation code + makedoc.tex 2012/11/13 examples reformatted, + include `makedoc.cfg' + mdoccorr.cfg 2012/11/13 \do as shorthand, + code line breaks + makedoc.pdf 2012/11/13 updated + nicetext.RLS 2012/11/13 updated + srcfiles.tex 2012/11/13 some `filedate' checks + +______________________________________________________________________ + +nicetext RELEASE 0.61 2012/11/09 makedoc/mdoccorr.cfg extended, use recent `nicefilelist' @@ -17,7 +37,7 @@ nicetext RELEEASE 0.61 2012/11/09 makedoc/mdoccorr.cfg ______________________________________________________________________ -nicetext RELEEASE 0.6a 2012/10/10 niceverb.pdf introduction +nicetext RELEASE 0.6a 2012/10/10 niceverb.pdf introduction describes \[Dont]AddQuotes ______________________________________________________________________ diff --git a/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt b/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt index c38de071b58..d65dd782917 100644 --- a/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt +++ b/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt @@ -3,11 +3,11 @@ DOCSRC.... -- -- -- -- README.tex 2012/03/18 -- make README.pdf fifinddo.tex 2011/11/19 -- documenting fifinddo.sty - makedoc.tex 2012/03/18 -- documenting makedoc.sty + makedoc.tex 2012/11/13 -- documenting makedoc.sty niceverb.tex 2012/10/10 -- documenting niceverb.sty mdoccheat.tex 2011/01/26 -- cheat sheet for `makedoc.sty' wikicheat.tex 2011/01/26 -- cheatsheet for wiki.sty - srcfiles.tex 2012/11/09 -- file infos -> SrcFILEs.txt + srcfiles.tex 2012/11/13 -- file infos -> SrcFILEs.txt RUN.... -- -- -- -- arseneau.tex 2012/03/18 -- some packages by D. Arseneau (ul) substr.tex 2012/03/18 -- documentation for substr.sty @@ -25,15 +25,17 @@ wikicheat.tex 2011/01/26 -- cheatsheet for wiki.sty USE.... -- -- -- -- fifinddo.sty 2012/08/27 v0.6 filtering TeX(t) files by TeX (UL) makedoc.sty 2012/08/28 v0.52 TeX input from *.sty (UL) - makedoc.cfg 2012/11/09 -- [06] documentation settings - mdoccorr.cfg 2012/11/07 -- `makedoc' local typographical corrections + makedoc.cfg 2012/11/13 -- documentation settings + mdoccorr.cfg 2012/11/13 -- `makedoc' local typographical corrections niceverb.sty 2012/09/27 v0.5 minimize doc markup (UL) wiki.sty 2008/07/02 v0.2 LaTeX through Wiki markup BUNDLE.... -- -- -- -- - nicetext.RLS 2012/11/09 r0.61 `lmodern', \qtdcode, \TODO, \MDsampleinput; - use recent `nicefilelist'; corr. upload dirs + nicetext.RLS 2012/11/13 r0.62 `makedoc.cfg' uses `filedate', + \MDdocnewline, \MDsamplecodeinput, + documented in `makedoc.pdf'; + `mdoccorr.cfg' nicer *********** - List made at 2012/11/09, 16:18 + List made at 2012/11/13, 19:08 from script file srcfiles.tex diff --git a/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf b/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf Binary files differindex 9dc009b91e3..6e0e712a6ab 100644 --- a/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf +++ b/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf 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 diff --git a/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg b/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg index f104cda3682..b1bb5fd5897 100644 --- a/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg +++ b/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg @@ -1,7 +1,7 @@ -\ProvidesFile{makedoc.cfg}[{2012/11/09 [06] documentation settings}] +\ProvidesFile{makedoc.cfg}[{2012/11/13 documentation settings}] -\author{Uwe L\"uck\thanks{\url{http://contact-ednotes.sty.de.vu}}} -% \author{Uwe L\"uck---{\tt http://contact-ednotes.sty.de.vu}} +\author{Uwe L\"uck\thanks{% + \url{http://contact-ednotes.sty.de.vu}}} %% hyperref: \RequirePackage{ifpdf} @@ -24,7 +24,10 @@ draft \fi ]{hyperref} -%% metadata, |\MDkeywords|, |\MDkeywordsstring|, |\printMDkeywords| +\hypersetup{% + pdfauthor={Uwe L\374ck}% +} +%% metadata, |\MDkeywords{<text>}|, |\MDkeywordsstring|, %% 2011/08/22: \makeatletter \newcommand*{\MDkeywords}[1]{% @@ -32,14 +35,18 @@ \hypersetup{pdfkeywords=\MDkeywordsstring}%% TODO!? } \@onlypreamble\MDkeywords - \newcommand*{\MDaddtoabstract}[1]{% %% 2012/05/10 + \newcommand*{\MDaddtoabstract}[1]{% %% 2012/05/10 \par\smallskip\noindent \strong{#1:}\quad\ignorespaces} +%% \pagebreak[2] +%% |\printMDkeywords|: \newcommand*{\printMDkeywords}{% \MDaddtoabstract{Keywords}% \MDkeywordsstring - \global\let\MDkeywordsstring\relax +% \global\let\MDkeywordsstring\relax %% `%' 2012/11/12 } +%% The previous definitions mainly are useful with a variant +%% |\begin{MDabstract}| of \LaTeX's `{abstract}' environment: \newenvironment{MDabstract} {\abstract\noindent \hspace{1sp}%% for niceverb @@ -47,11 +54,24 @@ {\@ifundefined{MDkeywordsstring}% {}% {\printMDkeywords}% + \global\let\MDabstract\relax %% 2012/11/12 + \global\let\endMDabstract\relax %% 2012/11/12 \endabstract} +%% |\[MD]docnewline| 2012/11/12 from `readprov.tex': + \newcommand*{\MDdocnewline}{\leavevmode\@normalcr[\topsep]} +%% <- `\leavevmode' for use with `\paragraph'. +%% Sometimes needs to be preceded by a space. +%% +%% |\MDfinaldatechecks[<tex-script>]| with \ctanpkgref{filedate}: + \newcommand*{\MDfinaldatechecks}[1][fdatechk]{% + \AtEndDocument{% + \def\@pkgextension{sty}% + \def\NeedsTeXFormat##1[##2]{}% + \input{#1}% + }} + \@onlypreamble\MDfinaldatechecks \makeatother -\hypersetup{% - pdfauthor={Uwe L\374ck}% -} +%% Use other packages: \RequirePackage{niceverb}[2011/01/24] \RequirePackage{readprov} %% 2010/12/08 \RequirePackage{hypertoc} %% 2011/01/23 @@ -59,14 +79,16 @@ \RequirePackage{relsize} %% 2011/06/27 \RequirePackage{color} %% 2011/08/06 \RequirePackage{lmodern} %% 2012/10/29 -%% Logical markup |\strong{<text>}|, |\file{<text>}|, |\acro{<text>}|, -%% |\meta{<text>}|, |\pkg{<text>}|, |\code{<text>}|, |\qtdcode{<text>}|: +\RequirePackage{filedate} %% 2012/11/12 +%% \pagebreak[3] +%% Logical markup:\qquad |\strong{<chars>}|, |\meta{<chars>}|, +%% |\acro{<chars>}|, |\pkg{<chars>}|, +%% |\code{<chars>}|, |\file{<chars>}|:{\sloppy\par} \makeatletter \def\do#1#2{\@ifdefinable#1{\let#1#2}}%% 2012/07/13 \do\strong\textbf \do\file\texttt \do\acro\textsmaller %% <- wrong tests before 2012/07/13 \do\meta\textit \do \pkg\textsf \do\code\texttt - \newcommand*{\qtdcode}[1]{`\code{#1}'} %% 2012/10/24 \ifpdf \pdfstringdefDisableCommands{% \let\acro\textrm @@ -77,19 +99,35 @@ \fi %% TODO 2011/07/22 -> `htlogml.sty' \makeatother +%% |\qtdcode{<text>}|: 2012/10/24: + \newcommand*{\qtdcode}[1]{`\code{#1}'} +%% |\pkgtitle{<package-name>}{<caption>}| \newcommand*{\pkgtitle}[2]{% %% 2012/07/13 \global\let\pkgtitle\relax \pkg{\huge #1}\\---\\#2\thanks{This document describes version \textcolor{blue}{\UseVersionOf{\jobname.sty}} of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}} +%% TODO: %% |\TODO| bad with `mdoccorr.cfg' \newcommand*{\TODO}{\textcolor{blue}{\acro{TODO}}} %% 2012/11/06 -\newcommand*{\MDsampleinput}[1]{% %% 2012/11/06 - \par\bigskip\hrule\verbatiminput{#1}% - \hrule\bigskip} - +%% \[`\MDsampleinput[{<file>}'\] was added 2012/11/06. +%% Problems with `myfilist.tex' were due to \ctanpkgref{parskip} +%% there. On 2012/11/12, we change the former simple macro to a +%% much more complex +%% |\MDsamplecodeinput[<add-hfuss>]{<file>}| +\newcommand*{\MDsamplecodeinput}[2][]{% + \begingroup + \bigskip \hrule + \nobreak\vskip-\parskip \nobreak\vskip\medskipamount + \ifx\\#1\\\else + \hfuzz=\textwidth \advance\hfuzz#1\relax + \fi + \noNiceVerb \verbatiminput{#2}% + \nobreak\vskip\medskipamount + \hrule \vskip-\parskip \bigbreak + \endgroup +} \errorcontextlines=4 \pagestyle{headings} -\endinput - +\endinput diff --git a/Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg b/Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg index 5914ea260bb..6a6a7012292 100644 --- a/Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg +++ b/Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg @@ -1,4 +1,4 @@ -\ProvidesFile{mdoccorr.cfg}[2012/11/07 +\ProvidesFile{mdoccorr.cfg}[2012/11/13 `makedoc' local typographical corrections] %% ... also demonstrates 'niceverb.sty'---see the typeset %% documentation of the present file in `makedoc.pdf'. @@ -13,24 +13,25 @@ %% |\PrependExpandableAllReplacer*{<find>}{<subst>}|: \PrependExpandableAllReplacer*{etc. }{etc.\ } %% ... you can keep inter-sentence space after `etc.' -%% by a code line break. -\PrependExpandableAllReplacer*{Cf. }{Cf.\ } %% 2011/01/12 -\PrependExpandableAllReplacer*{cf. }{cf.\ } %% corr. 2010/03/23 +%% by a code line break.---Now we use |\do| as a shorthand: +\renewcommand*{\do}{\PrependExpandableAllReplacer*} +\do{Cf. }{Cf.\ } %% 2011/01/12 +\do{cf. }{cf.\ } %% corr. 2010/03/23 %% ... but think of `cf.~'. Don't leave `cf.' at code line end! -\PrependExpandableAllReplacer*{->}{$\to$} %% 2010/11/06 -\PrependExpandableAllReplacer*{<-}{$\gets$} %% 2010/11/06 +\do{->}{$\to$} %% 2010/11/06 +\do{<-}{$\gets$} %% 2010/11/06 % \PrependExpandableAllReplacer{...}{...}{$\dots$} %% Allow extra space at line end (bug fix `{}' 2011/12/03): -\PrependExpandableAllReplacer*{...}{\textellipsis\unkern{}} +\do{...}{\textellipsis\unkern{}} %% 2011/10/13: original `\dots' correct before punctuation: % \PrependExpandableAllReplacer{dots,}{...,}{\dots,} -\PrependExpandableAllReplacer*{...)}{\dots)} %% 2011/10/25 -\PrependExpandableAllReplacer*{...:}{\dots:} %% 2012/11/07 -\PrependExpandableAllReplacer*{... }{\textellipsis\unkern\ } -\PrependExpandableAllReplacer*{TODO}{\TODO{}} -%% ... chain starts here, and here |\MakeDocCorrectHook| (silently) -%% enters through a default variant |\SetCorrectHookJobLast| -%% of |\SetCorrectHookJob{<id>}|: +\do{...)}{\dots)} %% 2011/10/25 +\do{...:}{\dots:} %% 2012/11/07 +\do{... }{\textellipsis\unkern\ } +\do{TODO}{\TODO{}} +%% ... chain starts here, and here |\MakeDocCorrectHook| +%% (silently) enters through a default variant +%% |\SetCorrectHookJobLast| of |\SetCorrectHookJob{<id>}|: \SetCorrectHookJobLast %% |\ResetPatternCodes| resets `\PatternCodes' to their default %% value (which is `\fdPatternCodes'): @@ -47,7 +48,8 @@ HISTORY 2010/03/29 use \SetPatternCodes etc. 2010/11/06 <- and -> 2010/11/24 `...' ``symmetric variant" of `\textellipsis'; - \StartPrependingChain, no more \MakeExpandableAllreplacer + \StartPrependingChain, no more + \MakeExpandableAllreplacer 2011/01/27 blue "TODO" 2011/09/13 \providecommand for dialogues 2011/10/13 \MDtwodots, without \PXAR, `...,' `...:' @@ -55,3 +57,5 @@ HISTORY 2011/11/13 \PrependExpandableAllReplacer* 2011/12/03 bug fix for 2011/10/25 at line ends 2012/11/07 TODO -> \TODO{} +2012/11/12 using \do +2012/11/13 shorter code lines diff --git a/Master/texmf-dist/tex/latex/nicetext/nicetext.RLS b/Master/texmf-dist/tex/latex/nicetext/nicetext.RLS index fa1b260e871..5befc57381b 100644 --- a/Master/texmf-dist/tex/latex/nicetext/nicetext.RLS +++ b/Master/texmf-dist/tex/latex/nicetext/nicetext.RLS @@ -1,4 +1,8 @@ \ProvidesFile{nicetext.RLS} %% RELEASE INFO + [2012/11/13 r0.62 `makedoc.cfg' uses `filedate',^^J% + \string\MDdocnewline, \string\MDsamplecodeinput,^^J% + documented in `makedoc.pdf';^^J% + `mdoccorr.cfg' nicer] [2012/11/09 r0.61 `lmodern', \string\qtdcode, \string\TODO, \string\MDsampleinput; use recent `nicefilelist'; diff --git a/Master/texmf-dist/tex/latex/nicetext/run/README-run.txt b/Master/texmf-dist/tex/latex/nicetext/run/README-run.txt new file mode 100644 index 00000000000..a953d293e83 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/README-run.txt @@ -0,0 +1,9 @@ +The .tex files can be run with latex ("script files"). +arseneau.tex and substr.tex demonstrate the "auto" feature +of makedoc.sty, see makedoc.pdf. +copyfile.tex and fdtxttex.tex are dialogues. +Replace copyfile.cfg by atari.cfg to get a conversion sample. +The .tpl files are templates for script files. See FILEs.txt, +fifinddo.pdf, and makedoc.pdffor additional informations. + +UL 2011-09-14 diff --git a/Master/texmf-dist/tex/latex/nicetext/run/arseneau.tex b/Master/texmf-dist/tex/latex/nicetext/run/arseneau.tex new file mode 100644 index 00000000000..c2a59f45552 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/arseneau.tex @@ -0,0 +1,153 @@ +\ProvidesFile{arseneau.tex} + [2012/03/18 some packages by D. Arseneau (ul)] +\title{A Few Packages by Donald Arseneau} +\author{Uwe L\"uck\thanks{applying \url{http://ctan.org/pkg/nicetext}}} +% \listfiles + +%% Preprocessing: +\RequirePackage{makedoc} +% \CopyFDconditionFromTo{PScomment}{comment} +\ProcessLineMessage{} +\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} + +\ProcessLineMessage{\message{.}} +%% optional: +% \SetPatternCodes{\MakeOther\\\MakeOther\ } +\SetPatternCodes{\MakeOther\\} +\MakeExpandableAllReplacer{LaTeX:}{LaTeX:}{\LaTeX:}{LEAVE} +\PrependExpandableAllReplacer{LaTeX}[\MakeOther\ ]% +{LaTeX }{\LaTeX{} } +\PrependExpandableAllReplacer{pkg}{optional.sty}{'optional.sty'} +\PrependExpandableAllReplacer{IS}{*IS*}{\emph{is}} +\PrependExpandableAllReplacer{tildes}[\MakeOther\ ]% +{HOW TO USE}{\SECT{How to Use}} +% \SetPatternCodes{\MakeOther\~} +% \PrependExpandableAllReplacer{tildes}[\MakeOther\~]{U}{X} + %% <- TODO \MakeOther\~ hangs up +\SetCorrectHookJobLast + +\HeaderLines{14} +\LaTeXresultFile{optional.doc} +\MakeCloseDoc*{optional.sty} + + +%% Typesetting: +\documentclass{article} +\usepackage{hyperref,niceverb,wiki} %% niceverb after hyperref! +\AddToNoVerbList{\DISPLAY\textbf\enspace\emph\LaTeX\SECT} +\newcommand*{\DISPLAY}{% + \\[\smallskipamount]\leavevmode\null\hfil} +\makeatletter + \newcommand*{\SECT}[1]{% + \par\medskip\textbf{#1}\par\smallskip\@afterheading} +\makeatother +\makeatletter \MakeLetter\_ +% {\MakeActive\"\gdef\DQcode#1"{\dqtd{\texttt{#1}}}} +% {\MakeActive\"\gdef\DQcode#1"{\texttt{#1}}} +{\MakeActive\" + \gdef\DQtt{\begingroup + \let\do\MakeOther \dospecials \tt \let"\endgroup} + \gdef\fineDQ{``\begingroup + \let\do\MakeOther \dospecials \tt \def"{\endgroup''}}} +%% 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'. (On 2010/04/05, we try addressing (i) with + 'wiki.sty', applied to Donald Arseneau's 'optional'. + A 'nicetext' bug with replacing tildes shows up.) + + It should be clear that all the package desriptions are Donald Arseneau's, + 'nicetext' just formats them. +\end{abstract} +\tableofcontents +\pagebreak + +\sloppy +\MakeNormal\| + +\section{'nolbreaks'} +% \MakeActiveLet\_\textunderscore +% \MakeActive\*\def*{\texttt{\string*}} +% \MakeActiveLetHere\"\startDQcode +\MakeActiveLetHere\"\DQtt +% \errorcontextlines=6 +\AutoCmdInput{nolbreaks.doc} + +\section{'notoccite'} +\ResetCodeLineNumbers +\AutoCmdInput{notoccite.doc} + +\section{'optional'} %% 2010/04/02 +\ResetCodeLineNumbers +\wikiEnvironments +\MakeActiveLet\"\DQtt +% \AddToNoVerbList{\tracingmacros} +\let~\relax %% TODO replacement bug 2010/04/05 +\AutoCmdInput{optional.doc} + +\end{document} diff --git a/Master/texmf-dist/tex/latex/nicetext/run/atari.cfg b/Master/texmf-dist/tex/latex/nicetext/run/atari.cfg new file mode 100644 index 00000000000..c226fd434ca --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/atari.cfg @@ -0,0 +1,6 @@ +\ProvidesFile{atari.cfg}[2011/09/13 sample for copyfile.tex] +\catcode`\_=11 +\InputFile{atari.txt} +\TextCodesFile{atari.fdf} +\ResultFile{iso.txt} +\endinput diff --git a/Master/texmf-dist/tex/latex/nicetext/run/atari.txt b/Master/texmf-dist/tex/latex/nicetext/run/atari.txt new file mode 100644 index 00000000000..8a5ffe937ca --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/atari.txt @@ -0,0 +1,2 @@ + + diff --git a/Master/texmf-dist/tex/latex/nicetext/run/copyfile.cfg b/Master/texmf-dist/tex/latex/nicetext/run/copyfile.cfg new file mode 100644 index 00000000000..63da90bfbc9 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/copyfile.cfg @@ -0,0 +1,6 @@ +\ProvidesFile{copyfile.cfg}[2011/09/13 initializing copyfile.tex] +\catcode`\_=11 +\InputFile{lines.txt} +\TextCodesFile{} +\ResultFile{lns.txt} +\endinput diff --git a/Master/texmf-dist/tex/latex/nicetext/run/copyfile.tex b/Master/texmf-dist/tex/latex/nicetext/run/copyfile.tex new file mode 100644 index 00000000000..f532ed4c545 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/copyfile.tex @@ -0,0 +1,23 @@ +\ProvidesFile{copyfile.tex}[2011/09/13 copy*ing/converting (UL)] +\RequirePackage{fddial0g} +\MakeSet{codes-f}{\TextCodesFile} +\let\TextCodes\relax %% avoid errmessage +\TryDialogueCFG{copyfile}{% + \InputFile{lines.txt} + \TextCodesFile{atari.fdf} + \ResultFile{lns.txt}} +\Announce{ * copyfile.tex * compressing blank lines/converting^^J} +\newcommand*{\VarShowSettings}{% + \ShowSet{in-f}\LBrk + \ShowSet{codes-f}\LBrk + \ShowSet{out-f}} +\newcommand*{\VarRunSettings}{% + \typeout{`copyfile.tex' generating `\UseSet{out-f}'} + \UseResultFile{\UseSet{out-f}} + \IfEmptySet{codes-f}{}{\input{\UseSet{codes-f}}} + \CopyFile*[\TextCodes]{\UseSet{in-f}}% +} +\DialogueLoop + +\stop + diff --git a/Master/texmf-dist/tex/latex/nicetext/run/fddial0g.sty b/Master/texmf-dist/tex/latex/nicetext/run/fddial0g.sty new file mode 100644 index 00000000000..3e3a56ab830 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/fddial0g.sty @@ -0,0 +1,192 @@ +\ProvidesPackage{fddial0g}[2011/09/13 v0.2 dialogues with fifinddo (UL)] +%% copyright (C) 2011 Uwe L\"uck, +%% +%% http://www.contact-ednotes.sty.de.vu +%% +%% -- author-maintained in the sense of LPPL below -- +%% This file can be redistributed and/or modified under +%% the terms of the LaTeX Project Public License; either +%% version 1.3c of the License, or any later version. +%% The latest version of this license is in +%% +%% http://www.latex-project.org/lppl.txt +%% +%% We did our best to help you, but there is NO WARRANTY. +%% Please report bugs, problems, and suggestions via +%% +%% http://www.contact-ednotes.sty.de.vu +%% +\RequirePackage{fifinddo} + +\catcode`\_=11 + +%% == Setting and Using Variables == +%% %% aus `fddialog.sty' in `blog/convert/' 2011/09/12: +\newcommand*{\FDD_set}{set:} +\newcommand*{\FDD_use}{use:} +%% |\MakeSet{<id>}{<set>}| declares an internal variable `<id>' +%% and defines a command `<set>' so that `<set>{<value>}' +%% will assign <value> to <id>: +\newcommand*{\MakeSet}[2]{% + \@namedef{\FDD_set#1}{#2}% + \newcommand*{#2}{\@namedef{\FDD_use#1}} +} +%% It would be nice if there were a warning when in an evaluation +%% of a variable it turns out that it has not been ``declared" by +%% `\MakeSet' or not been set by the according setting command. +%% However, all the evaluations seem to happen in expansion +%% (e.g., during `\typeout'), so \LaTeX's `\PackageError' +%% (not even `\GenericError') is not helpful, +%% and `\errhelp' cannot be set specifically (in time). +%% It may tell more generally about `\MakeSet', but I am not sure +%% about what errors can occur in processing the dialogues at all. +%% At least we can get a real `\errmessage' using something else +%% that has not been defined: +\newcommand*{\FDD_check_use}[1]{% + \@ifundefined{\FDD_use#1}% + {\@ifundefined{\FDD_set#1}% + {\FDD_undeclared_variable `#1'}% + {\FDD_undefined_variable `#1'}}% +} +%% |\UseSet{<id>}| expands to <id>'s value. +\newcommand*{\UseSet}[1]{% + \FDD_check_use{#1}{\csname\FDD_use#1\endcsname}} +%% |\EvalBooleanSet{<id>}|: +\newcommand*{\EvalBooleanSet}[1]{% + \FDD_check_use{#1}{% + \csname + \FDD_on_setstring\@gobble{#1}%% \if id + \csname\FDD_use#1\endcsname %% true/false + \endcsname + }% +} +\newcommand*{\FDD_on_setstring}[2]{% + \expandafter\FDD_double_xpa\expandafter + #1\expandafter\expandafter\expandafter + \string\csname\FDD_set#2\endcsname} +\def\FDD_double_xpa{\expandafter\expandafter\expandafter} +%% |\IfEmptySet{<id>}{<if>}{<unless>}|: +\newcommand*{\IfEmptySet}[1]{% + \if^^J\UseSet{#1}^^J\expandafter\@firstoftwo + \else\expandafter\@secondoftwo\fi} +%% TODO present variable names by tokens!? (namemod) +%% +%% |\DebugShowSet{<id>}|: +\newcommand*{\DebugShowVar}[1]{% + \expandafter\show\csname\FDD_use#1\endcsname} +%% +%% == In/Out Variables == +%% |\ResultFile| gets a different meaning here +%% in order to keep the dialogue nice. +\let\UseResultFile\ResultFile +\let\ResultFile\relax +\MakeSet{out-f}{\ResultFile} +\MakeSet {in-f}{\InputFile} +\MakeSet{cfg-f}{\CFGname} +%% == `.cfg' == +%% |\TryDialogue{<file-name-base>}{<settings>}| +%% loads file `<file-name-base>.cfg' if \TeX\ can find it, +%% otherwise executes <settings>: +\newcommand*{\TryDialogueCFG}[2]{% + \CFGname{#1}% + \InputIfFileExists{#1.cfg}% + {\typeout{^^J + * using settings from `#1.cfg'. * + ^^J}}% + {#2}% +} +%% +%% == Screen == +\newcommand*{\Announce}[1]{% + \typeout{% + \FD_dialogue_double_line + ^^J#1^^J% + The screen shows most recent settings commands.^^J% + You can modify initial settings in + `\UseSet{cfg-f}.cfg'.^^J}% +} +%% |\DialogueLoop| is the last mandatory command in the +%% main script file. It needs an earlier definition of +%% |\VarShowSettings|. |\LBrk| can be used for a +%% screen line break: %% TODO \MessageBreak \relax!? +\newcommand*{\DialogueLoop}{% + {\def\LBrk{^^J}% + \typeout{% + \FD_dialogue_double_line^^J% + \VarShowSettings %% specific to purpose + \FD_dialogue_double_line}% + }% + \typein[\action]% + {Run with these settings? + (Y)es? (C)hange? (Otherwise quit.)}% + \csname FDD_action_\action \endcsname +} +\def\FD_dialogue_double_line{% + ^^J% + ===========================================================} +%% For defining |\VarShowSettings|: +\newcommand*{\ShowSet}[1]{% + \FDD_check_use{#1}{% +% \expandafter\expandafter\expandafter +% \string\csname\FDD_set#1\endcsname + \FDD_on_setstring\@empty{#1}% + {\UseSet{#1}}% + }% +} +\newcommand*{\TimesDo}[2]{% + \ifnum\number#1>\z@ + #2\expandafter\@firstofone + \else + \expandafter\@gobble + \fi + {\expandafter\TimesDo\expandafter + {\number\predecessor_of{#1} }{#2}}% +} +\newcommand*{\predecessor_of}[1]{% + \ifnum#1>9 + \expandafter\twodig_predecessor_of + \else + \expandafter\onedig_predecessor_of + \fi + #1} +\newcommand*{\onedig_predecessor_of}[1]{% + \ifcase #1\or0\or1\or2\or3\or4\or5\or6\or7\or8\or9\fi} +\newcommand*{\twodig_predecessor_of}[2]{% + \ifcase #2 + \onedig_predecessor_of#19\or + #10\or#11\or#12\or#13\or#14\or#15\or#16\or#17\or#18\or#19\fi} + +\newcommand*{\Spaces}[1]{\TimesDo{#1}{\space}} + +%% +%% == Changing Settings == +%% When the user types `c' or `C', she is asked to input +%% replacement text for the macro |\change|. +%% This macro then is executed, and |\DialogueLoop| +%% is invoked again: +\newcommand*{\FDD_action_c}{\FDD_change_settings} +\newcommand*{\FDD_action_C}{\FDD_change_settings} +\newcommand*{\FDD_change_settings}{% + \typein[\change]{^^JType setting command(s).}% + \change \DialogueLoop} +%% == Running with Current Settings == +\newcommand*{\FDD_action_y}{\FDD_run_with_settings} +\newcommand*{\FDD_action_Y}{\FDD_run_with_settings} +%% When the user types `y' or `Y', the following macro is executed. +%% It invokes |\VarRunSettings| that must be defined +%% before `\DialogueLoop' is executed: +\newcommand*{\FDD_run_with_settings}{% + \VarRunSettings %% specific to purpose + \CloseResultFile + \typeout{Done.}% + \DialogueLoop} +%% +%% == The End == +\endinput + +== VERSION HISTORY == + +v0.1 2011/08/23 first, uploaded with NICETEXT r0.43 +v0.2 2011/09/12 merged with something earlier/better, messages + 2011/09/13 messages more carefully: ...undefined_var..., + \EvalBooleanSet, \TimesDo with two digits diff --git a/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.cfg b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.cfg new file mode 100644 index 00000000000..452ea5173a2 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.cfg @@ -0,0 +1,9 @@ +\ProvidesFile{fdtxttex.cfg}[2011/09/13 initializing fdtxttex.tex] +\JobName{sample} +\InputExtension{txt} +\OutputExtension{tex} +\CorrectionFile{mdoccorr.cfg} +\FileHeader{\protect\WriteProvides} +\FileFooter{} +\ShowLines{false} +\endinput diff --git a/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tex b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tex new file mode 100644 index 00000000000..0c17662f5d8 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tex @@ -0,0 +1,54 @@ +\ProvidesFile{fdtxttex.tex}[2011/09/13 txt to TeX by dialogue (UL)] +\RequirePackage{fddial0g} +% \errorcontextlines=4 +\MakeSet{job-name}{\JobName} +\MakeSet{in-ext} {\InputExtension} +\MakeSet{out-ext} {\OutputExtension} +\MakeSet{corr-f} {\CorrectionFile} +\MakeSet{f-head} {\FileHeader} +\MakeSet{f-foot} {\FileFooter} +\newif\ifShowLines +\MakeSet{show-l} {\ShowLines} +\TryDialogueCFG{fdtxttex}{% + \JobName{sample} + \InputExtension{txt} + \OutputExtension{tex} + \CorrectionFile{mdoccorr.cfg} + \FileHeader{\protect\WriteProvides} + \FileFooter{} + \ShowLines{false} +} +% \DebugShowVar{cfg-f} +\Announce{ *fdtxttex.tex* txt to TeX by dialogue^^J + (apply \string\MakeDocCorrectHook)^^J} +\newcommand*{\VarShowSettings}{% + \ShowSet{job-name}\LBrk\Spaces{15} + \ShowSet{in-ext} \space + \ShowSet{out-ext}\LBrk + \ShowSet{corr-f} + (define \BackslashChar MakeDocCorrectHook)\LBrk + \ShowSet{f-head}\LBrk + \ShowSet{f-foot}\LBrk + \Spaces{15} + \ShowSet{show-l} +}% +\newcommand*{\VarRunSettings}{% + \input{\UseSet{corr-f}}% + \typeout{`fdtxttex.tex' generating + `\UseSet{job-name}.\UseSet{out-ext}'.}% + \UseResultFile{\UseSet{job-name}.\UseSet{out-ext}}% + \IfEmptySet{f-head}{}{\UseSet{f-head}}% + \EvalBooleanSet{show-l}% + \ProcessFileWith{\UseSet{job-name}.\UseSet{in-ext}}{% + \WriteResult{\CorrectedInputLine}% + \ifShowLines + \typeout{\CorrectedInputLine}% + \else + \message{.}% + \fi}% + \IfEmptySet{f-foot}{}{\UseSet{f-foot}}% +} + +\DialogueLoop + +\stop diff --git a/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl new file mode 100644 index 00000000000..b50b9f79c26 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl @@ -0,0 +1,11 @@ +\ProvidesFile{fdtxttex.tpl}[2011/09/13 fifinddo correction template] +\RequirePackage{fifinddo} +\input{mdoccorr.cfg} +\ResultFile{sample.tex} +\WriteProvides +\ProcessFileWith{sample.txt}{% + \typeout{\CorrectedInputLine}% + \WriteResult{\CorrectedInputLine}% +} +\CloseResultFile +\stop diff --git a/Master/texmf-dist/tex/latex/nicetext/run/lines.txt b/Master/texmf-dist/tex/latex/nicetext/run/lines.txt new file mode 100644 index 00000000000..66681434654 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/lines.txt @@ -0,0 +1,4 @@ +abba + + +abba
\ No newline at end of file diff --git a/Master/texmf-dist/tex/latex/nicetext/run/makedoc.tpl b/Master/texmf-dist/tex/latex/nicetext/run/makedoc.tpl new file mode 100644 index 00000000000..69b2b957a28 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/makedoc.tpl @@ -0,0 +1,14 @@ +\ProvidesFile{makedoc.tpl}[2011/09/14 + makedoc preprocessing template] +\RequirePackage{makedoc} +\renewcommand*{\mdJobName}{SAMPLE} +\input{mdoccorr.cfg} +\LaTeXresultFile{\mdJobName.doc} +\HeaderLines{0} +\ProcessLineMessage{} +\MainDocParser{% +% \WriteResult{\ProcessInputWith{dots}}% + \WriteResult{\CorrectedInputLine}% +} +\MakeCloseDoc{\mdJobName.TEX} +\stop diff --git a/Master/texmf-dist/tex/latex/nicetext/run/sample.txt b/Master/texmf-dist/tex/latex/nicetext/run/sample.txt new file mode 100644 index 00000000000..69408f90fd8 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/sample.txt @@ -0,0 +1,3 @@ +blabla ... blabla +blabla cf. bla +etc. bla bla
\ No newline at end of file diff --git a/Master/texmf-dist/tex/latex/nicetext/run/substr.tex b/Master/texmf-dist/tex/latex/nicetext/run/substr.tex new file mode 100644 index 00000000000..64f202f0e9d --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/substr.tex @@ -0,0 +1,97 @@ +\ProvidesFile{substr.tex}[2012/03/18 documentation for substr.sty] +\title{\textsf{substr.sty}\thanks{See + \url{http://ctan.org/pkg/substr} for more about + \textsf{substr.sty}.}---Substring + Functions with \LaTeX} +\author{Harald Harders\thanks{Joint work with Heiko Oberdiek, + one line + documentation tool + by Uwe L\"uck.}} +% \listfiles + +%% Preprocessing 'substr.sty': +\RequirePackage{makedoc} + +%% Replacements: +\SetPatternCodes{\MakeOther\\} +\MakeExpandableAllReplacer{Cmds} + {Commands:}{\SECT{Commands:}}{LEAVE} +\PrependExpandableAllReplacer{Change}{ChangeLog}{\SECT{ChangeLog}} +\PrependExpandableAllReplacer{CR}{Copyright}{\COPYRIGHT} +\PrependExpandableAllReplacer{LaTeX} + [\MakeOther\ ]{LaTeX }{\LaTeX{} } +\PrependExpandableAllReplacer{HH@} + {h.harders@tu-bs.de} + {`h.harders@tu-bs.de'\MEDSK} +\PrependExpandableAllReplacer{COMP} + {de.comp.text.tex} + {`de.comp.text.tex'} +\PrependExpandableAllReplacer{LPPL} + {macros/latex/base/lppl.txt} + {`macros/latex/base/lppl.txt'} +\PrependExpandableAllReplacer{Hist}[\MakeOther\ ]% +{History of this package:}{\SECT{History of this package:}} +\ResetPatternCodes +\SetCorrectHookJobLast + +\HeaderLines{3} +\MainDocParser{\ProcessInputWith{comment}} +\LaTeXresultFile{substr.doc} +\MakeCloseDoc*{substr.sty} + +\documentclass{article} + +\usepackage{hyperref,makedoc,niceverb} %% niceverb after hyperref! +\AddToNoVerbList{\MEDSK\SECT\textbf\COPYRIGHT,\LaTeX} +\newcommand*{\MEDSK}{\par\medskip} +\newcommand*{\SECT}[1]{\MEDSK\textbf{#1}\nopagebreak\par} +\newcommand*{\COPYRIGHT}{\MEDSK\textbf{Copyright} } +\usepackage[utf8]{inputenc} %% for v1.2 + +\pagestyle{myheadings} +\markboth{\textsf{substr.sty}}{\textsf{substr.sty}} +\usepackage{parskip} +\usepackage{ragged2e} %% 2012/03/18 + +\begin{document} +\maketitle + +\begin{abstract}\noindent + This documentation of 'substr.sty' has been typeset + by automatical ASCII\slash UTF\hbox{-}8~$\to$ \LaTeX\ + enhancement provided by 'makedoc.sty' and 'niceverb.sty''s + ``auto mode."\footnote{See + \url{http://ctan.org/pkg/nicetext} + for more on these packages.} + Some extended formatting---kind of sectioning, + switches to `\tt'---have been achieved by string replacements + specific to the comment text of the package file + (see source file 'substr.tex'). + + 'substr.sty' especially demonstrates the rather rare + \lq`%% '\rq\ style of package comments that is somewhat + favoured by 'makedoc' because this way ``true comments" + are easily distinguishable from mere ``commenting out." +% +% The idea to use 'parskip.sty' for formatting the documentation +% (as opposed to the version of the present file of one week ago) +% is due to the quite recent +% 'import.tex'\footnote{\url{http://ctan.org/pkg/import}} +% that +%% ??? +\end{abstract} +\sloppy +\RaggedRight +% \MakeJobDoc{3}{\ProcessInputWith{comment}} +\AutoCmdInput{substr.doc} +\enlargethispage{\baselineskip} +\end{document} + +%% HISTORY +2010/03/18 sent to CTAN +2010/03/27 removed `\usepackage{substr}' +2010/03/28 extended formatting by replacing words +2010/03/29 \SetPatternCodes etc. +2010/03/30 import -> substr; see source file +2011/08/20 \ProvidesFile for fileinfo +2012/03/18 use \MakeCloseDoc*, \enlargethispage, ragged2e + diff --git a/Master/texmf-dist/tex/latex/nicetext/run/u8atablg.fdf b/Master/texmf-dist/tex/latex/nicetext/run/u8atablg.fdf new file mode 100644 index 00000000000..17a28555e67 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/u8atablg.fdf @@ -0,0 +1,34 @@ +\ProvidesFile{u8atablg.fdf}[2011/09/12 UTF-8->Atari/blog with fdtxttex] +\SetPatternCodes{\MakeOther\&\MakeOther\\\MakeOther\ } +\StartPrependingChain +\PrependExpandableAllReplacer{amp} {&}{\&} +%% <- for blog.sty. Next are Atari umlauts, +%% cf. 'umlaute' documentation: +\PrependExpandableAllReplacer{auml} {Γ€}{} +\PrependExpandableAllReplacer{ouml} {ΓΆ}{} +\PrependExpandableAllReplacer{uuml} {ΓΌ}{} +\PrependExpandableAllReplacer{szlig}{Γ}{} +\PrependExpandableAllReplacer{Auml} {Γ}{} +\PrependExpandableAllReplacer{Ouml} {Γ}{} +\PrependExpandableAllReplacer{Uuml} {Γ}{} +%% ... TODO as \TextCodes!? `Γ' one-parameter macro +%% there must be no space left of last argument. +%% `\endash{}' is not a solution because 'blog.sty' +%% then would display the braces: +\PrependExpandableAllReplacer{apostr} {β}{'} +\PrependExpandableAllReplacer{item} {β’}{\item } +\PrependExpandableAllReplacer{item } {β’ }{\item\ } +\PrependExpandableAllReplacer{endash} {β}{\endash } +\PrependExpandableAllReplacer{endash }{β }{\endash\ } +\PrependExpandableAllReplacer{hellip} {β¦}{\dots } +\PrependExpandableAllReplacer{hellip }{β¦ }{\dots\ } +\PrependExpandableAllReplacer{to} {β}{\to } +\PrependExpandableAllReplacer{to } {β }{\to\ } +% \newcommand*{\PXAR}{\PrependExpandableAllReplacer} +% \PXAR{dots}{...}{.\kern\fontdimen3\font.\kern\fontdimen3\font.} +%% Tomboy 2011/09/12: +% \PrependExpandableAllReplacer {it} {<italic>}{<i>} +% \PrependExpandableAllReplacer{/it}{</italic>}{</i>} +\SetCorrectHookJobLast +\endinput + |