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/source/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/source/latex/nicetext')
9 files changed, 65 insertions, 77 deletions
diff --git a/Master/texmf-dist/source/latex/nicetext/README.tex b/Master/texmf-dist/source/latex/nicetext/README.tex index ce26748edb5..0587bb398a7 100644 --- a/Master/texmf-dist/source/latex/nicetext/README.tex +++ b/Master/texmf-dist/source/latex/nicetext/README.tex @@ -1,4 +1,4 @@ -\ProvidesFile{README.tex}[2010/11/27 make README.pdf] +\ProvidesFile{README.tex}[2011/02/14 make README.pdf] \listfiles \documentclass[12pt]{article} @@ -7,5 +7,6 @@ \begin{document} \vspace*{-2\baselineskip} \enlargethispage{1\baselineskip} +% \small %% 2011/02/14 \verbatiminput{README.txt} \end{document} diff --git a/Master/texmf-dist/source/latex/nicetext/fifinddo.tex b/Master/texmf-dist/source/latex/nicetext/fifinddo.tex index f517ad3a3e7..5417ee4c02b 100644 --- a/Master/texmf-dist/source/latex/nicetext/fifinddo.tex +++ b/Master/texmf-dist/source/latex/nicetext/fifinddo.tex @@ -1,26 +1,25 @@ -\ProvidesFile{fifinddo.tex}[2010/11/27 documenting fifinddo.sty] +\ProvidesFile{fifinddo.tex}[2011/08/22 documenting fifinddo.sty] \title{\textsf{fifinddo}\\---\\Filtering \TeX(t) Files by \TeX\thanks{This file describes -% \protect\GetFileInfo{\jobname.sty}% version \fileversion\ of \textsf{\filename} as of \filedate.}} - %% ^ 2010/11/26 % \listfiles \documentclass{article} \usepackage{makedoc} % \usepackage{substr} %% for failure examples TODO 2010/03/17 \input{makedoc.cfg} -%% <- TODO -> makedoc.cfg -\usepackage{readprov} +\MDkeywords{text filtering, macro programming, + .txt to .tex enhancement} +\hypersetup{% + pdftitle=fifinddo.sty filters text by TeX, + pdfsubject=documenting fifinddo.sty +} \ReadPackageInfos{fifinddo} -% \ReadFileInfos{fifinddo.sty} -% \hypersetup{pdfstartview=FitH} %% fine! 2010/11/11 \begin{document} -% \GetFileInfo{fifinddo.sty} %% 2010/11/25/26 \maketitle \begin{flushright}\small\it FIDO, FIND!\\or:\\FIND FIDO!\\oder:\\FIFI, SUCH!\end{flushright} -\begin{abstract}\noindent\hspace{1sp}%% for niceverb-apostrophe +\begin{MDabstract} 'fifinddo' starts implementing parsing of plain text or \TeX\ files using \TeX, generalizing the philosophy behind 'docstrip', based on how \TeX\ reads macro arguments. @@ -38,7 +37,7 @@ e.g., with `txt'\,$\to$\,\TeX\ functionality. The method of testing for substrings is carefully discussed, revealing an earlier mistake (then) shared with 'substr.sty' and \LaTeX's internal `\in@'. -\end{abstract} +\end{MDabstract} \tableofcontents \section{Introduction: The Gnome of the Aim} @@ -340,3 +339,4 @@ TODO cf. Kastrup 'makematch' and others 2009/04/09, 2010/11/24 debugging 2010/11/25f. using readprov.sty 2010/11/27 reworked \ProvidesFile +2011/08/22 PDF metadata; adjusting to makedoc.cfg diff --git a/Master/texmf-dist/source/latex/nicetext/gather.tex b/Master/texmf-dist/source/latex/nicetext/gather.tex deleted file mode 100644 index 5a14c651361..00000000000 --- a/Master/texmf-dist/source/latex/nicetext/gather.tex +++ /dev/null @@ -1,8 +0,0 @@ -\RequirePackage{myfilist} -\ProvidesFile{gather.tex}[2010/11/27 collect file infos] -\EmptyFileList %%% [readprov.sty,myfilist.sty] -% \ReadPackageInfos{readprov,myfilist} -\ReadPackageInfos{fifinddo,makedoc,niceverb,wiki} -\ReadFileInfos{fifinddo,makedoc,niceverb,makedoc.cfg,mdoccorr.cfg} %%% ,mdoccheat,wikicheat} -\ReadFileInfos{gather} -\ListInfos[FileList.txt] diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.cfg b/Master/texmf-dist/source/latex/nicetext/makedoc.cfg deleted file mode 100644 index 43d57ed87cc..00000000000 --- a/Master/texmf-dist/source/latex/nicetext/makedoc.cfg +++ /dev/null @@ -1,40 +0,0 @@ -\ProvidesFile{makedoc.cfg}[2011/01/24 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, - citebordercolor={ .6 1 .6}, - filebordercolor={1 .6 1}, - linkbordercolor={1 .9 .7}, - urlbordercolor={ .7 1 1}, %% playing 2011/01/24 - \else - draft - \fi -]{hyperref} - -\RequirePackage{niceverb}[2011/01/24] -\RequirePackage{readprov} %% 2010/12/08 -\RequirePackage{hypertoc} %% 2011/01/23 -\RequirePackage{texlinks} %% 2011/01/24 -\makeatletter - \@ifundefined{strong} - {\let\strong\textbf} %% 2011/01/24 - {} -\makeatother - -\errorcontextlines=4 -\pagestyle{headings} - -\endinput - diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.tex b/Master/texmf-dist/source/latex/nicetext/makedoc.tex index b6c78135c42..23371c332ce 100644 --- a/Master/texmf-dist/source/latex/nicetext/makedoc.tex +++ b/Master/texmf-dist/source/latex/nicetext/makedoc.tex @@ -1,9 +1,15 @@ -\ProvidesFile{makedoc.tex}[2011/01/25 documenting makedoc.sty] +\ProvidesFile{makedoc.tex}[2011/08/22 documenting makedoc.sty] \RequirePackage{makedoc} \documentclass{article} \input{makedoc.cfg} -\usepackage{color} %% 2011/01/25 -\sfcode`/=1001 %% TODO makedoc.cfg!? 2010/03/21 niceverb!? 2011/01/25 +%% 2011/08/22: +\MDkeywords{literate programming, .txt to .tex enhancement, + preprocessing documentation, macro programming} +\hypersetup{% + pdftitle=makedoc.sty preprocesses .sty for documentation, + pdfsubject=documenting makedoc.sty +}%% /2011/08/22 +\sfcode`/=1001 %% TODO makedoc.cfg!? 2010/03/21 niceverb!? 2011/01/25 \makeatletter %% TEST for hyperref compatibility 2010/03/11 % \def\@testdef #1#2#3{% % \def\reserved@a{#3}% @@ -24,7 +30,7 @@ version~\textcolor{blue}{\UseVersionOf{makedoc.sty}} of 'makedoc.sty' as of \UseDateOf{makedoc.sty}.}} \maketitle -\begin{abstract}\noindent +\begin{MDabstract} 'makedoc' provides commands for generating \LaTeX\ input from a package file in order to typeset the latter's documentation (somewhat similar and opposite to 'docstrip')---with @@ -41,7 +47,7 @@ documentation driver file.---The present approach is meant to be an It provides \emph{less} than 'doc' does, rather deliberately. It may be helpful at least for the development of small packages, or at least at early stages. -\end{abstract} +\end{MDabstract} \tableofcontents \section{Introduction} \emph{The abstract will not be repeated in this section.} Let me add @@ -644,3 +650,4 @@ end of a file it writes. %% todo TeXbook where? 2009/04/08 2010/03/30 \listfiles test 2010/11/27 \ProvidesFile for myfilist 2011/01/25 \thanks with readprov.sty +2011/08/22 using new makedoc.cfg features diff --git a/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex b/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex index 029bf243bf8..1fcbc68beda 100644 --- a/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex +++ b/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex @@ -1,4 +1,4 @@ -\typeout{mdoccheat.tex 2010/03/30 cheat sheat for `makedoc.sty'} +\ProvidesFile{mdoccheat.tex}[2011/01/26 cheat sheet for `makedoc.sty'] % \listfiles \documentclass{article} \input{makedoc.cfg} %% with pdf stuff and 'niceverb' diff --git a/Master/texmf-dist/source/latex/nicetext/niceverb.tex b/Master/texmf-dist/source/latex/nicetext/niceverb.tex index f4b380b985f..dd789adeae0 100644 --- a/Master/texmf-dist/source/latex/nicetext/niceverb.tex +++ b/Master/texmf-dist/source/latex/nicetext/niceverb.tex @@ -1,4 +1,4 @@ -\ProvidesFile{niceverb.tex}[2011/01/26 documenting niceverb.sty] +\ProvidesFile{niceverb.tex}[2011/08/22 documenting niceverb.sty] \title{\textsf{niceverb.sty}\\---\\Minimizing Markup\\for Documenting \LaTeX\ packages\thanks{This document describes version @@ -10,14 +10,20 @@ \MakeJobDoc{19}{\SectionLevelThreeParseInput} } \documentclass{article}%% TODO paper dimensions!? \input{makedoc.cfg} %% shared formatting settings -\usepackage{color} +%% 2011/08/22: +\MDkeywords{literate programming, syntactic sugar, + .txt to .tex enhancement, macro programming} +\hypersetup{% + pdftitle=syntacic sugar for LaTeX documentation by niceverb.sty, + pdfsubject=documenting niceverb.sty +}%% /2011/08/22 \begin{document} \maketitle -\begin{abstract}\noindent +\begin{MDabstract} 'niceverb.sty' provides very decent syntax (through active characters) for describing \LaTeX\ packages and the syntax of macros conforming to \LaTeX\ syntax conventions. -\end{abstract} +\end{MDabstract} \tableofcontents %% TODO table listing of active characters @@ -31,8 +37,8 @@ for describing \LaTeX\ packages and the syntax of macros conforming to The 'niceverb' package provides ``minimal" markup for documenting \LaTeX\ packages, reducing the number of keystrokes/visible characters needed % .\,.\,. %%% ... %% TODO nicedots -(kind of poor man's WYSIWYG).\footnote{``What you see is what you - get." Novices are always warned that WYSIWYG is essentially +(kind of poor man's \acro{WYSIWYG}).\footnote{``What you see is what you + get." Novices are always warned that \acro{WYSIWYG} is essentially impossible with \LaTeX.} %% TODO UK FAQ 2010/03/11 % One feature---\verb'&\foo'%%% badly self-documenting, `&' fails It conveniently handles command names in arguments of macros @@ -115,7 +121,7 @@ This was achieved by typing \[\HardVerbBox+&\foo*[<opt-arg>]{<mand-arg>}+\] In ``auto mode" of the package, even typing \[\HardVerbBox+\foo*[<opt-arg>]{<mand-arg>}+\] -would have sufficed---WYSIWYG! I call such mixtures of +would have sufficed---\acro{WYSIWYG}! I call such mixtures of \emph{verbatim} and ``meta-variables" \textit{\qtd{meta-code}}. Outside macro arguments, you obtain the same by typing @@ -237,8 +243,7 @@ so \verb+\item[\foo]+ works as wanted. (some of the) special characters %% 2010/03/20 (as listed in the standard macro `\dospecials') verbatim in arguments (where `\verb' and the like fail). It just acts similarly as \TeX's -(as listed in the standard macro `\dospecials') verbatim in arguments -(where `\verb' and the like fail). It just acts similarly as \TeX's + %% undoubled lines 2011/05/09 primitive `\string' (which it actually invokes---cf. discussion on the left quote feature above). @@ -273,7 +278,7 @@ environment.\footnote{This idea appeared 2009 on the 'LATEX-L' %% <- changed 2010/03/11 Rather, \lq`#'\rq\ is an active character for taking the next character (assuming it is a digit) to form a reference to a -\emph{macro parameter}---\lq`#1'\rq\ becomes \lq#1\rq\---WYSIWYG +\emph{macro parameter}---\lq`#1'\rq\ becomes \lq#1\rq\---\acro{WYSIWYG} indeed! (So the general syntax is |#<digit>|.) \item[Escaping from 'niceverb' (generally).] To get rid of the functionality of some active character <char> @@ -450,4 +455,5 @@ HISTORY 2010/12/29 \AddToNoVerbList 2011/01/26 using color.sty and readprov.sty; ack. Stephan B. for <...>; auto headings issue - +2011/05/09 undoubled lines about `&' +2011/08/22 using new makedoc.cfg features diff --git a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex new file mode 100644 index 00000000000..743b729fed4 --- /dev/null +++ b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex @@ -0,0 +1,22 @@ +\RequirePackage{myfilist} +\ProvidesFile{srcfiles.tex}[2011/08/23 collect file infos] +\EmptyFileList %%% [readprov.sty,myfilist.sty] +% \ReadPackageInfos{readprov,myfilist} +\ReadFileInfos{DOCSRC.} %% updsfl.sh +\ReadFileInfos{srcfiles} +\ReadFileInfos{README,fifinddo,makedoc,niceverb} +\ReadFileInfos{mdoccheat,wikicheat} %% updsfl.sh +\ReadFileInfos{RUN.} +\ReadFileInfos{arseneau,substr} +\ReadFileInfos{copyfile,fdtxttex} +\ReadFileInfos{fdtxttex.tpl,makedoc.tpl} +\ReadFileInfos{RUNUSE.} +\ReadFileInfos{atari.cfg,atari.fdf} +% \ReadPackageInfos{fddialog} +\ReadPackageInfos{fddial0g} +\ReadFileInfos{copyfile.cfg,fdtxttex.cfg} +\ReadFileInfos{USE.} +\ReadPackageInfos{fifinddo,makedoc} +\ReadFileInfos{makedoc.cfg,mdoccorr.cfg} +\ReadPackageInfos{niceverb,wiki} +\ListInfos[SrcFILEs.txt] diff --git a/Master/texmf-dist/source/latex/nicetext/wikicheat.tex b/Master/texmf-dist/source/latex/nicetext/wikicheat.tex index e56bff99120..f80251cd778 100644 --- a/Master/texmf-dist/source/latex/nicetext/wikicheat.tex +++ b/Master/texmf-dist/source/latex/nicetext/wikicheat.tex @@ -1,4 +1,4 @@ -\ProvidesFile{wikicheat}[2008/07/10 Cheatsheet for wiki.sty] +\ProvidesFile{wikicheat.tex}[2011/01/26 cheatsheet for wiki.sty] % \def\title{Cheatsheet for the \textsf{wiki} Package} \def\title{\textbf{Cheatsheet} for the \textbf{\textsf{wiki}} Package} \def\author{Uwe L\"uck} |