From 80219992c1ed63efeca5390194411fcdcedb17bb Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 26 Aug 2011 22:17:31 +0000 Subject: nicetex 0.43 (24aug11) git-svn-id: svn://tug.org/texlive/trunk@23703 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt | 36 +++++ Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG | 40 +++++- Master/texmf-dist/doc/latex/nicetext/CHANGE.txt | 40 +++++- Master/texmf-dist/doc/latex/nicetext/FILEs.txt | 84 ++++++----- Master/texmf-dist/doc/latex/nicetext/FileList.txt | 17 --- Master/texmf-dist/doc/latex/nicetext/NNOUNCE.txt | 53 +++---- Master/texmf-dist/doc/latex/nicetext/README | 136 +++++++++--------- Master/texmf-dist/doc/latex/nicetext/README.pdf | Bin 19520 -> 19886 bytes Master/texmf-dist/doc/latex/nicetext/README.txt | 136 +++++++++--------- .../texmf-dist/doc/latex/nicetext/RELEASE042.txt | 26 ++++ Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt | 35 +++++ Master/texmf-dist/doc/latex/nicetext/demo/iso.txt | 3 + Master/texmf-dist/doc/latex/nicetext/demo/lns.txt | 3 + .../texmf-dist/doc/latex/nicetext/demo/sample.tex | 5 + Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf | Bin 308881 -> 468092 bytes Master/texmf-dist/doc/latex/nicetext/makedoc.pdf | Bin 304457 -> 477995 bytes Master/texmf-dist/doc/latex/nicetext/mdoccheat.pdf | Bin 69681 -> 0 bytes Master/texmf-dist/doc/latex/nicetext/niceverb.pdf | Bin 278658 -> 444848 bytes .../texmf-dist/doc/latex/nicetext/run/arseneau.tex | 153 --------------------- .../texmf-dist/doc/latex/nicetext/run/fdtxttex.tex | 58 -------- .../texmf-dist/doc/latex/nicetext/run/fdtxttex.tpl | 13 -- .../texmf-dist/doc/latex/nicetext/run/makedoc.tpl | 17 --- .../texmf-dist/doc/latex/nicetext/run/sample.txt | 3 - .../texmf-dist/doc/latex/nicetext/run/substr.tex | 92 ------------- Master/texmf-dist/source/latex/nicetext/README.tex | 3 +- .../texmf-dist/source/latex/nicetext/fifinddo.tex | 20 +-- Master/texmf-dist/source/latex/nicetext/gather.tex | 8 -- .../texmf-dist/source/latex/nicetext/makedoc.cfg | 40 ------ .../texmf-dist/source/latex/nicetext/makedoc.tex | 17 ++- .../texmf-dist/source/latex/nicetext/mdoccheat.tex | 2 +- .../texmf-dist/source/latex/nicetext/niceverb.tex | 28 ++-- .../texmf-dist/source/latex/nicetext/srcfiles.tex | 22 +++ .../texmf-dist/source/latex/nicetext/wikicheat.tex | 2 +- Master/texmf-dist/tex/latex/nicetext/fifinddo.sty | 23 +++- Master/texmf-dist/tex/latex/nicetext/makedoc.cfg | 81 +++++++++++ Master/texmf-dist/tex/latex/nicetext/makedoc.sty | 8 +- Master/texmf-dist/tex/latex/nicetext/niceverb.sty | 27 +++- .../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 | 7 + Master/texmf-dist/tex/latex/nicetext/run/atari.fdf | 9 ++ Master/texmf-dist/tex/latex/nicetext/run/atari.txt | 2 + .../texmf-dist/tex/latex/nicetext/run/copyfile.cfg | 7 + .../texmf-dist/tex/latex/nicetext/run/copyfile.tex | 28 ++++ .../texmf-dist/tex/latex/nicetext/run/fddial0g.sty | 74 ++++++++++ .../texmf-dist/tex/latex/nicetext/run/fdtxttex.cfg | 8 ++ .../texmf-dist/tex/latex/nicetext/run/fdtxttex.tex | 39 ++++++ .../texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl | 14 ++ Master/texmf-dist/tex/latex/nicetext/run/lines.txt | 4 + .../texmf-dist/tex/latex/nicetext/run/makedoc.tpl | 19 +++ .../texmf-dist/tex/latex/nicetext/run/sample.txt | 3 + .../texmf-dist/tex/latex/nicetext/run/substr.tex | 93 +++++++++++++ 52 files changed, 1069 insertions(+), 631 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt delete mode 100644 Master/texmf-dist/doc/latex/nicetext/FileList.txt create mode 100644 Master/texmf-dist/doc/latex/nicetext/RELEASE042.txt create mode 100644 Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt create mode 100644 Master/texmf-dist/doc/latex/nicetext/demo/iso.txt create mode 100644 Master/texmf-dist/doc/latex/nicetext/demo/lns.txt create mode 100644 Master/texmf-dist/doc/latex/nicetext/demo/sample.tex delete mode 100644 Master/texmf-dist/doc/latex/nicetext/mdoccheat.pdf delete mode 100644 Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex delete mode 100644 Master/texmf-dist/doc/latex/nicetext/run/fdtxttex.tex delete mode 100644 Master/texmf-dist/doc/latex/nicetext/run/fdtxttex.tpl delete mode 100644 Master/texmf-dist/doc/latex/nicetext/run/makedoc.tpl delete mode 100644 Master/texmf-dist/doc/latex/nicetext/run/sample.txt delete mode 100644 Master/texmf-dist/doc/latex/nicetext/run/substr.tex delete mode 100644 Master/texmf-dist/source/latex/nicetext/gather.tex delete mode 100644 Master/texmf-dist/source/latex/nicetext/makedoc.cfg create mode 100644 Master/texmf-dist/source/latex/nicetext/srcfiles.tex create mode 100644 Master/texmf-dist/tex/latex/nicetext/makedoc.cfg 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.fdf 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 (limited to 'Master') diff --git a/Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt b/Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt new file mode 100644 index 00000000000..ef40163b58d --- /dev/null +++ b/Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt @@ -0,0 +1,36 @@ +Minimal markup for documentation, text filtering +================================================================= +Release 0.43 synchronizes references to here, +provides minor fixes, and enhances dialogues: + + `atari.cfg' settings for conversion with: + + `atari.fdf' from `morehype' exemplifies conversion with: + +`copyfile.cfg' initializes: + +`copyfile.tex' dialogue for compressing blank lines + (and text encoding conversion) + +`fdtxttex.cfg' initializes: + +`fdtxttex.tex' dialogue for .txt -> .tex conversion + +`fddial0g.sty' shared macros for the dialogues + +`fifinddo.sty' documentation fix \WriteResult -> \ResultFile + + `makedoc.cfg' loads `color.sty'; provides \acro by `relsize.sty' + (with a funny protection for hyperref bookmarks); + uses \meta as semantical alias for \textit; + [new with release r.0.43a:] + \MDkeywords passes keywords to \hypersetup + as well as to `MDabstract' environment + + `makedoc.sty' documentation fix makedoc.cfg -> mdoccorr.cfg + +`niceverb.sty' \gt for >, \lt for <; + fixed noisy catcode changing in .aux + + `README' adjusted, enhanced + diff --git a/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG b/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG index da671983231..3a3b8c19b60 100644 --- a/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG +++ b/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG @@ -1,3 +1,38 @@ +______________________________________________________________________ +r0.43a 2011/08/25 adds in ANNOUNCE.txt as of 2011/08/25 +that makedoc.cfg provides \MDkeywords and {MDabstract} + +______________________________________________________________________ +nicetext RELEASE 0.43 2011/08/23 SUMMARY: dialogues enhanced + (new copyfile.tex, fddial0g.sty), + makedoc.cfg enhanced, + niceverb.sty gets \gt+\lt + and an .aux bug fix. + + ANNOUNCE.txt 2011/08/23 announcing present release + CHANGE.LOG/txt 2011/08/23 updated + SrcFILEs.txt 2011/08/23 updated, was FileList.txt + README(.txt,.pdf) 2011/08/23 + .tds + copyfile.tex + README.tex 2010/02/14 moved by one line +README-run.txt 2011/08/23 new + atari.cfg 2011/08/23 new + atari.fdf 2010/08/23 new here + copyfile.cfg 2011/08/22 new + copyfile.tex 2011/08/22 + \Prov... for fileinfo + fddial0g.sty 2011/08/23 new + fdtxttex.tex 2011/08/23 uses fddial0g.sty + fdtxttex.tpl 2011/08/21 + \Prov... for fileinfo + fifinddo.sty v0.42a 2011/08/22 documentation fix + fifinddo.tex 2011/08/22 using new makedoc.cfg + makedoc.cfg 2011/08/22 + color.sty + \acro + \meta + makedoc.sty v0.41a 2011/08/22 documentation fix + makedoc.tex 2011/08/22 using new makedoc.cfg + makedoc.tpl 2011/08/23 + \Prov... for fileinfo + niceverb.sty v0.43 2011/08/20 + \gt + \lt, .aux fix + niceverb.tex 2011/08/22 using new makedoc.cfg + srcfiles.tex 2011/08/22 collects infos, was gather.tex + substr.tex 2011/08/20 + \Prov... for fileinfo + ______________________________________________________________________ r0.42a 2011/01/30 moves makedoc.cfg to docsrc, changes name `FILES.txt' into `FILEs.txt' and ordering within the file, @@ -11,10 +46,10 @@ nicetext RELEASE 0.42 2011/01/26 SUMMARY: corrected `makedoc.sty', README(.txt) 2011/01/26 updated README.pdf 2011/01/26 new, README version - README.tex 2010/11/27 new, generates README.pdf + README.tex 2011/02/14 moved by one line CHANGE.LOG/txt 2011/01/26 updated FileList.txt/gather.tex2011/01/26 new for source file versions - fifinddo.sty v0.42 2011/01/25 code and documentation enhanced + fifinddo.sty v0.42a 2011/08/22 fifinddo.tex/pdf 2010/11/27 uses `readprov.sty', +TODO makedoc.cfg 2011/01/24 uses `hypertoc' and `readprov' makedoc.sty v0.41 2011/01/25 corrected! @@ -31,6 +66,7 @@ nicetext RELEASE 0.41 2010/04/05 SUMMARY: documentation changes, FILES.txt 2010/04/05 changed name (for ...), updated, corrected README(.txt) 2010/04/05 typo fix ("http."), correction + README.tex 2010/11/27 new, generates README.pdf CHANGE.LOG 2010/04/05 updated CHANGE.txt 2010/04/05 new copy of CHANGE.LOG arseneau.tex/pdf 2010/04/05 added `optional.sty' diff --git a/Master/texmf-dist/doc/latex/nicetext/CHANGE.txt b/Master/texmf-dist/doc/latex/nicetext/CHANGE.txt index da671983231..3a3b8c19b60 100644 --- a/Master/texmf-dist/doc/latex/nicetext/CHANGE.txt +++ b/Master/texmf-dist/doc/latex/nicetext/CHANGE.txt @@ -1,3 +1,38 @@ +______________________________________________________________________ +r0.43a 2011/08/25 adds in ANNOUNCE.txt as of 2011/08/25 +that makedoc.cfg provides \MDkeywords and {MDabstract} + +______________________________________________________________________ +nicetext RELEASE 0.43 2011/08/23 SUMMARY: dialogues enhanced + (new copyfile.tex, fddial0g.sty), + makedoc.cfg enhanced, + niceverb.sty gets \gt+\lt + and an .aux bug fix. + + ANNOUNCE.txt 2011/08/23 announcing present release + CHANGE.LOG/txt 2011/08/23 updated + SrcFILEs.txt 2011/08/23 updated, was FileList.txt + README(.txt,.pdf) 2011/08/23 + .tds + copyfile.tex + README.tex 2010/02/14 moved by one line +README-run.txt 2011/08/23 new + atari.cfg 2011/08/23 new + atari.fdf 2010/08/23 new here + copyfile.cfg 2011/08/22 new + copyfile.tex 2011/08/22 + \Prov... for fileinfo + fddial0g.sty 2011/08/23 new + fdtxttex.tex 2011/08/23 uses fddial0g.sty + fdtxttex.tpl 2011/08/21 + \Prov... for fileinfo + fifinddo.sty v0.42a 2011/08/22 documentation fix + fifinddo.tex 2011/08/22 using new makedoc.cfg + makedoc.cfg 2011/08/22 + color.sty + \acro + \meta + makedoc.sty v0.41a 2011/08/22 documentation fix + makedoc.tex 2011/08/22 using new makedoc.cfg + makedoc.tpl 2011/08/23 + \Prov... for fileinfo + niceverb.sty v0.43 2011/08/20 + \gt + \lt, .aux fix + niceverb.tex 2011/08/22 using new makedoc.cfg + srcfiles.tex 2011/08/22 collects infos, was gather.tex + substr.tex 2011/08/20 + \Prov... for fileinfo + ______________________________________________________________________ r0.42a 2011/01/30 moves makedoc.cfg to docsrc, changes name `FILES.txt' into `FILEs.txt' and ordering within the file, @@ -11,10 +46,10 @@ nicetext RELEASE 0.42 2011/01/26 SUMMARY: corrected `makedoc.sty', README(.txt) 2011/01/26 updated README.pdf 2011/01/26 new, README version - README.tex 2010/11/27 new, generates README.pdf + README.tex 2011/02/14 moved by one line CHANGE.LOG/txt 2011/01/26 updated FileList.txt/gather.tex2011/01/26 new for source file versions - fifinddo.sty v0.42 2011/01/25 code and documentation enhanced + fifinddo.sty v0.42a 2011/08/22 fifinddo.tex/pdf 2010/11/27 uses `readprov.sty', +TODO makedoc.cfg 2011/01/24 uses `hypertoc' and `readprov' makedoc.sty v0.41 2011/01/25 corrected! @@ -31,6 +66,7 @@ nicetext RELEASE 0.41 2010/04/05 SUMMARY: documentation changes, FILES.txt 2010/04/05 changed name (for ...), updated, corrected README(.txt) 2010/04/05 typo fix ("http."), correction + README.tex 2010/11/27 new, generates README.pdf CHANGE.LOG 2010/04/05 updated CHANGE.txt 2010/04/05 new copy of CHANGE.LOG arseneau.tex/pdf 2010/04/05 added `optional.sty' diff --git a/Master/texmf-dist/doc/latex/nicetext/FILEs.txt b/Master/texmf-dist/doc/latex/nicetext/FILEs.txt index 4c512433240..2a56a6707a6 100644 --- a/Master/texmf-dist/doc/latex/nicetext/FILEs.txt +++ b/Master/texmf-dist/doc/latex/nicetext/FILEs.txt @@ -1,52 +1,66 @@ FILES IN CTAN DIRECTORY /macros/latex/contrib/nicetext: - FILES.txt present file -FileList.txt source file versions + FILEs.txt present file +SrcFILEs.txt source file versions/descriptions README summary README.pdf PDF version of README README.txt copy of README -fifinddo.sty parsing and file handling - makedoc.sty package to documentation preprocessing -mdoccorr.cfg txt to TeX macros -niceverb.sty minimal documentation markup - wiki.sty Wikimedia-like markup - SUBDIRECTORIES: demo automatically generated documentation ... -|__arseneau.pdf of packages by Donald Arseneau -|____substr.pdf of Harald Harders' substr.sty +|___arseneau.pdf ... of packages by Donald Arseneau +|________iso.txt result from atari.txt +|________lns.txt result of "compressing" blank lines +|_____sample.tex result from sample.txt +|_____substr.pdf ... of Harald Harders' substr.sty doc documentation -|____CHANGE.LOG bundle changes -|____CHANGE.txt copy of CHANGE.LOG -|___NNOUNCE.txt announcement for present release -|__RELEAS03.txt announcement for earlier release -|__RELEAS04.txt announcement for earlier release -|__fifinddo.pdf for fifinddo.sty -|___makedoc.pdf for makedoc.sty -|_mdoccheat.pdf lists makedoc+fifinddo commands -|__niceverb.pdf for niceverb.sty -|_wikicheat.pdf lists wiki.sty features +|___ANNOUNCE.txt announcement for present release +|_____CHANGE.LOG bundle changes +|_____CHANGE.txt copy of CHANGE.LOG +|___RELEAS03.txt announcement for earlier release +|___RELEAS04.txt announcement for earlier release +|_RELEASE042.txt announcement for earlier release +|___fifinddo.pdf for fifinddo.sty +|____makedoc.pdf for makedoc.sty +|__mdoccheat.pdf lists makedoc+fifinddo commands +|___niceverb.pdf for niceverb.sty +|__wikicheat.pdf lists wiki.sty features docsrc documentation sources -|____README.tex generates README.pdf -|__fifinddo.tex -|____gather.tex gather source file versions -|___makedoc.tex -|___makedoc.cfg shared style settings -|_mdoccheat.tex -|__niceverb.tex -|_wikicheat.tex +|_____README.tex generates README.pdf [likewise:] +|___fifinddo.tex +|____makedoc.tex +|__mdoccheat.tex +|___niceverb.tex +|___srcfiles.tex gather source file versions +|__wikicheat.tex run dialogues/templates/examples -|__arseneau.tex typesets documentation of ... -|__fdtxttex.tex dialogue for txt to TeX etc. -|__fdtxttex.tpl fifinddo script for txt to TeX etc. -|___makedoc.tpl makedoc script for txt to TeX -|____sample.txt watch its TeX enhancement -|____substr.tex typesets substr.sty documentation +|_README-run.txt describes this subdirectory +|______atari.cfg Atari sample configuration +|______atari.fdf some Atari->ISO-8859-1 mappings +|______atari.txt Atari umlauts +|___arseneau.tex typesets documentation of ... +|___copyfile.cfg initializes copyfile.tex dialogue +|___copyfile.tex dialogue: compressing blank lines, conversion +|___fddial0g.sty macros for dialogues (to be improved ...) +|___fdtxttex.cfg initializes fdtxttex.tex dialogue +|___fdtxttex.tex dialogue for txt to TeX etc. +|___fdtxttex.tpl fifinddo script template for txt to TeX etc. +|______lines.txt initial/demo input for copyfile.tex +|____makedoc.tpl makedoc preprocessing script template +|_____sample.txt initial/demo input for fdtxttex.tex +|_____substr.tex typesets substr.sty documentation + +use macro packages +|___fifinddo.sty file handling and parsing +|____makedoc.cfg shared local style settings +|____makedoc.sty documentation preprocessing +|___mdoccorr.cfg txt to TeX macros +|___niceverb.sty minimal documentation markup +|_______wiki.sty Wikimedia-like markup __________________________ -this file 2011/01/30, U.L. +this file 2011/08/23, U.L. diff --git a/Master/texmf-dist/doc/latex/nicetext/FileList.txt b/Master/texmf-dist/doc/latex/nicetext/FileList.txt deleted file mode 100644 index 83f382ebe98..00000000000 --- a/Master/texmf-dist/doc/latex/nicetext/FileList.txt +++ /dev/null @@ -1,17 +0,0 @@ - - *File List* -fifinddo.sty 2011/01/25 v0.42 filtering TeX(t) files by TeX (UL) - makedoc.sty 2011/01/25 v0.41 TeX input from *.sty (UL) -niceverb.sty 2011/01/26 v0.42 minimize doc markup (UL) - wiki.sty 2008/07/02 v0.2 LaTeX through Wiki markup -fifinddo.tex 2010/11/27 documenting fifinddo.sty - makedoc.tex 2011/01/25 documenting makedoc.sty -niceverb.tex 2011/01/26 documenting niceverb.sty - makedoc.cfg 2011/01/24 documentation settings -mdoccorr.cfg 2011/01/12 local typographical corrections with makedoc.sty - gather.tex 2010/11/27 collect file infos - *********** - - List made at 2011/01/26, 17:48 - from script file gather.tex - diff --git a/Master/texmf-dist/doc/latex/nicetext/NNOUNCE.txt b/Master/texmf-dist/doc/latex/nicetext/NNOUNCE.txt index a39e9134bac..fb8e34ade10 100644 --- a/Master/texmf-dist/doc/latex/nicetext/NNOUNCE.txt +++ b/Master/texmf-dist/doc/latex/nicetext/NNOUNCE.txt @@ -1,26 +1,33 @@ -Minimal markup for simple text (Wikipedia style) and documentation -================================================================== -New with release 0.42: - - `makedoc.sty' \small starting \mdPackageCode spoiled all - documentations 2009/2010! (fixed); - \ResetCodeLineNumbers fixed - -`mdoccorr.cfg' `<-' and `->' typeset arrows, `...' re-implemented - -`fifinddo.sty' new macros \IfFDpreviousInputEmpty ("compression" - of empty lines), \BasicNormalCatcodes, \CopyFile* - (compress), \CopyLine, \StartPrependingChain - (per-line jobs), documentation modified - -`niceverb.sty' fixed `\ ' in auto mode; - \ctanpkgref moves to `texlinks.sty'; - additions in introduction - - `makedoc.cfg' loads `hypertoc.sty' and `texlinks.sty' - --- dedicated to my sister for her birthday! - +Minimal markup for documentation, text filtering +================================================================= +Release 0.43 synchronizes references to here, +provides minor fixes, and enhances dialogues: + + `atari.cfg' settings for conversion with: + `atari.fdf' from `morehype' exemplifies conversion with: + +`copyfile.cfg' initializes: + +`copyfile.tex' dialogue for compressing blank lines + (and text encoding conversion) + +`fdtxttex.cfg' initializes: + +`fdtxttex.tex' dialogue for .txt -> .tex conversion + +`fddial0g.sty' shared macros for the dialogues + +`fifinddo.sty' documentation fix \WriteResult -> \ResultFile + + `makedoc.cfg' loads `color.sty'; provides \acro by `relsize.sty' + (with a funny protection for hyperref bookmarks); + uses \meta as semantical alias for \textit + + `makedoc.sty' documentation fix makedoc.cfg -> mdoccorr.cfg + +`niceverb.sty' \gt for >, \lt for <; + fixed noisy catcode changing in .aux + `README' adjusted, enhanced diff --git a/Master/texmf-dist/doc/latex/nicetext/README b/Master/texmf-dist/doc/latex/nicetext/README index 5ce1fb0b0c4..9666441116a 100644 --- a/Master/texmf-dist/doc/latex/nicetext/README +++ b/Master/texmf-dist/doc/latex/nicetext/README @@ -1,29 +1,29 @@ The NICETEXT bundle - (c) 2009-2011 Uwe Lueck http://contact-ednotes.sty.de.vu + (c) 2009-2011 Uwe Lueck http://contact-ednotes.sty.de.vu == General Idea == The NICETEXT bundle supports "minimal" markup syntax for rather simple kinds of text. The code you type should show little more -characters than are printed, though you get LaTeX quality. We try -to do away with backslashes, technical terms, and curly braces -(which also are so clumsy to type on PC keyboards). +characters than are printed, though you get LaTeX quality. We +try to do away with backslashes, technical terms, and curly +braces (clumsy to type ... - "syntactic sugar"). -Main focus is easy documentation of LaTeX packages. Preprocessing -by Perl or so is replaced by TeX macros (reviving/generalizing the -'docstrip' idea), including expandable, safe, correct string -substitution and typographical enhancements of plain text for -LaTeX input. +Main focus is easy documentation of LaTeX packages. +Preprocessing by Perl or so is replaced by TeX macros +(reviving/generalizing the `docstrip' idea), including +expandable, safe, correct string substitution and typographical +enhancements of plain text for LaTeX input. == Packages == -'wiki.sty' addresses general kinds of texts. 'niceverb.sty' is -made for documenting LaTeX packages. 'niceverb.sty' especially -offers [almost-]WYSIWIG for meta-variables (macro arguments) and -for referring to commands (and their syntax) in footnotes, +`wiki.sty' addresses general kinds of texts. `niceverb.sty' is +made for documenting LaTeX packages. `niceverb.sty' especially +offers [almost-]WYSIWIG for meta-variables (macro arguments) +and for referring to commands (and their syntax) in footnotes, section titles etc. E.g., to get the syntax description \foo[]{} @@ -31,85 +31,82 @@ you just type \foo[]{} !-) -'fifinddo.sty' provides basic setup for text filtering, especially -string substitution. 'makedoc.sty' extends it to provide a simple -script language for transforming plain text package files into LaTeX -input files [manual!?]. One LaTeX run can perform preprocessing and -typesetting. +`fifinddo.sty' provides basic setup for text filtering, +especially string substitution. `makedoc.sty' extends it to +provide a simple script language for transforming plain text +package files into LaTeX input files [manual!?]. One LaTeX run +can perform preprocessing and typesetting. == Comparisons == -One source of inspiration is the markup syntax of editing Wikipedia -pages. 'wiki.sty' of the bundle offers something similar as a LaTeX -front-end for italics, boldface, sectioning, and certain list-like -environments. This is also similar to 'easylatex', +One source of inspiration is the markup syntax of editing +Wikipedia pages. `wiki.sty' of the bundle offers something +similar as a LaTeX front-end for italics, boldface, sectioning, +and certain list-like environments. This is also similar to +`easylatex', http://www.ctan.org/pkg/easylatex -which is more powerful and uses Perl. NICETEXT, by contrast, consists -just of LaTeX packages, working on any TeX installation [!? note -restrictions in 'fifinddo.pdf']. Cf. also preprocessor packages -'txt2tex' and 'txt2latex'. +which is more powerful and uses Perl. NICETEXT, by contrast, +consists just of LaTeX packages, working on any TeX +installation [!? note restrictions in `fifinddo.pdf']. +Cf. also preprocessor packages `txt2tex' and `txt2latex'. -Regarding "self-documentation," there is a difference to current -`\DocInput', similar ideas are in 'gmdoc' and 'lineno.sty', -see 'niceverb.pdf' and 'makedoc.pdf'. Standard 'doc.sty' and -'contrib' extensions of it are rather avoided. +Regarding "self-documentation," there is a difference to +current `\DocInput', similar ideas are in `gmdoc' and +`lineno.sty', see `niceverb.pdf' and `makedoc.pdf'. Standard +`doc.sty' and `contrib' extensions of it are rather avoided. There are several *LaTeX macro* packages for processing text or databases or for editing TeX's input stream while typesetting --- see 'fifinddo.pdf'. What seems to be new here is +-- see `fifinddo.pdf'. What seems to be new here is *expandable string substitution* and safe, correct detection of -substrings -- discussed in 'fifinddo.pdf'. +substrings -- discussed in `fifinddo.pdf'. == Documentation == -'fifinddo.pdf' describes 'fifinddo.sty', typeset from 'fifinddo.tex'. -'makedoc.pdf' describes 'makedoc.sty', typeset from 'makedoc.tex'. -'mdoccheat.pdf' is a list of script commands, typeset from 'mdocchea.tex'. -'niceverb.pdf' describes 'niceverb.sty', typeset from 'niceverb.tex'. -Typesetting them anew (for customizing printout) requires -'makedoc.cfg', 'mdoccorr.cfg', and the *.sty files. +`fifinddo.pdf' describes `fifinddo.sty', typeset from +`fifinddo.tex'. `makedoc.pdf' describes `makedoc.sty', typeset +from `makedoc.tex'. `mdoccheat.pdf' is a list of script +commands, typeset from `mdocchea.tex'. `niceverb.pdf' describes +`niceverb.sty', typeset from `niceverb.tex'. Typesetting them +anew (for customizing printout) requires `makedoc.cfg', +`mdoccorr.cfg', and the *.sty files. -'wikicheat.pdf' is a one-page manual of 'wiki.sty'. The file -'wiki.sty' contains additional documentation as plain text. +`wikicheat.pdf' is a one-page manual of `wiki.sty'. The file +`wiki.sty' contains additional documentation as plain text. Note that certain features must be activated by commands in the document environment. == Templates/Dialogue == -txt to TeX functionality through \MakeDocCorrectHook can be tried -and applied with templates `fdtxttex.tpl' and `makedoc.tpl' and in -a dialogue started by running `fdtxttex.tex'. +txt to TeX functionality through \MakeDocCorrectHook can be +tried and applied with templates `fdtxttex.tpl' and +`makedoc.tpl' and in a dialogue started by running +`fdtxttex.tex'. Running `copyfile.tex', you get a dialogue +for "compressing" blank lines or text encoding conversion. `substr.tex' should typeset the version of Harald Harders' `substr.sty' next at your TeX installation. `arseneau.tex' -should typeset documentation of a few packages by Donald Arseneau. -My results are `substr.pdf' and `arseneau.pdf'. - - - == Required == - -`makedoc.sty' requires the `moreverb' package from - - CTAN:/macros/latex/contrib/moreverb +should typeset documentation of a few packages by Donald +Arseneau. MY results are `substr.pdf' and `arseneau.pdf'. == License == -Copying, distributing, modifying, using the files of the `nicetext' -bundle are allowed under the terms of the LaTeX Project Public -License, either version 1.3a or any later version, the latest version -is at +Copying, distributing, modifying, using the files of the +`nicetext' bundle are allowed under the terms of the +LaTeX Project Public License, either version 1.3a or any later +version, the latest version is at http://www.latex-project.org/lppl.txt -There is NO WARRANTY, and you must CARE indeed with `fifinddo' and -`makedoc', they will OVERWRITE existing files without warning because -their main purpose is updating. +There is NO WARRANTY, and you must CARE indeed with `fifinddo' +and `makedoc', they will OVERWRITE existing files without +warning (because their main purpose is updating). The bundle is AUTHOR-MAINTAINED in the sense of the LPPL. @@ -117,9 +114,24 @@ Copyright (C) 2009-2011 Uwe Lueck, http://www.contact-ednotes.sty.de.vu -Please report bugs, problems, and suggestions via the previous web -form. +Please report bugs, problems, and suggestions via the previous +web form. + + + == Installing/Required == + +`makedoc.sty' requires the `moreverb' package from + + CTAN:/macros/latex/contrib/moreverb + +You find the latest public version of the NICETEXT bundle at + + http://mirror.ctan.org/macros/latex/contrib/nicetext/ + +A TDS version `nictext.tds.zip' is available at + + http://mirror.ctan.org/install/macros/latex/contrib/ ________________________________ - [This file 2011/01/26 Uwe Lueck] + [This file 2011/08/23 Uwe Lueck] diff --git a/Master/texmf-dist/doc/latex/nicetext/README.pdf b/Master/texmf-dist/doc/latex/nicetext/README.pdf index ed7c4e39431..0ab0e2c15fb 100644 Binary files a/Master/texmf-dist/doc/latex/nicetext/README.pdf and b/Master/texmf-dist/doc/latex/nicetext/README.pdf differ diff --git a/Master/texmf-dist/doc/latex/nicetext/README.txt b/Master/texmf-dist/doc/latex/nicetext/README.txt index 5ce1fb0b0c4..9666441116a 100644 --- a/Master/texmf-dist/doc/latex/nicetext/README.txt +++ b/Master/texmf-dist/doc/latex/nicetext/README.txt @@ -1,29 +1,29 @@ The NICETEXT bundle - (c) 2009-2011 Uwe Lueck http://contact-ednotes.sty.de.vu + (c) 2009-2011 Uwe Lueck http://contact-ednotes.sty.de.vu == General Idea == The NICETEXT bundle supports "minimal" markup syntax for rather simple kinds of text. The code you type should show little more -characters than are printed, though you get LaTeX quality. We try -to do away with backslashes, technical terms, and curly braces -(which also are so clumsy to type on PC keyboards). +characters than are printed, though you get LaTeX quality. We +try to do away with backslashes, technical terms, and curly +braces (clumsy to type ... - "syntactic sugar"). -Main focus is easy documentation of LaTeX packages. Preprocessing -by Perl or so is replaced by TeX macros (reviving/generalizing the -'docstrip' idea), including expandable, safe, correct string -substitution and typographical enhancements of plain text for -LaTeX input. +Main focus is easy documentation of LaTeX packages. +Preprocessing by Perl or so is replaced by TeX macros +(reviving/generalizing the `docstrip' idea), including +expandable, safe, correct string substitution and typographical +enhancements of plain text for LaTeX input. == Packages == -'wiki.sty' addresses general kinds of texts. 'niceverb.sty' is -made for documenting LaTeX packages. 'niceverb.sty' especially -offers [almost-]WYSIWIG for meta-variables (macro arguments) and -for referring to commands (and their syntax) in footnotes, +`wiki.sty' addresses general kinds of texts. `niceverb.sty' is +made for documenting LaTeX packages. `niceverb.sty' especially +offers [almost-]WYSIWIG for meta-variables (macro arguments) +and for referring to commands (and their syntax) in footnotes, section titles etc. E.g., to get the syntax description \foo[]{} @@ -31,85 +31,82 @@ you just type \foo[]{} !-) -'fifinddo.sty' provides basic setup for text filtering, especially -string substitution. 'makedoc.sty' extends it to provide a simple -script language for transforming plain text package files into LaTeX -input files [manual!?]. One LaTeX run can perform preprocessing and -typesetting. +`fifinddo.sty' provides basic setup for text filtering, +especially string substitution. `makedoc.sty' extends it to +provide a simple script language for transforming plain text +package files into LaTeX input files [manual!?]. One LaTeX run +can perform preprocessing and typesetting. == Comparisons == -One source of inspiration is the markup syntax of editing Wikipedia -pages. 'wiki.sty' of the bundle offers something similar as a LaTeX -front-end for italics, boldface, sectioning, and certain list-like -environments. This is also similar to 'easylatex', +One source of inspiration is the markup syntax of editing +Wikipedia pages. `wiki.sty' of the bundle offers something +similar as a LaTeX front-end for italics, boldface, sectioning, +and certain list-like environments. This is also similar to +`easylatex', http://www.ctan.org/pkg/easylatex -which is more powerful and uses Perl. NICETEXT, by contrast, consists -just of LaTeX packages, working on any TeX installation [!? note -restrictions in 'fifinddo.pdf']. Cf. also preprocessor packages -'txt2tex' and 'txt2latex'. +which is more powerful and uses Perl. NICETEXT, by contrast, +consists just of LaTeX packages, working on any TeX +installation [!? note restrictions in `fifinddo.pdf']. +Cf. also preprocessor packages `txt2tex' and `txt2latex'. -Regarding "self-documentation," there is a difference to current -`\DocInput', similar ideas are in 'gmdoc' and 'lineno.sty', -see 'niceverb.pdf' and 'makedoc.pdf'. Standard 'doc.sty' and -'contrib' extensions of it are rather avoided. +Regarding "self-documentation," there is a difference to +current `\DocInput', similar ideas are in `gmdoc' and +`lineno.sty', see `niceverb.pdf' and `makedoc.pdf'. Standard +`doc.sty' and `contrib' extensions of it are rather avoided. There are several *LaTeX macro* packages for processing text or databases or for editing TeX's input stream while typesetting --- see 'fifinddo.pdf'. What seems to be new here is +-- see `fifinddo.pdf'. What seems to be new here is *expandable string substitution* and safe, correct detection of -substrings -- discussed in 'fifinddo.pdf'. +substrings -- discussed in `fifinddo.pdf'. == Documentation == -'fifinddo.pdf' describes 'fifinddo.sty', typeset from 'fifinddo.tex'. -'makedoc.pdf' describes 'makedoc.sty', typeset from 'makedoc.tex'. -'mdoccheat.pdf' is a list of script commands, typeset from 'mdocchea.tex'. -'niceverb.pdf' describes 'niceverb.sty', typeset from 'niceverb.tex'. -Typesetting them anew (for customizing printout) requires -'makedoc.cfg', 'mdoccorr.cfg', and the *.sty files. +`fifinddo.pdf' describes `fifinddo.sty', typeset from +`fifinddo.tex'. `makedoc.pdf' describes `makedoc.sty', typeset +from `makedoc.tex'. `mdoccheat.pdf' is a list of script +commands, typeset from `mdocchea.tex'. `niceverb.pdf' describes +`niceverb.sty', typeset from `niceverb.tex'. Typesetting them +anew (for customizing printout) requires `makedoc.cfg', +`mdoccorr.cfg', and the *.sty files. -'wikicheat.pdf' is a one-page manual of 'wiki.sty'. The file -'wiki.sty' contains additional documentation as plain text. +`wikicheat.pdf' is a one-page manual of `wiki.sty'. The file +`wiki.sty' contains additional documentation as plain text. Note that certain features must be activated by commands in the document environment. == Templates/Dialogue == -txt to TeX functionality through \MakeDocCorrectHook can be tried -and applied with templates `fdtxttex.tpl' and `makedoc.tpl' and in -a dialogue started by running `fdtxttex.tex'. +txt to TeX functionality through \MakeDocCorrectHook can be +tried and applied with templates `fdtxttex.tpl' and +`makedoc.tpl' and in a dialogue started by running +`fdtxttex.tex'. Running `copyfile.tex', you get a dialogue +for "compressing" blank lines or text encoding conversion. `substr.tex' should typeset the version of Harald Harders' `substr.sty' next at your TeX installation. `arseneau.tex' -should typeset documentation of a few packages by Donald Arseneau. -My results are `substr.pdf' and `arseneau.pdf'. - - - == Required == - -`makedoc.sty' requires the `moreverb' package from - - CTAN:/macros/latex/contrib/moreverb +should typeset documentation of a few packages by Donald +Arseneau. MY results are `substr.pdf' and `arseneau.pdf'. == License == -Copying, distributing, modifying, using the files of the `nicetext' -bundle are allowed under the terms of the LaTeX Project Public -License, either version 1.3a or any later version, the latest version -is at +Copying, distributing, modifying, using the files of the +`nicetext' bundle are allowed under the terms of the +LaTeX Project Public License, either version 1.3a or any later +version, the latest version is at http://www.latex-project.org/lppl.txt -There is NO WARRANTY, and you must CARE indeed with `fifinddo' and -`makedoc', they will OVERWRITE existing files without warning because -their main purpose is updating. +There is NO WARRANTY, and you must CARE indeed with `fifinddo' +and `makedoc', they will OVERWRITE existing files without +warning (because their main purpose is updating). The bundle is AUTHOR-MAINTAINED in the sense of the LPPL. @@ -117,9 +114,24 @@ Copyright (C) 2009-2011 Uwe Lueck, http://www.contact-ednotes.sty.de.vu -Please report bugs, problems, and suggestions via the previous web -form. +Please report bugs, problems, and suggestions via the previous +web form. + + + == Installing/Required == + +`makedoc.sty' requires the `moreverb' package from + + CTAN:/macros/latex/contrib/moreverb + +You find the latest public version of the NICETEXT bundle at + + http://mirror.ctan.org/macros/latex/contrib/nicetext/ + +A TDS version `nictext.tds.zip' is available at + + http://mirror.ctan.org/install/macros/latex/contrib/ ________________________________ - [This file 2011/01/26 Uwe Lueck] + [This file 2011/08/23 Uwe Lueck] diff --git a/Master/texmf-dist/doc/latex/nicetext/RELEASE042.txt b/Master/texmf-dist/doc/latex/nicetext/RELEASE042.txt new file mode 100644 index 00000000000..a39e9134bac --- /dev/null +++ b/Master/texmf-dist/doc/latex/nicetext/RELEASE042.txt @@ -0,0 +1,26 @@ +Minimal markup for simple text (Wikipedia style) and documentation +================================================================== +New with release 0.42: + + `makedoc.sty' \small starting \mdPackageCode spoiled all + documentations 2009/2010! (fixed); + \ResetCodeLineNumbers fixed + +`mdoccorr.cfg' `<-' and `->' typeset arrows, `...' re-implemented + +`fifinddo.sty' new macros \IfFDpreviousInputEmpty ("compression" + of empty lines), \BasicNormalCatcodes, \CopyFile* + (compress), \CopyLine, \StartPrependingChain + (per-line jobs), documentation modified + +`niceverb.sty' fixed `\ ' in auto mode; + \ctanpkgref moves to `texlinks.sty'; + additions in introduction + + `makedoc.cfg' loads `hypertoc.sty' and `texlinks.sty' + +-- dedicated to my sister for her birthday! + + + + diff --git a/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt b/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt new file mode 100644 index 00000000000..71ecb6f2779 --- /dev/null +++ b/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt @@ -0,0 +1,35 @@ + + *File List* + DOCSRC. +srcfiles.tex 2011/08/23 collect file infos + README.tex 2011/02/14 make README.pdf +fifinddo.tex 2011/08/22 documenting fifinddo.sty + makedoc.tex 2011/08/22 documenting makedoc.sty +niceverb.tex 2011/08/22 documenting niceverb.sty +mdoccheat.tex 2011/01/26 cheat sheet for `makedoc.sty' +wikicheat.tex 2011/01/26 cheatsheet for wiki.sty + RUN. +arseneau.tex 2010/04/05 some packages by D. Arseneau (ul) + substr.tex 2011/08/20 [2010/03/30] documentation for substr.sty +copyfile.tex 2011/08/22 copy*ing/converting (UL) +fdtxttex.tex 2011/08/23 txt to TeX by dialogue (UL) +fdtxttex.tpl 2011/08/21 [2010/03/30] fifinddo correction template + makedoc.tpl 2011/08/23 makedoc preprocessing template + RUNUSE. + atari.cfg 2011/08/23 sample for copyfile.tex + atari.fdf 2010/08/23 Atari to ISO-8859-1 with blog.sty +fddial0g.sty 2011/08/23 dialogues with fifinddo (UL) +copyfile.cfg 2011/08/22 initializing copyfile.tex +fdtxttex.cfg 2010/11/25 initializing fdtxttex.tex + USE. +fifinddo.sty 2011/08/22 v0.42a filtering TeX(t) files by TeX (UL) + makedoc.sty 2011/08/22 v0.41a TeX input from *.sty (UL) + makedoc.cfg 2011/08/22 documentation settings +mdoccorr.cfg 2011/01/27 local typographical corrections with makedoc.sty +niceverb.sty 2011/08/20 v0.43 minimize doc markup (UL) + wiki.sty 2008/07/02 v0.2 LaTeX through Wiki markup + *********** + + List made at 2011/08/23, 16:47 + from script file srcfiles.tex + diff --git a/Master/texmf-dist/doc/latex/nicetext/demo/iso.txt b/Master/texmf-dist/doc/latex/nicetext/demo/iso.txt new file mode 100644 index 00000000000..455c8e2a79b --- /dev/null +++ b/Master/texmf-dist/doc/latex/nicetext/demo/iso.txt @@ -0,0 +1,3 @@ + + + diff --git a/Master/texmf-dist/doc/latex/nicetext/demo/lns.txt b/Master/texmf-dist/doc/latex/nicetext/demo/lns.txt new file mode 100644 index 00000000000..455c8e2a79b --- /dev/null +++ b/Master/texmf-dist/doc/latex/nicetext/demo/lns.txt @@ -0,0 +1,3 @@ + + + diff --git a/Master/texmf-dist/doc/latex/nicetext/demo/sample.tex b/Master/texmf-dist/doc/latex/nicetext/demo/sample.tex new file mode 100644 index 00000000000..046931aa080 --- /dev/null +++ b/Master/texmf-dist/doc/latex/nicetext/demo/sample.tex @@ -0,0 +1,5 @@ +\ProvidesFile{sample.tex}[2011/08/23 automatically generated with fifinddo.sty] +blabla .\kern\fontdimen3\font.\kern\fontdimen3\font.\ blabla +blabla cf.\ bla +etc.\ bla bla + diff --git a/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf b/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf index 7551e473cd7..819b4d48209 100644 Binary files a/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf and b/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf differ diff --git a/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf b/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf index d2e6a4a2be9..c50c091d7eb 100644 Binary files a/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf and b/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf differ diff --git a/Master/texmf-dist/doc/latex/nicetext/mdoccheat.pdf b/Master/texmf-dist/doc/latex/nicetext/mdoccheat.pdf deleted file mode 100644 index 1ead8986302..00000000000 Binary files a/Master/texmf-dist/doc/latex/nicetext/mdoccheat.pdf and /dev/null differ diff --git a/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf b/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf index a1fa66d2e67..09808c1771d 100644 Binary files a/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf and b/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf differ diff --git a/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex b/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex deleted file mode 100644 index 10b86dc6254..00000000000 --- a/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex +++ /dev/null @@ -1,153 +0,0 @@ -\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/doc/latex/nicetext/run/fdtxttex.tex b/Master/texmf-dist/doc/latex/nicetext/run/fdtxttex.tex deleted file mode 100644 index a7ea6de14d4..00000000000 --- a/Master/texmf-dist/doc/latex/nicetext/run/fdtxttex.tex +++ /dev/null @@ -1,58 +0,0 @@ - \makeatletter -\typeout{^^J*fdtxttex.tex* 2010/03/30 txt to TeX by dialogue^^J - (apply \string\MakeDocCorrectHook) - ^^J} - -\RequirePackage{fifinddo} - -\catcode`\_=11 -\def\CorrectionFile{\def\mdoc_corr} -\CorrectionFile{mdoccorr.cfg} -\ResultFile{sample.tex} -\def\InputFile{\def\input_file_name} -\InputFile{sample.txt} -\newif\iftoscreen - -\def\FD_dialogue{% - \typeout{^^J% - ===========================================================^^J% - \string\CorrectionFile{\mdoc_corr} - \space (define \@backslashchar MakeDocCorrectHook)^^J% - \string\InputFile {\input_file_name}^^J% - \string\ResultFile{\result_file_name} - \space\space\space\space\space\space\space - \string\toscreen\iftoscreen true\else false\fi ^^J% - ===========================================================% - }% - \typein[\action]% - {Run with these settings? (Y)es? (C)hange? (Otherwise quit.)}% - \csname action_\action \endcsname -} -\def\run_with_settings{% - \input{\mdoc_corr}% - \WriteProvides - \ProcessFileWith{\input_file_name}{% - \WriteResult{\expandafter \MakeDocCorrectHook - \expandafter{\fdInputLine}}% - \iftoscreen - \typeout{\expandafter \MakeDocCorrectHook - \expandafter{\fdInputLine}}% - \else - \message{.}% - \fi} - \CloseResultFile - \typeout{Done.}% - \FD_dialogue -} -\expandafter\let\csname action_y\endcsname \run_with_settings -\expandafter\let\csname action_Y\endcsname \run_with_settings - -\def\change_settings{% - \typein[\change]{^^JType setting command(s).}% - \change \FD_dialogue} -\expandafter\let\csname action_c\endcsname \change_settings -\expandafter\let\csname action_C\endcsname \change_settings - -\FD_dialogue - -\stop diff --git a/Master/texmf-dist/doc/latex/nicetext/run/fdtxttex.tpl b/Master/texmf-dist/doc/latex/nicetext/run/fdtxttex.tpl deleted file mode 100644 index 9b97a0a9f7c..00000000000 --- a/Master/texmf-dist/doc/latex/nicetext/run/fdtxttex.tpl +++ /dev/null @@ -1,13 +0,0 @@ -\typeout{fdtxttex.tpl 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/doc/latex/nicetext/run/makedoc.tpl b/Master/texmf-dist/doc/latex/nicetext/run/makedoc.tpl deleted file mode 100644 index e508d8cded5..00000000000 --- a/Master/texmf-dist/doc/latex/nicetext/run/makedoc.tpl +++ /dev/null @@ -1,17 +0,0 @@ -\typeout{makedoc.tpl 2010/03/23 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 \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/nicetext/run/sample.txt b/Master/texmf-dist/doc/latex/nicetext/run/sample.txt deleted file mode 100644 index 69408f90fd8..00000000000 --- a/Master/texmf-dist/doc/latex/nicetext/run/sample.txt +++ /dev/null @@ -1,3 +0,0 @@ -blabla ... blabla -blabla cf. bla -etc. bla bla \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/nicetext/run/substr.tex b/Master/texmf-dist/doc/latex/nicetext/run/substr.tex deleted file mode 100644 index f876d173289..00000000000 --- a/Master/texmf-dist/doc/latex/nicetext/run/substr.tex +++ /dev/null @@ -1,92 +0,0 @@ -\typeout{substr.tex 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 - 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*[]{}+\] In ``auto mode" of the package, even typing \[\HardVerbBox+\foo*[]{}+\] -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 |#|.) \item[Escaping from 'niceverb' (generally).] To get rid of the functionality of some active character @@ -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} 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[]{}| %% is an application of `\ProcessFileWith' %% that ``copies" the content of file -%% into the file specified by `\WriteResult'. +%% into the file specified by +%% `\ResultFile'. %% was `\WriteResult'. 2011/08/06 %% However, optional 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+

+. %% %% |\CloseResultFile| closes . @@ -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{}}'\] @@ -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{}| from 'doc.sty'. +%% so we provide something like |\cs{}| 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}' 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 + -- cgit v1.2.3