From d0098ed79f8feef72d604d541cd49cead7665f9d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 16 Nov 2012 00:39:32 +0000 Subject: nicetext (15nov12) git-svn-id: svn://tug.org/texlive/trunk@28271 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/tex/latex/nicetext/makedoc.cfg | 74 ++++++-- Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg | 34 ++-- Master/texmf-dist/tex/latex/nicetext/nicetext.RLS | 4 + .../tex/latex/nicetext/run/README-run.txt | 9 + .../texmf-dist/tex/latex/nicetext/run/arseneau.tex | 153 ++++++++++++++++ Master/texmf-dist/tex/latex/nicetext/run/atari.cfg | 6 + Master/texmf-dist/tex/latex/nicetext/run/atari.txt | 2 + .../texmf-dist/tex/latex/nicetext/run/copyfile.cfg | 6 + .../texmf-dist/tex/latex/nicetext/run/copyfile.tex | 23 +++ .../texmf-dist/tex/latex/nicetext/run/fddial0g.sty | 192 +++++++++++++++++++++ .../texmf-dist/tex/latex/nicetext/run/fdtxttex.cfg | 9 + .../texmf-dist/tex/latex/nicetext/run/fdtxttex.tex | 54 ++++++ .../texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl | 11 ++ Master/texmf-dist/tex/latex/nicetext/run/lines.txt | 4 + .../texmf-dist/tex/latex/nicetext/run/makedoc.tpl | 14 ++ .../texmf-dist/tex/latex/nicetext/run/sample.txt | 3 + .../texmf-dist/tex/latex/nicetext/run/substr.tex | 97 +++++++++++ .../texmf-dist/tex/latex/nicetext/run/u8atablg.fdf | 34 ++++ 18 files changed, 696 insertions(+), 33 deletions(-) create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/README-run.txt create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/arseneau.tex create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/atari.cfg create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/atari.txt create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/copyfile.cfg create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/copyfile.tex create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/fddial0g.sty create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.cfg create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tex create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/lines.txt create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/makedoc.tpl create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/sample.txt create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/substr.tex create mode 100644 Master/texmf-dist/tex/latex/nicetext/run/u8atablg.fdf (limited to 'Master/texmf-dist/tex/latex/nicetext') 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{}|, |\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[]| 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{}|, |\file{}|, |\acro{}|, -%% |\meta{}|, |\pkg{}|, |\code{}|, |\qtdcode{}|: +\RequirePackage{filedate} %% 2012/11/12 +%% \pagebreak[3] +%% Logical markup:\qquad |\strong{}|, |\meta{}|, +%% |\acro{}|, |\pkg{}|, +%% |\code{}|, |\file{}|:{\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{}|: 2012/10/24: + \newcommand*{\qtdcode}[1]{`\code{#1}'} +%% |\pkgtitle{}{}| \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[{}'\] 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[]{}| +\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*{}{}|: \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{}|: +\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{}|: \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{}{}| declares an internal variable `' +%% and defines a command `' so that `{}' +%% will assign to : +\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{}| expands to 's value. +\newcommand*{\UseSet}[1]{% + \FDD_check_use{#1}{\csname\FDD_use#1\endcsname}} +%% |\EvalBooleanSet{}|: +\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{}{}{}|: +\newcommand*{\IfEmptySet}[1]{% + \if^^J\UseSet{#1}^^J\expandafter\@firstoftwo + \else\expandafter\@secondoftwo\fi} +%% TODO present variable names by tokens!? (namemod) +%% +%% |\DebugShowSet{}|: +\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{}{}| +%% loads file `.cfg' if \TeX\ can find it, +%% otherwise executes : +\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} {}{} +% \PrependExpandableAllReplacer{/it}{}{} +\SetCorrectHookJobLast +\endinput + -- cgit v1.2.3