2009-12-07 Andreas Kupries * * Released and tagged Tcllib 1.12 ======================== * 2009-07-21 Andreas Kupries * doctools.tcl: Fixed @mdgen instructions, added forgotten ownership reference to man.macros. See ActiveState Bug 83781, reported by Nicolas Castagne. Bumped to version 1.4.3. * docidx.tcl: See above, bumped to version 1.0.3. * doctoc.tcl: See above, bumped to version 1.1.2. 2009-03-30 Andreas Kupries * checker.tcl (manpage): Added new markup command for document references (manpage). For now formatted like a 'term'. * doctools.tcl: Fixed handling of include files. Search relative * doctools.man: to processed file, and run the command through 'subst' first, to resolve embedded commands (vset uses). Bumped to version 1.4.2. * docidx.tcl: Fixed handling of include files. Search relative * docidx.man: to processed file, and run the command through 'subst' first, to resolve embedded commands (vset uses). Bumped to version 1.0.2 * doctoc.tcl: Fixed handling of include files. Search relative * doctoc.man: to processed file, and run the command through 'subst' first, to resolve embedded commands (vset uses). Bumped to version 1.1.1. * docidx_lang_syntax.man: Added notes about command arguments. 2009-02-11 Andreas Kupries * checker_toc.tcl: TOC language extended to allow empty tocs, empty * docidx.test: divisions, and the mixing of items and divisions at * doctoc.tcl: every level. Extended testsuite. Updated documentation. * doctoc.test: Bumped version to 1.1. Fixed bug in the documentation * doctoc_lang_cmdref.man: of markup command 'item' (arguments were * doctoc_lang_intro.man: missing). * doctoc_lang_syntax.man: * doctoc.man: * pkgIndex.tcl: 2009-02-10 Andreas Kupries * checker_idx.tcl (index_end): Allow empty index (no keys). * docidx.tcl: Bumped package to vrsion 1.0.1. Updated the * docidx.test: documentation, where not already in alignment. * docidx_lang_intro.man: Extended testsuite. Fixed small typo * docidx_lang_syntax.man: orthogonal to this change. * pkgIndex.tcl: Fixes [SF Tcllib Bug 2557107]. 2009-01-29 Andreas Kupries * docidx.tcl: Extended the plugin APIs for all formats with a new * docidx_plugin_apiref.man: command "dt_read" to read a file's * doctoc.tcl: contents into a plugin. Modified the nroff plugins * doctoc_plugin_apiref.man: to inline the man.macros file into * doctools.tcl: their result instead of generating a * doctools.test: '.so man.macros' command. Stuart Cassoff * doctools_plugin_apiref.man: did the * mpformats/_nroff.tcl: work and provided the patches as part of * mpformats/fmt.nroff: his effort on making a Tcllib OpenBSD port. * mpformats/idx.nroff: * mpformats/toc.nroff: 2009-01-28 Andreas Kupries * checker.tcl: Fixed bug in handling 'category' command. Bumped * doctools.tcl: version to 1.4.1 * doctools.man: * pkgIndex.tcl: * changelog.man: Added 'category' information to all manpages. * cvs.man: * docidx.man: * docidx_intro.man: * docidx_lang_cmdref.man: * docidx_lang_faq.man: * docidx_lang_intro.man: * docidx_lang_syntax.man: * docidx_plugin_apiref.man: * doctoc.man: * doctoc_intro.man: * doctoc_lang_cmdref.man: * doctoc_lang_faq.man: * doctoc_lang_intro.man: * doctoc_lang_syntax.man: * doctoc_plugin_apiref.man: * doctools.man: * doctools_intro.man: * doctools_lang_cmdref.man: * doctools_lang_faq.man: * doctools_lang_intro.man: * doctools_lang_syntax.man: * doctools_plugin_apiref.man: * mpexpand.man: 2008-12-12 Andreas Kupries * * Released and tagged Tcllib 1.11.1 ======================== * 2008-12-01 Andreas Kupries * doctools.tcl: New command in doctools language is extended API. * doctools.man: Bumped minor version, to 1.4. * pkgIndex.tcl: 2008-11-26 Andreas Kupries * api.tcl: Extended doctools language with a 'category' * checker.tcl: command. This allows manpages to provide * doctools.tcl: a category string, like they already * doctools_lang_cmdref.man: provide keywords and see-also * doctools_lang_syntax.man: references. Updated all engines * mpformats/_common.tcl: to handle the command in some way. * mpformats/fmt.html: Bumped package version to 1.3.6. * mpformats/fmt.latex: Needed: Some tests to demo the * mpformats/fmt.list: handling of 'category'. * mpformats/fmt.nroff: * mpformats/fmt.null: * mpformats/fmt.text: * mpformats/fmt.tmml: * mpformats/fmt.wiki: * doctools.test: * tests/list/00: * tests/list/01: * tests/list/02: * tests/list/03: * tests/list/04: * tests/list/05: * tests/list/06: * tests/list/07: * tests/list/08: 2008-10-16 Andreas Kupries * * Released and tagged Tcllib 1.11 ======================== * 2008-07-08 Andreas Kupries * changelog.man: Bumped the packages to version 1. They have * changelog.tcl: been on 0 long enough. * cvs.man: * cvs.tcl: * docidx.man: * docidx.tcl: * doctoc.man: * doctoc.tcl: 2008-05-16 Andreas Kupries * checker.tcl (sectref): The way it was documented confused me and * doctools.tcl: the last change flipped identifying and text * doctools.man: argument, changing the meaning of sectref. Should * pkgIndex.tcl: have seen that quicker with how comm/comm_wire.man had to be updated. Fixed this now, restoring the proper order. Rewrote docs as well for better understanding. Bumped to version 1.3.5. * ../comm/comm_wire.man: Fixed the sectref argument order issues. * ../rcs/rcs.man: Fixed the sectref argument order issues. * ../snit/snitfaq.man: Fixed the sectref argument order issues. * ../tie/tie.man: Fixed the sectref argument order issues. 2008-05-15 Andreas Kupries * doctools.tcl: Bumped version to 1.3.4. * doctools.man: * pkgIndex.tcl: * checker.tcl: Reworked the (sub)section handling, enabled the * doctools_lang_cmdref.man: documentation writer to label (sub)sections with logical names and use these in references. Automatic logical names are improved, taking the current section into account, making for a better ambiguity check. References are now better as well. Backends are given unique physical (sub)section ids. Added a new formatting command 'sectref-external' for references to (sub)sections outside of the current document, to disable checking, and documented it. * docidx_plugin_apiref.man: Fixed the external section references * doctoc_plugin_apiref.man: in the manpages to prevent false warnings. * doctools_plugin_apiref.man: * mpformats/c.msg: Message catalogs extended with new warning * mpformats/de.msg: 'missingsect' for apparently dangling * mpformats/en.msg: (sub)section references. * mpformats/fr.msg: * mpformats/fmt.html: Updated the backends for the changes in the * mpformats/fmt.latex: frontend/backend API, and updated testsuite * mpformats/fmt.nroff: results. * mpformats/fmt.text: * mpformats/fmt.tmml: * mpformats/fmt.wiki: * mpformats/_common.tcl: * tests/latex/00: * tests/latex/01: * tests/latex/02: * tests/latex/03: * tests/latex/04: * tests/latex/05: * tests/latex/06: * tests/latex/07: * tests/latex/08: * tests/tmml/00: * tests/tmml/01: * tests/tmml/02: * tests/tmml/03: * tests/tmml/04: * tests/tmml/05: * tests/tmml/06: * tests/tmml/07: * tests/tmml/08: * tests/html/00: * tests/html/01: * tests/html/02: * tests/html/03: * tests/html/04: * tests/html/05: * tests/html/06: * tests/html/07: * tests/html/08: * mpformats/_nroff.tcl: Modified the nroff backend to convert * tests/nroff/03: (sub)section titles into uppercase in the output. Updated testsuite results. * checker.tcl: Reworked the (sub)section handling, enabled the documentation writer to label (sub)sections with logical names and use these in references. Automatic logical names are improved, taking the current section into account, making for a better ambiguity check. References are now better as well. Backends are given unique physical (sub)section ids. * mpformats/c.msg: Message catalogs extended with new warning * mpformats/de.msg: 'missingsect' for apparently dangling * mpformats/en.msg: (sub)section references. * mpformats/fr.msg: * mpformats/fmt.html: Updated backends for the changes in the * mpformats/fmt.latex: frontend/backend API. Nroff backend * mpformats/fmt.nroff: additionally modified to automatically * mpformats/fmt.text: convert (sub)section titles into uppercase. * mpformats/fmt.tmml: * mpformats/fmt.wiki: * mpformats/_common.tcl: * mpformats/_nroff.tcl: * mpformats/fmt.html (XrefLink): Now checking for and suppressing * doctools.tcl: self-referential links from the current output * doctools.man: file to itself exactly. Bumped version to 1.3.3. * pkgIndex.tcl: 2008-04-27 Andreas Kupries * mpformats/fmt.html: Gave title h1 tag a class. Put a div around * tests/html/*: the content of the synopsis section. Removed the div around examples. Their pre tag has a class, that is enough. Added default CSS styling to the code. Its definitions are derived from the CSS Joe English uses for the HTML generated by his TMML converter. Nice and simple. Thank you. * tests/man/08: All possible list types are in testcase 5 already. * tests/desc/08: Changed to demo all the commands in one file. * tests/html/08: This makes trying out styles for the HTML easier too * tests/latex/08: as everything can looked at in one file. * tests/list/08: * tests/nroff/08: * tests/null/08: * tests/text/08: * tests/tmml/08: * tests/wiki/08: * mpformats/fmt.html: Changed example formatting, removed the nested * tests/html/*: table structure. Changed toc and synopsis formatting to be more sematical, using classed unordered lists. Added classes to the list formatting. Removed hardwired linebreaks between last list element and end of list. Replaced linebreaks in list items with proper paragraph formatting. Fixed initialization error causing spurious para_close at the beginning. Added foundation for an internal style-sheet. No definitions yet however. 2008-04-26 Andreas Kupries * tests/man/08: Added test demonstrating all possible list types. * tests/desc/08: * tests/html/08: * tests/latex/08: * tests/list/08: * tests/nroff/08: * tests/null/08: * tests/text/08: * tests/tmml/08: * tests/wiki/08: 2008-04-23 Andreas Kupries * tests/man/02: Added see_also and keyword references to this * tests/html/02: example. Updated all changed results. * tests/latex/02: * tests/list/02: * tests/nroff/02: * tests/text/02: * tests/tmml/02: * tests/wiki/02: 2008-04-21 Andreas Kupries * mpformats/fmt.html: Modified to put sections and subsections * mpformats/_html.tcl: into divisions a CSS can lock onto. Changed * tests/html/*: to properly close paragraphs, sections, and sub- sections. Changed to remove empty paragraphs, and empty lines. Put the whole body into a division. Put text marked up as optional into a span. Put section references into a span. Put examples into a division. Some general cleanup of the internals. 2008-04-19 Andreas Kupries * tests/*/06: Extended for nested lists. * tests/*/07: 2nd input and results for nested lists. * mpformats/_nroff.tcl (nr_vspace): Added newlines to output for proper formatting of text coming after it. * tests/syntax/e_*: Additional input and result files, completing * tests/syntax/r_*: the list errors. Ditto the example commands, sectref, and the commands for the semantic categories. 2008-04-17 Andreas Kupries * doctools.test: Extended with loop to test response to the various * tests/syntax/e_*: syntax errors we may find in doctools files, plus * tests/syntax/r_*: first set of input files and error results. * checker.tcl: Modified errors for commands which are allowed everywhere in the header section since the extended syntax came into effect. 2008-04-14 Andreas Kupries * doctools.test: Fixed [Bug 1942472], reported by Michael * tests/latex/00: Schlenker, in made with the new test cases. * tests/latex/01: Now mapping the name of the user running * tests/latex/02: the tests around in the expected and * tests/latex/03: actual results as well. Modified the * tests/latex/04: expected results for the one backend * tests/latex/05: affected by the change. * tests/latex/06: 2008-04-13 Andreas Kupries * doctools.test: Added the remaining backends to the list of backends checked. * tests/tmml/00: Expected results for TMML backend. * tests/tmml/01: * tests/tmml/02: * tests/tmml/03: * tests/tmml/04: * tests/tmml/05: * tests/tmml/06: * tests/text/00: Expected results for TEXT backend. * tests/text/01: * tests/text/02: * tests/text/03: * tests/text/04: * tests/text/05: * tests/text/06: * tests/wiki/00: Expected results for WIKI backend. * tests/wiki/01: * tests/wiki/02: * tests/wiki/03: * tests/wiki/04: * tests/wiki/05: * tests/wiki/06: * tests/latex/00: Expected results for LATEX backend. * tests/latex/01: * tests/latex/02: * tests/latex/03: * tests/latex/04: * tests/latex/05: * tests/latex/06: * tests/desc/00: Expected results for DESC backend. * tests/desc/01: * tests/desc/02: * tests/desc/03: * tests/desc/04: * tests/desc/05: * tests/desc/06: * tests/list/00: Expected results for LIST backend. * tests/list/01: * tests/list/02: * tests/list/03: * tests/list/04: * tests/list/05: * tests/list/06: * tests/null/00: Expected results for NULL backend. * tests/null/01: * tests/null/02: * tests/null/03: * tests/null/04: * tests/null/05: * tests/null/06: * tests/html/00: Replaced $ I d $ placeholder with @ID@. See * tests/html/01: doctools.test. * tests/html/02: * tests/html/03: * tests/man/04: Replaced placeholder text with actual input to * tests/man/05: run through the formatting backends. * tests/man/06: * tests/html/04: Made results current. The handling of * tests/html/05: backslashes is known to be wrong, noted * tests/html/06: other ugliness. * tests/nroff/04: Made results current, fixed some formatting * tests/nroff/05: problems, see below. * tests/nroff/06: * mpformats/fmt.nroff (fmt_arg_def, fmt_opt_def): Added newlines to output for proper formatting of elements in argument and option lists. * doctools.test: Fix handling of $ I d $ placeholder used in input files and expected results. Extended to handle errors, to catch problems other than differences between expected and actual results. Ignore CVS subdirectory and handle missing files for expected results. 2008-03-31 Andreas Kupries * doctools.test: Added tests to invoke the backends on a series of input files and check the results against expectations. * tests/man/00: First set of input files, and expected output for * tests/man/01: the html and nroff backends. * tests/man/02: * tests/man/03: * tests/man/04: * tests/man/05: * tests/man/06: * tests/html/00: * tests/html/01: * tests/html/02: * tests/html/03: * tests/html/04: * tests/html/05: * tests/html/06: * tests/nroff/00: * tests/nroff/01: * tests/nroff/02: * tests/nroff/03: * tests/nroff/04: * tests/nroff/05: * tests/nroff/06: 2008-03-12 Andreas Kupries * checker.tcl (widget): Fixed bad call propagation. 2008-03-08 Andreas Kupries * doctools.tcl: Code cleanup, giving all upvar commands an * docidx.tcl: explicit level argument. Bumped all version * doctoc.tcl: numbers by one patchlevel. doctools -> 1.3.2, * cvs.tcl: doctools::toc -> 0.3.1, doctools::idx -> 0.3.1, * changelog.tcl: doctools::cvs -> 0.1.2, * pkgIndex.tcl: doctools::changelog -> 0.1.2 * docidx.man: * doctoc.man: * doctools.man: * cvs.man: * changelog.man: 2007-09-25 Andreas Kupries * doctools.tcl: Extended processor to pass the pass number to the * checker.tcl: checker layer as well. Modified the checker layer * pkgIndex.tcl: to suppress generation of warnings in all but the * doctools.man: first pass, to avoid replication. Bumped version to 1.3.1. This fixes [SF Tcllib Bug 1800413]. * mpformats/fmt.nroff: Fixed argument swap in fmt_arg_def, fixing [SF Tcllib Bug 1800420]. * mpformats/fmt.html: Handled [SF Tcllib Bug 1800408] and [SF Tcllib Bug 411], removing superfluous whitespace around link text and adding more class names to semantic markup. 2007-09-20 Andreas Kupries * mpformats/fmt.html: Added closing of paragraphs per the request in [SF Tcllib Bug 1798427]. Tis more complicated. Paragraphs inside of list elements are not yet closed. * mpformats/fmt.html: Reworking handling of list items a bit to properly close the dt, dd, and li tags. Requested by [SF Tcllib Bug 1798427]. 2007-09-12 Andreas Kupries * * Released and tagged Tcllib 1.10 ======================== * 2007-08-20 Andreas Kupries * doctools.tcl: Bumped versions to 1.3 and 0.3 respectively to * docidx.tcl: reflect the extended syntax and bugfixes listed * doctoc.tcl: below. * doctools.man: * docidx.man: * doctoc.man: * pkgIndex.tcl: 2007-08-02 Andreas Kupries * mpformats/fmt.latex: Further reworking of the backend internals for proper quoting of TeX special characters, prevention of double-quoting, and markup of wanted special characters. Further removed the use of 'quote' environments. Not needed for the formatting and its use restricts the nesting of lists to three levels. Without we can nest seven levels. Final fixes for [Tcllib SF Bug 1766381]. * mpformats/fmt.text: Fixed handling of 'cmd_def'. * mpformats/fmt.tmml: Fixed handling of nested lists. * mpformats/fmt.latex: Fixed handling of list_end, was not updated to the new list type codes. * mpformats/fmt.latex: Fixed handling of ^ character. Has to be escaped in regular text. Fixed handling of keywords and references (see also). May contain special character in need of escaping. Quote backslashes in paths. Fixes for [Tcllib SF Bug 1766381.] 2007-08-01 Andreas Kupries * doctools.test: Updated test 8.4 for changes in the formatting of warnings. 2007-03-20 Andreas Kupries * apps/dtplite: Added a block of meta data. 2007-03-20 Andreas Kupries * mpformats/fmt.wiki: Added MD pragma excluding a bogus dependency from consideration. 2007-03-19 Andreas Kupries * doctoc.tcl: Extended MD pragmas declaring the ownership of * docidx.tcl: various non-code files. * doctools.tcl: * support/devel/sak/doc/doc.tcl: Modified to print warnings even if processed was stopped by an error. * mpformats/c.msg: Added messages for a set of newly deprecated * mpformats/de.msg: commands and list types. Added proper umlauts * mpformats/en.msg: to the german messages. * mpformats/fr.msg: * doctools.tcl: Added a plugin API command (dt_where), providing information about the current location, to provide location data to warnings. * checker_toc.tcl: Language change (doctoc, docidx). Comments in * checker_idx.tcl: the input are now swallowed by the checker layer and not propagated to the backend anymore. * checker.tcl: Language changes. -- Comments are swallowed, backends do not see them anymore. -- 'require'ments an now go everywhere in the header, not only after the 'desc'riptions. -- Warnings now have location information. -- The list types 'bullet', 'arg', 'opt', 'cmd', and 'tkoption' are now deprecated. They are replaced by 'itemized', 'arguments', 'options', 'commands', and 'tkoptions', and their short forms 'items', 'args', 'opts', and 'cmds'. -- 'para' can now be used inside of lists. Conversely 'nl' works outside of lists too. The two commands are identical now, and 'nl' is deprecated. -- The list entry command 'lst_item' has been deprecated, replaced by 'def'. Additionally the possible misspellings 'list_item', 'listitem', and 'lstitem' of the old command are recognized now too, albeit also considered to be deprecated. -- The list entry command 'bullet' is deprecated, replaced 'item'. -- The commands 'see_also' and 'keywords' can now go anywhere in the document, not only after the header. Note that everything which was made deprecated is still accepted as valid input, however their use does cause the generation of warnings. This means that the language after the changes is a proper superset of the language before it. Old documents can be processed just fine with the new code. * mpformats/fmt.html: Use the new list types for translation. * mpformats/fmt.latex: * mpformats/fmt.text: * mpformats/fmt.tmml: * mpformats/fmt.nroff: Add a para when closing an inner list. * mpformats/idx.html: Rewritten to be single-pass, defering output until the index is closed. Changed to ensure that keywords are printed alpha-sorted (lsort -dict). Added navigation bar and sectioning of the index. * apps/dtplite: Added a format 'validate' as alias for 'null', * apps/dtplite.man: both of these now do not require an output specification anymore. Added the collection and printing of warnings. Replaced the homegrown commands for the reading and writing of files with calls to fileutil commands. Now processing input files in alphabetical order. Put common code for doctoc and docidx generation into a small set of commands. toc and idx are now sorted by description/keyword, output is column-aligned. The doc* output is saved, to serve as examples. Document titles are now cross-referencable via 'term', allowing direct links between documents. Comments about internals added. Documentation updated for the new functionality, and fixed all warnings due to use of deprecated commands and list types. Added a section on how to give feedback. * cvs.man: Fixed all warnings due to use of deprecated commands * changelog.man: and list types, tweaked the titles, and added sections about how to give feedback. * docidx.man: Significant rewrites for better language, better * doctoc.man: referencing of introductory documents. Tweaked the * doctools.man: titles, and added sections about how to give feedback. * docidx_api.man: *** REMOVED *** old documentation about the * docidx_fmt.man: languages and plugin APIs. * doctoc_api.man: * doctoc_fmt.man: * doctools_api.man: * doctools_fmt.man: * docidx_intro.man: *** ADDED *** new documentation about the * docidx_lang_cmdref.man: languages and plugin APIs, with basic * docidx_lang_faq.man: introductions, cross-referencing to * docidx_lang_intro.man: related documents, further readings, * docidx_lang_syntax.man: introduction by example, first * docidx_plugin_apiref.man: beginning of faqs. * doctoc_intro.man: * doctoc_lang_cmdref.man: * doctoc_lang_faq.man: * doctoc_lang_intro.man: * doctoc_lang_syntax.man: * doctoc_plugin_apiref.man: * doctools_intro.man: * doctools_lang_cmdref.man: * doctools_lang_faq.man: * doctools_lang_intro.man: * doctools_lang_syntax.man: * doctools_plugin_apiref.man: 2006-10-25 Andreas Kupries * doctools.test: Added an explicit LANG=C setting to the tests. * docidx.test: At least OS X needs the setting to behave correctly. * doctoc.test: Thanks to Gustaf Neumann for the report. 2006-10-08 Andreas Kupries * doctools.test: Rewritten to use new features for handling the * docidx.test: environment. * doctoc.test: 2006-10-03 Andreas Kupries * * Released and tagged Tcllib 1.9 ======================== * 2006-10-02 Andreas Kupries * doctools.test: Made the testsuite robust against locale * doctoc.test: settings in the environment. The tests * docidx.test: assume the default locale (LANG=C). 2006-09-19 Andreas Kupries * doctools.man: Bumped version to 1.2.1 * doctools.tcl: * pkgIndex.tcl: 2006-08-10 Andreas Kupries * mpformats/_text.tcl: Replaced textutil with the exact packages * mpformats/fmt.text: needed, and adjusted all callers to use the long command names. 2006-06-16 Andreas Kupries * ../../apps/dtplite: Still found a xref link bug in the -merge code path. The per-module toc had the wrong links. Added code to generate and set a proper file mapping for these tocs. Removed MapLink and switched to the new command "fileutil::relativeUrl". 2006-03-13 Andreas Kupries * mpformats/_nroff.tcl: Do not double-quote (sub)section titles if they do not contain whitespaces. 2006-01-28 Andreas Kupries * doctools.test: Fixed use of duplicate test names 2006-01-22 Andreas Kupries * docidx.test: More boilerplate simplified via use of test support. * doctoc.test: * doctools.test: 2006-01-19 Andreas Kupries * docidx.test: Hooked into the new common test support code. * doctoc.test: * doctools.test: 2005-10-06 Andreas Kupries * * Released and tagged Tcllib 1.8 ======================== * 2005-10-03 Andreas Kupries * checker.tcl: Added code checking for ambiguities in section * mpformats/c.msg: and subsection titles. It causes warnings. * mpformats/en.msg: Extended the message catalogs with strings for * mpformats/de.msg: the new warning. * mpformats/fr.msg: 2005-06-17 Andreas Kupries * mpformats/_common.tcl (c_sectionId): Converting quotes into underscores. Fixes [SF Tcllib Bug 1220089]. 2005-06-06 Andreas Kupries * mpformats/fr.msg: Fixed [Tcllib SF Bug 1213636], reported by , by removing the incorrect english strings preceding the french ones. 2005-04-13 Andreas Kupries * doctools.test: Testsuite package requirements fixed to ensure * docidx.test: use of local packages. * doctoc.test: * doctools.tcl: Typo police. * docidx.tcl: * doctoc.tcl: 2005-02-18 Andreas Kupries * mpformats/_nroff.tcl: Fixed problem with comment handling. Before the fix we could generate output where nroff would misinterpret a string in apostrophes at the beginning of a line as comment. Regular comments now have the special \1 quoting for markup. * fmt.nroff: Fixed list processing. The commands stating list items needed newlines to ensure proper separation if the input has text immediately following the command, and not on the next line. Superfluous newlines coming from text stating in the next line is automatically excised during post-processing. 2005-01-17 Andreas Kupries * mpformats/_nroff.tcl: Extended the post processing to regularize confusing *roff formatting at the beginning of lines. This fixes Tcllib SF Bug 1094294, which was reported by Rolf Ade . 2005-01-11 Andreas Kupries * mpformats/fmt.nroff: Fixed bad nroff formatting for examples * mpformats/_nroff.tcl: with explicit start/end commands. 2004-11-01 Andreas Kupries * mpformats/fmt.html (fmt_namespace): Added HTML backend code for the namespace command. 2004-10-05 Andreas Kupries * * Released and tagged Tcllib 1.7 ======================== * 2004-09-23 Andreas Kupries * mpformats/_text.tcl: Fixed expr'essions without braces. 2004-09-21 Andreas Kupries * mpformats/fmt.nroff: Removed superfluous nr_rst calls inserted at the end of a command, by the commands 'call', and 'usage'. 2004-07-30 Andreas Kupries * mpformats/_common.tcl: Made section references * mpformats/fmt.html: insensitive to case of * mpformats/fmt.latex: the refering text. Also * mpformats/fmt.nroff: now allowing an optional * mpformats/fmt.text: label to the reference * mpformats/fmt.tmml: a different text than * mpformats/fmt.wiki: the section title. Updated * doctools_fmt.man: the format and api specifi- * doctools_api.man: cations. * checker.tcl: 2004-07-29 Andreas Kupries * mpformats/idx.html: Changed index table to use top alignment. * doctools.man: Full overhaul of the documentation * doctools_api.man: pertaining to doctools, format, engine * doctools_fmt.man: api, and framework package. * docidx_fmt.man: Typo fixes. * doctoc_fmt.man: * doctools.test: Updated to changes in error processing made * doctoc.test: on 2004-07-22 (See below). * docidx.test: 2004-07-24 Andreas Kupries * docidx_fmt.man: More overhaul. * docidx_api.man: * doctoc_fmt.man: * doctoc_api.man: * doctoc.man: * doctools_fmt.man: * doctools_api.man: * doctools.man: * changelog.man: * cvs.man: 2004-07-23 Andreas Kupries * docidx_api.man: Overhaul. * docidx.man: * ../../apps/dtplite: Revamped the whole file mapping. Actually ripped it out. Is not needed, the formatting engine does the necessary parts for us, if we feed it the correct -file options. This kills the outstanding bug with xref links. * ../../apps/dtplite: Bugfix. Added checks to prevent duplicate entries in the keyword index. Without these checks going through a set of packages twice for merging will create double links for each actual entry. Changed the representation of the index saved between merge invokations to keep the array for the voiding of duplicates around. * docidx.man: Overhaul of documentation. * cvs.man: * changelog.man: 2004-07-22 Andreas Kupries * ../../apps/dtplite: Reduced error output, show only the message, not the whole stack. * doctools.tcl: Changed processing of error messages so that * doctoc.tcl: we don't loose the location information. * docidx.tcl: 2004-07-22 Andreas Kupries * doctools_api.man: Polished the manpages a bit, * ../../apps/dtplite.man: for better cross-referencing. * mpformats/fmt.html: Fixed initialization bug regarding cross-references. Added xref matching to the formatting commands 'term' and 'package'. Extended matching to allow multiple prefixes, and to search for the word in lowercase. 2004-07-20 Andreas Kupries * apps/dtplite.man: New application for doctools processing. * apps/dtplite: Supercedes 'mpexpand'. Will be installed. * mpformats/idx.html: Added engine parameter 'kwid', allowing the external definition of anchor names for keywords instead of having them generated automatically. Required for persistence when extending an existing index. * mpformats/fmt.html: Added eols to the table of contents for better readability of the generated HTML. * mpformats/toc.nroff: Fixed bad markup in genration of * mpformats/idx.nroff: tocs and indices. Internal markers were not stripped out. * mpformats/toc.wiki: * mpformats/toc.tmml: * mpformats/toc.text: * mpformats/toc.nroff: * mpformats/toc.html: * checker_toc.tcl: Extended 'division_start' formatting command * doctoc_fmt.man: with an optional second argument, a symbolic file reference. Create a link to this file from the division label, if supported by the format. Where not the second argument will be ignored. 2004-07-10 Andreas Kupries * docidx.man: Fixed [Tcllib SF Bug 985601]. A number * doctoc.man: of options (-copyright) and methods (map, * doctools.man: parameters, setparam) were not documented, * docidx_api.man: nor the engine parameters supported by the * doctoc_api.man: predefined html formatters (header, footer, * doctools_api.man: meta, xref). This is no longer the case. 2004-05-30 Andreas Kupries * mpexpand.man: Updated reference 'dtformat' to 'doctools_fmt'. 2004-05-23 Andreas Kupries * doctools.tcl: Updated version number to distinguish from the * doctools.man: 1.6.1 release. * pkgIndex.tcl: 2004-05-23 Andreas Kupries * * Released and tagged Tcllib 1.6.1 ======================== * 2004-05-23 Andreas Kupries * doctools.tcl: Rel. engineering. Updated version number * doctools.man: of doctools to reflect its changes, to 1.0.2. * pkgIndex.tcl: 2004-05-14 Andreas Kupries * doctools.tcl: Fixed a bug in the namespace implementation * checker.tcl: (RFE 943145, see below). Cannot use 'namespace' in checker, it uses msgcat, uses in turn the builtin, overwriting is bad. Have to handle this specially (New name, rewrite to new name) before handing the macro over to the expander. * doctools.tcl: Implemented [SF Tcllib RFE 772490] for * checker.tcl: doctools, the addition of 'subsections' * mpformats/_common.tcl: to the language. Updated the main engine, * mpformats/_nroff.tcl: the validator subsystem, and all formatting * mpformats/_text.tcl: engines which are coming with the package. * mpformats/fmt.html: For HTML output subsections are added to * mpformats/fmt.latex: the TOC (See [SF Tcllib RFE 772491] below) * mpformats/fmt.nroff: as well. * mpformats/fmt.null: * mpformats/fmt.text: * mpformats/fmt.tmml: * mpformats/fmt.wiki: 2004-05-14 Andreas Kupries * mpformats/_text.tcl (SECT): Fixed a small problem in the text generator which was present for ages. Titles of more than one word would have braces around them. Not fatal but also not so nice looking. It was an argument versus argument list thing. Adding a lindex in the proper place gets rid of the additional level of quoting. 2004-05-04 Andreas Kupries * mpformats/fmt.html: Implemented [SF Tcllib RFE 772491]. Added the generation of a table of contents at the beginning of the html output for quick jumps to the various parts of the documentation. * checker.tcl: Accepted [SF Tcllib RFE 946856], an * doctools_fmt.man: extension of the uri command to allow * doctools.tcl: labels. Updated documentation, added * mpformats/fmt.html: added to highlevel implementation, * mpformats/fmt.latex: updated all predefined formatters. * mpformats/fmt.nroff: * mpformats/fmt.null: Accepted [SF Tcllib RFE 943145] as * mpformats/fmt.text: well, adding a namespace markup. * mpformats/fmt.tmml: * mpformats/fmt.wiki: * mpformats/_nroff.tcl: Fixed [SF Tcllib Bug 943146]. Added markup * mpformats/fmt.nroff: protection code like already in use for HTML and XML to handle nroff's special characters, i.e. the backslash properly. Also fixed handling of leading dashes in 'opt_def'. 2004-04-22 Joe English * mpformats/fmt.xml: BUGFIX: "puts stderr" ==> "puts_stderr". 2004-02-15 Andreas Kupries * * Released and tagged Tcllib 1.6 ======================== * 2004-02-09 Andreas Kupries * doctools.test: Fixed problems with Tcl 8.5, the tests were dependent on the order of keys in the result of [array get]. 2003-10-21 Andreas Kupries * mpformats/fmt.wiki (fmt_manpage_end): Fixed usage of wrong variable ('copyright' was used, should have been 'ct'). [Bug 826206]. 2003-06-06 Andreas Kupries * mpformats/fr.msg: Added french message catalog. Supplied by David Zolli , aka kroc. This is tracker item [Bug 744149]. 2003-05-23 Andreas Kupries * mpformats/fmt.nroff (fmt_arg_def, fmt_cmd_def): Analogous errors to fmt_opt_def, see below. Fixed. Reported by David Welton. 2003-05-21 Andreas Kupries * mpformats/fmt.nroff (fmt_opt_def): Fixed bug. Called [option], should have been [fmt_option]. Prevented the nroff conversion of the multiplexer documentation. Reported by David Welton. 2003-05-05 Andreas Kupries * * Released and tagged Tcllib 1.4 ======================== * 2003-04-01 Andreas Kupries * checker_toc.tcl: Bug fixes for handling of nested toc divisions. * ../../examples/doctools/doctools.idx: * ../../examples/doctools/doctools.toc: Updated to reflect latest changes in the format definitions. * doctoc.tcl: * docidx.tcl: Added the package and file ops initially created in doctools.tcl to these packages too, so that their text engines can use 'textutil' too. * mpformats/_text.tcl: * mpformats/fmt.text: * mpformats/toc.text: * mpformats/idx.text: Bug fixes. 2003-03-31 Andreas Kupries * mpformats/toc.text: * mpformats/idx.text: New files, toc & index formatting in plain text. * mpformats/_text.tcl: * mpformats/fmt.text: Moved processing of plain text into the generic part. 2003-03-31 Andreas Kupries * cvs.tcl (scanLog): Applied fix for Bug #712951 reported by Joe English . 2003-03-29 Andreas Kupries * doctools.tcl (SetupFormatter): Moved error output command to the front, so that the code loading the engine can use it too, and not only the engine procedures. Added alias for 'file', and a special command which is a shortcut for 'package require' so that engines can load packages. This was required for the plain text engine which makes heavy use of the formatting commands in 'textutil'. Added setup of 'ctopandclear'. (SetupChecker): Added setup of 'ctopandclear'. (Package, Locate): New commands supporting package require. Instead of trying to enable every command in the safe interpreter required for package management we use the standard package commands to locate the index for thr requested package and evaluate just that in the safe interpreter, after temporarily enabling source and load commands. * checker.tcl: Added code for debugging, like already present in the files checker_doc*.tcl. * mpformats/_text.tcl: Core for plain text engines. * mpformats/fmt.text: New engine. Generates output in plain text. 2003-03-28 Andreas Kupries * pkgIndex.tcl: added 'doctools::cvs' and 'doctools::changelog' to the package index. * changelog.man: * changelog.tcl: New. Parsing of ChangeLogs into list structures, merging of multiple logs, conversion into a doctools document. The code for parsing came originally out Makedist_SupportAku, a private package extending my Makedist tool. Documented the code. * cvs.tcl (toChangeLog): Using the new textutil commands 'indent' and 'undent' for proper alignment of the comments extracted from the log. 2003-03-27 Andreas Kupries * cvs.man: * cvs.tcl: Added code to handle parsing and reformatting of cvs log files. Origin of the code the tcl'ers wiki, page http://wiki.tcl.tk/log2changelog. The actual original author is unknown (not listed on the wiki). 2003-03-24 Andreas Kupries * doctools_fmt.man: Fixed documentation bug #704187 reported by Roy Terry . 2003-03-13 Andreas Kupries * checker.tcl: Fixed incorrect signature of 'usage'. * mpformats/fmt.null: Bugfix in naming of the procedures. 2003-03-13 Andreas Kupries * mpformats/_common.tcl: Fixed initialization error for cross-references causing unwanted suppression (leakage of definitions between multiple pages). * doctoc.tcl: Bug fixes in three return statemments. * docidx.tcl: (return -code error string, not return -code string) * doctools.tcl: 2003-03-11 Andreas Kupries * mpformats/fmt.html: Rewrite handling of [keywords] and * mpformats/fmt.latex: [see_also] to behave like for the TMML * mpformats/fmt.list: formatter: Collect all keywords and * mpformats/fmt.nroff: x-references during the first pass, insert * mpformats/fmt.wiki: the results during the second pass, in [manpage_end]. Ensures that at most one see_also / keyword section is present, ensures uniform order and handling of multiple keyword / see_also commands is now uniform too. * examples/doctools.idx: Moved to the new examples/doctools * examples/doctools.toc: directory. Thanks to Larry Virden for pointing out that the original location in the doctools module violated the principle of collecting examples in a separate directory, instated by myself. Stupid me. 2003-03-04 Andreas Kupries * A examples/doctools.idx: Fairly extensive revamping of the * A examples/doctools.toc: codebase. Added a format for * A mpformats/_idx_common.tcl: indices, formatting engines, a * A mpformats/_toc_common.tcl: package for handling it. Extended * A mpformats/idx.html: all packages to allow engine * A mpformats/idx.nroff: parameters and mapping from * A mpformats/idx.null: symbolic to actual filenames or * A mpformats/idx.wiki: urls. Right now only the HTML * A mpformats/toc.html: engines actually provide * A mpformats/toc.nroff: parameters. Added testsuites for * A mpformats/toc.null: doctoc and docidx. Revamped the * A mpformats/toc.tmml: documentation to cross-reference * A mpformats/toc.wiki: each other better, more uniform in * A api_idx.tcl: structure (not complete), naming of * A api_toc.tcl: the manpages for this module is now * A checker_idx.tcl: uniform. Added examples for doctoc * A checker_toc.tcl: and docidx formats, both in the * A docidx.man: manpages, and as separate files. * A docidx.tcl: * A docidx.test: * A docidx_api.man: * A docidx_fmt.man: * A doctoc.man: * A doctoc.tcl: * A doctoc.test: * A doctoc_api.man: * A doctoc_fmt.man: * A doctools_api.man: * A doctools_fmt.man: * A tocexpand: * M ChangeLog: * M NOTES: * M api.tcl: * M checker.tcl: * M doctools.man: * M doctools.tcl: * M doctools.test: * M pkgIndex.tcl: * M mpformats/_common.tcl: * M mpformats/_nroff.tcl: * M mpformats/c.msg: * M mpformats/de.msg: * M mpformats/en.msg: * M mpformats/fmt.html: * M mpformats/fmt.latex: * M mpformats/fmt.list: * R dtformat.man: * R dtformatter.man: 2003-02-16 Andreas Kupries * mpformats/fmt.list: Modified to extract all meta information out of the page. Changed the output format. Argument to the 'manpage' command in the output is now a key/value list acceptable to 'array set' instead of a simple list with fixed positions for the various data elements. 2003-02-16 Andreas Kupries * doctoc.tcl: Specified a new portable format for * api_toc.tcl: writing a table of contents. Wrote a * checker_toc.tcl: package to handle input that format * dtocformat.man: and a number of formatting engines * dtocengine.man: plugging into this package to * mpformats/_toc_common.tcl: generate output in various formats. * mpformats/toc.html: This required additional checker code * mpformats/toc.nroff: and more messages in the message * mpformats/toc.null: catalogs. * mpformats/toc.tmml: * mpformats/toc.wiki: * pkgIndex.tcl: * mpformats/c.msg: * mpformats/en.msg: * mpformats/de.msg: * mpformats/_nroff.tcl: * doctools.tcl: Rephrased documentation of SetupChecker a bit. 2003-02-12 Andreas Kupries * dtformatter.man: Updated the documentation to include the * dtformat.man: two new commands (vset, include). * doctools.tcl (Eval): Added handling of new [include] * doctools.tcl (ExpandInclude): formatting command. * checker.tcl (vset): New command in the formatting language for handling variables (setting and retrieving values). Differs from the regular in that the set value is not retruned as the result of the command. This is necessary to avoid unwanted insertion of data into the output stream. The command is handled in the checker layer (although no checking is required). The engines never see this command. * mpformats/fmt.nroff: Changed both engines to not use the * mpformats/fmt.wiki: expander context stack anymore. It interferes with handling of include files. It was used to catch all output and then perform last-miunte processing. for that we have [fmt_postprocess], moved the code to that. 2003-01-27 Andreas Kupries * mpformats/fmt.html: Modified generation of section titles to make the resulting HTML more conformant and less troublesome. Thanks to Larry Virden for the catch. Revised the engine a bit. Entries in the synopsis now refer directly to the location where they are defined ([call] command). 2003-01-16 Andreas Kupries * mpformats/fmt.html: Removed 'strong' formatting. The checker * mpformats/fmt.latex: warns if used and warnings requested, it * mpformats/fmt.nroff: now also redirects the command to 'emph'. * mpformats/fmt.wiki: The option -visualwarn (doctools, and * mpformats/fmt.null: mpexpand) renamed to -deprecated. Message * mpformats/fmt.list: 'visualmarkup' removed from the catalogs, * mpformats/c.msg: and 'depr_strong' added instead. * mpformats/en.msg: * mpformats/de.msg: * checker.tcl: * doctools.tcl: * mpexpand: * doctools.man: Updated, converted [strong] to better * dtformat.man: formatting commands. Ditto for all manpages * dtformatter.man: in tcllib containing 'strong'. 'strong' is now * mpexpand.man: not present anymore. * mpformats/_common.tcl: Applied a patch by Joe English adding the * mpformats/fmt.tmml: copyright information to the appropriate place in the TMML output. This also fixes a bug in c_get_copyright where an empty string resulted in a incomplete line being given to the formatter. * mpformats/fmt.html: Removed the phrase 'All rights reserved' * mpformats/fmt.latex: from the code, on recommendation by * mpformats/fmt.nroff: Joe English. * mpformats/fmt.wiki: (In the way to early morrow :) * mpformats/fmt.html: Changed to display copyright information in * mpformats/fmt.latex: the conversion result itself and not only * mpformats/fmt.nroff: embedded in comments. * mpformats/fmt.wiki: 2003-01-14 Andreas Kupries * doctools.tcl: Added a new formatting command, * doctools.test: 'copyright', to declare/assign copyright * doctools.man: for manpages. Updated both documentation * dtformat.man: and testsuite. Extended the common code * checker.tcl: base with convenience methods for storing * api.tcl: and retrieving such information. The * mpformats/fmt.html: retrieval operation also implements the * mpformats/fmt.latex: logic giving the information in a manpage * mpformats/fmt.list: precedence over information coming from the * mpformats/fmt.nroff: processor. Updated all predefined engines * mpformats/fmt.null: to handle the new command. TMML done only * mpformats/fmt.tmml: partially, as I don't know where the copy- * mpformats/fmt.wiki: right has to go. * mpformats/_common.tcl: * mpformats/_html.tcl: * mpformats/_nroff.tcl: * mpexpand: 2003-01-13 Andreas Kupries * mpexpand: Moved format help into the package itself. * doctools.tcl: Changed the checker. Input syntax errors are not * checker.tcl: written to stderr anymore, but reported through * doctools.man: an standard tcl error. Warnings are collected and * doctools.test: can be queried after a formatting run. Made the generic engine more robust against failures in a formatting engine. Wrote documentation for the package. Extended the configuration method to be more standard. Wrote a testsuite. 2003-01-11 Andreas Kupries * mpexpand: Nearly complete rewrite of the system. * mpformats/fmt.html: The recognized input format was _not_ * mpformats/fmt.latex: changed. The main functionality was * mpformats/fmt.list: placed into a package, doctools. This * mpformats/fmt.nroff: package allows the creation of multiple * mpformats/fmt.null: formatter objects, to be used alone or * mpformats/fmt.tmml: together. The application 'mpexpand' was * mpformats/fmt.wiki: rewritten to use that package and is now * mpformats/_common.tcl: much simpler. The communication between * mpformats/_nroff.tcl: the various stages was made simpler, and * mpformats/_xml.tcl: one slave interpreter was dropped because * mpformats/_html.tcl: of this. It might be added back if its * api.tcl: existence proves to be beneficial. The * checker.tcl: API between main systen and formatter * doctools.tcl: engine was changed, consequently all * dtformatter.man: existing engines had to be updated. They were also made simpler, especially in the area of list handling, because of the validation done by the checker subsystem. The version number is now 1.0. 2002-12-16 David N. Welton * mpexpand (format_find): Added 'argv0' as a global variable, in order to avoid erroring out when providing a bad format. 2002-12-05 Andreas Kupries * mpformats/fmt.nroff: Changed so that comments coming before manpage_begin are moved after the standard header generated by manpage_begin. 2002-09-23 Andreas Kupries * mpexpand: Corrected example formatting, have to run argument through plain text handling. * mpformats/fmt.wiki: Added Wiki formatting. 2002-07-08 Andreas Kupries * mpformats/fmt.html: Changed bug #578465 which caused mis-generation of angle-brackets and quotes. 2002-06-06 Andreas Kupries * mpformats/fmt.html: * mpformats/_html.tcl: Added the missing handling of " (") to the format. 2002-05-27 Andreas Kupries * mpformats/_xml.tcl: args -> arguments, as the argument is not the last one. The code as is was not erroneous, but a possible trouble spot should tcl ever be more strict with 'args'. 2002-05-21 Andreas Kupries * mpformats/fmt.nroff: Accepted patch for bug #556509, both by Joe English . 2002-05-09 Andreas Kupries * This completes the implementation of SF tcllib item #534334. * mpformats/fmt.html: See last entry, completed definitions for the new lists. * format.man: Added the new commands (see last entry) to the format specification and also added more explanations regarding sections and paragraphs. 2002-05-09 Joe English * mpexpand: * mpformats/c.msg: * mpformats/de.msg: * mpformats/en.msg: * mpformats/fmt.nroff: * mpformats/fmt.latex: * mpformats/fmt.list: * mpformats/fmt.nroff: * mpformats/fmt.null: Added new list types for arguments, options, commands, and Tk (widget) options. 2002-04-24 Andreas Kupries * mpformats/fmt.html: * mpformats/_html.tcl: Changes analogous to TMML (see below) to differentiate internal markup and external special characters. 2002-04-24 Joe English * mpformats/_xml.tcl * mpformats/fmt.tmml: Correctly handles XML markup characters in macro arguments. Also correctly escapes apostrophes in attribute values (previously-unnoticed bug). * mpformats/fmt.tmml: TMML uses instead of , and does not have a element; changed output accordingly. 2002-04-23 Andreas Kupries * format.man: Added descriptions for all the commands performing semantic markup. This closes bug #527025. 2002-04-10 Andreas Kupries * mpexpand: Fixed error in checker of plain text. * mpformats/fmt.nroff: Added newlines in front of dot commands to make sure that the formatting is correct. Superfluous newlines are stripped in the post processor of this format, so unconditionally adding them does not hurt. 2002-04-02 Andreas Kupries * mpformats/en.msg: * mpformats/c.msg: * mpformats/de.msg: Added the messages required by the new code below. * mpexpand: Added code to check that plain text is not used in places where it is not allowed. 2002-04-01 Andreas Kupries * Committed changes to list generation (better generation of whitespace for HTML, allowing hints). Only the HTML formatter currently acknowledges hints. This fixes SF Bug #535382. 2002-03-26 Andreas Kupries * mpexpand: Changed the generation of error messages by the format checker to use explicit error codes instead of trying to construct the whole message automatically. Error codes are mapped to textual messages using the message catalog facility, allowing for easy i18n and l10n of mpexpand. Catalogs for the locales "c", "en", and "de" are provided. * mpformats/fmt.html: Changed uri formatting to be a link. * mpformats/fmt.tmml: * mpformats/fmt.html: * mpformats/fmt.nroff: * mpformats/fmt.latex: * mpformats/fmt.list: * mpformats/fmt.null: * mpformats/_api.tcl: Added formatting commands "term" and "const" to allow the structural markup of non-specific terminology and of constant values. * mpformats/fmt.nroff (bullet): Bulleting changed, use \(bu as bullet instead of *. (uri): Fixed error with underlining. 2002-03-25 Andreas Kupries * mpexpand: Extended with additional code checking that the formatting commands are not used out of order and in the wrong context. This check is independent of the format and thus implemented outside of the format. Tcllib FR #530059. * mpexpand: Implemented Tcllib FR #527029 (help options). 2002-03-13 Andreas Kupries * mpformats/fmt.html: Removed 'center' alignment from examples. Tcllib Bug #528390. 2002-03-09 Andreas Kupries * modules/doctools/format.man: Added documentation for [rb] and [lb]. This partially fixes bug #527025. * modules/doctools/mpformats/_html.tcl: The patch for FR #527716 also fixes a bug in the generation of HTML escapes. The table swiped from htmlparse seems to contain some non-standard escapes. Which are removed now. * modules/doctools/format.man: * modules/doctools/mpexpand: * modules/doctools/mpformats/fmt.html: * modules/doctools/mpformats/fmt.latex: * modules/doctools/mpformats/fmt.list: * modules/doctools/mpformats/fmt.nroff: * modules/doctools/mpformats/fmt.null: * modules/doctools/mpformats/fmt.tmml: * modules/doctools/mpformats/fmt.tmml: Accepted FR #527716 by Bryan Oakley which adds a command [usage] to the format. It allows the specification of usage information for the synopsis without the need to be embedded into a definition list. 2002-02-28 Andreas Kupries * mpformats/fmt.nroff: Corrected problems with trimming lines and the stripping of empty lines. * mpformats/fmt.html: Changed the formatting of examples. Embedded them into a table and additionally marked them with a black bar to the left. 2002-02-27 Andreas Kupries * mpformats/fmt.null: Null format, does not produce any output. * mpformats/fmt.tmml: * mpformats/fmt.nroff: * mpformats/fmt.latex: * mpformats/fmt.html: * mpformats/fmt.list: Implementations of the new command. * mpexpand: Added the commands to the processor application. Added option "-visualwarn". When present the processor warn about usage of visual markup. Tcllib FR #517599. * mpformats/_api.tcl: Added a number of semantic markup commands to the api as part of Tcllib FR #517599. Also added comment command, see Tcllib FR #520269. 2002-02-14 Andreas Kupries * mpformats/_common.tcl: Frink run. 2002-02-13 Andreas Kupries * mpformats/fmt.html: Added detection of section cross-references in [emph] and [strong] based on the code for TMML. 2002-02-13 Joe English * mpformats/fmt.tmml: [example_begin] inside lists was not handled correctly. * mpformats/fmt.tmml: Detect section cross-references in [emph] and [strong]. 2002-02-12 Andreas Kupries * mpformats/_html.tcl: Added command to map HTML special characters to their escape sequences. * mpformats/fmt.latex: Added code to disable special processing of plain text while inside of an example. * mpformats/fmt.tmml: Added HandleText call to [example] to handle special XML characters inside of the example. Not requitred for [example_begin] / [example_end] as the text will go through HandleText automatically for that case. * mpformats/fmt.nroff: Added split to lsearch statement in manpage_end to make the code robust against strings which are not valid lists. 2002-02-12 Joe English * Added [example_begin] and [example_end] commands. Also [example { code ... }] command. 2001-12-13 Andreas Kupries * Added formatter for LaTeX. 2001-12-12 Andreas Kupries * New module. Application module providing a simple tcl-based manpage markup language and a processor for converting this format to TMML, nroff and HTML. Extensible, i.e. additional formats can be added without to much work (Manpages for format and internal interfaces are provided).