12013-11-07 Andreas Kupries <andreask@activestate.com> 2 3 * mpformats/man.macros: [Ticket 369f67aeee] Updated to newest from 4 Tcl/Tk. 5 62013-11-06 Andreas Kupries <andreask@activestate.com> 7 8 * mpformats/fmt.nroff: [Ticket efe207eff1]: Applied 9 * mpformats/idx.nroff: patched by Stuart Casoff to 10 * mpformats/toc.nroff: unbreak manpage rendering on 11 * modules/doctools/tests/nroff/00: various BSD variants. 12 * modules/doctools/tests/nroff/01: Must include our 13 * modules/doctools/tests/nroff/02: macros after emitting 14 * modules/doctools/tests/nroff/03: .TH to avoid clashes. 15 * modules/doctools/tests/nroff/04: Updated test results. 16 * modules/doctools/tests/nroff/05: 17 * modules/doctools/tests/nroff/06: 18 * modules/doctools/tests/nroff/07: 19 * modules/doctools/tests/nroff/08: 20 212013-06-05 Andreas Kupries <andreask@activestate.com> 22 23 * doctools.tcl: Added dt_ibase command to the set 24 * mpformats/_common.tcl: available in formatters. 25 * pkgIndex.tcl: Extended file command emulation. 26 Used in the provenance code for shorter reference 27 to the proper input file. Bumped to 1.4.17. 28 292013-02-26 Andreas Kupries <andreas_kupries@users.sourceforge.net> 30 31 * mpformats/_nroff.tcl: Modified the formatting of dots ("."). 32 * pkgIndex.tcl: Always quote them with \& (zero-width escape). 33 * doctools.tcl: Updated test results. Version bumped to 1.4.16. 34 * doctools.man: 35 * modules/doctools/tests/nroff/00: 36 * modules/doctools/tests/nroff/01: 37 * modules/doctools/tests/nroff/02: 38 * modules/doctools/tests/nroff/03: 39 * modules/doctools/tests/nroff/04: 40 * modules/doctools/tests/nroff/05: 41 * modules/doctools/tests/nroff/06: 42 * modules/doctools/tests/nroff/07: 43 * modules/doctools/tests/nroff/08: 44 45 462013-02-25 Andreas Kupries <andreas_kupries@users.sourceforge.net> 47 48 * mpformats/_nroff.tcl (nroff_postprocess): Followup fixes to 49 * mpformats/fmt.nroff: bugs found in branch "bug-3601370-td", 50 * pkgIndex.tcl: Missing markup of several nroff directives as 51 * doctools.tcl: such. Version bumped to 1.4.15. 52 * doctools.man: 53 542013-02-04 Andreas Kupries <andreas_kupries@users.sourceforge.net> 55 56 * changelog.tcl: flatten method added. Extension of for 'sak 57 * changelog.man: review'. Simpler structured output. Bumped 58 version to 1.1. 59 602013-02-01 Andreas Kupries <andreas_kupries@users.sourceforge.net> 61 62 * 63 * Released and tagged Tcllib 1.15 ======================== 64 * 65 662013-01-29 Andreas Kupries <andreask@activestate.com> 67 68 * doctools.man: Bumped version to 1.4.14 for the 69 * doctools.tcl: last change, see below. 70 * pkgIndex.tcl: 71 722013-01-21 Andreas Kupries <andreask@activestate.com> 73 74 * checker.tcl: Added check to manpage_begin, reject spaces in title. 75 * mpformats/c.msg: Message catalogs extended with new warning 76 * mpformats/de.msg: 'mptitle' for spaces in the manpage title. 77 * mpformats/en.msg: The french catalog contains the english 78 * mpformats/fr.msg: text, and needs a translation. 79 802012-02-27 Andreas Kupries <aku@hephaistos> 81 82 * tests/text/04: Update the expected the result to match the new 83 actual result. See the 2011-12-13 last-second bugfix in 84 textutil::adjust::undent for the cause. 85 862011-12-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 87 88 * 89 * Released and tagged Tcllib 1.14 ======================== 90 * 91 922011-11-07 Andreas Kupries <andreas_kupries@users.sourceforge.net> 93 94 * tests/nroff/04: Updated the test outputs to match the changes 95 * tests/nroff/07: introduced by the last two commits, below. 96 * tests/nroff/08: 97 982011-02-23 Andreas Kupries <andreask@activestate.com> 99 100 * mpformats/fmt.nroff: Moved the handling of the list nesting 101 * mpformats/_nroff.tcl: level a bit around to be consistent at 102 * checker.tcl: both begin and end. Fixed the long-standing 103 indentation bug where the rendered text got unindented after a 104 nested list or example. We simply had to start indented 105 paragraphs, via .IP after them, and for each paragraph in a list 106 element. This needed the consistent nesting level to correctly 107 know when to emit the commands. And while this may generate 108 empty paragraphs, these can be removed easily in the 109 post-processing. 110 * doctools.tcl: Bumped version to 1.4.13. 111 * doctools.man: 112 * pkgIndex.tcl: 113 1142011-02-23 Andreas Kupries <andreask@activestate.com> 115 116 * mpformats/_nroff.tcl (nr_ce): [Bug 3167244]: Added \n after .CE 117 to prevent misformatting when examples are used in a sentence 118 without placement on a separate line of input. 119 * doctools.tcl: Bumped version to 1.4.12. 120 * doctools.man: 121 * pkgIndex.tcl: 122 1232011-01-24 Andreas Kupries <andreas_kupries@users.sourceforge.net> 124 125 * 126 * Released and tagged Tcllib 1.13 ======================== 127 * 128 1292011-01-12 Andreas Kupries <andreas_kupries@users.sourceforge.net> 130 131 * doctools.test: Updated for the changes made per the entry below. 132 1332010-11-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 134 135 * doctools.man: Bumped to version 1.4.11, fixing issues with 136 * doctools.tcl: resolution of relative include paths. -file had 137 * pkgIndex.tcl: overloaded semantics, used for both source paths 138 (include resolution) and destination paths (HTML relative 139 links). Added new option -ibase as primary for include 140 resolution, using -file only as fallback anymore. 141 1422010-09-15 Andreas Kupries <andreask@activestate.com> 143 144 * tests/nroff/04: [Bug 3058654] and last entry. Updated 145 * tests/nroff/08: the affected testcases. 146 1472010-09-07 Andreas Kupries <andreask@activestate.com> 148 149 * mpformats/fmt.nroff: [Bug 3058654]: Changed formatting of 150 * mpformats/_nroff.tcl: examples to .CS/.CE. 151 1522010-09-07 Andreas Kupries <andreask@activestate.com> 153 154 * mpformats/fmt.nroff: [Bug 3058654]: Added code compacting 155 whitespace in various strings used for nroff comments and NAME 156 section. 157 1582010-07-06 Andreas Kupries <andreask@activestate.com> 159 160 * checker.tcl: [RFE 2915921] Accepted the RFE, adding 161 * mpformats/fmt.wiki: commands to portably write em- and 162 * mpformats/fmt.text: en-dashes. Bumped version to 1.4.10. 163 * mpformats/fmt.latex: 164 * mpformats/fmt.tmml: 165 * mpformats/fmt.html: 166 * mpformats/fmt.nroff: 167 * mpformats/fmt.null: 168 * doctools.man: 169 * pkgIndex.tcl: 170 * doctools.tcl: 171 1722010-06-17 Andreas Kupries <andreask@activestate.com> 173 174 * mpformats/fmt.html: Tweaked formatting of images when no 175 * mpformats/fmt.latex: data was found. Especially for HTML 176 * mpformats/fmt.text: accept http and ftp uris and format 177 * mpformats/fmt.wiki: them as links, allowing the embedding 178 * mpformats/fmt.nroff: of images without requiring a local 179 * doctools.man: file. Bumped version to 1.4.9 180 * pkgIndex.tcl: 181 * doctools.tcl: 182 1832010-06-10 Andreas Kupries <andreas_kupries@users.sourceforge.net> 184 185 * doctools.tcl: Extended the plugin API to the image map to 186 * mpformats/fmt.nroff: allow querying the image data instead of 187 * mpformats/fmt.wiki: its paths. Fixed the nroff, wiki, and text 188 * mpformats/fmt.text: plugins to use this new command, as they 189 * doctools_plugin_apiref.man: are in a restricted environment 190 * doctools.man: which does not allow them to 'open' files on their 191 * pkgIndex.tcl: own. Documented the command now. nroff further 192 extended to accept .txt images as well as .pic, and do a bit of 193 formatting of their own to make them fit (.nf/.fi). Version 194 bumped to 1.4.8. 195 196 * ../../apps/dtplite: Fixes for problems with the handling of 197 relative paths. Version bumped to 1.0.2. 198 1992010-06-08 Andreas Kupries <andreask@activestate.com> 200 201 * ../../apps/dtplite: Fix the min version requirements. 202 203 * checker.tcl: Added 'image' command to doctools, and the 204 * doctools.man: various backends. Bumped to version 1.4.7. 205 * doctools_lang_cmdref.man: Images are specified through 206 * doctools.tcl: symbolic name. Tools like dtp(lite) specify 207 * pkgIndex.tcl: possible mappings, and the backends select 208 * mpformats/fmt.html: a proper variant (png, jpeg, text, ...) 209 * mpformats/fmt.latex: or fallback to a 'here should be this 210 * mpformats/fmt.nroff: image' markup, if no proper variant 211 * mpformats/fmt.null: for them was found. 212 * mpformats/fmt.wiki: 213 * mpformats/fmt.text: Future/Todo - Recognize uris as symbolic 214 * mpformats/_html.tcl: name and treat as external reference. 215 * ../../apps/dtplite: 216 217 * docidx.man: Added missing dt_package and restricted 'file' 218 * docidx.tcl: support to doctool::toc and doctools::idx. Versions 219 * doctoc.man: bumped to 1.1.3 and 1.0.4. 220 * doctoc.tcl: 221 * pkgIndex.tcl: 222 223 * mpformats/toc.text: Fixed command names using various textutil 224 * mpformats/idx.text: functionality. 225 2262010-02-05 Andreas Kupries <andreask@activestate.com> 227 228 * checker.tcl: Gave the checking layer access to dt_file, 229 * doctools.tcl: and extended it to provide the file name 230 * doctools.man: as part of the location information in 231 * doctools.test: errors and warnings. Bumped version to 232 * pkgIndex.tcl: 1.4.6. 233 2342010-02-04 Andreas Kupries <andreask@activestate.com> 235 236 * doctools.tcl: Extended with new plugin API command 237 * doctools.man: [dt_mainfile], which always returns 238 * doctools_plugin_apiref.man: the toplevel file currently 239 * pkgIndex.tcl: processed, in contrast to [dt_file] which 240 returns the currently processed file, which may be included. 241 Bumped version to 1.4.5. 242 243 * mpformats/fmt.html: Fixed bug in inter-document link generation 244 caused by computing links relative to the active (include) file, 245 instead of the toplevel. 246 2472009-12-09 Andreas Kupries <andreask@activestate.com> 248 249 * doctools.tcl: Bumped version to 1.4.4. 250 * doctools.man: 251 * pkgIndex.tcl: 252 253 * mpformats/fmt.html: Extended to support the engine variable 254 * doctools.test: 'raw' (boolean flag). The default is off, causing 255 the engine to generate the full html, as usual. If set, the 256 engine will generate only the HTML normally between the <body> 257 and </body> tags, excluding these two tags. This allows for 258 easier embedding of the result in other HTML. Thanks to Jos 259 DeCoster for the idea. Extended the testsuite to cover raw mode 260 results. 261 262 * mpformats/fmt.wiki: Thanks to Jos DeCoster for updating the Wiki 263 * tests/wiki/00: formatter to generate text making better use of 264 * tests/wiki/01: Wikit's new features, and also fixing bugs in the 265 * tests/wiki/02: use of the older features. Updated test results. 266 * tests/wiki/03: 267 * tests/wiki/04: 268 * tests/wiki/05: 269 * tests/wiki/06: 270 * tests/wiki/07: 271 * tests/wiki/08: 272 2732009-12-07 Andreas Kupries <andreas_kupries@users.sourceforge.net> 274 275 * 276 * Released and tagged Tcllib 1.12 ======================== 277 * 278 2792009-07-21 Andreas Kupries <andreask@activestate.com> 280 281 * doctools.tcl: Fixed @mdgen instructions, added forgotten 282 ownership reference to man.macros. See ActiveState Bug 83781, 283 reported by Nicolas Castagne. Bumped to version 1.4.3. 284 * docidx.tcl: See above, bumped to version 1.0.3. 285 * doctoc.tcl: See above, bumped to version 1.1.2. 286 2872009-03-30 Andreas Kupries <andreas_kupries@users.sourceforge.net> 288 289 * checker.tcl (manpage): Added new markup command for document 290 references (manpage). For now formatted like a 'term'. 291 292 * doctools.tcl: Fixed handling of include files. Search relative 293 * doctools.man: to processed file, and run the command through 294 'subst' first, to resolve embedded commands (vset uses). Bumped 295 to version 1.4.2. 296 297 * docidx.tcl: Fixed handling of include files. Search relative 298 * docidx.man: to processed file, and run the command through 299 'subst' first, to resolve embedded commands (vset uses). Bumped 300 to version 1.0.2 301 302 * doctoc.tcl: Fixed handling of include files. Search relative 303 * doctoc.man: to processed file, and run the command through 304 'subst' first, to resolve embedded commands (vset uses). Bumped 305 to version 1.1.1. 306 307 * docidx_lang_syntax.man: Added notes about command arguments. 308 3092009-02-11 Andreas Kupries <andreas_kupries@users.sourceforge.net> 310 311 * checker_toc.tcl: TOC language extended to allow empty tocs, empty 312 * docidx.test: divisions, and the mixing of items and divisions at 313 * doctoc.tcl: every level. Extended testsuite. Updated documentation. 314 * doctoc.test: Bumped version to 1.1. Fixed bug in the documentation 315 * doctoc_lang_cmdref.man: of markup command 'item' (arguments were 316 * doctoc_lang_intro.man: missing). 317 * doctoc_lang_syntax.man: 318 * doctoc.man: 319 * pkgIndex.tcl: 320 3212009-02-10 Andreas Kupries <andreask@activestate.com> 322 323 * checker_idx.tcl (index_end): Allow empty index (no keys). 324 * docidx.tcl: Bumped package to vrsion 1.0.1. Updated the 325 * docidx.test: documentation, where not already in alignment. 326 * docidx_lang_intro.man: Extended testsuite. Fixed small typo 327 * docidx_lang_syntax.man: orthogonal to this change. 328 * pkgIndex.tcl: Fixes [SF Tcllib Bug 2557107]. 329 3302009-01-29 Andreas Kupries <andreas_kupries@users.sourceforge.net> 331 332 * docidx.tcl: Extended the plugin APIs for all formats with a new 333 * docidx_plugin_apiref.man: command "dt_read" to read a file's 334 * doctoc.tcl: contents into a plugin. Modified the nroff plugins 335 * doctoc_plugin_apiref.man: to inline the man.macros file into 336 * doctools.tcl: their result instead of generating a 337 * doctools.test: '.so man.macros' command. Stuart Cassoff 338 * doctools_plugin_apiref.man: <stwo@users.sourceforge.net> did the 339 * mpformats/_nroff.tcl: work and provided the patches as part of 340 * mpformats/fmt.nroff: his effort on making a Tcllib OpenBSD port. 341 * mpformats/idx.nroff: 342 * mpformats/toc.nroff: 343 3442009-01-28 Andreas Kupries <andreas_kupries@users.sourceforge.net> 345 346 * checker.tcl: Fixed bug in handling 'category' command. Bumped 347 * doctools.tcl: version to 1.4.1 348 * doctools.man: 349 * pkgIndex.tcl: 350 351 * changelog.man: Added 'category' information to all manpages. 352 * cvs.man: 353 * docidx.man: 354 * docidx_intro.man: 355 * docidx_lang_cmdref.man: 356 * docidx_lang_faq.man: 357 * docidx_lang_intro.man: 358 * docidx_lang_syntax.man: 359 * docidx_plugin_apiref.man: 360 * doctoc.man: 361 * doctoc_intro.man: 362 * doctoc_lang_cmdref.man: 363 * doctoc_lang_faq.man: 364 * doctoc_lang_intro.man: 365 * doctoc_lang_syntax.man: 366 * doctoc_plugin_apiref.man: 367 * doctools.man: 368 * doctools_intro.man: 369 * doctools_lang_cmdref.man: 370 * doctools_lang_faq.man: 371 * doctools_lang_intro.man: 372 * doctools_lang_syntax.man: 373 * doctools_plugin_apiref.man: 374 * mpexpand.man: 375 3762008-12-12 Andreas Kupries <andreas_kupries@users.sourceforge.net> 377 378 * 379 * Released and tagged Tcllib 1.11.1 ======================== 380 * 381 3822008-12-01 Andreas Kupries <andreask@activestate.com> 383 384 * doctools.tcl: New command in doctools language is extended API. 385 * doctools.man: Bumped minor version, to 1.4. 386 * pkgIndex.tcl: 387 3882008-11-26 Andreas Kupries <andreask@activestate.com> 389 390 * api.tcl: Extended doctools language with a 'category' 391 * checker.tcl: command. This allows manpages to provide 392 * doctools.tcl: a category string, like they already 393 * doctools_lang_cmdref.man: provide keywords and see-also 394 * doctools_lang_syntax.man: references. Updated all engines 395 * mpformats/_common.tcl: to handle the command in some way. 396 * mpformats/fmt.html: Bumped package version to 1.3.6. 397 * mpformats/fmt.latex: Needed: Some tests to demo the 398 * mpformats/fmt.list: handling of 'category'. 399 * mpformats/fmt.nroff: 400 * mpformats/fmt.null: 401 * mpformats/fmt.text: 402 * mpformats/fmt.tmml: 403 * mpformats/fmt.wiki: 404 * doctools.test: 405 * tests/list/00: 406 * tests/list/01: 407 * tests/list/02: 408 * tests/list/03: 409 * tests/list/04: 410 * tests/list/05: 411 * tests/list/06: 412 * tests/list/07: 413 * tests/list/08: 414 4152008-10-16 Andreas Kupries <andreas_kupries@users.sourceforge.net> 416 417 * 418 * Released and tagged Tcllib 1.11 ======================== 419 * 420 4212008-07-08 Andreas Kupries <andreask@activestate.com> 422 423 * changelog.man: Bumped the packages to version 1. They have 424 * changelog.tcl: been on 0 long enough. 425 * cvs.man: 426 * cvs.tcl: 427 * docidx.man: 428 * docidx.tcl: 429 * doctoc.man: 430 * doctoc.tcl: 431 4322008-05-16 Andreas Kupries <andreask@activestate.com> 433 434 * checker.tcl (sectref): The way it was documented confused me and 435 * doctools.tcl: the last change flipped identifying and text 436 * doctools.man: argument, changing the meaning of sectref. Should 437 * pkgIndex.tcl: have seen that quicker with how comm/comm_wire.man 438 had to be updated. Fixed this now, restoring the proper 439 order. Rewrote docs as well for better understanding. Bumped to 440 version 1.3.5. 441 442 * ../comm/comm_wire.man: Fixed the sectref argument order issues. 443 * ../rcs/rcs.man: Fixed the sectref argument order issues. 444 * ../snit/snitfaq.man: Fixed the sectref argument order issues. 445 * ../tie/tie.man: Fixed the sectref argument order issues. 446 4472008-05-15 Andreas Kupries <andreas_kupries@users.sourceforge.net> 448 449 * doctools.tcl: Bumped version to 1.3.4. 450 * doctools.man: 451 * pkgIndex.tcl: 452 453 * checker.tcl: Reworked the (sub)section handling, enabled the 454 * doctools_lang_cmdref.man: documentation writer to label 455 (sub)sections with logical names and use these in references. 456 Automatic logical names are improved, taking the current section 457 into account, making for a better ambiguity check. References 458 are now better as well. Backends are given unique physical 459 (sub)section ids. Added a new formatting command 460 'sectref-external' for references to (sub)sections outside of 461 the current document, to disable checking, and documented it. 462 463 * docidx_plugin_apiref.man: Fixed the external section references 464 * doctoc_plugin_apiref.man: in the manpages to prevent false warnings. 465 * doctools_plugin_apiref.man: 466 467 * mpformats/c.msg: Message catalogs extended with new warning 468 * mpformats/de.msg: 'missingsect' for apparently dangling 469 * mpformats/en.msg: (sub)section references. 470 * mpformats/fr.msg: 471 472 * mpformats/fmt.html: Updated the backends for the changes in the 473 * mpformats/fmt.latex: frontend/backend API, and updated testsuite 474 * mpformats/fmt.nroff: results. 475 * mpformats/fmt.text: 476 * mpformats/fmt.tmml: 477 * mpformats/fmt.wiki: 478 * mpformats/_common.tcl: 479 * tests/latex/00: 480 * tests/latex/01: 481 * tests/latex/02: 482 * tests/latex/03: 483 * tests/latex/04: 484 * tests/latex/05: 485 * tests/latex/06: 486 * tests/latex/07: 487 * tests/latex/08: 488 * tests/tmml/00: 489 * tests/tmml/01: 490 * tests/tmml/02: 491 * tests/tmml/03: 492 * tests/tmml/04: 493 * tests/tmml/05: 494 * tests/tmml/06: 495 * tests/tmml/07: 496 * tests/tmml/08: 497 * tests/html/00: 498 * tests/html/01: 499 * tests/html/02: 500 * tests/html/03: 501 * tests/html/04: 502 * tests/html/05: 503 * tests/html/06: 504 * tests/html/07: 505 * tests/html/08: 506 507 * mpformats/_nroff.tcl: Modified the nroff backend to convert 508 * tests/nroff/03: (sub)section titles into uppercase in the 509 output. Updated testsuite results. 510 511 * checker.tcl: Reworked the (sub)section handling, enabled the 512 documentation writer to label (sub)sections with logical names 513 and use these in references. Automatic logical names are 514 improved, taking the current section into account, making for a 515 better ambiguity check. References are now better as well. 516 Backends are given unique physical (sub)section ids. 517 518 * mpformats/c.msg: Message catalogs extended with new warning 519 * mpformats/de.msg: 'missingsect' for apparently dangling 520 * mpformats/en.msg: (sub)section references. 521 * mpformats/fr.msg: 522 523 * mpformats/fmt.html: Updated backends for the changes in the 524 * mpformats/fmt.latex: frontend/backend API. Nroff backend 525 * mpformats/fmt.nroff: additionally modified to automatically 526 * mpformats/fmt.text: convert (sub)section titles into uppercase. 527 * mpformats/fmt.tmml: 528 * mpformats/fmt.wiki: 529 * mpformats/_common.tcl: 530 * mpformats/_nroff.tcl: 531 532 * mpformats/fmt.html (XrefLink): Now checking for and suppressing 533 * doctools.tcl: self-referential links from the current output 534 * doctools.man: file to itself exactly. Bumped version to 1.3.3. 535 * pkgIndex.tcl: 536 5372008-04-27 Andreas Kupries <andreas_kupries@users.sourceforge.net> 538 539 * mpformats/fmt.html: Gave title h1 tag a class. Put a div around 540 * tests/html/*: the content of the synopsis section. Removed the 541 div around examples. Their pre tag has a class, that is enough. 542 Added default CSS styling to the code. Its definitions are 543 derived from the CSS Joe English <jenglish@users.sourceforge.net> 544 uses for the HTML generated by his TMML converter. Nice and 545 simple. Thank you. 546 547 * tests/man/08: All possible list types are in testcase 5 already. 548 * tests/desc/08: Changed to demo all the commands in one file. 549 * tests/html/08: This makes trying out styles for the HTML easier too 550 * tests/latex/08: as everything can looked at in one file. 551 * tests/list/08: 552 * tests/nroff/08: 553 * tests/null/08: 554 * tests/text/08: 555 * tests/tmml/08: 556 * tests/wiki/08: 557 558 * mpformats/fmt.html: Changed example formatting, removed the nested 559 * tests/html/*: table structure. Changed toc and synopsis 560 formatting to be more sematical, using classed unordered lists. 561 Added classes to the list formatting. Removed hardwired 562 linebreaks between last list element and end of list. Replaced 563 linebreaks in list items with proper paragraph formatting. Fixed 564 initialization error causing spurious para_close at the 565 beginning. Added foundation for an internal style-sheet. No 566 definitions yet however. 567 5682008-04-26 Andreas Kupries <andreas_kupries@users.sourceforge.net> 569 570 * tests/man/08: Added test demonstrating all possible list types. 571 * tests/desc/08: 572 * tests/html/08: 573 * tests/latex/08: 574 * tests/list/08: 575 * tests/nroff/08: 576 * tests/null/08: 577 * tests/text/08: 578 * tests/tmml/08: 579 * tests/wiki/08: 580 5812008-04-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 582 583 * tests/man/02: Added see_also and keyword references to this 584 * tests/html/02: example. Updated all changed results. 585 * tests/latex/02: 586 * tests/list/02: 587 * tests/nroff/02: 588 * tests/text/02: 589 * tests/tmml/02: 590 * tests/wiki/02: 591 5922008-04-21 Andreas Kupries <andreas_kupries@users.sourceforge.net> 593 594 * mpformats/fmt.html: Modified to put sections and subsections 595 * mpformats/_html.tcl: into divisions a CSS can lock onto. Changed 596 * tests/html/*: to properly close paragraphs, sections, and sub- 597 sections. Changed to remove empty paragraphs, and empty lines. 598 Put the whole body into a division. Put text marked up as 599 optional into a span. Put section references into a span. Put 600 examples into a division. Some general cleanup of the internals. 601 6022008-04-19 Andreas Kupries <andreas_kupries@users.sourceforge.net> 603 604 * tests/*/06: Extended for nested lists. 605 * tests/*/07: 2nd input and results for nested lists. 606 * mpformats/_nroff.tcl (nr_vspace): Added newlines to output for 607 proper formatting of text coming after it. 608 609 * tests/syntax/e_*: Additional input and result files, completing 610 * tests/syntax/r_*: the list errors. Ditto the example commands, 611 sectref, and the commands for the semantic categories. 612 6132008-04-17 Andreas Kupries <andreas_kupries@users.sourceforge.net> 614 615 * doctools.test: Extended with loop to test response to the various 616 * tests/syntax/e_*: syntax errors we may find in doctools files, plus 617 * tests/syntax/r_*: first set of input files and error results. 618 * checker.tcl: Modified errors for commands which are allowed 619 everywhere in the header section since the extended syntax came 620 into effect. 621 6222008-04-14 Andreas Kupries <andreas_kupries@users.sourceforge.net> 623 624 * doctools.test: Fixed [Bug 1942472], reported by Michael 625 * tests/latex/00: Schlenker, in made with the new test cases. 626 * tests/latex/01: Now mapping the name of the user running 627 * tests/latex/02: the tests around in the expected and 628 * tests/latex/03: actual results as well. Modified the 629 * tests/latex/04: expected results for the one backend 630 * tests/latex/05: affected by the change. 631 * tests/latex/06: 632 6332008-04-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 634 635 * doctools.test: Added the remaining backends to the list of 636 backends checked. 637 638 * tests/tmml/00: Expected results for TMML backend. 639 * tests/tmml/01: 640 * tests/tmml/02: 641 * tests/tmml/03: 642 * tests/tmml/04: 643 * tests/tmml/05: 644 * tests/tmml/06: 645 646 * tests/text/00: Expected results for TEXT backend. 647 * tests/text/01: 648 * tests/text/02: 649 * tests/text/03: 650 * tests/text/04: 651 * tests/text/05: 652 * tests/text/06: 653 654 * tests/wiki/00: Expected results for WIKI backend. 655 * tests/wiki/01: 656 * tests/wiki/02: 657 * tests/wiki/03: 658 * tests/wiki/04: 659 * tests/wiki/05: 660 * tests/wiki/06: 661 662 * tests/latex/00: Expected results for LATEX backend. 663 * tests/latex/01: 664 * tests/latex/02: 665 * tests/latex/03: 666 * tests/latex/04: 667 * tests/latex/05: 668 * tests/latex/06: 669 670 * tests/desc/00: Expected results for DESC backend. 671 * tests/desc/01: 672 * tests/desc/02: 673 * tests/desc/03: 674 * tests/desc/04: 675 * tests/desc/05: 676 * tests/desc/06: 677 678 * tests/list/00: Expected results for LIST backend. 679 * tests/list/01: 680 * tests/list/02: 681 * tests/list/03: 682 * tests/list/04: 683 * tests/list/05: 684 * tests/list/06: 685 686 * tests/null/00: Expected results for NULL backend. 687 * tests/null/01: 688 * tests/null/02: 689 * tests/null/03: 690 * tests/null/04: 691 * tests/null/05: 692 * tests/null/06: 693 694 * tests/html/00: Replaced $ I d $ placeholder with @ID@. See 695 * tests/html/01: doctools.test. 696 * tests/html/02: 697 * tests/html/03: 698 699 * tests/man/04: Replaced placeholder text with actual input to 700 * tests/man/05: run through the formatting backends. 701 * tests/man/06: 702 703 * tests/html/04: Made results current. The handling of 704 * tests/html/05: backslashes is known to be wrong, noted 705 * tests/html/06: other ugliness. 706 707 * tests/nroff/04: Made results current, fixed some formatting 708 * tests/nroff/05: problems, see below. 709 * tests/nroff/06: 710 711 * mpformats/fmt.nroff (fmt_arg_def, fmt_opt_def): Added newlines 712 to output for proper formatting of elements in argument and 713 option lists. 714 715 * doctools.test: Fix handling of $ I d $ placeholder used in input 716 files and expected results. Extended to handle errors, to catch 717 problems other than differences between expected and actual 718 results. Ignore CVS subdirectory and handle missing files for 719 expected results. 720 7212008-03-31 Andreas Kupries <andreas_kupries@users.sourceforge.net> 722 723 * doctools.test: Added tests to invoke the backends on a series of 724 input files and check the results against expectations. 725 * tests/man/00: First set of input files, and expected output for 726 * tests/man/01: the html and nroff backends. 727 * tests/man/02: 728 * tests/man/03: 729 * tests/man/04: 730 * tests/man/05: 731 * tests/man/06: 732 * tests/html/00: 733 * tests/html/01: 734 * tests/html/02: 735 * tests/html/03: 736 * tests/html/04: 737 * tests/html/05: 738 * tests/html/06: 739 * tests/nroff/00: 740 * tests/nroff/01: 741 * tests/nroff/02: 742 * tests/nroff/03: 743 * tests/nroff/04: 744 * tests/nroff/05: 745 * tests/nroff/06: 746 7472008-03-12 Andreas Kupries <andreask@activestate.com> 748 749 * checker.tcl (widget): Fixed bad call propagation. 750 7512008-03-08 Andreas Kupries <andreas_kupries@users.sourceforge.net> 752 753 * doctools.tcl: Code cleanup, giving all upvar commands an 754 * docidx.tcl: explicit level argument. Bumped all version 755 * doctoc.tcl: numbers by one patchlevel. doctools -> 1.3.2, 756 * cvs.tcl: doctools::toc -> 0.3.1, doctools::idx -> 0.3.1, 757 * changelog.tcl: doctools::cvs -> 0.1.2, 758 * pkgIndex.tcl: doctools::changelog -> 0.1.2 759 * docidx.man: 760 * doctoc.man: 761 * doctools.man: 762 * cvs.man: 763 * changelog.man: 764 7652007-09-25 Andreas Kupries <andreask@activestate.com> 766 767 * doctools.tcl: Extended processor to pass the pass number to the 768 * checker.tcl: checker layer as well. Modified the checker layer 769 * pkgIndex.tcl: to suppress generation of warnings in all but the 770 * doctools.man: first pass, to avoid replication. Bumped version 771 to 1.3.1. This fixes [SF Tcllib Bug 1800413]. 772 773 * mpformats/fmt.nroff: Fixed argument swap in fmt_arg_def, fixing 774 [SF Tcllib Bug 1800420]. 775 776 * mpformats/fmt.html: Handled [SF Tcllib Bug 1800408] and [SF 777 Tcllib Bug 411], removing superfluous whitespace around link 778 text and adding more class names to semantic markup. 779 7802007-09-20 Andreas Kupries <andreask@activestate.com> 781 782 * mpformats/fmt.html: Added closing of paragraphs per the request 783 in [SF Tcllib Bug 1798427]. Tis more complicated. Paragraphs 784 inside of list elements are not yet closed. 785 786 * mpformats/fmt.html: Reworking handling of list items a bit to 787 properly close the dt, dd, and li tags. Requested by [SF Tcllib 788 Bug 1798427]. 789 7902007-09-12 Andreas Kupries <andreas_kupries@users.sourceforge.net> 791 792 * 793 * Released and tagged Tcllib 1.10 ======================== 794 * 795 7962007-08-20 Andreas Kupries <andreask@activestate.com> 797 798 * doctools.tcl: Bumped versions to 1.3 and 0.3 respectively to 799 * docidx.tcl: reflect the extended syntax and bugfixes listed 800 * doctoc.tcl: below. 801 * doctools.man: 802 * docidx.man: 803 * doctoc.man: 804 * pkgIndex.tcl: 805 8062007-08-02 Andreas Kupries <andreask@activestate.com> 807 808 * mpformats/fmt.latex: Further reworking of the backend internals 809 for proper quoting of TeX special characters, prevention of 810 double-quoting, and markup of wanted special characters. Further 811 removed the use of 'quote' environments. Not needed for the 812 formatting and its use restricts the nesting of lists to three 813 levels. Without we can nest seven levels. Final fixes for 814 [Tcllib SF Bug 1766381]. 815 816 * mpformats/fmt.text: Fixed handling of 'cmd_def'. 817 * mpformats/fmt.tmml: Fixed handling of nested lists. 818 * mpformats/fmt.latex: Fixed handling of list_end, was not updated 819 to the new list type codes. 820 * mpformats/fmt.latex: Fixed handling of ^ character. Has to be 821 escaped in regular text. Fixed handling of keywords and 822 references (see also). May contain special character in need of 823 escaping. Quote backslashes in paths. 824 Fixes for [Tcllib SF Bug 1766381.] 825 8262007-08-01 Andreas Kupries <andreask@activestate.com> 827 828 * doctools.test: Updated test 8.4 for changes in the formatting of 829 warnings. 830 8312007-03-20 Andreas Kupries <andreask@activestate.com> 832 833 * apps/dtplite: Added a block of meta data. 834 8352007-03-20 Andreas Kupries <andreask@activestate.com> 836 837 * mpformats/fmt.wiki: Added MD pragma excluding a bogus dependency 838 from consideration. 839 8402007-03-19 Andreas Kupries <andreas_kupries@users.sourceforge.net> 841 842 * doctoc.tcl: Extended MD pragmas declaring the ownership of 843 * docidx.tcl: various non-code files. 844 * doctools.tcl: 845 846 * support/devel/sak/doc/doc.tcl: Modified to print warnings even 847 if processed was stopped by an error. 848 849 * mpformats/c.msg: Added messages for a set of newly deprecated 850 * mpformats/de.msg: commands and list types. Added proper umlauts 851 * mpformats/en.msg: to the german messages. 852 * mpformats/fr.msg: 853 854 * doctools.tcl: Added a plugin API command (dt_where), providing 855 information about the current location, to provide location data 856 to warnings. 857 858 * checker_toc.tcl: Language change (doctoc, docidx). Comments in 859 * checker_idx.tcl: the input are now swallowed by the checker 860 layer and not propagated to the backend anymore. 861 862 * checker.tcl: Language changes. 863 -- Comments are swallowed, backends do not see them anymore. 864 -- 'require'ments an now go everywhere in the header, not only 865 after the 'desc'riptions. 866 -- Warnings now have location information. 867 -- The list types 'bullet', 'arg', 'opt', 'cmd', and 'tkoption' 868 are now deprecated. They are replaced by 'itemized', 869 'arguments', 'options', 'commands', and 'tkoptions', and their 870 short forms 'items', 'args', 'opts', and 'cmds'. 871 -- 'para' can now be used inside of lists. Conversely 'nl' works 872 outside of lists too. The two commands are identical now, and 873 'nl' is deprecated. 874 -- The list entry command 'lst_item' has been deprecated, 875 replaced by 'def'. Additionally the possible misspellings 876 'list_item', 'listitem', and 'lstitem' of the old command are 877 recognized now too, albeit also considered to be deprecated. 878 -- The list entry command 'bullet' is deprecated, replaced 879 'item'. 880 -- The commands 'see_also' and 'keywords' can now go anywhere in 881 the document, not only after the header. 882 883 Note that everything which was made deprecated is still accepted 884 as valid input, however their use does cause the generation of 885 warnings. This means that the language after the changes is a 886 proper superset of the language before it. Old documents can be 887 processed just fine with the new code. 888 889 * mpformats/fmt.html: Use the new list types for translation. 890 * mpformats/fmt.latex: 891 * mpformats/fmt.text: 892 * mpformats/fmt.tmml: 893 894 * mpformats/fmt.nroff: Add a para when closing an inner list. 895 896 * mpformats/idx.html: Rewritten to be single-pass, defering output 897 until the index is closed. Changed to ensure that keywords are 898 printed alpha-sorted (lsort -dict). Added navigation bar and 899 sectioning of the index. 900 901 * apps/dtplite: Added a format 'validate' as alias for 'null', 902 * apps/dtplite.man: both of these now do not require an output 903 specification anymore. Added the collection and printing of 904 warnings. Replaced the homegrown commands for the reading and 905 writing of files with calls to fileutil commands. Now processing 906 input files in alphabetical order. Put common code for doctoc 907 and docidx generation into a small set of commands. toc and idx 908 are now sorted by description/keyword, output is column-aligned. 909 The doc* output is saved, to serve as examples. Document titles 910 are now cross-referencable via 'term', allowing direct links 911 between documents. Comments about internals added. Documentation 912 updated for the new functionality, and fixed all warnings due to 913 use of deprecated commands and list types. Added a section on 914 how to give feedback. 915 916 * cvs.man: Fixed all warnings due to use of deprecated commands 917 * changelog.man: and list types, tweaked the titles, and added 918 sections about how to give feedback. 919 920 * docidx.man: Significant rewrites for better language, better 921 * doctoc.man: referencing of introductory documents. Tweaked the 922 * doctools.man: titles, and added sections about how to give 923 feedback. 924 925 * docidx_api.man: *** REMOVED *** old documentation about the 926 * docidx_fmt.man: languages and plugin APIs. 927 * doctoc_api.man: 928 * doctoc_fmt.man: 929 * doctools_api.man: 930 * doctools_fmt.man: 931 932 * docidx_intro.man: *** ADDED *** new documentation about the 933 * docidx_lang_cmdref.man: languages and plugin APIs, with basic 934 * docidx_lang_faq.man: introductions, cross-referencing to 935 * docidx_lang_intro.man: related documents, further readings, 936 * docidx_lang_syntax.man: introduction by example, first 937 * docidx_plugin_apiref.man: beginning of faqs. 938 * doctoc_intro.man: 939 * doctoc_lang_cmdref.man: 940 * doctoc_lang_faq.man: 941 * doctoc_lang_intro.man: 942 * doctoc_lang_syntax.man: 943 * doctoc_plugin_apiref.man: 944 * doctools_intro.man: 945 * doctools_lang_cmdref.man: 946 * doctools_lang_faq.man: 947 * doctools_lang_intro.man: 948 * doctools_lang_syntax.man: 949 * doctools_plugin_apiref.man: 950 9512006-10-25 Andreas Kupries <andreask@activestate.com> 952 953 * doctools.test: Added an explicit LANG=C setting to the tests. 954 * docidx.test: At least OS X needs the setting to behave correctly. 955 * doctoc.test: Thanks to Gustaf Neumann for the report. 956 9572006-10-08 Andreas Kupries <andreas_kupries@users.sourceforge.net> 958 959 * doctools.test: Rewritten to use new features for handling the 960 * docidx.test: environment. 961 * doctoc.test: 962 9632006-10-03 Andreas Kupries <andreas_kupries@users.sourceforge.net> 964 965 * 966 * Released and tagged Tcllib 1.9 ======================== 967 * 968 9692006-10-02 Andreas Kupries <andreas_kupries@users.sourceforge.net> 970 971 * doctools.test: Made the testsuite robust against locale 972 * doctoc.test: settings in the environment. The tests 973 * docidx.test: assume the default locale (LANG=C). 974 9752006-09-19 Andreas Kupries <andreask@activestate.com> 976 977 * doctools.man: Bumped version to 1.2.1 978 * doctools.tcl: 979 * pkgIndex.tcl: 980 9812006-08-10 Andreas Kupries <andreask@activestate.com> 982 983 * mpformats/_text.tcl: Replaced textutil with the exact packages 984 * mpformats/fmt.text: needed, and adjusted all callers to use the 985 long command names. 986 9872006-06-16 Andreas Kupries <andreask@activestate.com> 988 989 * ../../apps/dtplite: Still found a xref link bug in the -merge 990 code path. The per-module toc had the wrong links. Added code to 991 generate and set a proper file mapping for these tocs. Removed 992 MapLink and switched to the new command "fileutil::relativeUrl". 993 9942006-03-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 995 996 * mpformats/_nroff.tcl: Do not double-quote (sub)section titles if 997 they do not contain whitespaces. 998 9992006-01-28 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1000 1001 * doctools.test: Fixed use of duplicate test names 1002 10032006-01-22 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1004 1005 * docidx.test: More boilerplate simplified via use of test support. 1006 * doctoc.test: 1007 * doctools.test: 1008 10092006-01-19 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1010 1011 * docidx.test: Hooked into the new common test support code. 1012 * doctoc.test: 1013 * doctools.test: 1014 10152005-10-06 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1016 1017 * 1018 * Released and tagged Tcllib 1.8 ======================== 1019 * 1020 10212005-10-03 Andreas Kupries <andreask@activestate.com> 1022 1023 * checker.tcl: Added code checking for ambiguities in section 1024 * mpformats/c.msg: and subsection titles. It causes warnings. 1025 * mpformats/en.msg: Extended the message catalogs with strings for 1026 * mpformats/de.msg: the new warning. 1027 * mpformats/fr.msg: 1028 10292005-06-17 Andreas Kupries <andreask@activestate.com> 1030 1031 * mpformats/_common.tcl (c_sectionId): Converting quotes into 1032 underscores. Fixes [SF Tcllib Bug 1220089]. 1033 10342005-06-06 Andreas Kupries <andreask@activestate.com> 1035 1036 * mpformats/fr.msg: Fixed [Tcllib SF Bug 1213636], reported by 1037 <sarnold75@users.sourceforge.net>, by removing the incorrect 1038 english strings preceding the french ones. 1039 10402005-04-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1041 1042 * doctools.test: Testsuite package requirements fixed to ensure 1043 * docidx.test: use of local packages. 1044 * doctoc.test: 1045 1046 * doctools.tcl: Typo police. 1047 * docidx.tcl: 1048 * doctoc.tcl: 1049 10502005-02-18 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1051 1052 * mpformats/_nroff.tcl: Fixed problem with comment 1053 handling. Before the fix we could generate output where nroff 1054 would misinterpret a string in apostrophes at the beginning of a 1055 line as comment. Regular comments now have the special \1 1056 quoting for markup. 1057 1058 * fmt.nroff: Fixed list processing. The commands stating list 1059 items needed newlines to ensure proper separation if the input 1060 has text immediately following the command, and not on the next 1061 line. Superfluous newlines coming from text stating in the next 1062 line is automatically excised during post-processing. 1063 10642005-01-17 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1065 1066 * mpformats/_nroff.tcl: Extended the post processing to regularize 1067 confusing *roff formatting at the beginning of lines. This fixes 1068 Tcllib SF Bug 1094294, which was reported by Rolf Ade 1069 <pointsman@users.sourceforge.net>. 1070 10712005-01-11 Andreas Kupries <andreask@activestate.com> 1072 1073 * mpformats/fmt.nroff: Fixed bad nroff formatting for examples 1074 * mpformats/_nroff.tcl: with explicit start/end commands. 1075 10762004-11-01 Andreas Kupries <andreask@activestate.com> 1077 1078 * mpformats/fmt.html (fmt_namespace): Added HTML backend code for 1079 the namespace command. 1080 10812004-10-05 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1082 1083 * 1084 * Released and tagged Tcllib 1.7 ======================== 1085 * 1086 10872004-09-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1088 1089 * mpformats/_text.tcl: Fixed expr'essions without braces. 1090 10912004-09-21 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1092 1093 * mpformats/fmt.nroff: Removed superfluous nr_rst calls inserted 1094 at the end of a command, by the commands 'call', and 'usage'. 1095 10962004-07-30 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1097 1098 * mpformats/_common.tcl: Made section references 1099 * mpformats/fmt.html: insensitive to case of 1100 * mpformats/fmt.latex: the refering text. Also 1101 * mpformats/fmt.nroff: now allowing an optional 1102 * mpformats/fmt.text: label to the reference 1103 * mpformats/fmt.tmml: a different text than 1104 * mpformats/fmt.wiki: the section title. Updated 1105 * doctools_fmt.man: the format and api specifi- 1106 * doctools_api.man: cations. 1107 * checker.tcl: 1108 11092004-07-29 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1110 1111 * mpformats/idx.html: Changed index table to use top alignment. 1112 1113 * doctools.man: Full overhaul of the documentation 1114 * doctools_api.man: pertaining to doctools, format, engine 1115 * doctools_fmt.man: api, and framework package. 1116 1117 * docidx_fmt.man: Typo fixes. 1118 * doctoc_fmt.man: 1119 1120 * doctools.test: Updated to changes in error processing made 1121 * doctoc.test: on 2004-07-22 (See below). 1122 * docidx.test: 1123 11242004-07-24 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1125 1126 * docidx_fmt.man: More overhaul. 1127 * docidx_api.man: 1128 * doctoc_fmt.man: 1129 * doctoc_api.man: 1130 * doctoc.man: 1131 * doctools_fmt.man: 1132 * doctools_api.man: 1133 * doctools.man: 1134 * changelog.man: 1135 * cvs.man: 1136 11372004-07-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1138 1139 * docidx_api.man: Overhaul. 1140 * docidx.man: 1141 1142 * ../../apps/dtplite: Revamped the whole file mapping. Actually 1143 ripped it out. Is not needed, the formatting engine does the 1144 necessary parts for us, if we feed it the correct -file 1145 options. This kills the outstanding bug with xref links. 1146 1147 * ../../apps/dtplite: Bugfix. Added checks to prevent duplicate 1148 entries in the keyword index. Without these checks going through 1149 a set of packages twice for merging will create double links for 1150 each actual entry. Changed the representation of the index saved 1151 between merge invokations to keep the array for the voiding of 1152 duplicates around. 1153 1154 * docidx.man: Overhaul of documentation. 1155 * cvs.man: 1156 * changelog.man: 1157 11582004-07-22 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1159 1160 * ../../apps/dtplite: Reduced error output, show only the message, 1161 not the whole stack. 1162 1163 * doctools.tcl: Changed processing of error messages so that 1164 * doctoc.tcl: we don't loose the location information. 1165 * docidx.tcl: 1166 11672004-07-22 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1168 1169 * doctools_api.man: Polished the manpages a bit, 1170 * ../../apps/dtplite.man: for better cross-referencing. 1171 1172 * mpformats/fmt.html: Fixed initialization bug regarding 1173 cross-references. Added xref matching to the formatting commands 1174 'term' and 'package'. Extended matching to allow multiple 1175 prefixes, and to search for the word in lowercase. 1176 11772004-07-20 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1178 1179 * apps/dtplite.man: New application for doctools processing. 1180 * apps/dtplite: Supercedes 'mpexpand'. Will be installed. 1181 1182 * mpformats/idx.html: Added engine parameter 'kwid', allowing the 1183 external definition of anchor names for keywords instead of 1184 having them generated automatically. Required for persistence 1185 when extending an existing index. 1186 1187 * mpformats/fmt.html: Added eols to the table of contents for 1188 better readability of the generated HTML. 1189 1190 * mpformats/toc.nroff: Fixed bad markup in genration of 1191 * mpformats/idx.nroff: tocs and indices. Internal markers 1192 were not stripped out. 1193 1194 * mpformats/toc.wiki: 1195 * mpformats/toc.tmml: 1196 * mpformats/toc.text: 1197 * mpformats/toc.nroff: 1198 * mpformats/toc.html: 1199 * checker_toc.tcl: Extended 'division_start' formatting command 1200 * doctoc_fmt.man: with an optional second argument, a symbolic 1201 file reference. Create a link to this file from the division 1202 label, if supported by the format. Where not the second argument 1203 will be ignored. 1204 12052004-07-10 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1206 1207 * docidx.man: Fixed [Tcllib SF Bug 985601]. A number 1208 * doctoc.man: of options (-copyright) and methods (map, 1209 * doctools.man: parameters, setparam) were not documented, 1210 * docidx_api.man: nor the engine parameters supported by the 1211 * doctoc_api.man: predefined html formatters (header, footer, 1212 * doctools_api.man: meta, xref). This is no longer the case. 1213 12142004-05-30 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1215 1216 * mpexpand.man: Updated reference 'dtformat' to 'doctools_fmt'. 1217 12182004-05-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1219 1220 * doctools.tcl: Updated version number to distinguish from the 1221 * doctools.man: 1.6.1 release. 1222 * pkgIndex.tcl: 1223 12242004-05-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1225 1226 * 1227 * Released and tagged Tcllib 1.6.1 ======================== 1228 * 1229 12302004-05-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1231 1232 * doctools.tcl: Rel. engineering. Updated version number 1233 * doctools.man: of doctools to reflect its changes, to 1.0.2. 1234 * pkgIndex.tcl: 1235 12362004-05-14 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1237 1238 * doctools.tcl: Fixed a bug in the namespace implementation 1239 * checker.tcl: (RFE 943145, see below). Cannot use 'namespace' in 1240 checker, it uses msgcat, uses in turn the builtin, overwriting 1241 is bad. Have to handle this specially (New name, rewrite to new 1242 name) before handing the macro over to the expander. 1243 1244 * doctools.tcl: Implemented [SF Tcllib RFE 772490] for 1245 * checker.tcl: doctools, the addition of 'subsections' 1246 * mpformats/_common.tcl: to the language. Updated the main engine, 1247 * mpformats/_nroff.tcl: the validator subsystem, and all formatting 1248 * mpformats/_text.tcl: engines which are coming with the package. 1249 * mpformats/fmt.html: For HTML output subsections are added to 1250 * mpformats/fmt.latex: the TOC (See [SF Tcllib RFE 772491] below) 1251 * mpformats/fmt.nroff: as well. 1252 * mpformats/fmt.null: 1253 * mpformats/fmt.text: 1254 * mpformats/fmt.tmml: 1255 * mpformats/fmt.wiki: 1256 12572004-05-14 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1258 1259 * mpformats/_text.tcl (SECT): Fixed a small problem in the text 1260 generator which was present for ages. Titles of more than one 1261 word would have braces around them. Not fatal but also not so 1262 nice looking. It was an argument versus argument list 1263 thing. Adding a lindex in the proper place gets rid of the 1264 additional level of quoting. 1265 12662004-05-04 Andreas Kupries <andreask@activestate.com> 1267 1268 * mpformats/fmt.html: Implemented [SF Tcllib RFE 772491]. Added 1269 the generation of a table of contents at the beginning of the 1270 html output for quick jumps to the various parts of the 1271 documentation. 1272 1273 * checker.tcl: Accepted [SF Tcllib RFE 946856], an 1274 * doctools_fmt.man: extension of the uri command to allow 1275 * doctools.tcl: labels. Updated documentation, added 1276 * mpformats/fmt.html: added to highlevel implementation, 1277 * mpformats/fmt.latex: updated all predefined formatters. 1278 * mpformats/fmt.nroff: 1279 * mpformats/fmt.null: Accepted [SF Tcllib RFE 943145] as 1280 * mpformats/fmt.text: well, adding a namespace markup. 1281 * mpformats/fmt.tmml: 1282 * mpformats/fmt.wiki: 1283 1284 * mpformats/_nroff.tcl: Fixed [SF Tcllib Bug 943146]. Added markup 1285 * mpformats/fmt.nroff: protection code like already in use for 1286 HTML and XML to handle nroff's special 1287 characters, i.e. the backslash properly. 1288 Also fixed handling of leading dashes in 1289 'opt_def'. 1290 12912004-04-22 Joe English <jenglish@users.sourceforge.net> 1292 1293 * mpformats/fmt.xml: BUGFIX: "puts stderr" ==> "puts_stderr". 1294 12952004-02-15 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1296 1297 * 1298 * Released and tagged Tcllib 1.6 ======================== 1299 * 1300 13012004-02-09 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1302 1303 * doctools.test: Fixed problems with Tcl 8.5, the tests were 1304 dependent on the order of keys in the result of [array get]. 1305 13062003-10-21 Andreas Kupries <andreask@activestate.com> 1307 1308 * mpformats/fmt.wiki (fmt_manpage_end): Fixed usage of wrong 1309 variable ('copyright' was used, should have been 'ct'). 1310 [Bug 826206]. 1311 13122003-06-06 Andreas Kupries <andreask@activestate.com> 1313 1314 * mpformats/fr.msg: Added french message catalog. Supplied by 1315 David Zolli <dzolli@users.sourceforge.net>, aka kroc. This is 1316 tracker item [Bug 744149]. 1317 13182003-05-23 Andreas Kupries <andreask@activestate.com> 1319 1320 * mpformats/fmt.nroff (fmt_arg_def, fmt_cmd_def): Analogous errors 1321 to fmt_opt_def, see below. Fixed. Reported by David Welton. 1322 13232003-05-21 Andreas Kupries <andreask@activestate.com> 1324 1325 * mpformats/fmt.nroff (fmt_opt_def): Fixed bug. Called [option], 1326 should have been [fmt_option]. Prevented the nroff conversion of 1327 the multiplexer documentation. Reported by David Welton. 1328 13292003-05-05 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1330 1331 * 1332 * Released and tagged Tcllib 1.4 ======================== 1333 * 1334 13352003-04-01 Andreas Kupries <andreask@activestate.com> 1336 1337 * checker_toc.tcl: Bug fixes for handling of nested toc divisions. 1338 1339 * ../../examples/doctools/doctools.idx: 1340 * ../../examples/doctools/doctools.toc: Updated to reflect latest 1341 changes in the format definitions. 1342 1343 * doctoc.tcl: 1344 * docidx.tcl: Added the package and file ops initially created in 1345 doctools.tcl to these packages too, so that their text engines 1346 can use 'textutil' too. 1347 1348 * mpformats/_text.tcl: 1349 * mpformats/fmt.text: 1350 * mpformats/toc.text: 1351 * mpformats/idx.text: Bug fixes. 1352 13532003-03-31 Andreas Kupries <andreask@activestate.com> 1354 1355 * mpformats/toc.text: 1356 * mpformats/idx.text: New files, toc & index formatting in plain text. 1357 1358 * mpformats/_text.tcl: 1359 * mpformats/fmt.text: Moved processing of plain text into the generic part. 1360 13612003-03-31 Andreas Kupries <andreask@activestate.com> 1362 1363 * cvs.tcl (scanLog): Applied fix for Bug #712951 reported by Joe 1364 English <jenglish@users.sourceforge.net>. 1365 13662003-03-29 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1367 1368 * doctools.tcl (SetupFormatter): Moved error output command to the 1369 front, so that the code loading the engine can use it too, and 1370 not only the engine procedures. Added alias for 'file', and a 1371 special command which is a shortcut for 'package require' so 1372 that engines can load packages. This was required for the plain 1373 text engine which makes heavy use of the formatting commands in 1374 'textutil'. Added setup of 'ctopandclear'. 1375 (SetupChecker): Added setup of 'ctopandclear'. 1376 (Package, Locate): New commands supporting package 1377 require. Instead of trying to enable every command in the safe 1378 interpreter required for package management we use the standard 1379 package commands to locate the index for thr requested package 1380 and evaluate just that in the safe interpreter, after 1381 temporarily enabling source and load commands. 1382 1383 * checker.tcl: Added code for debugging, like already present in 1384 the files checker_doc*.tcl. 1385 1386 * mpformats/_text.tcl: Core for plain text engines. 1387 * mpformats/fmt.text: New engine. Generates output in plain text. 1388 13892003-03-28 Andreas Kupries <andreask@activestate.com> 1390 1391 * pkgIndex.tcl: added 'doctools::cvs' and 'doctools::changelog' to 1392 the package index. 1393 1394 * changelog.man: 1395 * changelog.tcl: New. Parsing of ChangeLogs into list structures, 1396 merging of multiple logs, conversion into a doctools 1397 document. The code for parsing came originally out 1398 Makedist_SupportAku, a private package extending my Makedist 1399 tool. Documented the code. 1400 1401 * cvs.tcl (toChangeLog): Using the new textutil commands 'indent' 1402 and 'undent' for proper alignment of the comments extracted from 1403 the log. 1404 14052003-03-27 Andreas Kupries <andreask@activestate.com> 1406 1407 * cvs.man: 1408 * cvs.tcl: Added code to handle parsing and reformatting of cvs 1409 log files. Origin of the code the tcl'ers wiki, page 1410 http://wiki.tcl.tk/log2changelog. The actual original author is 1411 unknown (not listed on the wiki). 1412 14132003-03-24 Andreas Kupries <andreask@activestate.com> 1414 1415 * doctools_fmt.man: Fixed documentation bug #704187 reported by 1416 Roy Terry <royterry@users.sourceforge.net>. 1417 14182003-03-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1419 1420 * checker.tcl: Fixed incorrect signature of 'usage'. 1421 * mpformats/fmt.null: Bugfix in naming of the procedures. 1422 14232003-03-13 Andreas Kupries <andreask@activestate.com> 1424 1425 * mpformats/_common.tcl: Fixed initialization error for 1426 cross-references causing unwanted suppression (leakage of 1427 definitions between multiple pages). 1428 1429 * doctoc.tcl: Bug fixes in three return statemments. 1430 * docidx.tcl: (return -code error string, not return -code string) 1431 * doctools.tcl: 1432 14332003-03-11 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1434 1435 * mpformats/fmt.html: Rewrite handling of [keywords] and 1436 * mpformats/fmt.latex: [see_also] to behave like for the TMML 1437 * mpformats/fmt.list: formatter: Collect all keywords and 1438 * mpformats/fmt.nroff: x-references during the first pass, insert 1439 * mpformats/fmt.wiki: the results during the second pass, in 1440 [manpage_end]. Ensures that at most one 1441 see_also / keyword section is present, 1442 ensures uniform order and handling of 1443 multiple keyword / see_also commands is 1444 now uniform too. 1445 1446 * examples/doctools.idx: Moved to the new examples/doctools 1447 * examples/doctools.toc: directory. Thanks to Larry Virden 1448 <lvirden@users.sourceforge.net> for 1449 pointing out that the original location 1450 in the doctools module violated the 1451 principle of collecting examples in a 1452 separate directory, instated by 1453 myself. Stupid me. 1454 14552003-03-04 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1456 1457 * A examples/doctools.idx: Fairly extensive revamping of the 1458 * A examples/doctools.toc: codebase. Added a format for 1459 * A mpformats/_idx_common.tcl: indices, formatting engines, a 1460 * A mpformats/_toc_common.tcl: package for handling it. Extended 1461 * A mpformats/idx.html: all packages to allow engine 1462 * A mpformats/idx.nroff: parameters and mapping from 1463 * A mpformats/idx.null: symbolic to actual filenames or 1464 * A mpformats/idx.wiki: urls. Right now only the HTML 1465 * A mpformats/toc.html: engines actually provide 1466 * A mpformats/toc.nroff: parameters. Added testsuites for 1467 * A mpformats/toc.null: doctoc and docidx. Revamped the 1468 * A mpformats/toc.tmml: documentation to cross-reference 1469 * A mpformats/toc.wiki: each other better, more uniform in 1470 * A api_idx.tcl: structure (not complete), naming of 1471 * A api_toc.tcl: the manpages for this module is now 1472 * A checker_idx.tcl: uniform. Added examples for doctoc 1473 * A checker_toc.tcl: and docidx formats, both in the 1474 * A docidx.man: manpages, and as separate files. 1475 * A docidx.tcl: 1476 * A docidx.test: 1477 * A docidx_api.man: 1478 * A docidx_fmt.man: 1479 * A doctoc.man: 1480 * A doctoc.tcl: 1481 * A doctoc.test: 1482 * A doctoc_api.man: 1483 * A doctoc_fmt.man: 1484 * A doctools_api.man: 1485 * A doctools_fmt.man: 1486 * A tocexpand: 1487 * M ChangeLog: 1488 * M NOTES: 1489 * M api.tcl: 1490 * M checker.tcl: 1491 * M doctools.man: 1492 * M doctools.tcl: 1493 * M doctools.test: 1494 * M pkgIndex.tcl: 1495 * M mpformats/_common.tcl: 1496 * M mpformats/_nroff.tcl: 1497 * M mpformats/c.msg: 1498 * M mpformats/de.msg: 1499 * M mpformats/en.msg: 1500 * M mpformats/fmt.html: 1501 * M mpformats/fmt.latex: 1502 * M mpformats/fmt.list: 1503 * R dtformat.man: 1504 * R dtformatter.man: 1505 15062003-02-16 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1507 1508 * mpformats/fmt.list: Modified to extract all meta information out 1509 of the page. Changed the output format. Argument to the 1510 'manpage' command in the output is now a key/value list 1511 acceptable to 'array set' instead of a simple list with fixed 1512 positions for the various data elements. 1513 15142003-02-16 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1515 1516 * doctoc.tcl: Specified a new portable format for 1517 * api_toc.tcl: writing a table of contents. Wrote a 1518 * checker_toc.tcl: package to handle input that format 1519 * dtocformat.man: and a number of formatting engines 1520 * dtocengine.man: plugging into this package to 1521 * mpformats/_toc_common.tcl: generate output in various formats. 1522 * mpformats/toc.html: This required additional checker code 1523 * mpformats/toc.nroff: and more messages in the message 1524 * mpformats/toc.null: catalogs. 1525 * mpformats/toc.tmml: 1526 * mpformats/toc.wiki: 1527 * pkgIndex.tcl: 1528 * mpformats/c.msg: 1529 * mpformats/en.msg: 1530 * mpformats/de.msg: 1531 * mpformats/_nroff.tcl: 1532 1533 * doctools.tcl: Rephrased documentation of SetupChecker a bit. 1534 15352003-02-12 Andreas Kupries <andreask@activestate.com> 1536 1537 * dtformatter.man: Updated the documentation to include the 1538 * dtformat.man: two new commands (vset, include). 1539 1540 * doctools.tcl (Eval): Added handling of new [include] 1541 * doctools.tcl (ExpandInclude): formatting command. 1542 1543 * checker.tcl (vset): New command in the formatting language for 1544 handling variables (setting and retrieving values). Differs from 1545 the regular in that the set value is not retruned as the result 1546 of the command. This is necessary to avoid unwanted insertion of 1547 data into the output stream. The command is handled in the 1548 checker layer (although no checking is required). The engines 1549 never see this command. 1550 1551 * mpformats/fmt.nroff: Changed both engines to not use the 1552 * mpformats/fmt.wiki: expander context stack anymore. It 1553 interferes with handling of include 1554 files. It was used to catch all output and 1555 then perform last-miunte processing. for 1556 that we have [fmt_postprocess], moved the 1557 code to that. 1558 15592003-01-27 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1560 1561 * mpformats/fmt.html: Modified generation of section titles to 1562 make the resulting HTML more conformant and less 1563 troublesome. Thanks to Larry Virden 1564 <lvirden@users.sourceforge.net> for the catch. Revised the 1565 engine a bit. Entries in the synopsis now refer directly to the 1566 location where they are defined ([call] command). 1567 15682003-01-16 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1569 1570 * mpformats/fmt.html: Removed 'strong' formatting. The checker 1571 * mpformats/fmt.latex: warns if used and warnings requested, it 1572 * mpformats/fmt.nroff: now also redirects the command to 'emph'. 1573 * mpformats/fmt.wiki: The option -visualwarn (doctools, and 1574 * mpformats/fmt.null: mpexpand) renamed to -deprecated. Message 1575 * mpformats/fmt.list: 'visualmarkup' removed from the catalogs, 1576 * mpformats/c.msg: and 'depr_strong' added instead. 1577 * mpformats/en.msg: 1578 * mpformats/de.msg: 1579 * checker.tcl: 1580 * doctools.tcl: 1581 * mpexpand: 1582 1583 * doctools.man: Updated, converted [strong] to better 1584 * dtformat.man: formatting commands. Ditto for all manpages 1585 * dtformatter.man: in tcllib containing 'strong'. 'strong' is now 1586 * mpexpand.man: not present anymore. 1587 1588 * mpformats/_common.tcl: Applied a patch by Joe English adding the 1589 * mpformats/fmt.tmml: copyright information to the appropriate 1590 place in the TMML output. This also fixes 1591 a bug in c_get_copyright where an empty 1592 string resulted in a incomplete line 1593 being given to the formatter. 1594 1595 * mpformats/fmt.html: Removed the phrase 'All rights reserved' 1596 * mpformats/fmt.latex: from the code, on recommendation by 1597 * mpformats/fmt.nroff: Joe English. 1598 * mpformats/fmt.wiki: 1599 1600 (In the way to early morrow :) 1601 * mpformats/fmt.html: Changed to display copyright information in 1602 * mpformats/fmt.latex: the conversion result itself and not only 1603 * mpformats/fmt.nroff: embedded in comments. 1604 * mpformats/fmt.wiki: 1605 16062003-01-14 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1607 1608 * doctools.tcl: Added a new formatting command, 1609 * doctools.test: 'copyright', to declare/assign copyright 1610 * doctools.man: for manpages. Updated both documentation 1611 * dtformat.man: and testsuite. Extended the common code 1612 * checker.tcl: base with convenience methods for storing 1613 * api.tcl: and retrieving such information. The 1614 * mpformats/fmt.html: retrieval operation also implements the 1615 * mpformats/fmt.latex: logic giving the information in a manpage 1616 * mpformats/fmt.list: precedence over information coming from the 1617 * mpformats/fmt.nroff: processor. Updated all predefined engines 1618 * mpformats/fmt.null: to handle the new command. TMML done only 1619 * mpformats/fmt.tmml: partially, as I don't know where the copy- 1620 * mpformats/fmt.wiki: right has to go. 1621 * mpformats/_common.tcl: 1622 * mpformats/_html.tcl: 1623 * mpformats/_nroff.tcl: 1624 * mpexpand: 1625 16262003-01-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1627 1628 * mpexpand: Moved format help into the package itself. 1629 * doctools.tcl: Changed the checker. Input syntax errors are not 1630 * checker.tcl: written to stderr anymore, but reported through 1631 * doctools.man: an standard tcl error. Warnings are collected and 1632 * doctools.test: can be queried after a formatting run. Made the 1633 generic engine more robust against failures in a 1634 formatting engine. Wrote documentation for the 1635 package. Extended the configuration method to be 1636 more standard. Wrote a testsuite. 1637 16382003-01-11 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1639 1640 * mpexpand: Nearly complete rewrite of the system. 1641 * mpformats/fmt.html: The recognized input format was _not_ 1642 * mpformats/fmt.latex: changed. The main functionality was 1643 * mpformats/fmt.list: placed into a package, doctools. This 1644 * mpformats/fmt.nroff: package allows the creation of multiple 1645 * mpformats/fmt.null: formatter objects, to be used alone or 1646 * mpformats/fmt.tmml: together. The application 'mpexpand' was 1647 * mpformats/fmt.wiki: rewritten to use that package and is now 1648 * mpformats/_common.tcl: much simpler. The communication between 1649 * mpformats/_nroff.tcl: the various stages was made simpler, and 1650 * mpformats/_xml.tcl: one slave interpreter was dropped because 1651 * mpformats/_html.tcl: of this. It might be added back if its 1652 * api.tcl: existence proves to be beneficial. The 1653 * checker.tcl: API between main systen and formatter 1654 * doctools.tcl: engine was changed, consequently all 1655 * dtformatter.man: existing engines had to be updated. They 1656 were also made simpler, especially in the 1657 area of list handling, because of the 1658 validation done by the checker subsystem. 1659 The version number is now 1.0. 1660 16612002-12-16 David N. Welton <davidw@dedasys.com> 1662 1663 * mpexpand (format_find): Added 'argv0' as a global variable, in 1664 order to avoid erroring out when providing a bad format. 1665 16662002-12-05 Andreas Kupries <andreask@activestate.com> 1667 1668 * mpformats/fmt.nroff: Changed so that comments coming before 1669 manpage_begin are moved after the standard header generated by 1670 manpage_begin. 1671 16722002-09-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1673 1674 * mpexpand: Corrected example formatting, have to run argument 1675 through plain text handling. 1676 * mpformats/fmt.wiki: Added Wiki formatting. 1677 16782002-07-08 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1679 1680 * mpformats/fmt.html: Changed bug #578465 which caused 1681 mis-generation of angle-brackets and quotes. 1682 16832002-06-06 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1684 1685 * mpformats/fmt.html: 1686 * mpformats/_html.tcl: Added the missing handling of " (") to 1687 the format. 1688 16892002-05-27 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1690 1691 * mpformats/_xml.tcl: args -> arguments, as the argument is not 1692 the last one. The code as is was not erroneous, but a possible 1693 trouble spot should tcl ever be more strict with 'args'. 1694 16952002-05-21 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1696 1697 * mpformats/fmt.nroff: Accepted patch for bug #556509, both by Joe 1698 English <jenglish@users.sourceforge.net>. 1699 17002002-05-09 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1701 1702 * This completes the implementation of SF tcllib item #534334. 1703 1704 * mpformats/fmt.html: See last entry, completed definitions for 1705 the new lists. 1706 1707 * format.man: Added the new commands (see last entry) to the 1708 format specification and also added more explanations regarding 1709 sections and paragraphs. 1710 17112002-05-09 Joe English <jenglish@users.sourceforge.net> 1712 1713 * mpexpand: 1714 * mpformats/c.msg: 1715 * mpformats/de.msg: 1716 * mpformats/en.msg: 1717 * mpformats/fmt.nroff: 1718 * mpformats/fmt.latex: 1719 * mpformats/fmt.list: 1720 * mpformats/fmt.nroff: 1721 * mpformats/fmt.null: Added new list types for arguments, options, 1722 commands, and Tk (widget) options. 1723 17242002-04-24 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1725 1726 * mpformats/fmt.html: 1727 * mpformats/_html.tcl: Changes analogous to TMML (see below) to 1728 differentiate internal markup and external special characters. 1729 17302002-04-24 Joe English <jenglish@users.sourceforge.net> 1731 1732 * mpformats/_xml.tcl 1733 * mpformats/fmt.tmml: Correctly handles XML markup characters 1734 in macro arguments. Also correctly escapes apostrophes 1735 in attribute values (previously-unnoticed bug). 1736 * mpformats/fmt.tmml: TMML uses <url> instead of <uri>, and 1737 does not have a <strong> element; changed output accordingly. 1738 17392002-04-23 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1740 1741 * format.man: Added descriptions for all the commands performing 1742 semantic markup. This closes bug #527025. 1743 17442002-04-10 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1745 1746 * mpexpand: Fixed error in checker of plain text. 1747 1748 * mpformats/fmt.nroff: Added newlines in front of dot commands to 1749 make sure that the formatting is correct. Superfluous newlines 1750 are stripped in the post processor of this format, so 1751 unconditionally adding them does not hurt. 1752 17532002-04-02 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1754 1755 * mpformats/en.msg: 1756 * mpformats/c.msg: 1757 * mpformats/de.msg: Added the messages required by the new code 1758 below. 1759 1760 * mpexpand: Added code to check that plain text is not used in 1761 places where it is not allowed. 1762 17632002-04-01 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1764 1765 * Committed changes to list generation (better generation of 1766 whitespace for HTML, allowing hints). Only the HTML formatter 1767 currently acknowledges hints. This fixes SF Bug #535382. 1768 17692002-03-26 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1770 1771 * mpexpand: Changed the generation of error messages by the format 1772 checker to use explicit error codes instead of trying to 1773 construct the whole message automatically. Error codes are 1774 mapped to textual messages using the message catalog facility, 1775 allowing for easy i18n and l10n of mpexpand. Catalogs for the 1776 locales "c", "en", and "de" are provided. 1777 1778 * mpformats/fmt.html: Changed uri formatting to be a link. 1779 1780 * mpformats/fmt.tmml: 1781 * mpformats/fmt.html: 1782 * mpformats/fmt.nroff: 1783 * mpformats/fmt.latex: 1784 * mpformats/fmt.list: 1785 * mpformats/fmt.null: 1786 * mpformats/_api.tcl: Added formatting commands "term" and "const" 1787 to allow the structural markup of non-specific terminology and 1788 of constant values. 1789 1790 * mpformats/fmt.nroff (bullet): Bulleting changed, use \(bu as 1791 bullet instead of *. 1792 (uri): Fixed error with underlining. 1793 17942002-03-25 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1795 1796 * mpexpand: Extended with additional code checking that the 1797 formatting commands are not used out of order and in the wrong 1798 context. This check is independent of the format and thus 1799 implemented outside of the format. Tcllib FR #530059. 1800 1801 * mpexpand: Implemented Tcllib FR #527029 (help options). 1802 18032002-03-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1804 1805 * mpformats/fmt.html: Removed 'center' alignment from 1806 examples. Tcllib Bug #528390. 1807 18082002-03-09 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1809 1810 * modules/doctools/format.man: Added documentation for [rb] and 1811 [lb]. This partially fixes bug #527025. 1812 1813 * modules/doctools/mpformats/_html.tcl: The patch for FR #527716 1814 also fixes a bug in the generation of HTML escapes. The table 1815 swiped from htmlparse seems to contain some non-standard 1816 escapes. Which are removed now. 1817 1818 * modules/doctools/format.man: 1819 * modules/doctools/mpexpand: 1820 * modules/doctools/mpformats/fmt.html: 1821 * modules/doctools/mpformats/fmt.latex: 1822 * modules/doctools/mpformats/fmt.list: 1823 * modules/doctools/mpformats/fmt.nroff: 1824 * modules/doctools/mpformats/fmt.null: 1825 * modules/doctools/mpformats/fmt.tmml: 1826 * modules/doctools/mpformats/fmt.tmml: Accepted FR #527716 by 1827 Bryan Oakley <boakley@users.sourceforge.net> which adds a 1828 command [usage] to the format. It allows the specification of 1829 usage information for the synopsis without the need to be 1830 embedded into a definition list. 1831 18322002-02-28 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1833 1834 * mpformats/fmt.nroff: Corrected problems with trimming lines and 1835 the stripping of empty lines. 1836 1837 * mpformats/fmt.html: Changed the formatting of examples. Embedded 1838 them into a table and additionally marked them with a black bar 1839 to the left. 1840 18412002-02-27 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1842 1843 * mpformats/fmt.null: Null format, does not produce any output. 1844 1845 * mpformats/fmt.tmml: 1846 * mpformats/fmt.nroff: 1847 * mpformats/fmt.latex: 1848 * mpformats/fmt.html: 1849 * mpformats/fmt.list: Implementations of the new command. 1850 1851 * mpexpand: Added the commands to the processor application. Added 1852 option "-visualwarn". When present the processor warn about 1853 usage of visual markup. Tcllib FR #517599. 1854 1855 * mpformats/_api.tcl: Added a number of semantic markup commands 1856 to the api as part of Tcllib FR #517599. Also added comment 1857 command, see Tcllib FR #520269. 1858 18592002-02-14 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1860 1861 * mpformats/_common.tcl: Frink run. 1862 18632002-02-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1864 1865 * mpformats/fmt.html: Added detection of section cross-references 1866 in [emph] and [strong] based on the code for TMML. 1867 18682002-02-13 Joe English <jenglish@users.sourceforge.net> 1869 1870 * mpformats/fmt.tmml: [example_begin] inside lists was 1871 not handled correctly. 1872 1873 * mpformats/fmt.tmml: Detect section cross-references 1874 in [emph] and [strong]. 1875 18762002-02-12 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1877 1878 * mpformats/_html.tcl: Added command to map HTML special 1879 characters to their escape sequences. 1880 1881 * mpformats/fmt.latex: Added code to disable special processing of 1882 plain text while inside of an example. 1883 1884 * mpformats/fmt.tmml: Added HandleText call to [example] to handle 1885 special XML characters inside of the example. Not requitred for 1886 [example_begin] / [example_end] as the text will go through 1887 HandleText automatically for that case. 1888 1889 * mpformats/fmt.nroff: Added split to lsearch statement in 1890 manpage_end to make the code robust against strings which are 1891 not valid lists. 1892 18932002-02-12 Joe English <jenglish@users.sourceforge.net> 1894 1895 * Added [example_begin] and [example_end] commands. 1896 Also [example { code ... }] command. 1897 18982001-12-13 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1899 1900 * Added formatter for LaTeX. 1901 19022001-12-12 Andreas Kupries <andreas_kupries@users.sourceforge.net> 1903 1904 * New module. Application module providing a simple tcl-based 1905 manpage markup language and a processor for converting this 1906 format to TMML, nroff and HTML. Extensible, i.e. additional 1907 formats can be added without to much work (Manpages for format 1908 and internal interfaces are provided). 1909