diff options
Diffstat (limited to 'web/noweb/CHANGES')
-rw-r--r-- | web/noweb/CHANGES | 394 |
1 files changed, 394 insertions, 0 deletions
diff --git a/web/noweb/CHANGES b/web/noweb/CHANGES new file mode 100644 index 0000000000..9f01a042d2 --- /dev/null +++ b/web/noweb/CHANGES @@ -0,0 +1,394 @@ +CHANGES FOR VERSION 2.12 +l2h and sl2h now support rules from booktabs package +l2h and sl2h now deal with \suspend and \resume from package mdwlist +l2h and sl2h now deal with \verbatiminput package verbatim +note to FAQ about \usepackage[T1]{fontenc} +root Makefile now has a default target that complains bitterly (Allan Adler) +get xchunks to track source locations +fix bogon in Hacker's Guide: @index nl takes no argument +totex didn't handle @line +improved German text from Pascal Schmitt +l2h and sl2h now make -- – and --- — +brace fix for 2.11 broke [[}]]; now fixed +improved German text from Johannes Wiedersich (closes Debian #418892) +\usepackage{vmargin} not \usepackage{vpage} (Hubert Chan; closes Debian #420614) +added an optional argument to Emacs noweb-mode to support desktop-read (NR) +added an option to l2h/sl2h to convert LaTeX double-quote ligatures to HTML 4 entities +NR has a new address +changes to noweb-mode.el to make font-lock work better (Christian-Lynbeck) +C code now compiles with gcc -Wall -Werror, though tricks with rcsid make me blush +awkname script needed to update roff scripts and lib/pipedocs (Chloe Lopez) +Partial support for Icelandic (Johann Oskarsson <johann@myrkraverk.com>) +added Lee Wittenberg's custom-code filter to contrib/leew +the noweb-mode command now sets noweb-chunk-vector when run +fix nountangle script to support multiple filters (Anon Sricharoenchai) +noscript shell-script trick by Greyson Fischer (added to contrib) +'getline' renamed (now part of POSIX standard) (Brad Larsen) +added missing control sequences to nwmac.tex (Sergio Spina) +Aharon Robbins is now Arnold Robbins <arnold@skeeve.com> +Point to Jim Pettigrew's installation instructions for Windows 7 +noweb & other 25 yo scripts now quote shell variables correctly (Francky Leyn) +eliminated deprecated tmpnam() in favor of tmpfile(3) +Makefile now uses mkdir -p (to keep GNU Make from bleating) +added BSD-2 license (H/T Jonas Stein, Gentoo project) +Scripts no longer use insecure names in /tmp/; instead using mktemp + +CHANGES FOR VERSION 2.11b - released 12 Jun 2006 +Make noroff use -mm by default (Debian 218050) +Fixed flagrant errors in noweave -x -troff (but bad formatting remains) + +CHANGES FOR VERSION 2.11a - released 20 May 2006 +Clarify instructions for $PATH and $MANPATH (B Pierce) +Create examples/Makefile.awk (B Pierce) +Clarify documentation: unescaped << and >> not OK in docs chunk (R Hemmecke) +Add -lua option to docs2comments filter + +CHANGES FOR VERSION 2.11 - released 6 April 2006 +Braces did not render correctly in [[<<$\{a_i\}$>>]] (Albert Reiner) +From Kevin Quick, Windows hints and a new NOTANGLE.BAT +Generate postscript with -P cmz for better PDF (Francky Leyn) +Clarify for noweave -delay that the first doco chunk is before the first @ +extended xchunks with -summary argument +Line in a code chunk opening with unclosed, unescaped << is OK (Ralf Hemmecke) + +UNDO ME! Make docs2comments filter tolerate embedded @xref stuff.. +Added Windows XP help to FAQ (David Lemmon) +Noidx now calculates labels for a code chunk using the number of preceding + definitions from the same @file, not the overall number +Change wording for \noweboptions{german} (Christian Lindig) +Need to insert \leavevmode in \sublabel so that new \@bsphack will work right +From Yann Dirson, new filters in contrib/ydirson. +From Fr'ed'eric Lin'e, some improvements in French translation (apologies to Moli`ere) + +CHANGES FOR VERSION 2.10c - released 17 Jul 2002 + +Bug in noidx.nw caused tag NWD1 etc to be used in multiple files. +Cleaned up alignment tags in tables emitted by l2h.nw (Federico Di Gregorio) +Fixed some bugs in the HTML markup for the hacker's guide +Goes back to iconc, except for noidx.nw, which can't be compiled because + of the 32-bit polynomial arithmetic + +CHANGES FOR VERSION 2.10b - released 15 Jul 2002 + +Bug in xchunks.nw, around line 100 -- db never initialized (Stephen Edwards) +In local identifier cross-reference, enable breaks between pages + of multiply defined identifiers (option breakdefs) +Create a secret \noweboptions{breakcode} for those who want their + code chunks broken across page boundaries +German is `Benutzt' not `Benutztt' (Johannes Huesing) +No longer suggests iconc; compiling with icont is now the default. + +CHANGES FOR VERSION 2.10a - released 30 Mar 2001 + +Fixed problem in src/Makefile -- FAQ should be built by `source' not `all' + +CHANGES FOR VERSION 2.10 - released 16 Jun 2000, but not officially + +Added -matlab to nountangle (Uwe Brauer) +Added \nwblindhyperanchor to \weblabel (Andrew Swann) +Changed one more 'char c' to 'unsigned char c' in recognize.nw (Gilles ANDRE) +Change noweb.sty to support more than 26 code chunks on a page (F. Leyn) +l2h skips optional arguments with \includegraphics +fixed bugs in htmltoc having to do with nested anchors on one line +Added capacity for two more filters to noweave script +Fixed bug in autodefs.sml (including spaces in symbol chars) +Added autodefs.mmix +Added autodefs.asdl +Scripts for Plan 9 rc (Russ Cox) +Tinkered with noidx sortkey +Added \mbox{} to \nwnewline, so that spaces won't be eaten (John Cummings) +Added xchunks filter, per request of Mike Smith & Glenn Holloway +Replaced FORTH uniqueid heuristic with 32-bit CRC +Added pipedocs filter to pipe documentation chunks through commands +Added h2a (convert html to ascii) for use with pipedoces +Added docs2comments filter, with pipedocs and h2a, to replace nountangle +Added nwmtime filter; helps derive Zephyr web pages +Moved the official FAQ to html +Added multiple-language support to noweb.sty (Miguel Filgueiras) +notangle -L initial newline is a bug and will never be fixed (Harald Soleng) +Added \noweboptions{noxref}, intended for temporary use inside documents. + +CHANGES FOR VERSION 2.9a - released 16 Feb 1999 + +Fixed bug in htmltoc that left multiple toc anchors + + +CHANGES FOR VERSION 2.9 + +Good support for hypertext using the `hyperref' package +noweave now finds uses in quoted code, the better to exploit hypertext +added support for emacs font-lock highlighting as comments to noweb-mode (Adnan Yaqub) +Document common -L options on notangle man page (Brett Presnell) +Fixed incompatibility with verbatim package (Rafael Laboissiere) +added contrib/leyn from Francky Leyn +noweb-mode.el no longer treats @x as chunk end for non-white x (Chris Milner) +Don't use signed char to index array of 256 in recognize.nw (Michael Herrmann) +Added explanation for WNT to FAQ. +Support \ quoting in argument to elide +Support multiple -R options on the same notangle command line. +Change tohtml so that noweave -latex+html doesn't protect anchor texts + in a rawhtml environment (???) +Added to /usr/doc/noweb for Slackware binary distribution +Slackware binary distribution now includes emacs noweb mode. +Updated internal docs in support.nw to explain the great \nwlbrace trouble +Use gcc -ansi -pedantic in Makefiles. +Remove multicols environment from examples/wc.nw (Yotam Medini) +Change noweave and totex to support subscripting identifiers used in quoted code +Fixed bug in l2h (bad conversion of tables). +Make l2h of \section use CPS (for newline between \section and {) +Added letenv to l2h, and changed verbatim to use environment name as terminator + + +CHANGES FOR VERSION 2.8a + +noweave complains if you use -x with -index or -indexfrom +installation now includes noweb-mode.el +noroots no longer treats uses in quoted code as real uses (David Bruce) +file INSTALL now notes that 'awkname' is always needed (Robert Solovay) +file INSTALL now notes that texhash(1) may be needed (Robert Solovay) +mnt (noweb script) now complains about chunks named <<*>> (Robert Solovay) +lots of rcs identifiers and names everywhere +all man pages should carry version numbers +Use Stephen Parker's htmltoc, with many bug fixes and improvements. + + +CHANGES FOR VERSION 2.8 + +fixed unbalanced brace in support.nw for nwmac.tex (Hartmut Henkel) +changed notangle script so notangle -L preserves tabs (Saul London, NR) +changed uniqueid in noidx to avoid everything except letters, digits, + and a few known special chars. fixes the Norwegian bug (Hans + Husum) and also the non-Posix regexp (Christian Wagner) +update recognizer.nw to use 128-node recognizer for larger character sets + as per Christian Wagner +$arkopts -> $markopts for noweave -v +noweave now uses \documentclass for headers +fixed a bug in tohtml ``impossible character to skip'' +hacked \catcode \other for " in \setupcode, + which is better for german.sty even though \setupmodname is still wrong +added support for @fatal to all pipeline stages; + noweave and notangle now detect pipeline errors and exit nonzero +added Lee Wittenberg's changes to support.nw and totex.nw to support + printing of index identifiers in different fonts +updated documentation to be consisten with latex2e, e.g., talk about + the noweb 'package' not the 'document-style option'. + Kept nowebstyle(1) for backward compatability. +added \nextchunklabel to support dotNoweb (replaces its \chunklabel) +massive improvements to l2h, including support for tables +moved nowebstyle and nowebfilters man pages to section 7 +noweave -v shows @header and @trailer + + +CHANGES FOR VERSION 2.7d + +noweb.sty steals \{ and \} in chunk names. Bad dog! No biscuit! +Forgot to include [noweb] style in numarkup.nw +changed <- to <- in tohtml and l2h, and similarly for -> +HTML output of noweb tools is now weblint-clean +didn't properly skip <!-- ...> in tohtml +bug fix for bad indentation when chunk starts at beginning of line +added many more control sequences to l2h +added % l2h closure, makes nr's \secn, \fig, and the like possible. + + + +CHANGES FOR VERSION 2.7c + +Fixed bug in l2h, wasn't treating quotes in @use correctly. +Added -autodefs pascal (a hack) +Fixed bug in tohtml, with noweave -option longxref was showing uses twice +Fixed ``black magic'' claim in man page to refer to -option longxref... +Fixed tohtml to make placement of anchors nest properly when possible +Underscores in filenames are now in FAQ +Added the htmltoc command + + +CHANGES FOR VERSION 2.7b + +Changed module->chunk in error message 'undefined module name' +Added touch to `make source' in a forlorn attempt to eliminate once + and for all the problem of sources and derived sources with + identical timestamps +Added `make touch' in case CTAN screws up timestamps, and updated FAQ. +Disabled assertions in lexer (markmain.nw) +Added pointer to noweb home page to README +Mention sharpline in the man page entry for notangle -L +@@ in column 1 now stands for a single @ sign. +Change my address from Bellcore to Purdue. +Preliminary support for hypertext with hyper.sty. + +CHANGES FOR VERSION 2.7a + +Move @xrev prevdef and @xref nextdef to appear before @defn, to + support navigational aids as in Fraser and Hanson's book. + Requires changes in totex and tohtml to delay xref output. + Support.nw now makes long vs short a noweb option. +Hack noweave to pass -shortxref to backend on seeing `-option shortxref' +Offer shortxref support in tohtml. +Changed noidx to avoid putting anchor labels in empty documentation chunks. +Fixed bug in l2h; was treating saved ignore flag as text fun after copying bracket. +tohtml dumped core if it tried to warn of bad tag with null arg +Botched local definitions in autodefs files +SHELL=/bin/sh in Makefiles +Improvements in l2h, including multiple citations. +Fixed Makefile in xdoc to build techrep with wc.tex now that examples have moved +Fix bugs in awkname; thanks to Steven Ooms for the bug report and the fix. +In INSTALL, noted special awk problems for HP-UX users. +Change noweb.sty to use \textwidth, not \hsize, to place use/def markup +Fixed bug in -autodefs.c (confusion around static storage class) +Quoted code no longer makes l2h forget what mode it was in ($[[x]]+1$) +Uses in quoted code (e.g., [[<<exported functions>>]]) are now + formatted sensibly and with proper cross-reference. As a side effect, + lexical analysis is faster. + +CHANGES FOR VERSION 2.7 + +New directory structure, new Makefiles. +Distributing gzipped tar file instead of compressed shell archive. +Added l2h filter to convert latex to HTML. +Added -markup option to tools +contrib/norman now has a numarkup, which is markup for nuweb +Fixed unmarkup to handle nuweb chunks, which don't end in newlines. +The awk versions of filters are even more inferior to the Icon versions, + and they are barely tested. I will fix bugs as they are reported. + +CHANGES FOR VERSION 2.6d (which never left Bellcore) + +New copyright, intended to make it possible to sell CD-ROMs containing noweb +Revisions to the Noweb Hacker's Guide +Added 'elide' filter to icon directory. +Changed totex to turn a reference to ??? into one to nw@notdef +Commented out references to \code and \edoc in support.nw + (too chicken to eliminate them completely) +Changed lib/tohtml not to use the awk 'length' variable --- mawk barfs + (thanks to Bill Trost for bug report) +Changed tohtml not to plant anchor on < or & because that + could start an SGML tag (thanks to Bill Trost for bug report) +Awk version of tohtml used && in patterns; some awks couldn't handle it. + (thanks to Mark Smucker for bug report) +Changed \filename to \nwfilename to avoid conflicts with some latex2e packages +Help for the most frequent problems now in INSTALL. +Fixed a bug that bit noweave -index when there are multiple definitions + of an identifier; tag of first defn was repeated instead of + getting all tags (thanks to Michael Norrish for bug report). +noweave -html -x was producing local index stuff, but it shouldn't. +Decided -html shouldn't disable -noindex in noweave script +Improved tohtml so it needn't insert * for an anchor so often. +Changed notangle internally so it doesn't complain + if a chunk doesn't end with a newline (possible with nufront) +changed noweave so -index no longer forces a latex wrapper +Changed noidx so it won't use HTML specials in unique ids +Changes tohtml not to quote HTML in chunk names + + +CHANGES FOR VERSION 2.6c + +Added -v option to noweave to show the pipeline. +A preliminary Noweb Hacker's Guide. + +CHANGES FOR VERSION 2.6b + +Added -autodefs c + +Changed installation procedure so that source is no longer distributed +with contributed software --- you now must install noweb, then build +contributed software. + +Bug fixes: + + - Makefile didn't create .../man/man1 + - noweave botched -x option, emitted index info anyway + - markup complained, incorrectly, about [[<<]] in documentation. + - noidx died if it tripped over an identifier used only in quoted code + - tohtml wasn't inserting doc anchor into above_defns, so some xrefs + that should have read `above' were coming out `below' + - when one identifier was a prefix of another, as in + Class and Class::member, finduses duplicated the prefix. + + +CHANGES FOR VERSION 2.6a + +Fix bug in finduses that bit on the HP snake. + +CHANGES FOR VERSION 2.6 + +For the HTML support + - Invented lots of new @xref markup to support cross-referencing and + indexing in a formatter-independent way. + - Rewrote noidx and totex to push cross-reference and index support into + the back end. + - Adapted an HTML back end contributed by Bill Trost +Dave Love provided the bug fixes for latex2e. + +CHANGES FOR VERSION 2.5: + +Improved Source Code + +Several parts of the source code have been rewritten in noweb. I +especially call your attention to the contents of the shell, lib, and +tex directories. Reading tex/support.nw will help you tinker with +formatting. + + +Enhanced Latex Support + +Includes INCOMPATIBLE changes to options accepted by noweave (and +noweave's default behavior). noweb now supports an index of +identifiers and identifier cross-reference in a language-independent +way. For more information, see the man page for noweave, especially +the -index option. The man page for noindex tells how to build +indexes for large, multi-file documents. + +I have added a `noweb' command that acts much like Preston Briggs's +`nuweb'; it extracts all the source programs and also writes a LaTeX +document with full cross-referencing. See the man page for details. + +latex support has been improved by changes to noweave, the noweave +cross-referencer, and the noweb document-style option. Dave Love and +Jon Krom provided impetus for some of these changes in the best +possible way; they sent code. Improvements include: + -- noweave now generates latex headers by default. + -- Code chunks are broken across pages only when they are more than + a page long. (Thanks to Dave Love.) + -- Thanks to Dave Love, cross-referenced definitions that appear on + the same page are now numbered 7a, 7b, 7c, etc. (optionally 7.1, + 7.2, 7.3, or just plain 7; see the noweave man page). + -- There is a `noweb' pagestyle, which puts source-file names and + dates on the header line. It is the default page style for noweave. + -- noweave inserts no extra newlines, so the line numbers are the + same in the .tex and .nw files (Dave Love's suggestion; a major win). + -- By using noweave -delay, you can put a latex preamble in the + first documentation chunk, and noweave will delay \filename and + \begindocs until after the preamble, which becomes a WEB-like + ``limbo'' area (suggested by Dave Love, Jon Krom, and others). + -- noweave now has a -filter option that lets you name a + cross-referencer or prettyprinter on the command line. + You can try Jon Krom's cross-referencer by using + noweave -filter $LIB/noxref.krom + -- notangle has a -filter option that you can use to implement + slightly different semantics, such as Knuth's ``...'' + abbreviation convention. + -- The awk version of the cross-referencer is now almost as good as + the Icon version; the sole remaining difference is that the Icon + version ignores case when sorting; the awk version does not. + -- Bug fixes in noweave's handling of special characters in chunk names. + -- Many of the shell and awk scripts are now noweb files. + -- \chunklist is now \nowebchunks, and it need not appear on a line + by itself. \nowebindex provides an index. + -- The TeX support is now somewhat documented; see tex/support.nw + -- Support for latex's New Font Selection Scheme (whatever that is), + thanks again to Dave Love. + +Finally, Kostas Oikonomou has contributed a simple prettyprinter for +Icon programs, and Conrado Martinez-Parra has contributed a +prettyprinter for Dijkstra's language of guarded commands. I have +made both suitable for use with noweave -filter. + + +Bug Fix + +The code that was supposed to prevent a chunk from including itself +didn't work at all. So +<<*>>= +Forever <<*>> +@ made notangle very unhappy. |