diff options
author | Karl Berry <karl@freefriends.org> | 2011-08-26 22:17:31 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-08-26 22:17:31 +0000 |
commit | 80219992c1ed63efeca5390194411fcdcedb17bb (patch) | |
tree | 71fa8ca43e70073fc77a5ff97454bf43549dee9a /Master/texmf-dist/tex/latex/nicetext | |
parent | 87f1685a45c8f23851013817d1ead13ff8c20677 (diff) |
nicetex 0.43 (24aug11)
git-svn-id: svn://tug.org/texlive/trunk@23703 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/nicetext')
19 files changed, 593 insertions, 15 deletions
diff --git a/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty b/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty index 2652ff75ac6..9a591b6c9c1 100644 --- a/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty +++ b/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty @@ -5,7 +5,7 @@ %% for processing tex(t) files %% (checking, filtering, converting, substituting, expanding, ...) -\def\fileversion{0.42} \def\filedate{2011/01/25} +\def\fileversion{0.42a} \def\filedate{2011/08/22} %% This file can be redistributed and/or modified under %% the terms of the LaTeX Project Public License; either @@ -189,11 +189,12 @@ %% |\CopyFile[<changes>]{<file>}| %% is an application of `\ProcessFileWith' %% that ``copies" the content of file <file> -%% into the file specified by `\WriteResult'. +%% into the file specified by +%% `\ResultFile'. %% was `\WriteResult'. 2011/08/06 %% However, optional <changes> allows some %% ``modifications" while ``copying"---especially, %% conversion of text encodings by active characters -%% and expanding macros for generating HTML +%% and expanding macros for generating \acro{HTML} %% or other code. The ``starred" variant %% |\CopyFile*| copies one empty line only %% when one empty line in the input file is followed @@ -203,8 +204,13 @@ {\let\FD@copy@style\CopyLine \FD@copyfile}} \newcommand*{\FD@copyfile}[2][]{% \ProcessFileWith[#1]{#2}{\FD@copy@style\message{.}}} -%% % <- message 2010/11/13 -%% |\CopyLine| +%% % <- message 2010/11/13; 2011/08/22: +%% You should find a file `copyfile.tex' providing a dialogue +%% for ``compressing" files this way. As soon as you have a +%% useful conversion mapping file (defining |\TextCodes|), +%% you can also use it for text encoding conversions. +%% +%% |\CopyLine|: \newcommand*{\CopyLine}{\WriteResult\fdInputLine} %% (... added `\space' without success with macro arguments %% 2010/04/26 --- `\BlogCodes' has used a better solution @@ -214,13 +220,13 @@ \CopyLine} %% Another difference to some \ctanpkgref{verbatimcopy} %% is that `\CopyFile' really was meant to -%% be used for creating a HTML file from some \emph{number} of +%% be used for creating a \acro{HTML} file from some \emph{number} of %% sources, especially for shared head sections (however, %% I have used macros for this purpose so far), a navigation column, %% the main varying ``blog-like" content, and finally a shared %% footer section. %% In the meantime, however, I have chosen another variant -%% for generating HTML that +%% for generating \acro{HTML} that %% replaces an empty line by a line consisting of \verb+<p>+. %% %% |\CloseResultFile| closes <output>. @@ -985,5 +991,8 @@ v0.42 2010/11/09 typo corr. 2011/01/25 updated (C); footnotes to `substring theory'; TODO with \RemoveTilde; some manual line spacings (adding `\ ') +belonged to nicetext RELEASE 0.42 +v0.42a 2011/08/06 doc.: mistake \WriteResult/\ResultFile, + 2011/08/22 use \acro TODO: cleveref 2010/03/18 diff --git a/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg b/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg new file mode 100644 index 00000000000..5873581b871 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg @@ -0,0 +1,81 @@ +\ProvidesFile{makedoc.cfg}[2011/08/22 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}} + +%% hyperref: +\RequirePackage{ifpdf} +\usepackage[% + \ifpdf +% bookmarks=false, %% 2010/12/22 +% bookmarksnumbered, + bookmarksopen, %% 2011/01/24!? + bookmarksopenlevel=2, %% 2011/01/23 +% pdfpagemode=UseNone, +% pdfstartpage=10, +% pdfstartview=FitH, + pdfstartview=0 0 100, %% 2011/08/22 + pdffitwindow=true, %% 2011/08/22 + citebordercolor={ .6 1 .6}, + filebordercolor={1 .6 1}, + linkbordercolor={1 .9 .7}, + urlbordercolor={ .7 1 1}, %% playing 2011/01/24 + \else + draft + \fi +]{hyperref} +%% metadata, |\MDkeywords|, |\MDkeywordsstring|, |\printMDkeywords| +%% 2011/08/22: +\makeatletter + \newcommand*{\MDkeywords}[1]{% + \gdef\MDkeywordsstring{#1}% + \hypersetup{pdfkeywords=\MDkeywordsstring}%% TODO!? + } + \@onlypreamble\MDkeywords + \newcommand*{\printMDkeywords}{% + \par\smallskip\noindent\strong{Keywords:}\quad + \MDkeywordsstring + \global\let\MDkeywordsstring\relax + } + \newenvironment{MDabstract} + {\abstract\noindent + \hspace{1sp}%% for niceverb + \ignorespaces} + {\@ifundefined{MDkeywordsstring}% + {}% + {\printMDkeywords}% + \endabstract} +\makeatother +\hypersetup{% + pdfauthor={Uwe L\374ck}% +} + +\RequirePackage{niceverb}[2011/01/24] +\RequirePackage{readprov} %% 2010/12/08 +\RequirePackage{hypertoc} %% 2011/01/23 +\RequirePackage{texlinks} %% 2011/01/24 +\RequirePackage{relsize} %% 2011/06/27 +\RequirePackage{color} %% 2011/08/06 +\makeatletter + \@ifundefined{strong} + {\let\strong\textbf} %% 2011/01/24 + {} + \@ifundefined{file} + {\let\file\texttt} %% 2011/05/23 + {} + \@ifundefined{acro} + {\let\acro\textsmaller} %% 2011/05/23 + {} + \@ifdefinable{\meta} + {\let\meta\textit} %% 2011/07/22 + \ifpdf + \pdfstringdefDisableCommands{\let\acro\textrm} + \fi + %% TODO 2011/07/22 -> `htlogml.sty' +\makeatother + +\errorcontextlines=4 +\pagestyle{headings} + +\endinput + diff --git a/Master/texmf-dist/tex/latex/nicetext/makedoc.sty b/Master/texmf-dist/tex/latex/nicetext/makedoc.sty index 93e14b8ffdb..89e1e2d8798 100644 --- a/Master/texmf-dist/tex/latex/nicetext/makedoc.sty +++ b/Master/texmf-dist/tex/latex/nicetext/makedoc.sty @@ -4,7 +4,7 @@ %% -- author-maintained in the sense of LPPL below -- %% for preparing documentations from packages. -\def\fileversion{0.41} \def\filedate{2011/01/25} +\def\fileversion{0.41a} \def\filedate{2011/08/22} %% This file can be redistributed and/or modified under %% the terms of the LaTeX Project Public License; either @@ -57,7 +57,8 @@ %% according to 'fifinddo'. %% %% It may be \emph{redefined} in a \emph{configuration} file like -%% 'makedoc.cfg' or the 'makedoc' script file applying to a single +%% 'mdoccorr.cfg' %% was makedoc.cfg 2011/08/22 +%% or the 'makedoc' script file applying to a single %% package file in order to, e.g., converting plain text to \TeX\ input %% conforming to typographical conventions, making `$\dots$' from %% \qtd{&.&.&.}, %% dots should not be replaced! @@ -65,7 +66,7 @@ %% Replace `LEAVE' in the previous suggestion by an identifier %% whose job you have defined before, and use `\renewcommand' %% in place of `\newcommand'. -%% See an example in 'makedoc.cfg'. +%% See an example in 'mdoccorr.cfg'. %% fixed 2011/08/22 %% %% You can \emph{test} your own `\MakeDocCorrectHook' by %% \[`\typeout{\MakeDocCorrectHook{<test-string>}}'\] @@ -588,3 +589,4 @@ v0.41 2010/12/20 \ResetCodeLineNumbers defined globally 2010/12/21 ... rather presented as a bug-fix 2011/01/19 \mdStartPackageCode 2011/01/25 updated (C) +v0.41a 2011/08/22 doc.: makedoc.cfg -> mdoccorr.cfg diff --git a/Master/texmf-dist/tex/latex/nicetext/niceverb.sty b/Master/texmf-dist/tex/latex/nicetext/niceverb.sty index 4afa3247703..2c4e0a7a9d1 100644 --- a/Master/texmf-dist/tex/latex/nicetext/niceverb.sty +++ b/Master/texmf-dist/tex/latex/nicetext/niceverb.sty @@ -1,5 +1,5 @@ \NeedsTeXFormat{LaTeX2e}[1994/12/01] -\ProvidesPackage{niceverb}[2011/01/26 v0.42 +\ProvidesPackage{niceverb}[2011/08/20 v0.43 minimize doc markup (UL)] %% Copyright (C) 2009-2011 Uwe Lueck, @@ -150,7 +150,8 @@ %% Turn off 'niceverb' specials: \MakeOther\|\MakeOther\`\MakeOther\'% \if_no_nice_meta_verb_ \MakeOther\<% - \else \MakeActiveLet\<\MetaVar %% 2010/12/31 + %%% \else \MakeActiveLet\<\MetaVar %% 2010/12/31 + \else \MakeActiveLetHere\<\MetaVar %% 2011/06/20 \fi \MakeActiveLetHere #1\niceverb_egroup \verb@eol@error %% TODO change message 2009/04/09 @@ -226,10 +227,12 @@ %% especially in \emph{macro arguments} %% 2010/03/05 %% and with 'hyperref' in titles of %% 2010/03/11 %% \emph{sections bearing \cs{label}s}, -%% so we provide something like |\cs{<characters>}| from 'doc.sty'. +%% so we provide something like |\cs{<characters>}| from +%% '\ctanpkgref{tugboat}.sty'. %% 'doc.sty'.%% corr. 2011/05/27 \DeclareRobustCommand*{\cs}[1]{% - \begin_min_verb \backslash_verb #1\egroup} + \begin_min_verb \backslash_verb #1\egroup} \newcommand*{\backslash_verb}{\char`\\} +%% %% 2011/06/27: undid 2011/05/27 %% Moreover, typing `&\par' in ``short" \emph{macro arguments} %% fails, you better type `\cs{par}' then. Likewise, %% `\cs{if<letters>}' and `\cs{fi}' is safer in case @@ -604,6 +607,14 @@ %% %% === When 'niceverb' Gets Nasty === %% These things are new with v0.3. +%% ==== Meta-Variables ==== +%% This is even newer than v0.3. %% 2011/05/09 +%% +%% In case you actually need $\lt$ and $\gt$ in math mode, +%% |\lt| and |\gt| are ``provided" as aliases: +\providecommand*{\gt}{>} +\providecommand*{\lt}{<} +%% %% ==== Quotes ==== %% %% WRONG 2010/03/05: %% % The left quote feature for meta-code requires that the right quote @@ -645,7 +656,7 @@ %% 2010/03/12 \MakeActiveLetHere\`\lq \MakeActiveLetHere\'\rq \MakeActiveLetHere\&\PDFcstring - \def\cs{\134}% %% 2010/03/17 + \def\cs{\134}% %% 2010/03/17, 2011/06/27 }% %% Moreover, in order to avoid spurious %% 2010/03/14 %% \texttt{Label(s) may have changed} with 'hyperref', @@ -787,3 +798,9 @@ v0.42 2010/12/30 corr. `\ ' emulation in auto mode 2011/01/19 `...' fix 2011/01/24 \ctanpkgref moves to texlinks.sty 2011/01/26 update (C) +with nicetext RELEASE r0.42 +v0.43 2011/05/09 \gt, \lt + 2011/05/27 \cs uses \@backslashchar + 2011/06/20 \MakeActiveLetHere in \nice_maybe_meta_verb !!! + 2011/06/27 2011/05/27 undone + 2011/08/20 `r0.42', `v0.43' 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..e4229bfc571 --- /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 and fifinddo.pdf for additional informations. + +UL 2011-08-23 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..10b86dc6254 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/arseneau.tex @@ -0,0 +1,153 @@ +\ProvidesFile{arseneau.tex} + [2010/04/05 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..fa7179f5788 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/atari.cfg @@ -0,0 +1,7 @@ +\ProvidesFile{atari.cfg}[2011/08/23 sample for copyfile.tex] +\catcode`\_=11 +\InputFile{atari.txt} +\TextCodesFile{atari.fdf} +\ResultFile{iso.txt} +% \toscreentrue +\endinput diff --git a/Master/texmf-dist/tex/latex/nicetext/run/atari.fdf b/Master/texmf-dist/tex/latex/nicetext/run/atari.fdf new file mode 100644 index 00000000000..6037cab688f --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/atari.fdf @@ -0,0 +1,9 @@ +\ProvidesFile{atari.fdf}[2010/08/23 Atari to ISO-8859-1 with blog.sty] +%% was \AtariCodes from 2010/08/24 till 2011/08/22: +\def\TextCodes{% + \MakeActiveDefŽ{Ä}\MakeActiveDef™{Ö}\MakeActiveDefš{Ü}% + \MakeActiveDef„{ä}\MakeActiveDef”{ö}\MakeActiveDef{ü}% + \MakeActiveDefž{ß}% +} +\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..d4f1f469435 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/copyfile.cfg @@ -0,0 +1,7 @@ +\ProvidesFile{copyfile.cfg}[2011/08/22 initializing copyfile.tex] +\catcode`\_=11 +\InputFile{lines.txt} +\TextCodesFile{} +\ResultFile{lns.txt} +% \toscreentrue +\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..3c8ae98da3e --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/copyfile.tex @@ -0,0 +1,28 @@ +\ProvidesFile{copyfile.tex}[{2011/08/22 copy*ing/converting (UL)}] +\RequirePackage{fddial0g} +\newcommand*{\TextCodesFile}{\def\text_codes_file_name} +\TextCodesFile{} \let\TextCodes\relax +\input{copyfile.cfg} + +\Announce{ * copyfile.tex * compressing blank lines/converting + ^^J} + {copyfile.cfg} +\newcommand*{\Dialogue}{% + \FD_dialogue_screen{% + \string\InputFile {\input_file_name}^^J% + \string\TextCodesFile{\text_codes_file_name}^^J% + \string\ResultFile{\result_file_dialogue}% + }% +} +\newcommand*{\RunWithSettings}{% + \run_with_settings_gen{% + \ifx\text_codes_file_name\empty\else + \input{\text_codes_file_name}% + \fi + \CopyFile*[\TextCodes]{\input_file_name}% + }% +} +\Dialogue + +\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..6c9b255c6e6 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/fddial0g.sty @@ -0,0 +1,74 @@ +\ProvidesPackage{fddial0g}[2011/08/23 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 +%% +%% T0D0: more abstract setting and using of variables +%% so the user must not invent names and see underscores. +%% (Probably use namemod.) +%% +\RequirePackage{fifinddo} + +\catcode`\_=11 + +%% |\ResultFile| gets a different meaning here +%% in order to keep the dialogue nice. +%% `\result_file_name' must be reserved for the original +%% meaning of `\ResultFile'. +\let\UseResultFile\ResultFile +\def\ResultFile{\def\result_file_dialogue} +\newcommand\InputFile{\def\input_file_name} +\newif\iftoscreen + +\def\Announce#1#2{% + \typeout{% + \FD_dialogue_double_line + ^^J#1^^J% + The screen shows most recent settings commands.^^J% + You can modify initial settings in #2.^^J% + }% +} +\def\FD_dialogue_screen#1{% + \typeout{% + \FD_dialogue_double_line^^J% + #1% + \FD_dialogue_double_line + }% + \typein[\action]% + {Run with these settings? (Y)es? (C)hange? (Otherwise quit.)}% + \csname action_\action \endcsname +} +\def\FD_dialogue_double_line{% + ^^J% + ===========================================================} +\def\run_with_settings_gen#1{% + \UseResultFile{\result_file_dialogue}% + #1% + \CloseResultFile + \typeout{Done.}% + \Dialogue +} +\def\FD_corrected_input_line{% + \expandafter \MakeDocCorrectHook \expandafter{\fdInputLine}} +\@namedef{action_y}{\RunWithSettings} +\@namedef{action_Y}{\RunWithSettings} +\def\change_settings{% + \typein[\change]{^^JType setting command(s).}% + \change \Dialogue} +\expandafter\let\csname action_c\endcsname \change_settings +\expandafter\let\csname action_C\endcsname \change_settings + +\endinput 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..50c52d6eaab --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.cfg @@ -0,0 +1,8 @@ +\ProvidesFile{fdtxttex.cfg}[2010/11/25 initializing fdtxttex.tex] +\catcode`\_=11 +\CorrectionFile{mdoccorr.cfg} +%% Note different meaning for 'fdtxttex.tex': +\ResultFile{sample.tex} +\InputFile{sample.txt} +% \toscreentrue +\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..81353508933 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tex @@ -0,0 +1,39 @@ +\ProvidesFile{fdtxttex.tex}[2011/08/23 txt to TeX by dialogue (UL)] +\RequirePackage{fddial0g} +%% Dialogue settings: +\newcommand\CorrectionFile{\def\mdoc_corr} +%% Default settings (modify for your own): +\input{fdtxttex.cfg} +%% Screen: +\Announce{ *fdtxttex.tex* txt to TeX by dialogue^^J + (apply \string\MakeDocCorrectHook)^^J} + {fdtxttex.cfg} +\newcommand*{\Dialogue}{% + \FD_dialogue_screen{% + \string\CorrectionFile{\mdoc_corr} + \space (define \BackslashChar MakeDocCorrectHook)^^J% + \string\InputFile \space\space\space\space\space + {\input_file_name}^^J% + \string\ResultFile\space\space\space\space + {\result_file_dialogue} + \space\space\space + \string\toscreen\iftoscreen true\else false\fi + }% +}% +\newcommand*{\RunWithSettings}{% + \run_with_settings_gen{% + \input{\mdoc_corr}% + \WriteProvides + \ProcessFileWith{\input_file_name}{% + \WriteResult{\FD_corrected_input_line}% + \iftoscreen + \typeout{\FD_corrected_input_line}% + \else + \message{.}% + \fi}% + }% +} + \errorcontextlines=4 +\Dialogue + +\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..30f3978847f --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl @@ -0,0 +1,14 @@ +\ProvidesFile{fdtxttex.tpl}[{2011/08/21 [2010/03/30] + fifinddo correction template}] +\RequirePackage{fifinddo} +\input{mdoccorr.cfg} +\ResultFile{sample.tex} +\WriteProvides +\ProcessFileWith{sample.txt}{% + \typeout{\expandafter \MakeDocCorrectHook + \expandafter{\fdInputLine}}% + \WriteResult{\expandafter \MakeDocCorrectHook + \expandafter{\fdInputLine}}% +} +\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..cd38f303933 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/makedoc.tpl @@ -0,0 +1,19 @@ +\ProvidesFile{makedoc.tpl}[{2011/08/23 + makedoc preprocessing template}] +\typeout{makedoc.tpl makedoc correction template} +\RequirePackage{makedoc} +\renewcommand*{\mdJobName}{SAMPLE} +\input{mdoccorr.cfg} +\LaTeXresultFile{\mdJobName.doc} +\HeaderLines{0} +\ProcessLineMessage{} +\MainDocParser{% +% \typeout{\ProcessInputWith{dots}}% +% \WriteResult{\ProcessInputWith{dots}}% + \typeout{\expandafter \MakeDocCorrectHook + \expandafter{\fdInputLine}}% + \WriteResult{\expandafter \MakeDocCorrectHook + \expandafter{\fdInputLine}}% +} +\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..1974b2e15bf --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/substr.tex @@ -0,0 +1,93 @@ +\ProvidesFile{substr.tex}[{2011/08/20 [2010/03/30] 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} + +\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 +% \MakeJobDoc{3}{\ProcessInputWith{comment}} +\AutoCmdInput{substr.doc} +\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 + |