diff options
Diffstat (limited to 'Master')
47 files changed, 795 insertions, 357 deletions
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,4 +1,39 @@ ______________________________________________________________________ +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, and uses the `source' tree in the .tds. @@ -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,4 +1,39 @@ ______________________________________________________________________ +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, and uses the `source' tree in the .tds. @@ -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[<opt-arg>]{<mand-arg>} @@ -31,85 +31,82 @@ you just type \foo[<opt-arg>]{<mand-arg>} !-) -'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 Binary files differindex ed7c4e39431..0ab0e2c15fb 100644 --- a/Master/texmf-dist/doc/latex/nicetext/README.pdf +++ b/Master/texmf-dist/doc/latex/nicetext/README.pdf 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[<opt-arg>]{<mand-arg>} @@ -31,85 +31,82 @@ you just type \foo[<opt-arg>]{<mand-arg>} !-) -'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 Binary files differindex 7551e473cd7..819b4d48209 100644 --- a/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf +++ b/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf diff --git a/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf b/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf Binary files differindex d2e6a4a2be9..c50c091d7eb 100644 --- a/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf +++ b/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf diff --git a/Master/texmf-dist/doc/latex/nicetext/mdoccheat.pdf b/Master/texmf-dist/doc/latex/nicetext/mdoccheat.pdf Binary files differdeleted file mode 100644 index 1ead8986302..00000000000 --- a/Master/texmf-dist/doc/latex/nicetext/mdoccheat.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf b/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf Binary files differindex a1fa66d2e67..09808c1771d 100644 --- a/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf +++ b/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf 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/source/latex/nicetext/README.tex b/Master/texmf-dist/source/latex/nicetext/README.tex index ce26748edb5..0587bb398a7 100644 --- a/Master/texmf-dist/source/latex/nicetext/README.tex +++ b/Master/texmf-dist/source/latex/nicetext/README.tex @@ -1,4 +1,4 @@ -\ProvidesFile{README.tex}[2010/11/27 make README.pdf] +\ProvidesFile{README.tex}[2011/02/14 make README.pdf] \listfiles \documentclass[12pt]{article} @@ -7,5 +7,6 @@ \begin{document} \vspace*{-2\baselineskip} \enlargethispage{1\baselineskip} +% \small %% 2011/02/14 \verbatiminput{README.txt} \end{document} diff --git a/Master/texmf-dist/source/latex/nicetext/fifinddo.tex b/Master/texmf-dist/source/latex/nicetext/fifinddo.tex index f517ad3a3e7..5417ee4c02b 100644 --- a/Master/texmf-dist/source/latex/nicetext/fifinddo.tex +++ b/Master/texmf-dist/source/latex/nicetext/fifinddo.tex @@ -1,26 +1,25 @@ -\ProvidesFile{fifinddo.tex}[2010/11/27 documenting fifinddo.sty] +\ProvidesFile{fifinddo.tex}[2011/08/22 documenting fifinddo.sty] \title{\textsf{fifinddo}\\---\\Filtering \TeX(t) Files by \TeX\thanks{This file describes -% \protect\GetFileInfo{\jobname.sty}% version \fileversion\ of \textsf{\filename} as of \filedate.}} - %% ^ 2010/11/26 % \listfiles \documentclass{article} \usepackage{makedoc} % \usepackage{substr} %% for failure examples TODO 2010/03/17 \input{makedoc.cfg} -%% <- TODO -> makedoc.cfg -\usepackage{readprov} +\MDkeywords{text filtering, macro programming, + .txt to .tex enhancement} +\hypersetup{% + pdftitle=fifinddo.sty filters text by TeX, + pdfsubject=documenting fifinddo.sty +} \ReadPackageInfos{fifinddo} -% \ReadFileInfos{fifinddo.sty} -% \hypersetup{pdfstartview=FitH} %% fine! 2010/11/11 \begin{document} -% \GetFileInfo{fifinddo.sty} %% 2010/11/25/26 \maketitle \begin{flushright}\small\it FIDO, FIND!\\or:\\FIND FIDO!\\oder:\\FIFI, SUCH!\end{flushright} -\begin{abstract}\noindent\hspace{1sp}%% for niceverb-apostrophe +\begin{MDabstract} 'fifinddo' starts implementing parsing of plain text or \TeX\ files using \TeX, generalizing the philosophy behind 'docstrip', based on how \TeX\ reads macro arguments. @@ -38,7 +37,7 @@ e.g., with `txt'\,$\to$\,\TeX\ functionality. The method of testing for substrings is carefully discussed, revealing an earlier mistake (then) shared with 'substr.sty' and \LaTeX's internal `\in@'. -\end{abstract} +\end{MDabstract} \tableofcontents \section{Introduction: The Gnome of the Aim} @@ -340,3 +339,4 @@ TODO cf. Kastrup 'makematch' and others 2009/04/09, 2010/11/24 debugging 2010/11/25f. using readprov.sty 2010/11/27 reworked \ProvidesFile +2011/08/22 PDF metadata; adjusting to makedoc.cfg diff --git a/Master/texmf-dist/source/latex/nicetext/gather.tex b/Master/texmf-dist/source/latex/nicetext/gather.tex deleted file mode 100644 index 5a14c651361..00000000000 --- a/Master/texmf-dist/source/latex/nicetext/gather.tex +++ /dev/null @@ -1,8 +0,0 @@ -\RequirePackage{myfilist} -\ProvidesFile{gather.tex}[2010/11/27 collect file infos] -\EmptyFileList %%% [readprov.sty,myfilist.sty] -% \ReadPackageInfos{readprov,myfilist} -\ReadPackageInfos{fifinddo,makedoc,niceverb,wiki} -\ReadFileInfos{fifinddo,makedoc,niceverb,makedoc.cfg,mdoccorr.cfg} %%% ,mdoccheat,wikicheat} -\ReadFileInfos{gather} -\ListInfos[FileList.txt] diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.cfg b/Master/texmf-dist/source/latex/nicetext/makedoc.cfg deleted file mode 100644 index 43d57ed87cc..00000000000 --- a/Master/texmf-dist/source/latex/nicetext/makedoc.cfg +++ /dev/null @@ -1,40 +0,0 @@ -\ProvidesFile{makedoc.cfg}[2011/01/24 documentation settings] - -\author{Uwe L\"uck\thanks{\url{http://contact-ednotes.sty.de.vu}}} -% \author{Uwe L\"uck---{\tt http://contact-ednotes.sty.de.vu}} - -%% hyperref: -\RequirePackage{ifpdf} -\usepackage[% - \ifpdf -% bookmarks=false, %% 2010/12/22 -% bookmarksnumbered, - bookmarksopen, %% 2011/01/24!? - bookmarksopenlevel=2, %% 2011/01/23 -% pdfpagemode=UseNone, -% pdfstartpage=10, -% pdfstartview=FitH, - citebordercolor={ .6 1 .6}, - filebordercolor={1 .6 1}, - linkbordercolor={1 .9 .7}, - urlbordercolor={ .7 1 1}, %% playing 2011/01/24 - \else - draft - \fi -]{hyperref} - -\RequirePackage{niceverb}[2011/01/24] -\RequirePackage{readprov} %% 2010/12/08 -\RequirePackage{hypertoc} %% 2011/01/23 -\RequirePackage{texlinks} %% 2011/01/24 -\makeatletter - \@ifundefined{strong} - {\let\strong\textbf} %% 2011/01/24 - {} -\makeatother - -\errorcontextlines=4 -\pagestyle{headings} - -\endinput - diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.tex b/Master/texmf-dist/source/latex/nicetext/makedoc.tex index b6c78135c42..23371c332ce 100644 --- a/Master/texmf-dist/source/latex/nicetext/makedoc.tex +++ b/Master/texmf-dist/source/latex/nicetext/makedoc.tex @@ -1,9 +1,15 @@ -\ProvidesFile{makedoc.tex}[2011/01/25 documenting makedoc.sty] +\ProvidesFile{makedoc.tex}[2011/08/22 documenting makedoc.sty] \RequirePackage{makedoc} \documentclass{article} \input{makedoc.cfg} -\usepackage{color} %% 2011/01/25 -\sfcode`/=1001 %% TODO makedoc.cfg!? 2010/03/21 niceverb!? 2011/01/25 +%% 2011/08/22: +\MDkeywords{literate programming, .txt to .tex enhancement, + preprocessing documentation, macro programming} +\hypersetup{% + pdftitle=makedoc.sty preprocesses .sty for documentation, + pdfsubject=documenting makedoc.sty +}%% /2011/08/22 +\sfcode`/=1001 %% TODO makedoc.cfg!? 2010/03/21 niceverb!? 2011/01/25 \makeatletter %% TEST for hyperref compatibility 2010/03/11 % \def\@testdef #1#2#3{% % \def\reserved@a{#3}% @@ -24,7 +30,7 @@ version~\textcolor{blue}{\UseVersionOf{makedoc.sty}} of 'makedoc.sty' as of \UseDateOf{makedoc.sty}.}} \maketitle -\begin{abstract}\noindent +\begin{MDabstract} 'makedoc' provides commands for generating \LaTeX\ input from a package file in order to typeset the latter's documentation (somewhat similar and opposite to 'docstrip')---with @@ -41,7 +47,7 @@ documentation driver file.---The present approach is meant to be an It provides \emph{less} than 'doc' does, rather deliberately. It may be helpful at least for the development of small packages, or at least at early stages. -\end{abstract} +\end{MDabstract} \tableofcontents \section{Introduction} \emph{The abstract will not be repeated in this section.} Let me add @@ -644,3 +650,4 @@ end of a file it writes. %% todo TeXbook where? 2009/04/08 2010/03/30 \listfiles test 2010/11/27 \ProvidesFile for myfilist 2011/01/25 \thanks with readprov.sty +2011/08/22 using new makedoc.cfg features diff --git a/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex b/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex index 029bf243bf8..1fcbc68beda 100644 --- a/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex +++ b/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex @@ -1,4 +1,4 @@ -\typeout{mdoccheat.tex 2010/03/30 cheat sheat for `makedoc.sty'} +\ProvidesFile{mdoccheat.tex}[2011/01/26 cheat sheet for `makedoc.sty'] % \listfiles \documentclass{article} \input{makedoc.cfg} %% with pdf stuff and 'niceverb' diff --git a/Master/texmf-dist/source/latex/nicetext/niceverb.tex b/Master/texmf-dist/source/latex/nicetext/niceverb.tex index f4b380b985f..dd789adeae0 100644 --- a/Master/texmf-dist/source/latex/nicetext/niceverb.tex +++ b/Master/texmf-dist/source/latex/nicetext/niceverb.tex @@ -1,4 +1,4 @@ -\ProvidesFile{niceverb.tex}[2011/01/26 documenting niceverb.sty] +\ProvidesFile{niceverb.tex}[2011/08/22 documenting niceverb.sty] \title{\textsf{niceverb.sty}\\---\\Minimizing Markup\\for Documenting \LaTeX\ packages\thanks{This document describes version @@ -10,14 +10,20 @@ \MakeJobDoc{19}{\SectionLevelThreeParseInput} } \documentclass{article}%% TODO paper dimensions!? \input{makedoc.cfg} %% shared formatting settings -\usepackage{color} +%% 2011/08/22: +\MDkeywords{literate programming, syntactic sugar, + .txt to .tex enhancement, macro programming} +\hypersetup{% + pdftitle=syntacic sugar for LaTeX documentation by niceverb.sty, + pdfsubject=documenting niceverb.sty +}%% /2011/08/22 \begin{document} \maketitle -\begin{abstract}\noindent +\begin{MDabstract} 'niceverb.sty' provides very decent syntax (through active characters) for describing \LaTeX\ packages and the syntax of macros conforming to \LaTeX\ syntax conventions. -\end{abstract} +\end{MDabstract} \tableofcontents %% TODO table listing of active characters @@ -31,8 +37,8 @@ for describing \LaTeX\ packages and the syntax of macros conforming to The 'niceverb' package provides ``minimal" markup for documenting \LaTeX\ packages, reducing the number of keystrokes/visible characters needed % .\,.\,. %%% ... %% TODO nicedots -(kind of poor man's WYSIWYG).\footnote{``What you see is what you - get." Novices are always warned that WYSIWYG is essentially +(kind of poor man's \acro{WYSIWYG}).\footnote{``What you see is what you + get." Novices are always warned that \acro{WYSIWYG} is essentially impossible with \LaTeX.} %% TODO UK FAQ 2010/03/11 % One feature---\verb'&\foo'%%% badly self-documenting, `&' fails It conveniently handles command names in arguments of macros @@ -115,7 +121,7 @@ This was achieved by typing \[\HardVerbBox+&\foo*[<opt-arg>]{<mand-arg>}+\] In ``auto mode" of the package, even typing \[\HardVerbBox+\foo*[<opt-arg>]{<mand-arg>}+\] -would have sufficed---WYSIWYG! I call such mixtures of +would have sufficed---\acro{WYSIWYG}! I call such mixtures of \emph{verbatim} and ``meta-variables" \textit{\qtd{meta-code}}. Outside macro arguments, you obtain the same by typing @@ -237,8 +243,7 @@ so \verb+\item[\foo]+ works as wanted. (some of the) special characters %% 2010/03/20 (as listed in the standard macro `\dospecials') verbatim in arguments (where `\verb' and the like fail). It just acts similarly as \TeX's -(as listed in the standard macro `\dospecials') verbatim in arguments -(where `\verb' and the like fail). It just acts similarly as \TeX's + %% undoubled lines 2011/05/09 primitive `\string' (which it actually invokes---cf. discussion on the left quote feature above). @@ -273,7 +278,7 @@ environment.\footnote{This idea appeared 2009 on the 'LATEX-L' %% <- changed 2010/03/11 Rather, \lq`#'\rq\ is an active character for taking the next character (assuming it is a digit) to form a reference to a -\emph{macro parameter}---\lq`#1'\rq\ becomes \lq#1\rq\---WYSIWYG +\emph{macro parameter}---\lq`#1'\rq\ becomes \lq#1\rq\---\acro{WYSIWYG} indeed! (So the general syntax is |#<digit>|.) \item[Escaping from 'niceverb' (generally).] To get rid of the functionality of some active character <char> @@ -450,4 +455,5 @@ HISTORY 2010/12/29 \AddToNoVerbList 2011/01/26 using color.sty and readprov.sty; ack. Stephan B. for <...>; auto headings issue - +2011/05/09 undoubled lines about `&' +2011/08/22 using new makedoc.cfg features diff --git a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex new file mode 100644 index 00000000000..743b729fed4 --- /dev/null +++ b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex @@ -0,0 +1,22 @@ +\RequirePackage{myfilist} +\ProvidesFile{srcfiles.tex}[2011/08/23 collect file infos] +\EmptyFileList %%% [readprov.sty,myfilist.sty] +% \ReadPackageInfos{readprov,myfilist} +\ReadFileInfos{DOCSRC.} %% updsfl.sh +\ReadFileInfos{srcfiles} +\ReadFileInfos{README,fifinddo,makedoc,niceverb} +\ReadFileInfos{mdoccheat,wikicheat} %% updsfl.sh +\ReadFileInfos{RUN.} +\ReadFileInfos{arseneau,substr} +\ReadFileInfos{copyfile,fdtxttex} +\ReadFileInfos{fdtxttex.tpl,makedoc.tpl} +\ReadFileInfos{RUNUSE.} +\ReadFileInfos{atari.cfg,atari.fdf} +% \ReadPackageInfos{fddialog} +\ReadPackageInfos{fddial0g} +\ReadFileInfos{copyfile.cfg,fdtxttex.cfg} +\ReadFileInfos{USE.} +\ReadPackageInfos{fifinddo,makedoc} +\ReadFileInfos{makedoc.cfg,mdoccorr.cfg} +\ReadPackageInfos{niceverb,wiki} +\ListInfos[SrcFILEs.txt] diff --git a/Master/texmf-dist/source/latex/nicetext/wikicheat.tex b/Master/texmf-dist/source/latex/nicetext/wikicheat.tex index e56bff99120..f80251cd778 100644 --- a/Master/texmf-dist/source/latex/nicetext/wikicheat.tex +++ b/Master/texmf-dist/source/latex/nicetext/wikicheat.tex @@ -1,4 +1,4 @@ -\ProvidesFile{wikicheat}[2008/07/10 Cheatsheet for wiki.sty] +\ProvidesFile{wikicheat.tex}[2011/01/26 cheatsheet for wiki.sty] % \def\title{Cheatsheet for the \textsf{wiki} Package} \def\title{\textbf{Cheatsheet} for the \textbf{\textsf{wiki}} Package} \def\author{Uwe L\"uck} diff --git a/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty b/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty index 2652ff75ac6..9a591b6c9c1 100644 --- a/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty +++ b/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty @@ -5,7 +5,7 @@ %% for processing tex(t) files %% (checking, filtering, converting, substituting, expanding, ...) -\def\fileversion{0.42} \def\filedate{2011/01/25} +\def\fileversion{0.42a} \def\filedate{2011/08/22} %% This file can be redistributed and/or modified under %% the terms of the LaTeX Project Public License; either @@ -189,11 +189,12 @@ %% |\CopyFile[<changes>]{<file>}| %% is an application of `\ProcessFileWith' %% that ``copies" the content of file <file> -%% into the file specified by `\WriteResult'. +%% into the file specified by +%% `\ResultFile'. %% was `\WriteResult'. 2011/08/06 %% However, optional <changes> allows some %% ``modifications" while ``copying"---especially, %% conversion of text encodings by active characters -%% and expanding macros for generating HTML +%% and expanding macros for generating \acro{HTML} %% or other code. The ``starred" variant %% |\CopyFile*| copies one empty line only %% when one empty line in the input file is followed @@ -203,8 +204,13 @@ {\let\FD@copy@style\CopyLine \FD@copyfile}} \newcommand*{\FD@copyfile}[2][]{% \ProcessFileWith[#1]{#2}{\FD@copy@style\message{.}}} -%% % <- message 2010/11/13 -%% |\CopyLine| +%% % <- message 2010/11/13; 2011/08/22: +%% You should find a file `copyfile.tex' providing a dialogue +%% for ``compressing" files this way. As soon as you have a +%% useful conversion mapping file (defining |\TextCodes|), +%% you can also use it for text encoding conversions. +%% +%% |\CopyLine|: \newcommand*{\CopyLine}{\WriteResult\fdInputLine} %% (... added `\space' without success with macro arguments %% 2010/04/26 --- `\BlogCodes' has used a better solution @@ -214,13 +220,13 @@ \CopyLine} %% Another difference to some \ctanpkgref{verbatimcopy} %% is that `\CopyFile' really was meant to -%% be used for creating a HTML file from some \emph{number} of +%% be used for creating a \acro{HTML} file from some \emph{number} of %% sources, especially for shared head sections (however, %% I have used macros for this purpose so far), a navigation column, %% the main varying ``blog-like" content, and finally a shared %% footer section. %% In the meantime, however, I have chosen another variant -%% for generating HTML that +%% for generating \acro{HTML} that %% replaces an empty line by a line consisting of \verb+<p>+. %% %% |\CloseResultFile| closes <output>. @@ -985,5 +991,8 @@ v0.42 2010/11/09 typo corr. 2011/01/25 updated (C); footnotes to `substring theory'; TODO with \RemoveTilde; some manual line spacings (adding `\ ') +belonged to nicetext RELEASE 0.42 +v0.42a 2011/08/06 doc.: mistake \WriteResult/\ResultFile, + 2011/08/22 use \acro TODO: cleveref 2010/03/18 diff --git a/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg b/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg new file mode 100644 index 00000000000..5873581b871 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg @@ -0,0 +1,81 @@ +\ProvidesFile{makedoc.cfg}[2011/08/22 documentation settings] + +\author{Uwe L\"uck\thanks{\url{http://contact-ednotes.sty.de.vu}}} +% \author{Uwe L\"uck---{\tt http://contact-ednotes.sty.de.vu}} + +%% hyperref: +\RequirePackage{ifpdf} +\usepackage[% + \ifpdf +% bookmarks=false, %% 2010/12/22 +% bookmarksnumbered, + bookmarksopen, %% 2011/01/24!? + bookmarksopenlevel=2, %% 2011/01/23 +% pdfpagemode=UseNone, +% pdfstartpage=10, +% pdfstartview=FitH, + pdfstartview=0 0 100, %% 2011/08/22 + pdffitwindow=true, %% 2011/08/22 + citebordercolor={ .6 1 .6}, + filebordercolor={1 .6 1}, + linkbordercolor={1 .9 .7}, + urlbordercolor={ .7 1 1}, %% playing 2011/01/24 + \else + draft + \fi +]{hyperref} +%% metadata, |\MDkeywords|, |\MDkeywordsstring|, |\printMDkeywords| +%% 2011/08/22: +\makeatletter + \newcommand*{\MDkeywords}[1]{% + \gdef\MDkeywordsstring{#1}% + \hypersetup{pdfkeywords=\MDkeywordsstring}%% TODO!? + } + \@onlypreamble\MDkeywords + \newcommand*{\printMDkeywords}{% + \par\smallskip\noindent\strong{Keywords:}\quad + \MDkeywordsstring + \global\let\MDkeywordsstring\relax + } + \newenvironment{MDabstract} + {\abstract\noindent + \hspace{1sp}%% for niceverb + \ignorespaces} + {\@ifundefined{MDkeywordsstring}% + {}% + {\printMDkeywords}% + \endabstract} +\makeatother +\hypersetup{% + pdfauthor={Uwe L\374ck}% +} + +\RequirePackage{niceverb}[2011/01/24] +\RequirePackage{readprov} %% 2010/12/08 +\RequirePackage{hypertoc} %% 2011/01/23 +\RequirePackage{texlinks} %% 2011/01/24 +\RequirePackage{relsize} %% 2011/06/27 +\RequirePackage{color} %% 2011/08/06 +\makeatletter + \@ifundefined{strong} + {\let\strong\textbf} %% 2011/01/24 + {} + \@ifundefined{file} + {\let\file\texttt} %% 2011/05/23 + {} + \@ifundefined{acro} + {\let\acro\textsmaller} %% 2011/05/23 + {} + \@ifdefinable{\meta} + {\let\meta\textit} %% 2011/07/22 + \ifpdf + \pdfstringdefDisableCommands{\let\acro\textrm} + \fi + %% TODO 2011/07/22 -> `htlogml.sty' +\makeatother + +\errorcontextlines=4 +\pagestyle{headings} + +\endinput + diff --git a/Master/texmf-dist/tex/latex/nicetext/makedoc.sty b/Master/texmf-dist/tex/latex/nicetext/makedoc.sty index 93e14b8ffdb..89e1e2d8798 100644 --- a/Master/texmf-dist/tex/latex/nicetext/makedoc.sty +++ b/Master/texmf-dist/tex/latex/nicetext/makedoc.sty @@ -4,7 +4,7 @@ %% -- author-maintained in the sense of LPPL below -- %% for preparing documentations from packages. -\def\fileversion{0.41} \def\filedate{2011/01/25} +\def\fileversion{0.41a} \def\filedate{2011/08/22} %% This file can be redistributed and/or modified under %% the terms of the LaTeX Project Public License; either @@ -57,7 +57,8 @@ %% according to 'fifinddo'. %% %% It may be \emph{redefined} in a \emph{configuration} file like -%% 'makedoc.cfg' or the 'makedoc' script file applying to a single +%% 'mdoccorr.cfg' %% was makedoc.cfg 2011/08/22 +%% or the 'makedoc' script file applying to a single %% package file in order to, e.g., converting plain text to \TeX\ input %% conforming to typographical conventions, making `$\dots$' from %% \qtd{&.&.&.}, %% dots should not be replaced! @@ -65,7 +66,7 @@ %% Replace `LEAVE' in the previous suggestion by an identifier %% whose job you have defined before, and use `\renewcommand' %% in place of `\newcommand'. -%% See an example in 'makedoc.cfg'. +%% See an example in 'mdoccorr.cfg'. %% fixed 2011/08/22 %% %% You can \emph{test} your own `\MakeDocCorrectHook' by %% \[`\typeout{\MakeDocCorrectHook{<test-string>}}'\] @@ -588,3 +589,4 @@ v0.41 2010/12/20 \ResetCodeLineNumbers defined globally 2010/12/21 ... rather presented as a bug-fix 2011/01/19 \mdStartPackageCode 2011/01/25 updated (C) +v0.41a 2011/08/22 doc.: makedoc.cfg -> mdoccorr.cfg diff --git a/Master/texmf-dist/tex/latex/nicetext/niceverb.sty b/Master/texmf-dist/tex/latex/nicetext/niceverb.sty index 4afa3247703..2c4e0a7a9d1 100644 --- a/Master/texmf-dist/tex/latex/nicetext/niceverb.sty +++ b/Master/texmf-dist/tex/latex/nicetext/niceverb.sty @@ -1,5 +1,5 @@ \NeedsTeXFormat{LaTeX2e}[1994/12/01] -\ProvidesPackage{niceverb}[2011/01/26 v0.42 +\ProvidesPackage{niceverb}[2011/08/20 v0.43 minimize doc markup (UL)] %% Copyright (C) 2009-2011 Uwe Lueck, @@ -150,7 +150,8 @@ %% Turn off 'niceverb' specials: \MakeOther\|\MakeOther\`\MakeOther\'% \if_no_nice_meta_verb_ \MakeOther\<% - \else \MakeActiveLet\<\MetaVar %% 2010/12/31 + %%% \else \MakeActiveLet\<\MetaVar %% 2010/12/31 + \else \MakeActiveLetHere\<\MetaVar %% 2011/06/20 \fi \MakeActiveLetHere #1\niceverb_egroup \verb@eol@error %% TODO change message 2009/04/09 @@ -226,10 +227,12 @@ %% especially in \emph{macro arguments} %% 2010/03/05 %% and with 'hyperref' in titles of %% 2010/03/11 %% \emph{sections bearing \cs{label}s}, -%% so we provide something like |\cs{<characters>}| from 'doc.sty'. +%% so we provide something like |\cs{<characters>}| from +%% '\ctanpkgref{tugboat}.sty'. %% 'doc.sty'.%% corr. 2011/05/27 \DeclareRobustCommand*{\cs}[1]{% - \begin_min_verb \backslash_verb #1\egroup} + \begin_min_verb \backslash_verb #1\egroup} \newcommand*{\backslash_verb}{\char`\\} +%% %% 2011/06/27: undid 2011/05/27 %% Moreover, typing `&\par' in ``short" \emph{macro arguments} %% fails, you better type `\cs{par}' then. Likewise, %% `\cs{if<letters>}' and `\cs{fi}' is safer in case @@ -604,6 +607,14 @@ %% %% === When 'niceverb' Gets Nasty === %% These things are new with v0.3. +%% ==== Meta-Variables ==== +%% This is even newer than v0.3. %% 2011/05/09 +%% +%% In case you actually need $\lt$ and $\gt$ in math mode, +%% |\lt| and |\gt| are ``provided" as aliases: +\providecommand*{\gt}{>} +\providecommand*{\lt}{<} +%% %% ==== Quotes ==== %% %% WRONG 2010/03/05: %% % The left quote feature for meta-code requires that the right quote @@ -645,7 +656,7 @@ %% 2010/03/12 \MakeActiveLetHere\`\lq \MakeActiveLetHere\'\rq \MakeActiveLetHere\&\PDFcstring - \def\cs{\134}% %% 2010/03/17 + \def\cs{\134}% %% 2010/03/17, 2011/06/27 }% %% Moreover, in order to avoid spurious %% 2010/03/14 %% \texttt{Label(s) may have changed} with 'hyperref', @@ -787,3 +798,9 @@ v0.42 2010/12/30 corr. `\ ' emulation in auto mode 2011/01/19 `...' fix 2011/01/24 \ctanpkgref moves to texlinks.sty 2011/01/26 update (C) +with nicetext RELEASE r0.42 +v0.43 2011/05/09 \gt, \lt + 2011/05/27 \cs uses \@backslashchar + 2011/06/20 \MakeActiveLetHere in \nice_maybe_meta_verb !!! + 2011/06/27 2011/05/27 undone + 2011/08/20 `r0.42', `v0.43' diff --git a/Master/texmf-dist/tex/latex/nicetext/run/README-run.txt b/Master/texmf-dist/tex/latex/nicetext/run/README-run.txt new file mode 100644 index 00000000000..e4229bfc571 --- /dev/null +++ b/Master/texmf-dist/tex/latex/nicetext/run/README-run.txt @@ -0,0 +1,9 @@ +The .tex files can be run with latex ("script files"). +arseneau.tex and substr.tex demonstrate the "auto" feature +of makedoc.sty, see makedoc.pdf. +copyfile.tex and fdtxttex.tex are dialogues. +Replace copyfile.cfg by atari.cfg to get a conversion sample. +The .tpl files are templates for script files. +See FILEs.txt and fifinddo.pdf for additional informations. + +UL 2011-08-23 diff --git a/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex b/Master/texmf-dist/tex/latex/nicetext/run/arseneau.tex index 10b86dc6254..10b86dc6254 100644 --- a/Master/texmf-dist/doc/latex/nicetext/run/arseneau.tex +++ b/Master/texmf-dist/tex/latex/nicetext/run/arseneau.tex 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/doc/latex/nicetext/run/fdtxttex.tpl b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl index 9b97a0a9f7c..30f3978847f 100644 --- a/Master/texmf-dist/doc/latex/nicetext/run/fdtxttex.tpl +++ b/Master/texmf-dist/tex/latex/nicetext/run/fdtxttex.tpl @@ -1,4 +1,5 @@ -\typeout{fdtxttex.tpl 2010/03/30 fifinddo correction template} +\ProvidesFile{fdtxttex.tpl}[{2011/08/21 [2010/03/30] + fifinddo correction template}] \RequirePackage{fifinddo} \input{mdoccorr.cfg} \ResultFile{sample.tex} 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/doc/latex/nicetext/run/makedoc.tpl b/Master/texmf-dist/tex/latex/nicetext/run/makedoc.tpl index e508d8cded5..cd38f303933 100644 --- a/Master/texmf-dist/doc/latex/nicetext/run/makedoc.tpl +++ b/Master/texmf-dist/tex/latex/nicetext/run/makedoc.tpl @@ -1,4 +1,6 @@ -\typeout{makedoc.tpl 2010/03/23 makedoc correction template} +\ProvidesFile{makedoc.tpl}[{2011/08/23 + makedoc preprocessing template}] +\typeout{makedoc.tpl makedoc correction template} \RequirePackage{makedoc} \renewcommand*{\mdJobName}{SAMPLE} \input{mdoccorr.cfg} @@ -14,4 +16,4 @@ \expandafter{\fdInputLine}}% } \MakeCloseDoc{\mdJobName.TEX} -\stop
\ No newline at end of file +\stop diff --git a/Master/texmf-dist/doc/latex/nicetext/run/sample.txt b/Master/texmf-dist/tex/latex/nicetext/run/sample.txt index 69408f90fd8..69408f90fd8 100644 --- a/Master/texmf-dist/doc/latex/nicetext/run/sample.txt +++ b/Master/texmf-dist/tex/latex/nicetext/run/sample.txt diff --git a/Master/texmf-dist/doc/latex/nicetext/run/substr.tex b/Master/texmf-dist/tex/latex/nicetext/run/substr.tex index f876d173289..1974b2e15bf 100644 --- a/Master/texmf-dist/doc/latex/nicetext/run/substr.tex +++ b/Master/texmf-dist/tex/latex/nicetext/run/substr.tex @@ -1,4 +1,4 @@ -\typeout{substr.tex 2010/03/30 documentation for substr.sty} +\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 @@ -89,4 +89,5 @@ 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 |