Tcl Library Source Code

Changes On Branch tcllib-1-21-rc
Login
Core Home Blog Docs Downloads Tickets Timeline Branches Tags Wiki
Patch Side-by-Side Diff

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Changes In Branch tcllib-1-21-rc Excluding Merge-Ins

This is equivalent to a diff from 134879802e to 2880642f73

2022-05-07
15:51
Tcllib Release 1.21 work integrated with trunk. Released. check-in: a25bdeaef4 user: aku tags: trunk, release, tcllib-1-21
14:21
Updated various meta data files. Closed-Leaf check-in: 2880642f73 user: aku tags: tcllib-1-21-rc
14:01
Updated information about deprecated packages. All have reached Stage 2. Attempts to use will now throw errors referencing their replacement. check-in: d1be409235 user: aku tags: tcllib-1-21-rc
2022-05-06
11:08
Merge documentation fix for picoirc. Still need to regen documentation. check-in: a2fb9ff71c user: gay tags: tcllib-1-21-rc
11:06
irc / picoirc - D - Correct chat callback on NOTICE. check-in: 134879802e user: gay tags: trunk
09:53
irc / picoirc - EF, D - Make [send] private and [post] behave like [send] when channel name is empty. Bump to version 0.13.0. check-in: 1772a32ea2 user: gay tags: trunk

Changes to DESCRIPTION.txt. 
1
2
3
4
5
6
7

8
9
10
11
12

13
14
15
16
17
18
19

1
2
3
4
5
6

7
8
9
10
11

12
13
14
15
16
17
18
19







-
+




-
+








Identifier: tcllib
Title:  Tcl Standard Library
Description: This package is intended to be a collection of
    Tcl packages that provide utility functions useful to a
    large collection of Tcl programmers.
Rights: BSD
Version: 1.20
Version: 1.21
URL: http://core.tcl.tk/tcllib
Architecture: tcl
Contributor:  <jeffh at activestate dot com>
Contributor: Aaron Faupell <afaupell at users dot sourceforge dot net>
Contributor: Andreas Kupries <andreas_kupries at users dot sourceforge dot net>
Contributor: Andreas Kupries <andreas dot kupries at gmail dot com>
Contributor: Arjen Markus <arjenmarkus at users dot sourceforge dot net>
Contributor: Benjamin Riefenstahl <b dot riefenstahl at turtle-trading dot net>
Contributor: Bob Techentin <techentin at users dot sourceforge dot net>
Contributor: Brent Welch <welch at scriptics dot com>
Contributor: Brett Schwarz <schwarzkopf at users dot sourceforge dot net>
Contributor: Colin McCormack <coldstore at users dot sourceforge dot net>
Contributor: Dan Kuchler <kuchler at ajubasolutions dot com>
︙
42
43
44
45
46
47
48

49
50
51
52

42
43
44
45
46
47
48
49
50
51
52
53








+





Contributor: Peter MacDonald <peter at pdqi dot com>
Contributor: Pierre David <pdav at users dot sourceforge dot net>
Contributor: Reinhard Max <max at suse dot de>
Contributor: Ross Mohn <rpmohn at panix dot com>
Contributor: Sandeep Tamhankar <sandeep at scriptics dot com>
Contributor: Scott Redman <redman at scriptics dot com>
Contributor: Scott Stanton <stanton at scriptics dot com>
Contributor: Shawn Wagner <shawnw dot mobile at gmail dot com>
Contributor: Steffen Traeger <Steffen dot Traeger at t-online dot de>
Contributor: Stephane Arnold <sarnold75 at users dot sourceforge dot net>
Contributor: Steve Ball <Steve dot Ball at zveno dot com>
Contributor: Will Duquette <will at wjduquette dot com>
Changes to apps/dtplite.man. 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

1
2












3
4
5
6
7
8
9



-
-
-
-
-
-
-
-
-
-
-
-








[comment {-*- tcl -*- doctools manpage}]
[manpage_begin dtplite n 1.0.5]
[see_also {docidx introduction}]
[see_also {doctoc introduction}]
[see_also {doctools introduction}]
[keywords conversion]
[keywords docidx]
[keywords doctoc]
[keywords doctools]
[keywords HTML]
[keywords manpage]
[keywords markup]
[keywords nroff]
[keywords TMML]
[copyright {2004-2013 Andreas Kupries <[email protected]>}]
[titledesc {Lightweight DocTools Markup Processor}]
[moddesc   {Documentation toolbox}]
[category  {Documentation tools}]
[description]
[para]
︙
Added apps/mkdoc. 

















































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

#!/bin/sh
# -*- tcl -*- A Tcl comment, whose contents don't matter \
exec tclsh "$0" "$@"

package require Tcl 8.6
package require mkdoc
package require hook

set Usage [string map [list "\n    " "\n"] {
    Usage: __APP__ ?[--help|version]? INFILE OUTFILE ?[--css file.css]?

    mkdoc - code documentation tool to process embedded Markdown markup
            given after "#'" comments

    Positional arguments (required):
    
        INFILE - input file with:
               - embedded Markdown comments: #' Markdown markup
               - pure Markdown code (file.md)

        OUTFILE - output file usually HTML or Markdown file,
                  file format is deduced on file extension .html or .md,
                  if OUTFILE is the `-` sign output is written to stdout

    Optional arguments:

        --help         - display this help page, and exit
        --version      - display version number, and exit
        --license      - display license information, and exit
        --css CSSFILE  - use the specified CSSFILE instead of internal default 
                         mkdoc.css

    Examples:

        # create manual page for mkdoc.tcl itself 
        __APP__ mkdoc.tcl mkdoc.html

        # create manual code for a CPP file using a custom style sheet
        __APP__ sample.cpp sample.html --css manual.css

        # extract code documentation as simple Markdown
        # ready to be processed further with pandoc
        __APP__ sample.cpp sample.md 

        # convert a Markdown file to HTML
        __APP__ sample.md sample.html

    Author: @ Dr. Detlef Groth, Schwielowsee, 2019-2022

    License: BSD
}]

if {[lsearch -exact $argv {--version}] > -1} {
    puts "[package provide mkdoc::mkdoc]"
    return
}
if {[lsearch -exact $argv {--license}] > -1} {
    puts "BSD License - see manual page"
    return
}

proc Report {event settings} {
    set label [dict get {
	D Defaults
	Y YAML....
	F Final...
    } $event]
    puts "$label $settings"
}

proc Done {outfile} {
    puts "Results written to `$outfile`."
}

proc Processing {infile inmode outmode} {
    puts "Processing $inmode file `$infile` for $outmode."
}

#hook bind mkdoc::mkdoc Header/Defaults x {::Report D}
hook bind mkdoc::mkdoc Header/YAML     x {::Report Y}
hook bind mkdoc::mkdoc Header/Final    x {::Report F}
hook bind mkdoc::mkdoc Done            x ::Done
hook bind mkdoc::mkdoc Processing      x ::Processing

if {[llength $argv] < 2 || [lsearch -exact $argv {--help}] > -1} {
    set usage [regsub -all {__APP__} $Usage [info script]]
    puts $usage
    exit 0
    
} elseif {[llength $argv] >= 2 && [lsearch -exact $argv {--run}] == 1} {
    # argv == `path --run ...` -- Modify for run to see `path ...`
    mkdoc::run {*}[lreplace $argv 1 1]

} elseif {[llength $argv] == 2} {
    if {[regexp {^-.} [lindex $argv 1]]} {
	puts stderr "Error: wrong outfile name [lindex $argv 1]"
	exit 1
    }

    mkdoc::mkdoc {*}$argv

} elseif {[llength $argv] > 2} {
    # Check for `--css` and replace with the internal `-css`
    set csspos [lsearch -exact $argv --css]
    if {$csspos >= 0} {
	set argv [lreplace $argv $csspos $csspos -css]
    }
    
    mkdoc::mkdoc {*}$argv
}

exit






Added apps/mkdoc.man.

















































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

[comment {-*- mode: tcl ; fill-column: 90 -*- doctools manpage}]
[vset VERSION 0.7.0]
[manpage_begin mkdoc n [vset VERSION]]
[copyright {2019-2022, Detlef Groth <detlef(at)dgroth(dot)de>}]
[moddesc   {Source code documentation using Markdown}]
[titledesc {Source code documentation extractor/converter application}]
[category  {Text processing}]
[description]

This document describes [cmd mkdoc], an application to extract documentation embedded in
source code files, be they [file .tcl], or other.


[section {Command Line}]

[list_begin definitions]

[call [cmd mkdoc] [option --help]]

The application prints a short help to standard output and exits.

[call [cmd mkdoc] [option --version]]

The application prints its version number to standard output and exits.

[call [cmd mkdoc] [option --license]]

The application prints its license to standard output and exits.

[call [cmd mkdoc] [arg input] [arg output] [opt "[option --css] [arg cssfile]"]]

The application reads the [arg input] file, extracts the embedded documentation, and
writes it to the [arg output] file.

[para] If the output file is not a [file .md] file the extracted documentation is
converted to HTML before being written.

[para] When generating and writing HTML the default CSS stylesheet can be overridden by
specifying the path to a custom stylesheet via option [option --css].

[para] If the input file is a [file .md] file it is expected to contain Markdown as-is,
instead of Markdown embedded into code.

[para] On the other side, when the file is considered code then the documentation is
expected to be contained in all lines starting with the marker [const "#'"].

For script languages like Tcl the [const #] character of this marker means that the
documentation is contained in the so-flagged comments.

For other languages the marker and documentation may have to be embedded into multi-line
comments.

[list_end]

[section Examples]

[example {
    # Create HTML manual for a CPP file using a custom style sheet
    mkdoc sample.cpp sample.html --css manual.css

    # Extract the documentation from code as simple Markdown, ready to be processed
    # further, for example with pandoc, or similar
    mkdoc sample.cpp sample.md 

    # Convert a Markdown file to HTML
    mkdoc sample.md sample.html
}]

[section "Bugs, Ideas, Feedback"]

This document, and the package it describes, will undoubtedly contain bugs and
other problems. Please report such to the author of this package. Please also report any ideas for enhancements you may have for
either package and/or documentation.

[section "Code Copyright"]

BSD License type:

[para] The following terms apply to all files a ssociated with the software unless
explicitly disclaimed in individual files.

[para] The authors hereby grant permission to use, copy, modify, distribute, and license
this software and its documentation for any purpose, provided that existing copyright
notices are retained in all copies and that this notice is included verbatim in any
distributions. No written agreement, license, or royalty fee is required for any of the
authorized uses.  Modifications to this software may be copyrighted by their authors and
need not follow the licensing terms described here, provided that the new terms are
clearly indicated on the first page of each file where they apply.

[para] In no event shall the authors or distributors be liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use of this
software, its documentation, or any derivatives thereof, even if the authors have been
advised of the possibility of such damage.

[para] The authors and distributors specifically disclaim any warranties, including, but
not limited to, the implied warranties of merchantability, fitness for a particular
purpose, and non-infringement.

This software is provided on an "as is" basis, and the authors and distributors have no
obligation to provide maintenance, support, updates, enhancements, or modifications.

[para] [strong {RESTRICTED RIGHTS}]: Use, duplication or disclosure by the government is
subject to the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in
Technical Data and Computer Software Clause as DFARS 252.227-7013 and FAR 52.227-19.

[vset CATEGORY mkdoc]
[manpage_end]






Changes to embedded/md/index.md.






︙


167
168
169
170
171
172
173
174

175
176
177
178
179
180
181

167
168
169
170
171
172
173

174
175
176
177
178
179
180
181








-
+








|<a name='constants'></a>constants|[math::constants](tcllib/files/modules/math/constants\.md) &#183; [units](tcllib/files/modules/units/units\.md)|
|<a name='container'></a>CONTAINER|[pt::peg::export::container](tcllib/files/modules/pt/pt\_peg\_export\_container\.md) &#183; [pt::peg::to::container](tcllib/files/modules/pt/pt\_peg\_to\_container\.md)|
|<a name='contents'></a>contents|[doctools2toc\_introduction](tcllib/files/modules/doctools2toc/toc\_introduction\.md)|
|<a name='context\_free\_grammar'></a>context\-free grammar|[grammar::me\_intro](tcllib/files/modules/grammar\_me/me\_intro\.md)|
|<a name='context\_free\_languages'></a>context\-free languages|[grammar::me\_intro](tcllib/files/modules/grammar\_me/me\_intro\.md) &#183; [grammar::peg](tcllib/files/modules/grammar\_peg/peg\.md) &#183; [grammar::peg::interp](tcllib/files/modules/grammar\_peg/peg\_interp\.md) &#183; [pt](tcllib/files/apps/pt\.md) &#183; [pt::ast](tcllib/files/modules/pt/pt\_astree\.md) &#183; [pt::cparam::configuration::critcl](tcllib/files/modules/pt/pt\_cparam\_config\_critcl\.md) &#183; [pt::cparam::configuration::tea](tcllib/files/modules/pt/pt\_cparam\_config\_tea\.md) &#183; [pt::json\_language](tcllib/files/modules/pt/pt\_json\_language\.md) &#183; [pt::param](tcllib/files/modules/pt/pt\_param\.md) &#183; [pt::pe](tcllib/files/modules/pt/pt\_pexpression\.md) &#183; [pt::pe::op](tcllib/files/modules/pt/pt\_pexpr\_op\.md) &#183; [pt::peg](tcllib/files/modules/pt/pt\_pegrammar\.md) &#183; [pt::peg::container](tcllib/files/modules/pt/pt\_peg\_container\.md) &#183; [pt::peg::container::peg](tcllib/files/modules/pt/pt\_peg\_container\_peg\.md) &#183; [pt::peg::export](tcllib/files/modules/pt/pt\_peg\_export\.md) &#183; [pt::peg::export::container](tcllib/files/modules/pt/pt\_peg\_export\_container\.md) &#183; [pt::peg::export::json](tcllib/files/modules/pt/pt\_peg\_export\_json\.md) &#183; [pt::peg::export::peg](tcllib/files/modules/pt/pt\_peg\_export\_peg\.md) &#183; [pt::peg::from::container](tcllib/files/modules/pt/pt\_peg\_from\_container\.md) &#183; [pt::peg::from::json](tcllib/files/modules/pt/pt\_peg\_from\_json\.md) &#183; [pt::peg::from::peg](tcllib/files/modules/pt/pt\_peg\_from\_peg\.md) &#183; [pt::peg::import](tcllib/files/modules/pt/pt\_peg\_import\.md) &#183; [pt::peg::import::container](tcllib/files/modules/pt/pt\_peg\_import\_container\.md) &#183; [pt::peg::import::json](tcllib/files/modules/pt/pt\_peg\_import\_json\.md) &#183; [pt::peg::import::peg](tcllib/files/modules/pt/pt\_peg\_import\_peg\.md) &#183; [pt::peg::interp](tcllib/files/modules/pt/pt\_peg\_interp\.md) &#183; [pt::peg::to::container](tcllib/files/modules/pt/pt\_peg\_to\_container\.md) &#183; [pt::peg::to::cparam](tcllib/files/modules/pt/pt\_peg\_to\_cparam\.md) &#183; [pt::peg::to::json](tcllib/files/modules/pt/pt\_peg\_to\_json\.md) &#183; [pt::peg::to::param](tcllib/files/modules/pt/pt\_peg\_to\_param\.md) &#183; [pt::peg::to::peg](tcllib/files/modules/pt/pt\_peg\_to\_peg\.md) &#183; [pt::peg::to::tclparam](tcllib/files/modules/pt/pt\_peg\_to\_tclparam\.md) &#183; [pt::peg\_language](tcllib/files/modules/pt/pt\_peg\_language\.md) &#183; [pt::pegrammar](tcllib/files/modules/pt/pt\_peg\_introduction\.md) &#183; [pt::pgen](tcllib/files/modules/pt/pt\_pgen\.md) &#183; [pt::rde](tcllib/files/modules/pt/pt\_rdengine\.md) &#183; [pt::tclparam::configuration::nx](tcllib/files/modules/pt/pt\_tclparam\_config\_nx\.md) &#183; [pt::tclparam::configuration::snit](tcllib/files/modules/pt/pt\_tclparam\_config\_snit\.md) &#183; [pt::tclparam::configuration::tcloo](tcllib/files/modules/pt/pt\_tclparam\_config\_tcloo\.md) &#183; [pt::util](tcllib/files/modules/pt/pt\_util\.md) &#183; [pt\_export\_api](tcllib/files/modules/pt/pt\_to\_api\.md) &#183; [pt\_import\_api](tcllib/files/modules/pt/pt\_from\_api\.md) &#183; [pt\_introduction](tcllib/files/modules/pt/pt\_introduction\.md) &#183; [pt\_parse\_peg](tcllib/files/modules/pt/pt\_parse\_peg\.md) &#183; [pt\_parser\_api](tcllib/files/modules/pt/pt\_parser\_api\.md) &#183; [pt\_peg\_op](tcllib/files/modules/pt/pt\_peg\_op\.md)|
|<a name='control'></a>control|[control](tcllib/files/modules/control/control\.md) &#183; [math::changepoint](tcllib/files/modules/math/changepoint\.md) &#183; [term](tcllib/files/modules/term/term\.md) &#183; [term::ansi::code](tcllib/files/modules/term/ansi\_code\.md) &#183; [term::ansi::code::attr](tcllib/files/modules/term/ansi\_cattr\.md) &#183; [term::ansi::code::ctrl](tcllib/files/modules/term/ansi\_cctrl\.md) &#183; [term::ansi::code::macros](tcllib/files/modules/term/ansi\_cmacros\.md) &#183; [term::ansi::ctrl::unix](tcllib/files/modules/term/ansi\_ctrlu\.md) &#183; [term::ansi::send](tcllib/files/modules/term/ansi\_send\.md) &#183; [term::interact::menu](tcllib/files/modules/term/imenu\.md) &#183; [term::interact::pager](tcllib/files/modules/term/ipager\.md) &#183; [term::receive](tcllib/files/modules/term/receive\.md) &#183; [term::receive::bind](tcllib/files/modules/term/term\_bind\.md) &#183; [term::send](tcllib/files/modules/term/term\_send\.md)|
|<a name='control\_structure'></a>control structure|[generator](tcllib/files/modules/generator/generator\.md)|
|<a name='conversion'></a>conversion|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools2idx\_introduction](tcllib/files/modules/doctools2idx/idx\_introduction\.md) &#183; [doctools2toc\_introduction](tcllib/files/modules/doctools2toc/toc\_introduction\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [math::roman](tcllib/files/modules/math/roman\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) &#183; [pt::peg::from::json](tcllib/files/modules/pt/pt\_peg\_from\_json\.md) &#183; [pt::peg::from::peg](tcllib/files/modules/pt/pt\_peg\_from\_peg\.md) &#183; [pt::peg::to::container](tcllib/files/modules/pt/pt\_peg\_to\_container\.md) &#183; [pt::peg::to::cparam](tcllib/files/modules/pt/pt\_peg\_to\_cparam\.md) &#183; [pt::peg::to::json](tcllib/files/modules/pt/pt\_peg\_to\_json\.md) &#183; [pt::peg::to::param](tcllib/files/modules/pt/pt\_peg\_to\_param\.md) &#183; [pt::peg::to::peg](tcllib/files/modules/pt/pt\_peg\_to\_peg\.md) &#183; [pt::peg::to::tclparam](tcllib/files/modules/pt/pt\_peg\_to\_tclparam\.md) &#183; [tcldocstrip](tcllib/files/apps/tcldocstrip\.md) &#183; [units](tcllib/files/modules/units/units\.md)|
|<a name='conversion'></a>conversion|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools2idx\_introduction](tcllib/files/modules/doctools2idx/idx\_introduction\.md) &#183; [doctools2toc\_introduction](tcllib/files/modules/doctools2toc/toc\_introduction\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [math::roman](tcllib/files/modules/math/roman\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [pt::peg::from::json](tcllib/files/modules/pt/pt\_peg\_from\_json\.md) &#183; [pt::peg::from::peg](tcllib/files/modules/pt/pt\_peg\_from\_peg\.md) &#183; [pt::peg::to::container](tcllib/files/modules/pt/pt\_peg\_to\_container\.md) &#183; [pt::peg::to::cparam](tcllib/files/modules/pt/pt\_peg\_to\_cparam\.md) &#183; [pt::peg::to::json](tcllib/files/modules/pt/pt\_peg\_to\_json\.md) &#183; [pt::peg::to::param](tcllib/files/modules/pt/pt\_peg\_to\_param\.md) &#183; [pt::peg::to::peg](tcllib/files/modules/pt/pt\_peg\_to\_peg\.md) &#183; [pt::peg::to::tclparam](tcllib/files/modules/pt/pt\_peg\_to\_tclparam\.md) &#183; [tcldocstrip](tcllib/files/apps/tcldocstrip\.md) &#183; [units](tcllib/files/modules/units/units\.md)|
|<a name='cooked'></a>cooked|[term::ansi::ctrl::unix](tcllib/files/modules/term/ansi\_ctrlu\.md)|
|<a name='cookie'></a>cookie|[ncgi](tcllib/files/modules/ncgi/ncgi\.md)|
|<a name='copy'></a>copy|[fileutil::multi](tcllib/files/modules/fileutil/multi\.md) &#183; [fileutil::multi::op](tcllib/files/modules/fileutil/multiop\.md) &#183; [transfer::copy](tcllib/files/modules/transfer/copyops\.md) &#183; [transfer::copy::queue](tcllib/files/modules/transfer/tqueue\.md) &#183; [transfer::data::destination](tcllib/files/modules/transfer/ddest\.md) &#183; [transfer::data::source](tcllib/files/modules/transfer/dsource\.md) &#183; [transfer::receiver](tcllib/files/modules/transfer/receiver\.md) &#183; [transfer::transmitter](tcllib/files/modules/transfer/transmitter\.md)|
|<a name='coroutine'></a>coroutine|[coroutine](tcllib/files/modules/coroutine/tcllib\_coroutine\.md) &#183; [coroutine::auto](tcllib/files/modules/coroutine/coro\_auto\.md) &#183; [generator](tcllib/files/modules/generator/generator\.md)|
|<a name='cost'></a>Cost|[treeql](tcllib/files/modules/treeql/treeql\.md)|
|<a name='counter'></a>counter|[tcl::transform::counter](tcllib/files/modules/virtchannel\_transform/vt\_counter\.md)|
|<a name='counting'></a>counting|[counter](tcllib/files/modules/counter/counter\.md)|




︙


246
247
248
249
250
251
252
253

254
255
256
257
258
259

260
261
262
263
264

265
266
267
268
269
270
271

246
247
248
249
250
251
252

253
254
255
256
257
258

259
260
261
262
263

264
265
266
267
268
269
270
271








-
+





-
+




-
+








|<a name='discover'></a>Discover|[valtype::creditcard::discover](tcllib/files/modules/valtype/cc\_discover\.md)|
|<a name='discrete\_items'></a>discrete items|[struct::pool](tcllib/files/modules/struct/pool\.md)|
|<a name='disjoint\_set'></a>disjoint set|[struct::disjointset](tcllib/files/modules/struct/disjointset\.md)|
|<a name='dispatcher'></a>dispatcher|[term::receive::bind](tcllib/files/modules/term/term\_bind\.md)|
|<a name='distance'></a>distance|[math::geometry](tcllib/files/modules/math/math\_geometry\.md) &#183; [struct::graph::op](tcllib/files/modules/struct/graphops\.md) &#183; [units](tcllib/files/modules/units/units\.md)|
|<a name='dns'></a>DNS|[dns](tcllib/files/modules/dns/tcllib\_dns\.md)|
|<a name='do'></a>do|[control](tcllib/files/modules/control/control\.md)|
|<a name='docidx'></a>docidx|[doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::export::docidx](tcllib/files/modules/doctools2idx/export\_docidx\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::idx::import::docidx](tcllib/files/modules/doctools2idx/import\_docidx\.md) &#183; [doctools::idx::parse](tcllib/files/modules/doctools2idx/idx\_parse\.md) &#183; [doctools::idx::structure](tcllib/files/modules/doctools2idx/idx\_structure\.md) &#183; [doctools::msgcat](tcllib/files/modules/doctools2base/tcllib\_msgcat\.md) &#183; [doctools::msgcat::idx::c](tcllib/files/modules/doctools2idx/idx\_msgcat\_c\.md) &#183; [doctools::msgcat::idx::de](tcllib/files/modules/doctools2idx/idx\_msgcat\_de\.md) &#183; [doctools::msgcat::idx::en](tcllib/files/modules/doctools2idx/idx\_msgcat\_en\.md) &#183; [doctools::msgcat::idx::fr](tcllib/files/modules/doctools2idx/idx\_msgcat\_fr\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md)|
|<a name='docidx'></a>docidx|[doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::export::docidx](tcllib/files/modules/doctools2idx/export\_docidx\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::idx::import::docidx](tcllib/files/modules/doctools2idx/import\_docidx\.md) &#183; [doctools::idx::parse](tcllib/files/modules/doctools2idx/idx\_parse\.md) &#183; [doctools::idx::structure](tcllib/files/modules/doctools2idx/idx\_structure\.md) &#183; [doctools::msgcat](tcllib/files/modules/doctools2base/tcllib\_msgcat\.md) &#183; [doctools::msgcat::idx::c](tcllib/files/modules/doctools2idx/idx\_msgcat\_c\.md) &#183; [doctools::msgcat::idx::de](tcllib/files/modules/doctools2idx/idx\_msgcat\_de\.md) &#183; [doctools::msgcat::idx::en](tcllib/files/modules/doctools2idx/idx\_msgcat\_en\.md) &#183; [doctools::msgcat::idx::fr](tcllib/files/modules/doctools2idx/idx\_msgcat\_fr\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md)|
|<a name='docidx\_commands'></a>docidx commands|[docidx\_lang\_cmdref](tcllib/files/modules/doctools/docidx\_lang\_cmdref\.md) &#183; [docidx\_lang\_faq](tcllib/files/modules/doctools/docidx\_lang\_faq\.md) &#183; [docidx\_lang\_intro](tcllib/files/modules/doctools/docidx\_lang\_intro\.md) &#183; [docidx\_lang\_syntax](tcllib/files/modules/doctools/docidx\_lang\_syntax\.md)|
|<a name='docidx\_language'></a>docidx language|[docidx\_lang\_cmdref](tcllib/files/modules/doctools/docidx\_lang\_cmdref\.md) &#183; [docidx\_lang\_faq](tcllib/files/modules/doctools/docidx\_lang\_faq\.md) &#183; [docidx\_lang\_intro](tcllib/files/modules/doctools/docidx\_lang\_intro\.md) &#183; [docidx\_lang\_syntax](tcllib/files/modules/doctools/docidx\_lang\_syntax\.md)|
|<a name='docidx\_markup'></a>docidx markup|[docidx\_lang\_cmdref](tcllib/files/modules/doctools/docidx\_lang\_cmdref\.md) &#183; [docidx\_lang\_faq](tcllib/files/modules/doctools/docidx\_lang\_faq\.md) &#183; [docidx\_lang\_intro](tcllib/files/modules/doctools/docidx\_lang\_intro\.md) &#183; [docidx\_lang\_syntax](tcllib/files/modules/doctools/docidx\_lang\_syntax\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md)|
|<a name='docidx\_syntax'></a>docidx syntax|[docidx\_lang\_faq](tcllib/files/modules/doctools/docidx\_lang\_faq\.md) &#183; [docidx\_lang\_intro](tcllib/files/modules/doctools/docidx\_lang\_intro\.md) &#183; [docidx\_lang\_syntax](tcllib/files/modules/doctools/docidx\_lang\_syntax\.md)|
|<a name='docstrip'></a>docstrip|[docstrip](tcllib/files/modules/docstrip/docstrip\.md) &#183; [docstrip\_util](tcllib/files/modules/docstrip/docstrip\_util\.md) &#183; [tcldocstrip](tcllib/files/apps/tcldocstrip\.md)|
|<a name='doctoc'></a>doctoc|[doctools::msgcat](tcllib/files/modules/doctools2base/tcllib\_msgcat\.md) &#183; [doctools::msgcat::toc::c](tcllib/files/modules/doctools2toc/toc\_msgcat\_c\.md) &#183; [doctools::msgcat::toc::de](tcllib/files/modules/doctools2toc/toc\_msgcat\_de\.md) &#183; [doctools::msgcat::toc::en](tcllib/files/modules/doctools2toc/toc\_msgcat\_en\.md) &#183; [doctools::msgcat::toc::fr](tcllib/files/modules/doctools2toc/toc\_msgcat\_fr\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::export::doctoc](tcllib/files/modules/doctools2toc/export\_doctoc\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [doctools::toc::import::doctoc](tcllib/files/modules/doctools2toc/import\_doctoc\.md) &#183; [doctools::toc::parse](tcllib/files/modules/doctools2toc/toc\_parse\.md) &#183; [doctools::toc::structure](tcllib/files/modules/doctools2toc/toc\_structure\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md)|
|<a name='doctoc'></a>doctoc|[doctools::msgcat](tcllib/files/modules/doctools2base/tcllib\_msgcat\.md) &#183; [doctools::msgcat::toc::c](tcllib/files/modules/doctools2toc/toc\_msgcat\_c\.md) &#183; [doctools::msgcat::toc::de](tcllib/files/modules/doctools2toc/toc\_msgcat\_de\.md) &#183; [doctools::msgcat::toc::en](tcllib/files/modules/doctools2toc/toc\_msgcat\_en\.md) &#183; [doctools::msgcat::toc::fr](tcllib/files/modules/doctools2toc/toc\_msgcat\_fr\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::export::doctoc](tcllib/files/modules/doctools2toc/export\_doctoc\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [doctools::toc::import::doctoc](tcllib/files/modules/doctools2toc/import\_doctoc\.md) &#183; [doctools::toc::parse](tcllib/files/modules/doctools2toc/toc\_parse\.md) &#183; [doctools::toc::structure](tcllib/files/modules/doctools2toc/toc\_structure\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md)|
|<a name='doctoc\_commands'></a>doctoc commands|[doctoc\_lang\_cmdref](tcllib/files/modules/doctools/doctoc\_lang\_cmdref\.md) &#183; [doctoc\_lang\_faq](tcllib/files/modules/doctools/doctoc\_lang\_faq\.md) &#183; [doctoc\_lang\_intro](tcllib/files/modules/doctools/doctoc\_lang\_intro\.md) &#183; [doctoc\_lang\_syntax](tcllib/files/modules/doctools/doctoc\_lang\_syntax\.md)|
|<a name='doctoc\_language'></a>doctoc language|[doctoc\_lang\_cmdref](tcllib/files/modules/doctools/doctoc\_lang\_cmdref\.md) &#183; [doctoc\_lang\_faq](tcllib/files/modules/doctools/doctoc\_lang\_faq\.md) &#183; [doctoc\_lang\_intro](tcllib/files/modules/doctools/doctoc\_lang\_intro\.md) &#183; [doctoc\_lang\_syntax](tcllib/files/modules/doctools/doctoc\_lang\_syntax\.md)|
|<a name='doctoc\_markup'></a>doctoc markup|[doctoc\_lang\_cmdref](tcllib/files/modules/doctools/doctoc\_lang\_cmdref\.md) &#183; [doctoc\_lang\_faq](tcllib/files/modules/doctools/doctoc\_lang\_faq\.md) &#183; [doctoc\_lang\_intro](tcllib/files/modules/doctools/doctoc\_lang\_intro\.md) &#183; [doctoc\_lang\_syntax](tcllib/files/modules/doctools/doctoc\_lang\_syntax\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md)|
|<a name='doctoc\_syntax'></a>doctoc syntax|[doctoc\_lang\_faq](tcllib/files/modules/doctools/doctoc\_lang\_faq\.md) &#183; [doctoc\_lang\_intro](tcllib/files/modules/doctools/doctoc\_lang\_intro\.md) &#183; [doctoc\_lang\_syntax](tcllib/files/modules/doctools/doctoc\_lang\_syntax\.md)|
|<a name='doctools'></a>doctools|[docstrip\_util](tcllib/files/modules/docstrip/docstrip\_util\.md) &#183; [doctools::changelog](tcllib/files/modules/doctools/changelog\.md) &#183; [doctools::html::cssdefaults](tcllib/files/modules/doctools2base/html\_cssdefaults\.md) &#183; [doctools::idx::export::docidx](tcllib/files/modules/doctools2idx/export\_docidx\.md) &#183; [doctools::idx::export::html](tcllib/files/modules/doctools2idx/idx\_export\_html\.md) &#183; [doctools::idx::export::json](tcllib/files/modules/doctools2idx/idx\_export\_json\.md) &#183; [doctools::idx::export::nroff](tcllib/files/modules/doctools2idx/idx\_export\_nroff\.md) &#183; [doctools::idx::export::text](tcllib/files/modules/doctools2idx/idx\_export\_text\.md) &#183; [doctools::idx::export::wiki](tcllib/files/modules/doctools2idx/idx\_export\_wiki\.md) &#183; [doctools::idx::import::docidx](tcllib/files/modules/doctools2idx/import\_docidx\.md) &#183; [doctools::idx::import::json](tcllib/files/modules/doctools2idx/idx\_import\_json\.md) &#183; [doctools::idx::parse](tcllib/files/modules/doctools2idx/idx\_parse\.md) &#183; [doctools::idx::structure](tcllib/files/modules/doctools2idx/idx\_structure\.md) &#183; [doctools::msgcat](tcllib/files/modules/doctools2base/tcllib\_msgcat\.md) &#183; [doctools::msgcat::idx::c](tcllib/files/modules/doctools2idx/idx\_msgcat\_c\.md) &#183; [doctools::msgcat::idx::de](tcllib/files/modules/doctools2idx/idx\_msgcat\_de\.md) &#183; [doctools::msgcat::idx::en](tcllib/files/modules/doctools2idx/idx\_msgcat\_en\.md) &#183; [doctools::msgcat::idx::fr](tcllib/files/modules/doctools2idx/idx\_msgcat\_fr\.md) &#183; [doctools::msgcat::toc::c](tcllib/files/modules/doctools2toc/toc\_msgcat\_c\.md) &#183; [doctools::msgcat::toc::de](tcllib/files/modules/doctools2toc/toc\_msgcat\_de\.md) &#183; [doctools::msgcat::toc::en](tcllib/files/modules/doctools2toc/toc\_msgcat\_en\.md) &#183; [doctools::msgcat::toc::fr](tcllib/files/modules/doctools2toc/toc\_msgcat\_fr\.md) &#183; [doctools::nroff::man\_macros](tcllib/files/modules/doctools2base/nroff\_manmacros\.md) &#183; [doctools::tcl::parse](tcllib/files/modules/doctools2base/tcl\_parse\.md) &#183; [doctools::toc::export::doctoc](tcllib/files/modules/doctools2toc/export\_doctoc\.md) &#183; [doctools::toc::export::html](tcllib/files/modules/doctools2toc/toc\_export\_html\.md) &#183; [doctools::toc::export::json](tcllib/files/modules/doctools2toc/toc\_export\_json\.md) &#183; [doctools::toc::export::nroff](tcllib/files/modules/doctools2toc/toc\_export\_nroff\.md) &#183; [doctools::toc::export::text](tcllib/files/modules/doctools2toc/toc\_export\_text\.md) &#183; [doctools::toc::export::wiki](tcllib/files/modules/doctools2toc/toc\_export\_wiki\.md) &#183; [doctools::toc::import::doctoc](tcllib/files/modules/doctools2toc/import\_doctoc\.md) &#183; [doctools::toc::import::json](tcllib/files/modules/doctools2toc/toc\_import\_json\.md) &#183; [doctools::toc::parse](tcllib/files/modules/doctools2toc/toc\_parse\.md) &#183; [doctools::toc::structure](tcllib/files/modules/doctools2toc/toc\_structure\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md)|
|<a name='doctools'></a>doctools|[docstrip\_util](tcllib/files/modules/docstrip/docstrip\_util\.md) &#183; [doctools::changelog](tcllib/files/modules/doctools/changelog\.md) &#183; [doctools::html::cssdefaults](tcllib/files/modules/doctools2base/html\_cssdefaults\.md) &#183; [doctools::idx::export::docidx](tcllib/files/modules/doctools2idx/export\_docidx\.md) &#183; [doctools::idx::export::html](tcllib/files/modules/doctools2idx/idx\_export\_html\.md) &#183; [doctools::idx::export::json](tcllib/files/modules/doctools2idx/idx\_export\_json\.md) &#183; [doctools::idx::export::nroff](tcllib/files/modules/doctools2idx/idx\_export\_nroff\.md) &#183; [doctools::idx::export::text](tcllib/files/modules/doctools2idx/idx\_export\_text\.md) &#183; [doctools::idx::export::wiki](tcllib/files/modules/doctools2idx/idx\_export\_wiki\.md) &#183; [doctools::idx::import::docidx](tcllib/files/modules/doctools2idx/import\_docidx\.md) &#183; [doctools::idx::import::json](tcllib/files/modules/doctools2idx/idx\_import\_json\.md) &#183; [doctools::idx::parse](tcllib/files/modules/doctools2idx/idx\_parse\.md) &#183; [doctools::idx::structure](tcllib/files/modules/doctools2idx/idx\_structure\.md) &#183; [doctools::msgcat](tcllib/files/modules/doctools2base/tcllib\_msgcat\.md) &#183; [doctools::msgcat::idx::c](tcllib/files/modules/doctools2idx/idx\_msgcat\_c\.md) &#183; [doctools::msgcat::idx::de](tcllib/files/modules/doctools2idx/idx\_msgcat\_de\.md) &#183; [doctools::msgcat::idx::en](tcllib/files/modules/doctools2idx/idx\_msgcat\_en\.md) &#183; [doctools::msgcat::idx::fr](tcllib/files/modules/doctools2idx/idx\_msgcat\_fr\.md) &#183; [doctools::msgcat::toc::c](tcllib/files/modules/doctools2toc/toc\_msgcat\_c\.md) &#183; [doctools::msgcat::toc::de](tcllib/files/modules/doctools2toc/toc\_msgcat\_de\.md) &#183; [doctools::msgcat::toc::en](tcllib/files/modules/doctools2toc/toc\_msgcat\_en\.md) &#183; [doctools::msgcat::toc::fr](tcllib/files/modules/doctools2toc/toc\_msgcat\_fr\.md) &#183; [doctools::nroff::man\_macros](tcllib/files/modules/doctools2base/nroff\_manmacros\.md) &#183; [doctools::tcl::parse](tcllib/files/modules/doctools2base/tcl\_parse\.md) &#183; [doctools::toc::export::doctoc](tcllib/files/modules/doctools2toc/export\_doctoc\.md) &#183; [doctools::toc::export::html](tcllib/files/modules/doctools2toc/toc\_export\_html\.md) &#183; [doctools::toc::export::json](tcllib/files/modules/doctools2toc/toc\_export\_json\.md) &#183; [doctools::toc::export::nroff](tcllib/files/modules/doctools2toc/toc\_export\_nroff\.md) &#183; [doctools::toc::export::text](tcllib/files/modules/doctools2toc/toc\_export\_text\.md) &#183; [doctools::toc::export::wiki](tcllib/files/modules/doctools2toc/toc\_export\_wiki\.md) &#183; [doctools::toc::import::doctoc](tcllib/files/modules/doctools2toc/import\_doctoc\.md) &#183; [doctools::toc::import::json](tcllib/files/modules/doctools2toc/toc\_import\_json\.md) &#183; [doctools::toc::parse](tcllib/files/modules/doctools2toc/toc\_parse\.md) &#183; [doctools::toc::structure](tcllib/files/modules/doctools2toc/toc\_structure\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md)|
|<a name='doctools\_commands'></a>doctools commands|[doctools\_lang\_cmdref](tcllib/files/modules/doctools/doctools\_lang\_cmdref\.md) &#183; [doctools\_lang\_faq](tcllib/files/modules/doctools/doctools\_lang\_faq\.md) &#183; [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) &#183; [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md)|
|<a name='doctools\_language'></a>doctools language|[doctools\_lang\_cmdref](tcllib/files/modules/doctools/doctools\_lang\_cmdref\.md) &#183; [doctools\_lang\_faq](tcllib/files/modules/doctools/doctools\_lang\_faq\.md) &#183; [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) &#183; [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md)|
|<a name='doctools\_markup'></a>doctools markup|[doctools\_lang\_cmdref](tcllib/files/modules/doctools/doctools\_lang\_cmdref\.md) &#183; [doctools\_lang\_faq](tcllib/files/modules/doctools/doctools\_lang\_faq\.md) &#183; [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) &#183; [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md)|
|<a name='doctools\_syntax'></a>doctools syntax|[doctools\_lang\_faq](tcllib/files/modules/doctools/doctools\_lang\_faq\.md) &#183; [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) &#183; [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md)|
|<a name='document'></a>document|[doctools\_plugin\_apiref](tcllib/files/modules/doctools/doctools\_plugin\_apiref\.md)|
|<a name='documentation'></a>documentation|[docstrip](tcllib/files/modules/docstrip/docstrip\.md) &#183; [docstrip\_util](tcllib/files/modules/docstrip/docstrip\_util\.md) &#183; [doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [tcldocstrip](tcllib/files/apps/tcldocstrip\.md) &#183; [tepam::doc\_gen](tcllib/files/modules/tepam/tepam\_doc\_gen\.md)|
|<a name='dom'></a>DOM|[treeql](tcllib/files/modules/treeql/treeql\.md)|




︙


397
398
399
400
401
402
403
404

405
406
407
408
409
410
411

397
398
399
400
401
402
403

404
405
406
407
408
409
410
411








-
+








|<a name='heartbeat'></a>heartbeat|[debug::heartbeat](tcllib/files/modules/debug/debug\_heartbeat\.md)|
|<a name='heuristic'></a>heuristic|[struct::graph::op](tcllib/files/modules/struct/graphops\.md)|
|<a name='hex'></a>hex|[base32::hex](tcllib/files/modules/base32/base32hex\.md)|
|<a name='hexadecimal'></a>hexadecimal|[tcl::transform::hex](tcllib/files/modules/virtchannel\_transform/hex\.md)|
|<a name='histogram'></a>histogram|[counter](tcllib/files/modules/counter/counter\.md)|
|<a name='hook'></a>hook|[hook](tcllib/files/modules/hook/hook\.md) &#183; [uevent](tcllib/files/modules/uev/uevent\.md)|
|<a name='horspool'></a>horspool|[grammar::aycock](tcllib/files/modules/grammar\_aycock/aycock\.md)|
|<a name='html'></a>HTML|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::html::cssdefaults](tcllib/files/modules/doctools2base/html\_cssdefaults\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::export::html](tcllib/files/modules/doctools2idx/idx\_export\_html\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::export::html](tcllib/files/modules/doctools2toc/toc\_export\_html\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md)|
|<a name='html'></a>HTML|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::html::cssdefaults](tcllib/files/modules/doctools2base/html\_cssdefaults\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::export::html](tcllib/files/modules/doctools2idx/idx\_export\_html\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::export::html](tcllib/files/modules/doctools2toc/toc\_export\_html\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md)|
|<a name='html'></a>html|[html](tcllib/files/modules/html/html\.md) &#183; [htmlparse](tcllib/files/modules/htmlparse/htmlparse\.md) &#183; [javascript](tcllib/files/modules/javascript/javascript\.md) &#183; [ncgi](tcllib/files/modules/ncgi/ncgi\.md)|
|<a name='http'></a>http|[autoproxy](tcllib/files/modules/http/autoproxy\.md) &#183; [httpd](tcllib/files/modules/httpd/httpd\.md) &#183; [map::geocode::nominatim](tcllib/files/modules/map/map\_geocode\_nominatim\.md) &#183; [map::slippy::fetcher](tcllib/files/modules/map/map\_slippy\_fetcher\.md) &#183; [uri](tcllib/files/modules/uri/uri\.md) &#183; [websocket](tcllib/files/modules/websocket/websocket\.md)|
|<a name='httpd'></a>httpd|[httpd](tcllib/files/modules/httpd/httpd\.md)|
|<a name='https'></a>https|[uri](tcllib/files/modules/uri/uri\.md)|
|<a name='httpserver'></a>httpserver|[httpd](tcllib/files/modules/httpd/httpd\.md)|
|<a name='huddle'></a>huddle|[huddle](tcllib/files/modules/yaml/huddle\.md) &#183; [yaml](tcllib/files/modules/yaml/yaml\.md)|
|<a name='human\_readable'></a>human readable|[bench::in](tcllib/files/modules/bench/bench\_read\.md) &#183; [bench::out::text](tcllib/files/modules/bench/bench\_wtext\.md)|




︙


529
530
531
532
533
534
535
536

537
538
539

540
541
542
543
544
545
546

529
530
531
532
533
534
535

536
537
538

539
540
541
542
543
544
545
546








-
+


-
+









|||
|---|---|
|<a name='macros'></a>macros|[doctools::nroff::man\_macros](tcllib/files/modules/doctools2base/nroff\_manmacros\.md)|
|<a name='mail'></a>mail|[imap4](tcllib/files/modules/imap4/imap4\.md) &#183; [mime](tcllib/files/modules/mime/mime\.md) &#183; [pop3](tcllib/files/modules/pop3/pop3\.md) &#183; [smtp](tcllib/files/modules/mime/smtp\.md)|
|<a name='mailto'></a>mailto|[uri](tcllib/files/modules/uri/uri\.md)|
|<a name='man\_macros'></a>man\_macros|[doctools::nroff::man\_macros](tcllib/files/modules/doctools2base/nroff\_manmacros\.md)|
|<a name='manpage'></a>manpage|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [doctools\_plugin\_apiref](tcllib/files/modules/doctools/doctools\_plugin\_apiref\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md)|
|<a name='manpage'></a>manpage|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [doctools\_plugin\_apiref](tcllib/files/modules/doctools/doctools\_plugin\_apiref\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md)|
|<a name='map'></a>map|[generator](tcllib/files/modules/generator/generator\.md) &#183; [map::geocode::nominatim](tcllib/files/modules/map/map\_geocode\_nominatim\.md) &#183; [map::slippy](tcllib/files/modules/map/map\_slippy\.md) &#183; [map::slippy::cache](tcllib/files/modules/map/map\_slippy\_cache\.md) &#183; [map::slippy::fetcher](tcllib/files/modules/map/map\_slippy\_fetcher\.md) &#183; [mapproj](tcllib/files/modules/mapproj/mapproj\.md) &#183; [struct::list](tcllib/files/modules/struct/struct\_list\.md)|
|<a name='markdown'></a>markdown|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md)|
|<a name='markup'></a>markup|[docidx\_intro](tcllib/files/modules/doctools/docidx\_intro\.md) &#183; [docidx\_lang\_cmdref](tcllib/files/modules/doctools/docidx\_lang\_cmdref\.md) &#183; [docidx\_lang\_faq](tcllib/files/modules/doctools/docidx\_lang\_faq\.md) &#183; [docidx\_lang\_intro](tcllib/files/modules/doctools/docidx\_lang\_intro\.md) &#183; [docidx\_lang\_syntax](tcllib/files/modules/doctools/docidx\_lang\_syntax\.md) &#183; [docidx\_plugin\_apiref](tcllib/files/modules/doctools/docidx\_plugin\_apiref\.md) &#183; [doctoc\_intro](tcllib/files/modules/doctools/doctoc\_intro\.md) &#183; [doctoc\_lang\_cmdref](tcllib/files/modules/doctools/doctoc\_lang\_cmdref\.md) &#183; [doctoc\_lang\_faq](tcllib/files/modules/doctools/doctoc\_lang\_faq\.md) &#183; [doctoc\_lang\_intro](tcllib/files/modules/doctools/doctoc\_lang\_intro\.md) &#183; [doctoc\_lang\_syntax](tcllib/files/modules/doctools/doctoc\_lang\_syntax\.md) &#183; [doctoc\_plugin\_apiref](tcllib/files/modules/doctools/doctoc\_plugin\_apiref\.md) &#183; [doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools2idx\_introduction](tcllib/files/modules/doctools2idx/idx\_introduction\.md) &#183; [doctools2toc\_introduction](tcllib/files/modules/doctools2toc/toc\_introduction\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [doctools\_intro](tcllib/files/modules/doctools/doctools\_intro\.md) &#183; [doctools\_lang\_cmdref](tcllib/files/modules/doctools/doctools\_lang\_cmdref\.md) &#183; [doctools\_lang\_faq](tcllib/files/modules/doctools/doctools\_lang\_faq\.md) &#183; [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) &#183; [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md) &#183; [doctools\_plugin\_apiref](tcllib/files/modules/doctools/doctools\_plugin\_apiref\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) &#183; [tcldocstrip](tcllib/files/apps/tcldocstrip\.md)|
|<a name='markup'></a>markup|[docidx\_intro](tcllib/files/modules/doctools/docidx\_intro\.md) &#183; [docidx\_lang\_cmdref](tcllib/files/modules/doctools/docidx\_lang\_cmdref\.md) &#183; [docidx\_lang\_faq](tcllib/files/modules/doctools/docidx\_lang\_faq\.md) &#183; [docidx\_lang\_intro](tcllib/files/modules/doctools/docidx\_lang\_intro\.md) &#183; [docidx\_lang\_syntax](tcllib/files/modules/doctools/docidx\_lang\_syntax\.md) &#183; [docidx\_plugin\_apiref](tcllib/files/modules/doctools/docidx\_plugin\_apiref\.md) &#183; [doctoc\_intro](tcllib/files/modules/doctools/doctoc\_intro\.md) &#183; [doctoc\_lang\_cmdref](tcllib/files/modules/doctools/doctoc\_lang\_cmdref\.md) &#183; [doctoc\_lang\_faq](tcllib/files/modules/doctools/doctoc\_lang\_faq\.md) &#183; [doctoc\_lang\_intro](tcllib/files/modules/doctools/doctoc\_lang\_intro\.md) &#183; [doctoc\_lang\_syntax](tcllib/files/modules/doctools/doctoc\_lang\_syntax\.md) &#183; [doctoc\_plugin\_apiref](tcllib/files/modules/doctools/doctoc\_plugin\_apiref\.md) &#183; [doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools2idx\_introduction](tcllib/files/modules/doctools2idx/idx\_introduction\.md) &#183; [doctools2toc\_introduction](tcllib/files/modules/doctools2toc/toc\_introduction\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::import](tcllib/files/modules/doctools2idx/idx\_import\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::import](tcllib/files/modules/doctools2toc/toc\_import\.md) &#183; [doctools\_intro](tcllib/files/modules/doctools/doctools\_intro\.md) &#183; [doctools\_lang\_cmdref](tcllib/files/modules/doctools/doctools\_lang\_cmdref\.md) &#183; [doctools\_lang\_faq](tcllib/files/modules/doctools/doctools\_lang\_faq\.md) &#183; [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) &#183; [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md) &#183; [doctools\_plugin\_apiref](tcllib/files/modules/doctools/doctools\_plugin\_apiref\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [tcldocstrip](tcllib/files/apps/tcldocstrip\.md)|
|<a name='mastercard'></a>MasterCard|[valtype::creditcard::mastercard](tcllib/files/modules/valtype/cc\_mastercard\.md)|
|<a name='matching'></a>matching|[grammar::me\_intro](tcllib/files/modules/grammar\_me/me\_intro\.md) &#183; [grammar::peg::interp](tcllib/files/modules/grammar\_peg/peg\_interp\.md) &#183; [pt](tcllib/files/apps/pt\.md) &#183; [pt::ast](tcllib/files/modules/pt/pt\_astree\.md) &#183; [pt::cparam::configuration::critcl](tcllib/files/modules/pt/pt\_cparam\_config\_critcl\.md) &#183; [pt::cparam::configuration::tea](tcllib/files/modules/pt/pt\_cparam\_config\_tea\.md) &#183; [pt::json\_language](tcllib/files/modules/pt/pt\_json\_language\.md) &#183; [pt::param](tcllib/files/modules/pt/pt\_param\.md) &#183; [pt::pe](tcllib/files/modules/pt/pt\_pexpression\.md) &#183; [pt::pe::op](tcllib/files/modules/pt/pt\_pexpr\_op\.md) &#183; [pt::peg](tcllib/files/modules/pt/pt\_pegrammar\.md) &#183; [pt::peg::container](tcllib/files/modules/pt/pt\_peg\_container\.md) &#183; [pt::peg::container::peg](tcllib/files/modules/pt/pt\_peg\_container\_peg\.md) &#183; [pt::peg::export](tcllib/files/modules/pt/pt\_peg\_export\.md) &#183; [pt::peg::export::container](tcllib/files/modules/pt/pt\_peg\_export\_container\.md) &#183; [pt::peg::export::json](tcllib/files/modules/pt/pt\_peg\_export\_json\.md) &#183; [pt::peg::export::peg](tcllib/files/modules/pt/pt\_peg\_export\_peg\.md) &#183; [pt::peg::from::container](tcllib/files/modules/pt/pt\_peg\_from\_container\.md) &#183; [pt::peg::from::json](tcllib/files/modules/pt/pt\_peg\_from\_json\.md) &#183; [pt::peg::from::peg](tcllib/files/modules/pt/pt\_peg\_from\_peg\.md) &#183; [pt::peg::import](tcllib/files/modules/pt/pt\_peg\_import\.md) &#183; [pt::peg::import::container](tcllib/files/modules/pt/pt\_peg\_import\_container\.md) &#183; [pt::peg::import::json](tcllib/files/modules/pt/pt\_peg\_import\_json\.md) &#183; [pt::peg::import::peg](tcllib/files/modules/pt/pt\_peg\_import\_peg\.md) &#183; [pt::peg::interp](tcllib/files/modules/pt/pt\_peg\_interp\.md) &#183; [pt::peg::to::container](tcllib/files/modules/pt/pt\_peg\_to\_container\.md) &#183; [pt::peg::to::cparam](tcllib/files/modules/pt/pt\_peg\_to\_cparam\.md) &#183; [pt::peg::to::json](tcllib/files/modules/pt/pt\_peg\_to\_json\.md) &#183; [pt::peg::to::param](tcllib/files/modules/pt/pt\_peg\_to\_param\.md) &#183; [pt::peg::to::peg](tcllib/files/modules/pt/pt\_peg\_to\_peg\.md) &#183; [pt::peg::to::tclparam](tcllib/files/modules/pt/pt\_peg\_to\_tclparam\.md) &#183; [pt::peg\_language](tcllib/files/modules/pt/pt\_peg\_language\.md) &#183; [pt::pegrammar](tcllib/files/modules/pt/pt\_peg\_introduction\.md) &#183; [pt::pgen](tcllib/files/modules/pt/pt\_pgen\.md) &#183; [pt::rde](tcllib/files/modules/pt/pt\_rdengine\.md) &#183; [pt::tclparam::configuration::nx](tcllib/files/modules/pt/pt\_tclparam\_config\_nx\.md) &#183; [pt::tclparam::configuration::snit](tcllib/files/modules/pt/pt\_tclparam\_config\_snit\.md) &#183; [pt::tclparam::configuration::tcloo](tcllib/files/modules/pt/pt\_tclparam\_config\_tcloo\.md) &#183; [pt::util](tcllib/files/modules/pt/pt\_util\.md) &#183; [pt\_export\_api](tcllib/files/modules/pt/pt\_to\_api\.md) &#183; [pt\_import\_api](tcllib/files/modules/pt/pt\_from\_api\.md) &#183; [pt\_introduction](tcllib/files/modules/pt/pt\_introduction\.md) &#183; [pt\_parse\_peg](tcllib/files/modules/pt/pt\_parse\_peg\.md) &#183; [pt\_parser\_api](tcllib/files/modules/pt/pt\_parser\_api\.md) &#183; [pt\_peg\_op](tcllib/files/modules/pt/pt\_peg\_op\.md) &#183; [struct::graph::op](tcllib/files/modules/struct/graphops\.md)|
|<a name='math'></a>math|[math](tcllib/files/modules/math/math\.md) &#183; [math::bigfloat](tcllib/files/modules/math/bigfloat\.md) &#183; [math::bignum](tcllib/files/modules/math/bignum\.md) &#183; [math::calculus](tcllib/files/modules/math/calculus\.md) &#183; [math::complexnumbers](tcllib/files/modules/math/qcomplex\.md) &#183; [math::constants](tcllib/files/modules/math/constants\.md) &#183; [math::decimal](tcllib/files/modules/math/decimal\.md) &#183; [math::fuzzy](tcllib/files/modules/math/fuzzy\.md) &#183; [math::geometry](tcllib/files/modules/math/math\_geometry\.md) &#183; [math::interpolate](tcllib/files/modules/math/interpolate\.md) &#183; [math::linearalgebra](tcllib/files/modules/math/linalg\.md) &#183; [math::optimize](tcllib/files/modules/math/optimize\.md) &#183; [math::PCA](tcllib/files/modules/math/pca\.md) &#183; [math::polynomials](tcllib/files/modules/math/polynomials\.md) &#183; [math::rationalfunctions](tcllib/files/modules/math/rational\_funcs\.md) &#183; [math::special](tcllib/files/modules/math/special\.md) &#183; [math::trig](tcllib/files/modules/math/trig\.md) &#183; [simulation::annealing](tcllib/files/modules/simulation/annealing\.md) &#183; [simulation::montecarlo](tcllib/files/modules/simulation/montecarlo\.md) &#183; [simulation::random](tcllib/files/modules/simulation/simulation\_random\.md)|
|<a name='mathematics'></a>mathematics|[math::figurate](tcllib/files/modules/math/figurate\.md) &#183; [math::fourier](tcllib/files/modules/math/fourier\.md) &#183; [math::probopt](tcllib/files/modules/math/probopt\.md) &#183; [math::quasirandom](tcllib/files/modules/math/quasirandom\.md) &#183; [math::statistics](tcllib/files/modules/math/statistics\.md)|
|<a name='matrices'></a>matrices|[math::linearalgebra](tcllib/files/modules/math/linalg\.md)|
|<a name='matrix'></a>matrix|[csv](tcllib/files/modules/csv/csv\.md) &#183; [math::linearalgebra](tcllib/files/modules/math/linalg\.md) &#183; [report](tcllib/files/modules/report/report\.md) &#183; [struct::matrix](tcllib/files/modules/struct/matrix\.md) &#183; [struct::matrix\_v1](tcllib/files/modules/struct/matrix1\.md) &#183; [struct::queue](tcllib/files/modules/struct/queue\.md) &#183; [struct::stack](tcllib/files/modules/struct/stack\.md)|
|<a name='max\_cut'></a>max cut|[struct::graph::op](tcllib/files/modules/struct/graphops\.md)|




︙


599
600
601
602
603
604
605
606

607
608
609
610
611
612
613

599
600
601
602
603
604
605

606
607
608
609
610
611
612
613








-
+








|<a name='nntp'></a>nntp|[nntp](tcllib/files/modules/nntp/nntp\.md)|
|<a name='nntpclient'></a>nntpclient|[nntp](tcllib/files/modules/nntp/nntp\.md)|
|<a name='no\_op'></a>no\-op|[control](tcllib/files/modules/control/control\.md)|
|<a name='node'></a>node|[struct::graph](tcllib/files/modules/struct/graph\.md) &#183; [struct::graph::op](tcllib/files/modules/struct/graphops\.md) &#183; [struct::tree](tcllib/files/modules/struct/struct\_tree\.md)|
|<a name='nominatim'></a>nominatim|[map::geocode::nominatim](tcllib/files/modules/map/map\_geocode\_nominatim\.md)|
|<a name='normalization'></a>normalization|[bench](tcllib/files/modules/bench/bench\.md) &#183; [page\_util\_norm\_lemon](tcllib/files/modules/page/page\_util\_norm\_lemon\.md) &#183; [page\_util\_norm\_peg](tcllib/files/modules/page/page\_util\_norm\_peg\.md) &#183; [unicode](tcllib/files/modules/stringprep/unicode\.md)|
|<a name='npi'></a>NPI|[valtype::usnpi](tcllib/files/modules/valtype/usnpi\.md)|
|<a name='nroff'></a>nroff|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::export::nroff](tcllib/files/modules/doctools2idx/idx\_export\_nroff\.md) &#183; [doctools::nroff::man\_macros](tcllib/files/modules/doctools2base/nroff\_manmacros\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::export::nroff](tcllib/files/modules/doctools2toc/toc\_export\_nroff\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md)|
|<a name='nroff'></a>nroff|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::idx::export](tcllib/files/modules/doctools2idx/idx\_export\.md) &#183; [doctools::idx::export::nroff](tcllib/files/modules/doctools2idx/idx\_export\_nroff\.md) &#183; [doctools::nroff::man\_macros](tcllib/files/modules/doctools2base/nroff\_manmacros\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export](tcllib/files/modules/doctools2toc/toc\_export\.md) &#183; [doctools::toc::export::nroff](tcllib/files/modules/doctools2toc/toc\_export\_nroff\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md)|
|<a name='ntlm'></a>NTLM|[SASL::NTLM](tcllib/files/modules/sasl/ntlm\.md)|
|<a name='ntp'></a>NTP|[ntp\_time](tcllib/files/modules/ntp/ntp\_time\.md)|
|<a name='null'></a>null|[tcl::chan::null](tcllib/files/modules/virtchannel\_base/tcllib\_null\.md) &#183; [tcl::chan::nullzero](tcllib/files/modules/virtchannel\_base/nullzero\.md)|
|<a name='number\_theory'></a>number theory|[math::numtheory](tcllib/files/modules/math/numtheory\.md)|


#### <a name='cO'></a>Keywords: O




︙


917
918
919
920
921
922
923
924

925
926
927
928
929
930
931

917
918
919
920
921
922
923

924
925
926
927
928
929
930
931








-
+








|<a name='timestamps'></a>timestamps|[debug::timestamp](tcllib/files/modules/debug/debug\_timestamp\.md)|
|<a name='tip\_219'></a>tip 219|[tcl::chan::cat](tcllib/files/modules/virtchannel\_base/cat\.md) &#183; [tcl::chan::core](tcllib/files/modules/virtchannel\_core/core\.md) &#183; [tcl::chan::events](tcllib/files/modules/virtchannel\_core/events\.md) &#183; [tcl::chan::facade](tcllib/files/modules/virtchannel\_base/facade\.md) &#183; [tcl::chan::fifo](tcllib/files/modules/virtchannel\_base/tcllib\_fifo\.md) &#183; [tcl::chan::fifo2](tcllib/files/modules/virtchannel\_base/tcllib\_fifo2\.md) &#183; [tcl::chan::halfpipe](tcllib/files/modules/virtchannel\_base/halfpipe\.md) &#183; [tcl::chan::memchan](tcllib/files/modules/virtchannel\_base/tcllib\_memchan\.md) &#183; [tcl::chan::null](tcllib/files/modules/virtchannel\_base/tcllib\_null\.md) &#183; [tcl::chan::nullzero](tcllib/files/modules/virtchannel\_base/nullzero\.md) &#183; [tcl::chan::random](tcllib/files/modules/virtchannel\_base/tcllib\_random\.md) &#183; [tcl::chan::std](tcllib/files/modules/virtchannel\_base/std\.md) &#183; [tcl::chan::string](tcllib/files/modules/virtchannel\_base/tcllib\_string\.md) &#183; [tcl::chan::textwindow](tcllib/files/modules/virtchannel\_base/textwindow\.md) &#183; [tcl::chan::variable](tcllib/files/modules/virtchannel\_base/tcllib\_variable\.md) &#183; [tcl::chan::zero](tcllib/files/modules/virtchannel\_base/tcllib\_zero\.md) &#183; [tcl::randomseed](tcllib/files/modules/virtchannel\_base/randseed\.md) &#183; [tcl::transform::core](tcllib/files/modules/virtchannel\_core/transformcore\.md)|
|<a name='tip\_230'></a>tip 230|[tcl::transform::adler32](tcllib/files/modules/virtchannel\_transform/adler32\.md) &#183; [tcl::transform::base64](tcllib/files/modules/virtchannel\_transform/vt\_base64\.md) &#183; [tcl::transform::counter](tcllib/files/modules/virtchannel\_transform/vt\_counter\.md) &#183; [tcl::transform::crc32](tcllib/files/modules/virtchannel\_transform/vt\_crc32\.md) &#183; [tcl::transform::hex](tcllib/files/modules/virtchannel\_transform/hex\.md) &#183; [tcl::transform::identity](tcllib/files/modules/virtchannel\_transform/identity\.md) &#183; [tcl::transform::limitsize](tcllib/files/modules/virtchannel\_transform/limitsize\.md) &#183; [tcl::transform::observe](tcllib/files/modules/virtchannel\_transform/observe\.md) &#183; [tcl::transform::otp](tcllib/files/modules/virtchannel\_transform/vt\_otp\.md) &#183; [tcl::transform::rot](tcllib/files/modules/virtchannel\_transform/rot\.md) &#183; [tcl::transform::spacer](tcllib/files/modules/virtchannel\_transform/spacer\.md) &#183; [tcl::transform::zlib](tcllib/files/modules/virtchannel\_transform/tcllib\_zlib\.md)|
|<a name='tip\_234'></a>tip 234|[tcl::transform::zlib](tcllib/files/modules/virtchannel\_transform/tcllib\_zlib\.md)|
|<a name='tip\_317'></a>tip 317|[tcl::transform::base64](tcllib/files/modules/virtchannel\_transform/vt\_base64\.md)|
|<a name='tk'></a>Tk|[tcl::chan::textwindow](tcllib/files/modules/virtchannel\_base/textwindow\.md)|
|<a name='tls'></a>tls|[comm](tcllib/files/modules/comm/comm\.md) &#183; [imap4](tcllib/files/modules/imap4/imap4\.md) &#183; [pop3](tcllib/files/modules/pop3/pop3\.md) &#183; [pop3d](tcllib/files/modules/pop3d/pop3d\.md) &#183; [smtp](tcllib/files/modules/mime/smtp\.md) &#183; [transfer::connect](tcllib/files/modules/transfer/connect\.md) &#183; [transfer::receiver](tcllib/files/modules/transfer/receiver\.md) &#183; [transfer::transmitter](tcllib/files/modules/transfer/transmitter\.md)|
|<a name='tmml'></a>TMML|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md)|
|<a name='tmml'></a>TMML|[doctools](tcllib/files/modules/doctools/doctools\.md) &#183; [doctools::idx](tcllib/files/modules/doctools/docidx\.md) &#183; [doctools::idx](tcllib/files/modules/doctools2idx/idx\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools2toc/toc\_container\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [dtplite](tcllib/files/apps/dtplite\.md) &#183; [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) &#183; [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md)|
|<a name='toc'></a>toc|[doctoc\_intro](tcllib/files/modules/doctools/doctoc\_intro\.md) &#183; [doctoc\_plugin\_apiref](tcllib/files/modules/doctools/doctoc\_plugin\_apiref\.md) &#183; [doctools::toc](tcllib/files/modules/doctools/doctoc\.md) &#183; [doctools::toc::export::doctoc](tcllib/files/modules/doctools2toc/export\_doctoc\.md) &#183; [doctools::toc::export::html](tcllib/files/modules/doctools2toc/toc\_export\_html\.md) &#183; [doctools::toc::export::json](tcllib/files/modules/doctools2toc/toc\_export\_json\.md) &#183; [doctools::toc::export::nroff](tcllib/files/modules/doctools2toc/toc\_export\_nroff\.md) &#183; [doctools::toc::export::text](tcllib/files/modules/doctools2toc/toc\_export\_text\.md) &#183; [doctools::toc::export::wiki](tcllib/files/modules/doctools2toc/toc\_export\_wiki\.md) &#183; [doctools::toc::import::doctoc](tcllib/files/modules/doctools2toc/import\_doctoc\.md) &#183; [doctools::toc::import::json](tcllib/files/modules/doctools2toc/toc\_import\_json\.md)|
|<a name='toc\_formatter'></a>toc formatter|[doctoc\_plugin\_apiref](tcllib/files/modules/doctools/doctoc\_plugin\_apiref\.md)|
|<a name='tokenization'></a>tokenization|[string::token](tcllib/files/modules/string/token\.md) &#183; [string::token::shell](tcllib/files/modules/string/token\_shell\.md)|
|<a name='tool'></a>TOOL|[oometa](tcllib/files/modules/oometa/oometa\.md) &#183; [tool](tcllib/files/modules/tool/tool\.md) &#183; [tool::dict\_ensemble](tcllib/files/modules/tool/tool\_dict\_ensemble\.md)|
|<a name='top\_down\_parsing\_languages'></a>top\-down parsing languages|[grammar::me\_intro](tcllib/files/modules/grammar\_me/me\_intro\.md) &#183; [grammar::peg](tcllib/files/modules/grammar\_peg/peg\.md) &#183; [grammar::peg::interp](tcllib/files/modules/grammar\_peg/peg\_interp\.md) &#183; [pt](tcllib/files/apps/pt\.md) &#183; [pt::ast](tcllib/files/modules/pt/pt\_astree\.md) &#183; [pt::cparam::configuration::critcl](tcllib/files/modules/pt/pt\_cparam\_config\_critcl\.md) &#183; [pt::cparam::configuration::tea](tcllib/files/modules/pt/pt\_cparam\_config\_tea\.md) &#183; [pt::json\_language](tcllib/files/modules/pt/pt\_json\_language\.md) &#183; [pt::param](tcllib/files/modules/pt/pt\_param\.md) &#183; [pt::pe](tcllib/files/modules/pt/pt\_pexpression\.md) &#183; [pt::pe::op](tcllib/files/modules/pt/pt\_pexpr\_op\.md) &#183; [pt::peg](tcllib/files/modules/pt/pt\_pegrammar\.md) &#183; [pt::peg::container](tcllib/files/modules/pt/pt\_peg\_container\.md) &#183; [pt::peg::container::peg](tcllib/files/modules/pt/pt\_peg\_container\_peg\.md) &#183; [pt::peg::export](tcllib/files/modules/pt/pt\_peg\_export\.md) &#183; [pt::peg::export::container](tcllib/files/modules/pt/pt\_peg\_export\_container\.md) &#183; [pt::peg::export::json](tcllib/files/modules/pt/pt\_peg\_export\_json\.md) &#183; [pt::peg::export::peg](tcllib/files/modules/pt/pt\_peg\_export\_peg\.md) &#183; [pt::peg::from::container](tcllib/files/modules/pt/pt\_peg\_from\_container\.md) &#183; [pt::peg::from::json](tcllib/files/modules/pt/pt\_peg\_from\_json\.md) &#183; [pt::peg::from::peg](tcllib/files/modules/pt/pt\_peg\_from\_peg\.md) &#183; [pt::peg::import](tcllib/files/modules/pt/pt\_peg\_import\.md) &#183; [pt::peg::import::container](tcllib/files/modules/pt/pt\_peg\_import\_container\.md) &#183; [pt::peg::import::json](tcllib/files/modules/pt/pt\_peg\_import\_json\.md) &#183; [pt::peg::import::peg](tcllib/files/modules/pt/pt\_peg\_import\_peg\.md) &#183; [pt::peg::interp](tcllib/files/modules/pt/pt\_peg\_interp\.md) &#183; [pt::peg::to::container](tcllib/files/modules/pt/pt\_peg\_to\_container\.md) &#183; [pt::peg::to::cparam](tcllib/files/modules/pt/pt\_peg\_to\_cparam\.md) &#183; [pt::peg::to::json](tcllib/files/modules/pt/pt\_peg\_to\_json\.md) &#183; [pt::peg::to::param](tcllib/files/modules/pt/pt\_peg\_to\_param\.md) &#183; [pt::peg::to::peg](tcllib/files/modules/pt/pt\_peg\_to\_peg\.md) &#183; [pt::peg::to::tclparam](tcllib/files/modules/pt/pt\_peg\_to\_tclparam\.md) &#183; [pt::peg\_language](tcllib/files/modules/pt/pt\_peg\_language\.md) &#183; [pt::pegrammar](tcllib/files/modules/pt/pt\_peg\_introduction\.md) &#183; [pt::pgen](tcllib/files/modules/pt/pt\_pgen\.md) &#183; [pt::rde](tcllib/files/modules/pt/pt\_rdengine\.md) &#183; [pt::tclparam::configuration::nx](tcllib/files/modules/pt/pt\_tclparam\_config\_nx\.md) &#183; [pt::tclparam::configuration::snit](tcllib/files/modules/pt/pt\_tclparam\_config\_snit\.md) &#183; [pt::tclparam::configuration::tcloo](tcllib/files/modules/pt/pt\_tclparam\_config\_tcloo\.md) &#183; [pt::util](tcllib/files/modules/pt/pt\_util\.md) &#183; [pt\_export\_api](tcllib/files/modules/pt/pt\_to\_api\.md) &#183; [pt\_import\_api](tcllib/files/modules/pt/pt\_from\_api\.md) &#183; [pt\_introduction](tcllib/files/modules/pt/pt\_introduction\.md) &#183; [pt\_parse\_peg](tcllib/files/modules/pt/pt\_parse\_peg\.md) &#183; [pt\_parser\_api](tcllib/files/modules/pt/pt\_parser\_api\.md) &#183; [pt\_peg\_op](tcllib/files/modules/pt/pt\_peg\_op\.md)|
|<a name='torrent'></a>torrent|[bee](tcllib/files/modules/bee/bee\.md)|
|<a name='touch'></a>touch|[fileutil](tcllib/files/modules/fileutil/fileutil\.md)|




︙





Added embedded/md/tcllib/files/apps/mkdoc.md.






















































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+


[//000000001]: # (mkdoc \- Source code documentation using Markdown)
[//000000002]: # (Generated from file 'mkdoc\.man' by tcllib/doctools with format 'markdown')
[//000000003]: # (Copyright &copy; 2019\-2022, Detlef Groth <detlef\(at\)dgroth\(dot\)de>)
[//000000004]: # (mkdoc\(n\) 0\.7\.0 tcllib "Source code documentation using Markdown")

<hr> [ <a href="../../../toc.md">Main Table Of Contents</a> &#124; <a
href="../../toc.md">Table Of Contents</a> &#124; <a
href="../../../index.md">Keyword Index</a> &#124; <a
href="../../../toc0.md">Categories</a> &#124; <a
href="../../../toc1.md">Modules</a> &#124; <a
href="../../../toc2.md">Applications</a> ] <hr>

# NAME

mkdoc \- Source code documentation extractor/converter application

# <a name='toc'></a>Table Of Contents

  - [Table Of Contents](#toc)

  - [Synopsis](#synopsis)

  - [Description](#section1)

  - [Command Line](#section2)

  - [Examples](#section3)

  - [Bugs, Ideas, Feedback](#section4)

  - [Code Copyright](#section5)

  - [Category](#category)

  - [Copyright](#copyright)

# <a name='synopsis'></a>SYNOPSIS

[__[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__ __\-\-help__](#1)  
[__[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__ __\-\-version__](#2)  
[__[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__ __\-\-license__](#3)  
[__[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__ *input* *output* ?__\-\-css__ *cssfile*?](#4)  

# <a name='description'></a>DESCRIPTION

This document describes __[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__, an
application to extract documentation embedded in source code files, be they
"\.tcl", or other\.

# <a name='section2'></a>Command Line

  - <a name='1'></a>__[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__ __\-\-help__

    The application prints a short help to standard output and exits\.

  - <a name='2'></a>__[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__ __\-\-version__

    The application prints its version number to standard output and exits\.

  - <a name='3'></a>__[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__ __\-\-license__

    The application prints its license to standard output and exits\.

  - <a name='4'></a>__[mkdoc](\.\./modules/mkdoc/mkdoc\.md)__ *input* *output* ?__\-\-css__ *cssfile*?

    The application reads the *input* file, extracts the embedded
    documentation, and writes it to the *output* file\.

    If the output file is not a "\.md" file the extracted documentation is
    converted to HTML before being written\.

    When generating and writing HTML the default CSS stylesheet can be
    overridden by specifying the path to a custom stylesheet via option
    __\-\-css__\.

    If the input file is a "\.md" file it is expected to contain Markdown as\-is,
    instead of Markdown embedded into code\.

    On the other side, when the file is considered code then the documentation
    is expected to be contained in all lines starting with the marker
    __\#'__\. For script languages like Tcl the __\#__ character of this
    marker means that the documentation is contained in the so\-flagged comments\.
    For other languages the marker and documentation may have to be embedded
    into multi\-line comments\.

# <a name='section3'></a>Examples

    # Create HTML manual for a CPP file using a custom style sheet
    mkdoc sample.cpp sample.html --css manual.css

    # Extract the documentation from code as simple Markdown, ready to be processed
    # further, for example with pandoc, or similar
    mkdoc sample.cpp sample.md

    # Convert a Markdown file to HTML
    mkdoc sample.md sample.html

# <a name='section4'></a>Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and
other problems\. Please report such to the author of this package\. Please also
report any ideas for enhancements you may have for either package and/or
documentation\.

# <a name='section5'></a>Code Copyright

BSD License type:

The following terms apply to all files a ssociated with the software unless
explicitly disclaimed in individual files\.

The authors hereby grant permission to use, copy, modify, distribute, and
license this software and its documentation for any purpose, provided that
existing copyright notices are retained in all copies and that this notice is
included verbatim in any distributions\. No written agreement, license, or
royalty fee is required for any of the authorized uses\. Modifications to this
software may be copyrighted by their authors and need not follow the licensing
terms described here, provided that the new terms are clearly indicated on the
first page of each file where they apply\.

In no event shall the authors or distributors be liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use
of this software, its documentation, or any derivatives thereof, even if the
authors have been advised of the possibility of such damage\.

The authors and distributors specifically disclaim any warranties, including,
but not limited to, the implied warranties of merchantability, fitness for a
particular purpose, and non\-infringement\. This software is provided on an "as
is" basis, and the authors and distributors have no obligation to provide
maintenance, support, updates, enhancements, or modifications\.

*RESTRICTED RIGHTS*: Use, duplication or disclosure by the government is
subject to the restrictions as set forth in subparagraph \(c\) \(1\) \(ii\) of the
Rights in Technical Data and Computer Software Clause as DFARS 252\.227\-7013 and
FAR 52\.227\-19\.

# <a name='category'></a>CATEGORY

Text processing

# <a name='copyright'></a>COPYRIGHT

Copyright &copy; 2019\-2022, Detlef Groth <detlef\(at\)dgroth\(dot\)de>






Changes to embedded/md/tcllib/files/modules/dtplite/pkg_dtplite.md.





1
2

3
4
5

6
7
8
9
10
11
12
13
14
15
16

17
18
19
20
21
22
23
24
25
26
27
28

29
30
31
32
33
34
35
36

37
38
39
40
41
42
43
44
45
46
47
48
49
50
51


52
53
54
55
56
57
58


59
60
61
62
63
64
65


66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

144
145
146
147
148

149
150
151
152
153
154
155
156
157

158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220

221
222
223
224

225
226
227

228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297

298
299
300
301

302
303

304
305

306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374

375
376
377
378
379
380
381

1

2
3
4

5
6
7
8
9
10
11
12
13
14
15

16
17
18
19
20
21
22
23
24
25



26
27







28
29
30
31
32
33
34
35
36
37
38
39
40
41


42
43


44
45
46


47
48







49
50
51





























52











































53




54

55



56






57


58




























































59


60

61


62



63



































































64


65

66


67


68


69



70

































































71
72
73
74
75
76
77
78


-
+


-
+










-
+









-
-
-
+

-
-
-
-
-
-
-
+













-
-
+
+
-
-



-
-
+
+
-
-
-
-
-
-
-
+
+

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-
-
-
-
+
-

-
-
-
+
-
-
-
-
-
-

-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-
-
+
-

-
-
+
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-
-
+
-

-
-
+
-
-
+
-
-
+
-
-
-

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+









[//000000001]: # (dtplite \- Documentation toolbox)
[//000000001]: # (pkg\_dtplite \- Documentation toolbox)
[//000000002]: # (Generated from file 'pkg\_dtplite\.man' by tcllib/doctools with format 'markdown')
[//000000003]: # (Copyright &copy; 2004\-2013 Andreas Kupries <andreas\_kupries@users\.sourceforge\.net>)
[//000000004]: # (dtplite\(n\) 1\.3\.1 tcllib "Documentation toolbox")
[//000000004]: # (pkg\_dtplite\(n\) 1\.3\.1 tcllib "Documentation toolbox")

<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
href="../../../toc.md">Table Of Contents</a> &#124; <a
href="../../../../index.md">Keyword Index</a> &#124; <a
href="../../../../toc0.md">Categories</a> &#124; <a
href="../../../../toc1.md">Modules</a> &#124; <a
href="../../../../toc2.md">Applications</a> ] <hr>

# NAME

dtplite \- Lightweight DocTools Markup Processor
pkg\_dtplite \- Lightweight DocTools Markup Processor

# <a name='toc'></a>Table Of Contents

  - [Table Of Contents](#toc)

  - [Synopsis](#synopsis)

  - [Description](#section1)

      - [USE CASES](#subsection1)

      - [COMMAND LINE](#subsection2)
  - [COMMANDS](#section2)

      - [OPTIONS](#subsection3)

      - [FORMATS](#subsection4)

      - [DIRECTORY STRUCTURES](#subsection5)

  - [Bugs, Ideas, Feedback](#section2)
  - [Bugs, Ideas, Feedback](#section3)

  - [See Also](#seealso)

  - [Keywords](#keywords)

  - [Category](#category)

  - [Copyright](#copyright)

# <a name='synopsis'></a>SYNOPSIS

package require dtplite ?1\.3\.1?  

[__[dtplite](\.\./\.\./apps/dtplite\.md)__ __\-o__ *output* ?options? *format* *inputfile*](#1)  
[__[dtplite](\.\./\.\./apps/dtplite\.md)__ __validate__ *inputfile*](#2)  
[__dtplite::print\-via__ *cmd*](#1)  
[__dtplite::do__ *arguments*](#2)  
[__[dtplite](\.\./\.\./apps/dtplite\.md)__ __\-o__ *output* ?options? *format* *inputdirectory*](#3)  
[__[dtplite](\.\./\.\./apps/dtplite\.md)__ __\-merge__ __\-o__ *output* ?options? *format* *inputdirectory*](#4)  

# <a name='description'></a>DESCRIPTION

The application described by this document,
__[dtplite](\.\./\.\./apps/dtplite\.md)__, is the successor to the extremely
The package provided by this document,
__[dtplite](\.\./\.\./apps/dtplite\.md)__, is the foundation for the
simple __[mpexpand](\.\./doctools/mpexpand\.md)__\. Influenced in its
functionality by the __dtp__ doctools processor it is much more powerful
than __[mpexpand](\.\./doctools/mpexpand\.md)__, yet still as easy to use;
definitely easier than __dtp__ with its myriad of subcommands and options\.

__[dtplite](\.\./\.\./apps/dtplite\.md)__ is based upon the package
__[doctools](\.\./doctools/doctools\.md)__, like the other two processors\.
__[dtplite](\.\./\.\./apps/dtplite\.md)__ application\. It is a light wrapper
around the various __[doctools](\.\./doctools/doctools\.md)__ packages\.

## <a name='subsection1'></a>USE CASES

__[dtplite](\.\./\.\./apps/dtplite\.md)__ was written with the following
three use cases in mind\.

  1. Validation of a single document, i\.e\. checking that it was written in valid
     doctools format\. This mode can also be used to get a preliminary version of
     the formatted output for a single document, for display in a browser,
     nroff, etc\., allowing proofreading of the formatting\.

  1. Generation of the formatted documentation for a single package, i\.e\. all
     the manpages, plus a table of contents and an index of keywords\.

  1. An extension of the previous mode of operation, a method for the easy
     generation of one documentation tree for several packages, and especially
     of a unified table of contents and keyword index\.

Beyond the above we also want to make use of the customization features provided
by the HTML formatter\. It is not the only format the application should be able
to generate, but we anticipiate it to be the most commonly used, and it is one
of the few which do provide customization hooks\.

We allow the caller to specify a header string, footer string, a stylesheet, and
data for a bar of navigation links at the top of the generated document\. While
all can be set as long as the formatting engine provides an appropriate engine
parameter \(See section [OPTIONS](#subsection3)\) the last two have internal
processing which make them specific to HTML\.

## <a name='subsection2'></a>COMMAND LINE
# <a name='section2'></a>COMMANDS

  - <a name='1'></a>__[dtplite](\.\./\.\./apps/dtplite\.md)__ __\-o__ *output* ?options? *format* *inputfile*

    This is the form for use case \[1\]\. The *options* will be explained later,
    in section [OPTIONS](#subsection3)\.

      * path *output* \(in\)

        This argument specifies where to write the generated document\. It can be
        the path to a file or directory, or __\-__\. The last value causes the
        application to write the generated documented to __stdout__\.

        If the *output* does not exist then \[file dirname $output\] has to
        exist and must be a writable directory\. The generated document will be
        written to a file in that directory, and the name of that file will be
        derived from the *inputfile*, the *format*, and the value given to
        option __\-ext__ \(if present\)\.

      * \(path&#124;handle\) *format* \(in\)

        This argument specifies the formatting engine to use when processing the
        input, and thus the format of the generated document\. See section
        [FORMATS](#subsection4) for the possibilities recognized by the
        application\.

      * path *inputfile* \(in\)

        This argument specifies the path to the file to process\. It has to
        exist, must be readable, and written in
        *[doctools](\.\./\.\./\.\./\.\./index\.md\#doctools)* format\.

  - <a name='2'></a>__[dtplite](\.\./\.\./apps/dtplite\.md)__ __validate__ *inputfile*

    This is a simpler form for use case \[1\]\. The "validate" format generates no
    output at all, only syntax checks are performed\. As such the specification
    of an output file or other options is not necessary and left out\.

  - <a name='3'></a>__[dtplite](\.\./\.\./apps/dtplite\.md)__ __\-o__ *output* ?options? *format* *inputdirectory*

    This is the form for use case \[2\]\. It differs from the form for use case \[1\]
    by having the input documents specified through a directory instead of a
    file\. The other arguments are identical, except for *output*, which now
    has to be the path to an existing and writable directory\.

    The input documents are all files in *inputdirectory* or any of its
    subdirectories which were recognized by __fileutil::fileType__ as
    containing text in *[doctools](\.\./\.\./\.\./\.\./index\.md\#doctools)* format\.

  - <a name='1'></a>__dtplite::print\-via__ *cmd*
  - <a name='4'></a>__[dtplite](\.\./\.\./apps/dtplite\.md)__ __\-merge__ __\-o__ *output* ?options? *format* *inputdirectory*

    This is the form for use case \[3\]\. The only difference to the form for use
    case \[2\] is the additional option __\-merge__\.

    Redirect print operations of the package to the specified *cmd*\.
    Each such call will merge the generated documents coming from processing the
    input documents under *inputdirectory* or any of its subdirectories to the
    files under *output*\. In this manner it is possible to incrementally build
    the unified documentation for any number of packages\. Note that it is
    necessary to run through all the packages twice to get fully correct
    cross\-references \(for formats supporting them\)\.

## <a name='subsection3'></a>OPTIONS

    The result of the command is the empty string\.
This section describes all the options available to the user of the application,
with the exception of the options __\-o__ and __\-merge__\. These two were
described already, in section [COMMAND LINE](#subsection2)\.

  - __\-exclude__ string

    This option specifies an exclude \(glob\) pattern\. Any files identified as
    manpages to process which match the exclude pattern are ignored\. The option
    can be provided multiple times, each usage adding an additional pattern to
    the list of exclusions\.

  - __\-ext__ string

    If the name of an output file has to be derived from the name of an input
    file it will use the name of the *format* as the extension by default\.
    This option here will override this however, forcing it to use *string* as
    the file extension\. This option is ignored if the name of the output file is
    fully specified through option __\-o__\.

    When used multiple times only the last definition is relevant\.

  - __\-header__ file

    This option can be used if and only if the selected *format* provides an
    engine parameter named "header"\. It takes the contents of the specified file
    and assign them to that parameter, for whatever use by the engine\. The HTML
    engine will insert the text just after the tag __<body>__\. If navigation
    buttons are present \(see option __\-nav__ below\), then the HTML generated
    for them is appended to the header data originating here before the final
    assignment to the parameter\.

    When used multiple times only the last definition is relevant\.

  - __\-footer__ file

    Like __\-header__, except that: Any navigation buttons are ignored, the
    corresponding required engine parameter is named "footer", and the data is
    inserted just before the tag __</body>__\.

    When used multiple times only the last definition is relevant\.

  - __\-style__ file

    This option can be used if and only if the selected *format* provides an
    engine parameter named "meta"\. When specified it will generate a piece of
    HTML code declaring the *file* as the stylesheet for the generated
    document and assign that to the parameter\. The HTML engine will insert this
    inot the document, just after the tag __<head>__\.

    When processing an input directory the stylesheet file is copied into the
    output directory and the generated HTML will refer to the copy, to make the
    result more self\-contained\. When processing an input file we have no
    location to copy the stylesheet to and so just reference it as specified\.

    When used multiple times only the last definition is relevant\.

  - __\-toc__ path&#124;text

    This option specifies a doctoc file \(or text\) to use for the table of
    contents instead of generating our own\.

    When used multiple times only the last definition is relevant\.

  - <a name='2'></a>__dtplite::do__ *arguments*
  - __\-pre\+toc__ label path&#124;text

  - __\-post\+toc__ label path&#124;text

    The main command it takes a *single list* of *arguments*, processes
    This option specifies additional doctoc files \(or texts\) to use in the
    navigation bar\.

    them, and performs the specified action\.
    Positioning and handling of multiple uses is like for options
    __\-prenav__ and __\-postnav__, see below\.

  - __\-nav__ label url

  - __\-prenav__ label url

    Use this option to specify a navigation button with *label* to display and
    the *url* to link to\. This option can be used if and only if the selected
    *format* provides an engine parameter named "header"\. The HTML generated
    for this is appended to whatever data we got from option __\-header__
    before it is inserted into the generated documents\.

    When used multiple times all definitions are collected and a navigation bar
    is created, with the first definition shown at the left edge and the last
    definition to the right\.

    The url can be relative\. In that case it is assumed to be relative to the
    main files \(TOC and Keyword index\), and will be transformed for all others
    to still link properly\.

  - __\-postnav__ label url

    Use this option to specify a navigation button with *label* to display and
    the *url* to link to\. This option can be used if and only if the selected
    *format* provides an engine parameter named "header"\. The HTML generated
    for this is appended to whatever data we got from option __\-header__
    before it is inserted into the generated documents\.

    When used multiple times all definitions are collected and a navigation bar
    is created, with the last definition shown at the right edge and the first
    definition to the left\.

    The url can be relative\. In that case it is assumed to be relative to the
    main files \(TOC and Keyword index\), and will be transformed for all others
    to still link properly\.

## <a name='subsection4'></a>FORMATS

At first the *format* argument will be treated as a path to a tcl file
containing the code for the requested formatting engine\. The argument will be
treated as the name of one of the predefined formats listed below if and only if
the path does not exist\.

*Note a limitation*: If treating the format as path to the tcl script
implementing the engine was sucessful, then this script has to implement not
only the engine API for doctools, i\.e\. *doctools\_api*, but for *doctoc\_api*
and *docidx\_api* as well\. Otherwise the generation of a table of contents and
of a keyword index will fail\.

List of predefined formats, i\.e\. as provided by the package
__[doctools](\.\./doctools/doctools\.md)__:

  - __nroff__

    The processor generates \*roff output, the standard format for unix manpages\.

  - __html__

    The processor generates HTML output, for usage in and display by web
    browsers\. This engine is currently the only one providing the various engine
    parameters required for the additional customaization of the output\.

  - __tmml__

    The processor generates TMML output, the Tcl Manpage Markup Language, a
    derivative of XML\.

  - __latex__

    The result of the command is the empty string\.
    The processor generates LaTeX output\.

  - __wiki__

    The details of the syntax inside of the *arguments* list are explained in
    The processor generates Wiki markup as understood by __wikit__\.

    section *COMMAND LINE* of the documentation for the
  - __list__

    __[dtplite](\.\./\.\./apps/dtplite\.md)__ application\.
    The processor extracts the information provided by __manpage\_begin__\.
    This format is used internally to extract the meta data from which both
    table of contents and keyword index are derived from\.

  - __null__

    The processor does not generate any output\. This is equivalent to
    __validate__\.

## <a name='subsection5'></a>DIRECTORY STRUCTURES

In this section we describe the directory structures generated by the
application under *output* when processing all documents in an
*inputdirectory*\. In other words, this is only relevant to the use cases \[2\]
and \[3\]\.

  - \[2\]

    The following directory structure is created when processing a single set of
    input documents\. The file extension used is for output in HTML, but that is
    not relevant to the structure and was just used to have proper file names\.

        output/
            toc.html
            index.html
            files/
                path/to/FOO.html

    The last line in the example shows the document generated for a file FOO
    located at

        inputdirectory/path/to/FOO

  - \[3\]

    When merging many packages into a unified set of documents the generated
    directory structure is a bit deeper:

        output
            .toc
            .idx
            .tocdoc
            .idxdoc
            .xrf
            toc.html
            index.html
            FOO1/
                ...
            FOO2/
                toc.html
                files/
                    path/to/BAR.html

    Each of the directories FOO1, \.\.\. contains the documents generated for the
    package FOO1, \.\.\. and follows the structure shown for use case \[2\]\. The only
    exception is that there is no per\-package index\.

    The files "\.toc", "\.idx", and "\.xrf" contain the internal status of the
    whole output and will be read and updated by the next invokation\. Their
    contents will not be documented\. Remove these files when all packages wanted
    for the output have been processed, i\.e\. when the output is complete\.

    The files "\.tocdoc", and "\.idxdoc", are intermediate files in doctoc and
    docidx markup, respectively, containing the main table of contents and
    keyword index for the set of documents before their conversion to the chosen
    output format\. They are left in place, i\.e\. not deleted, to serve as
    demonstrations of doctoc and docidx markup\.

# <a name='section2'></a>Bugs, Ideas, Feedback
# <a name='section3'></a>Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and
other problems\. Please report such in the category *doctools* of the [Tcllib
Trackers](http://core\.tcl\.tk/tcllib/reportlist)\. Please also report any ideas
for enhancements you may have for either package and/or documentation\.

When proposing code changes, please provide *unified diffs*, i\.e the output of




︙





Changes to embedded/md/tcllib/files/modules/irc/picoirc.md.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+









[//000000001]: # (picoirc \- Simple embeddable IRC interface)
[//000000002]: # (Generated from file 'picoirc\.man' by tcllib/doctools with format 'markdown')
[//000000003]: # (picoirc\(n\) 0\.11\.0 tcllib "Simple embeddable IRC interface")
[//000000003]: # (picoirc\(n\) 0\.13\.0 tcllib "Simple embeddable IRC interface")

<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
href="../../../toc.md">Table Of Contents</a> &#124; <a
href="../../../../index.md">Keyword Index</a> &#124; <a
href="../../../../toc0.md">Categories</a> &#124; <a
href="../../../../toc1.md">Modules</a> &#124; <a
href="../../../../toc2.md">Applications</a> ] <hr>




︙


31
32
33
34
35
36
37
38

39
40
41
42
43
44
45
46
47
48
49
50

31
32
33
34
35
36
37

38
39
40
41


42
43
44
45
46
47
48








-
+



-
-








  - [Keywords](#keywords)

  - [Category](#category)

# <a name='synopsis'></a>SYNOPSIS

package require Tcl 8\.6  
package require picoirc ?0\.11\.0?  
package require picoirc ?0\.13\.0?  

[__::picoirc::connect__ *callback* *nick* ?*password*? *url*](#1)  
[__::picoirc::post__ *context* *channel* *message*](#2)  
[__::picoirc::splituri__ *uri*](#3)  
[__::picoirc::send__ *context* *line*](#4)  

# <a name='description'></a>DESCRIPTION

This package provides a general purpose minimal IRC client suitable for
embedding in other applications\. All communication with the parent application
is done via an application provided callback procedure\. Each connection has its
own state so you can hook up multiple servers in a single application instance\.




︙


81
82
83
84
85
86
87
88
89
90




91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107






108
109
110
111
112
113
114

79
80
81
82
83
84
85



86
87
88
89

















90
91
92
93
94
95
96
97
98
99
100
101
102








-
-
-
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+








            if {$state == "verify"} {
                return [lindex $args 3]
            }
        }

  - <a name='2'></a>__::picoirc::post__ *context* *channel* *message*

    This should be called to process user input and send it to the server\. A
    number of commands are recognised when prefixed with a forward\-slash \(/\)\.
    Such commands are converted to IRC command sequences and then sent\.
    This should be called to process user input and send it to the server\. If
    *message* is multiline then each line will be processed and sent
    individually\. A number of commands are recognised when prefixed with a
    forward\-slash \(/\)\. Such commands are converted to IRC command sequences and

  - <a name='3'></a>__::picoirc::splituri__ *uri*

    Splits an IRC scheme uniform resource indicator into its component parts\.
    Returns a list of server, port, channels and secure where secure is a
    boolean flag which is __true__ if a TLS connection was requested via the
    *ircs://* schema\. The default port is 6667 \(or 6697 if secured\) and there
    are no default channels\.

  - <a name='4'></a>__::picoirc::send__ *context* *line*

    This command is where all raw output to the server is handled\. The default
    action is to write the *line* to the irc socket\. However, before this
    happens the callback is called with "debug write"\. This permits the
    application author to inspect the raw IRC data and if desired to return a
    break error code to halt further processing\. In this way the application can
    override the default send via the callback procedure\.
    then sent\. If *channel* is empty then all raw output to the server is
    handled\. The default action is to write the *message* to the irc socket\.
    However, before this happens the callback is called with "debug write"\. This
    permits the application author to inspect the raw IRC data and if desired to
    return a break error code to halt further processing\. In this way the
    application can override the default send via the callback procedure\.

# <a name='section3'></a>CALLBACK

The callback must look like:

    proc Callback {context state args} {
    }




︙


148
149
150
151
152
153
154
155


156
157
158
159
160
161
162

136
137
138
139
140
141
142

143
144
145
146
147
148
149
150
151








-
+
+









    called when a message arrives\. *target* is the identity that the message
    was targetted for\. This can be the logged in nick or a channel name\.
    *nick* is the name of the sender of the message\. *message* is the
    message text\. *type* is set to "ACTION" if the message was sent as a CTCP
    ACTION\. *type* is set to "NOTICE" if the message was sent as a NOTICE
    command, in that case *target* is empty if it matches current user nick or
    it's "\*", in later case empty *nick* means that notice comes from server\.
    it's "\*", in later case empty *target* means that notice comes from
    server\.

  - __mode__ *nick* *target* *flags*

    called when mode of user or channel changes\. *nick* is the name of the
    user who requested a change, can be empty if it's the server\. *target* is
    the identity that has its mode changed\. *flags* are the changes in mode\.





︙





Changes to embedded/md/tcllib/files/modules/markdown/markdown.md.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+









[//000000001]: # (markdown \- Markdown to HTML Converter)
[//000000002]: # (Generated from file 'markdown\.man' by tcllib/doctools with format 'markdown')
[//000000003]: # (markdown\(n\) 1\.2\.1 tcllib "Markdown to HTML Converter")
[//000000003]: # (markdown\(n\) 1\.2\.2 tcllib "Markdown to HTML Converter")

<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
href="../../../toc.md">Table Of Contents</a> &#124; <a
href="../../../../index.md">Keyword Index</a> &#124; <a
href="../../../../toc0.md">Categories</a> &#124; <a
href="../../../../toc1.md">Modules</a> &#124; <a
href="../../../../toc2.md">Applications</a> ] <hr>




︙


27
28
29
30
31
32
33
34

35
36
37
38
39
40
41

27
28
29
30
31
32
33

34
35
36
37
38
39
40
41








-
+








  - [Bugs, Ideas, Feedback](#section3)

  - [Category](#category)

# <a name='synopsis'></a>SYNOPSIS

package require Tcl 8\.5  
package require Markdown 1\.2\.1  
package require Markdown 1\.2\.2  
package require textutil ?0\.8?  

[__::Markdown::convert__ *markdown*](#1)  
[__::Markdown::register__ *langspec* *converter*](#2)  
[__::Markdown::get\_lang\_counter__](#3)  
[__::Markdown::reset\_lang\_counter__](#4)  





︙





Changes to embedded/md/tcllib/files/modules/math/figurate.md.






︙


86
87
88
89
90
91
92
93



94
95
96
97
98
99
100

86
87
88
89
90
91
92

93
94
95
96
97
98
99
100
101
102








-
+
+
+








    *  *
    *  *  *
    *  *  *  *
    ...

The __math::figurate__ package consists of a collection of procedures to
evaluate a wide variety of figurate numbers\. While all formulae are
straightforward, the details are sometimes puzzling\.
straightforward, the details are sometimes puzzling\. *Note:* The procedures
consider arguments lower than zero as to mean "no objects to be counted" and
therefore return 0\.

# <a name='section2'></a>PROCEDURES

The procedures can be arranged in a few categories: sums of integers raised to a
particular power, sums of odd integers and general figurate numbers, for
instance the pentagonal numbers\.





︙





Added embedded/md/tcllib/files/modules/mkdoc/mkdoc.md.













































































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+


[//000000001]: # (mkdoc \- Source code documentation using Markdown)
[//000000002]: # (Generated from file 'mkdoc\.man' by tcllib/doctools with format 'markdown')
[//000000003]: # (Copyright &copy; 2019\-2022, Detlef Groth <detlef\(at\)dgroth\(dot\)de>)
[//000000004]: # (mkdoc\(n\) 0\.7\.0 tcllib "Source code documentation using Markdown")

<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
href="../../../toc.md">Table Of Contents</a> &#124; <a
href="../../../../index.md">Keyword Index</a> &#124; <a
href="../../../../toc0.md">Categories</a> &#124; <a
href="../../../../toc1.md">Modules</a> &#124; <a
href="../../../../toc2.md">Applications</a> ] <hr>

# NAME

mkdoc \- Extracts and optionally converts Markdown comments in source code to
HTML

# <a name='toc'></a>Table Of Contents

  - [Table Of Contents](#toc)

  - [Synopsis](#synopsis)

  - [Description](#section1)

  - [Examples](#section2)

  - [Formatting](#section3)

  - [Bugs, Ideas, Feedback](#section4)

  - [Code Copyright](#section5)

  - [Category](#category)

  - [Copyright](#copyright)

# <a name='synopsis'></a>SYNOPSIS

package require Tcl 8\.6  
package require Markdown ?1\.2\.1?  
package require yaml ?0\.4\.1?  
package require mkdoc ?0\.7\.0?  
package require hook  

[__::mkdoc::mkdoc__ *infile* *outfile* ?__\-css__ *cssfile*?](#1)  
[__::mkdoc::run__ *infile*](#2)  

# <a name='description'></a>DESCRIPTION

The package __mkdoc__ provides a command to extract documentation embedded
in code and optionally convert these comments into HTML\. The latter uses
Tcllib's __[Markdown](\.\./markdown/markdown\.md)__ package\. Each line of
the embedded documentation begins with the special comment marker __\#'__\.

  - <a name='1'></a>__::mkdoc::mkdoc__ *infile* *outfile* ?__\-css__ *cssfile*?

    The command reads the specified *infile* and extracts the code comments
    introduced by the __\#'__ marker\. If the *outfile* is either a "\.html"
    or "\.htm" file the Markdown is converted into HTML using either a default
    style or the specified style sheet *cssfile*\.

    All arguments are paths to the files to read from or write to\.

    The result of the command is the empty string\.

    See section [Formatting](#section3) for the supported Markdown syntax
    and extensions to it\.

  - <a name='2'></a>__::mkdoc::run__ *infile*

    The command reads the specified *infile*, extracts the embedded
    documentation, and then executes the contents of the first example, i\.e\.
    __\`\`\`__\-quoted block, found in the __Example__ section\.

    Here is such an example which will be executed by the Tcl interpreter

        #' ## <a name="example">Example</a>
        #'
        #' ```
        #' puts "Hello mkdoc package"
        #' puts "I am in the example section"
        #' ```

    *DANGER, BEWARE*\. Failing to open the *infile* causes the command to
    *exit* the entire process\.

    Use of this command in a general context is not recommended\.

# <a name='section2'></a>Examples

The example below demonstrates the conversion of the documentation embedded into
the file "mkdoc\.tcl" itself:

    package require mkdoc
    # extracting the Markdown
    mkdoc::mkdoc mkdoc.tcl mkdoc.md
    # converting Markdown to HTML
    mkdoc::mkdoc mkdoc.md mkdoc.html
    # direct conversion without intermediate file
    mkdoc::mkdoc mkdoc.tcl mkdoc.html

# <a name='section3'></a>Formatting

The package supports the syntax supported by Tcllib's
__[Markdown](\.\./markdown/markdown\.md)__ package\.

It further supports a set of simple YAML headers whose information is inserted
into appropriate HTML __meta__\-tags\. The supported keys are

  - __author__

    Set the document author\. Defaults to __NN__\.

  - __title__

    Set the document title\. Defaults to __Documentation ____filename__\]\.

  - __date__

    Sets the document date\. Defaults to the current day\.

  - __css__

    Sets a custom CSS stylesheet\. Defaults to the internal mkdoc sheet\.

*Note* that in Markdown output mode these headers are simply passed through
into the result\. This is proper, as processors like __pandoc__ are able to
use them as well\.

See the example below for the syntax:

    #' ---
    #' title: mkdoc::mkdoc 0.7.0
    #' author: Detlef Groth, Schwielowsee, Germany
    #' date: 2022-04-17
    #' css: mini.css
    #' ---
    #'

Another extension over standard Markdown is the support of a single level of
includes\.

See the example below for the syntax:

    #' #include "path/to/include/file"

*Note*, the double\-quotes around the path are part of the syntax\.

*Beware* further that relative paths are resolved relative to the current
working directory, and *not* relative to the location of the including file\.

# <a name='section4'></a>Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and
other problems\. Please report such to the author of this package\. Please also
report any ideas for enhancements you may have for either package and/or
documentation\.

# <a name='section5'></a>Code Copyright

BSD License type:

The following terms apply to all files a ssociated with the software unless
explicitly disclaimed in individual files\.

The authors hereby grant permission to use, copy, modify, distribute, and
license this software and its documentation for any purpose, provided that
existing copyright notices are retained in all copies and that this notice is
included verbatim in any distributions\. No written agreement, license, or
royalty fee is required for any of the authorized uses\. Modifications to this
software may be copyrighted by their authors and need not follow the licensing
terms described here, provided that the new terms are clearly indicated on the
first page of each file where they apply\.

In no event shall the authors or distributors be liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use
of this software, its documentation, or any derivatives thereof, even if the
authors have been advised of the possibility of such damage\.

The authors and distributors specifically disclaim any warranties, including,
but not limited to, the implied warranties of merchantability, fitness for a
particular purpose, and non\-infringement\. This software is provided on an "as
is" basis, and the authors and distributors have no obligation to provide
maintenance, support, updates, enhancements, or modifications\.

*RESTRICTED RIGHTS*: Use, duplication or disclosure by the government is
subject to the restrictions as set forth in subparagraph \(c\) \(1\) \(ii\) of the
Rights in Technical Data and Computer Software Clause as DFARS 252\.227\-7013 and
FAR 52\.227\-19\.

# <a name='category'></a>CATEGORY

Text processing

# <a name='copyright'></a>COPYRIGHT

Copyright &copy; 2019\-2022, Detlef Groth <detlef\(at\)dgroth\(dot\)de>






Changes to embedded/md/tcllib/files/modules/rest/rest.md.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+









[//000000001]: # (rest \- A framework for RESTful web services)
[//000000002]: # (Generated from file 'rest\.man' by tcllib/doctools with format 'markdown')
[//000000003]: # (rest\(n\) 1\.4 tcllib "A framework for RESTful web services")
[//000000003]: # (rest\(n\) 1\.5 tcllib "A framework for RESTful web services")

<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
href="../../../toc.md">Table Of Contents</a> &#124; <a
href="../../../../index.md">Keyword Index</a> &#124; <a
href="../../../../toc0.md">Categories</a> &#124; <a
href="../../../../toc1.md">Modules</a> &#124; <a
href="../../../../toc2.md">Applications</a> ] <hr>




︙


35
36
37
38
39
40
41
42

43
44
45
46
47
48
49

35
36
37
38
39
40
41

42
43
44
45
46
47
48
49








-
+








  - [TLS Security Considerations](#section7)

  - [Bugs, Ideas, Feedback](#section8)

# <a name='synopsis'></a>SYNOPSIS

package require Tcl 8\.5  
package require rest ?1\.4?  
package require rest ?1\.5?  

[__::rest::simple__ *url* *query* ?*config*? ?*body*?](#1)  
[__::rest::get__ *url* *query* ?*config*? ?*body*?](#2)  
[__::rest::post__ *url* *query* ?*config*? ?*body*?](#3)  
[__::rest::patch__ *url* *query* ?*config*? ?*body*?](#4)  
[__::rest::head__ *url* *query* ?*config*? ?*body*?](#5)  
[__::rest::put__ *url* *query* ?*config*? ?*body*?](#6)  




︙


336
337
338
339
340
341
342





343
344
345
346
347
348
349

336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354








+
+
+
+
+








          + __basic__

            The user may configure the *basic authentication* by overriding
            the procedure __basic\_auth__ in the namespace of interface\. This
            procedure takes two arguments, the username and password, in this
            order\.

          + __bearer__

            The user may configure a bearer token as authentication\. The value
            is the token passed to the HTTP authorization header\.

          + __sign__

            The value must actually be a list with the second element the name
            of a procedure which will be called to perform request signing\.

      * __callback__





︙





Changes to embedded/md/tcllib/files/modules/struct/struct_list.md.





1
2
3
4
5
6

7
8
9
10
11
12
13

1
2
3
4
5

6
7
8
9
10
11
12
13






-
+









[//000000001]: # (struct::list \- Tcl Data Structures)
[//000000002]: # (Generated from file 'struct\_list\.man' by tcllib/doctools with format 'markdown')
[//000000003]: # (Copyright &copy; 2003\-2005 by Kevin B\. Kenny\. All rights reserved)
[//000000004]: # (Copyright &copy; 2003\-2012 Andreas Kupries <andreas\_kupries@users\.sourceforge\.net>)
[//000000005]: # (struct::list\(n\) 1\.8\.4 tcllib "Tcl Data Structures")
[//000000005]: # (struct::list\(n\) 1\.8\.5 tcllib "Tcl Data Structures")

<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
href="../../../toc.md">Table Of Contents</a> &#124; <a
href="../../../../index.md">Keyword Index</a> &#124; <a
href="../../../../toc0.md">Categories</a> &#124; <a
href="../../../../toc1.md">Modules</a> &#124; <a
href="../../../../toc2.md">Applications</a> ] <hr>




︙


39
40
41
42
43
44
45
46

47
48
49
50
51
52
53

39
40
41
42
43
44
45

46
47
48
49
50
51
52
53








-
+








  - [Category](#category)

  - [Copyright](#copyright)

# <a name='synopsis'></a>SYNOPSIS

package require Tcl 8\.4  
package require struct::list ?1\.8\.4?  
package require struct::list ?1\.8\.5?  

[__::struct::list__ __longestCommonSubsequence__ *sequence1* *sequence2* ?*maxOccurs*?](#1)  
[__::struct::list__ __longestCommonSubsequence2__ *sequence1 sequence2* ?*maxOccurs*?](#2)  
[__::struct::list__ __lcsInvert__ *lcsData* *len1* *len2*](#3)  
[__::struct::list__ __lcsInvert2__ *lcs1* *lcs2* *len1* *len2*](#4)  
[__::struct::list__ __lcsInvertMerge__ *lcsData* *len1* *len2*](#5)  
[__::struct::list__ __lcsInvertMerge2__ *lcs1* *lcs2* *len1* *len2*](#6)  




︙





Changes to embedded/md/tcllib/files/modules/tar/tar.md.






︙


18
19
20
21
22
23
24




25

26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
































48
49
50
51
52
53
54

18
19
20
21
22
23
24
25
26
27
28

29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49


50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88








+
+
+
+
-
+




















-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+









  - [Table Of Contents](#toc)

  - [Synopsis](#synopsis)

  - [Description](#section1)

  - [BEWARE](#section2)

  - [COMMANDS](#section3)

  - [Bugs, Ideas, Feedback](#section2)
  - [Bugs, Ideas, Feedback](#section4)

  - [Keywords](#keywords)

  - [Category](#category)

# <a name='synopsis'></a>SYNOPSIS

package require Tcl 8\.4  
package require tar ?0\.11?  

[__::tar::contents__ *tarball* ?__\-chan__?](#1)  
[__::tar::stat__ *tarball* ?file? ?__\-chan__?](#2)  
[__::tar::untar__ *tarball* *args*](#3)  
[__::tar::get__ *tarball* *fileName* ?__\-chan__?](#4)  
[__::tar::create__ *tarball* *files* *args*](#5)  
[__::tar::add__ *tarball* *files* *args*](#6)  
[__::tar::remove__ *tarball* *files*](#7)  

# <a name='description'></a>DESCRIPTION

Note: Starting with version 0\.8 the tar reader commands \(contents, stats, get,
untar\) support the GNU LongName extension \(header type 'L'\) for large paths\.
*Note*: Starting with version 0\.8 the tar reader commands \(contents, stats,
get, untar\) support the GNU LongName extension \(header type 'L'\) for large
paths\.

# <a name='section2'></a>BEWARE

For all commands, when using __\-chan__ \.\.\.

  1. It is assumed that the channel was opened for reading, and configured for
     binary input\.

  1. It is assumed that the channel position is at the beginning of a legal tar
     file\.

  1. The commands will *modify* the channel position as they perform their
     task\.

  1. The commands will *not* close the channel\.

  1. In other words, the commands leave the channel in a state very likely
     unsuitable for use by further __tar__ commands\. Still doing so will
     very likely results in errors, bad data, etc\. pp\.

  1. It is the responsibility of the user to seek the channel back to a suitable
     position\.

  1. When using a channel transformation which is not generally seekable, for
     example __gunzip__, then it is the responsibility of the user to \(a\)
     unstack the transformation before seeking the channel back to a suitable
     position, and \(b\) for restacking it after\.

# <a name='section3'></a>COMMANDS

  - <a name='1'></a>__::tar::contents__ *tarball* ?__\-chan__?

    Returns a list of the files contained in *tarball*\. The order is not
    sorted and depends on the order files were stored in the archive\.

    If the option __\-chan__ is present *tarball* is interpreted as an open




︙


183
184
185
186
187
188
189
190

191
192
193
194
195
196
197

217
218
219
220
221
222
223

224
225
226
227
228
229
230
231








-
+








    does not exist in the tarball\. Directory write permission and free disk
    space equivalent to at least the size of the tarball will be needed\.

        % ::tar::remove new.tar {file2 file3}
        % ::tar::contents new.tar
        file3

# <a name='section2'></a>Bugs, Ideas, Feedback
# <a name='section4'></a>Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and
other problems\. Please report such in the category *tar* of the [Tcllib
Trackers](http://core\.tcl\.tk/tcllib/reportlist)\. Please also report any ideas
for enhancements you may have for either package and/or documentation\.

When proposing code changes, please provide *unified diffs*, i\.e the output of




︙





Changes to embedded/md/tcllib/files/modules/websocket/websocket.md.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+









[//000000001]: # (websocket \- websocket client and server)
[//000000002]: # (Generated from file 'websocket\.man' by tcllib/doctools with format 'markdown')
[//000000003]: # (websocket\(n\) 1\.3\.1 tcllib "websocket client and server")
[//000000003]: # (websocket\(n\) 1\.4\.2 tcllib "websocket client and server")

<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
href="../../../toc.md">Table Of Contents</a> &#124; <a
href="../../../../index.md">Keyword Index</a> &#124; <a
href="../../../../toc0.md">Categories</a> &#124; <a
href="../../../../toc1.md">Modules</a> &#124; <a
href="../../../../toc2.md">Applications</a> ] <hr>




︙


41
42
43
44
45
46
47
48

49
50
51
52
53
54
55

41
42
43
44
45
46
47

48
49
50
51
52
53
54
55








-
+








# <a name='synopsis'></a>SYNOPSIS

package require Tcl 8\.4  
package require http 2\.7  
package require logger  
package require sha1  
package require base64  
package require websocket ?1\.3\.1?  
package require websocket ?1\.4\.2?  

[__::websocket::open__ *url* *handler* ?*options*?](#1)  
[__::websocket::send__ *sock* *type* ?*msg*? ?*final*?](#2)  
[__::websocket::server__ *sock*](#3)  
[__::websocket::live__ *sock* *path* *cb* ?*proto*?](#4)  
[__::websocket::test__ *srvSock* *cliSock* *path* ?*hdrs*? ?*qry*?](#5)  
[__::websocket::upgrade__ *sock*](#6)  




︙





Changes to embedded/md/tcllib/toc.md.






︙


217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232

217
218
219
220
221
222
223


224
225
226
227
228
229
230








-
-









  - [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) doctools language introduction

  - [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md) doctools language syntax

  - [doctools\_plugin\_apiref](tcllib/files/modules/doctools/doctools\_plugin\_apiref\.md) doctools plugin API reference

  - [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor

  - [dtplite](tcllib/files/apps/dtplite\.md) Lightweight DocTools Markup Processor

  - [fileutil](tcllib/files/modules/fileutil/fileutil\.md) Procedures implementing some file utilities

  - [fileutil::magic::cfront](tcllib/files/modules/fumagic/cfront\.md) Generator core for compiler of magic\(5\) files

  - [fileutil::magic::cgen](tcllib/files/modules/fumagic/cgen\.md) Generator core for compiler of magic\(5\) files




︙


405
406
407
408
409
410
411




412
413
414
415
416
417
418

403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420








+
+
+
+









  - [md5](tcllib/files/modules/md5/md5\.md) MD5 Message\-Digest Algorithm

  - [md5crypt](tcllib/files/modules/md5crypt/md5crypt\.md) MD5\-based password encryption

  - [mime](tcllib/files/modules/mime/mime\.md) Manipulation of MIME body parts

  - [mkdoc](tcllib/files/apps/mkdoc\.md) Source code documentation extractor/converter application

  - [mkdoc](tcllib/files/modules/mkdoc/mkdoc\.md) Extracts and optionally converts Markdown comments in source code to HTML

  - [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) Markup processor

  - [multiplexer](tcllib/files/modules/multiplexer/multiplexer\.md) One\-to\-many communication with sockets\.

  - [nameserv](tcllib/files/modules/nns/nns\_client\.md) Name service facility, Client

  - [nameserv::auto](tcllib/files/modules/nns/nns\_auto\.md) Name service facility, Client Extension




︙


466
467
468
469
470
471
472


473
474
475
476
477
478
479

468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483








+
+








  - [page\_util\_norm\_peg](tcllib/files/modules/page/page\_util\_norm\_peg\.md) page AST normalization, PEG

  - [page\_util\_peg](tcllib/files/modules/page/page\_util\_peg\.md) page PEG transformation utilities

  - [page\_util\_quote](tcllib/files/modules/page/page\_util\_quote\.md) page character quoting utilities

  - [picoirc](tcllib/files/modules/irc/picoirc\.md) Small and simple embeddable IRC client\.

  - [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor

  - [pki](tcllib/files/modules/pki/pki\.md) Implementation of the public key cipher

  - [pluginmgr](tcllib/files/modules/pluginmgr/pluginmgr\.md) Manage a plugin

  - [png](tcllib/files/modules/png/png\.md) PNG querying and manipulation of meta data





︙





Changes to embedded/md/toc.md.






︙


251
252
253
254
255
256
257
258
259
260
261
262


263
264
265
266
267
268
269

251
252
253
254
255
256
257


258
259
260
261
262
263
264
265
266
267
268
269








-
-



+
+









          + [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) doctools language introduction

          + [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md) doctools language syntax

          + [doctools\_plugin\_apiref](tcllib/files/modules/doctools/doctools\_plugin\_apiref\.md) doctools plugin API reference

          + [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor

          + [dtplite](tcllib/files/apps/dtplite\.md) Lightweight DocTools Markup Processor

          + [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) Markup processor

          + [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor

          + [tcldocstrip](tcllib/files/apps/tcldocstrip\.md) Tcl\-based Docstrip Processor

          + [tepam::doc\_gen](tcllib/files/modules/tepam/tepam\_doc\_gen\.md) TEPAM DOC Generation, reference manual

          + [textutil::expander](tcllib/files/modules/textutil/expander\.md) Procedures to process templates and expand text\.





︙


795
796
797
798
799
800
801




802
803
804
805
806
807
808

795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812








+
+
+
+









          + [inifile](tcllib/files/modules/inifile/ini\.md) Parsing of Windows INI files

          + [markdown](tcllib/files/modules/markdown/markdown\.md) Converts Markdown text to HTML

          + [mime](tcllib/files/modules/mime/mime\.md) Manipulation of MIME body parts

          + [mkdoc](tcllib/files/modules/mkdoc/mkdoc\.md) Extracts and optionally converts Markdown comments in source code to HTML

          + [mkdoc](tcllib/files/apps/mkdoc\.md) Source code documentation extractor/converter application

          + [rcs](tcllib/files/modules/rcs/rcs\.md) RCS low level utilities

          + [string::token](tcllib/files/modules/string/token\.md) Regex based iterative lexing

          + [string::token::shell](tcllib/files/modules/string/token\_shell\.md) Parsing of shell command line

          + [textutil](tcllib/files/modules/textutil/textutil\.md) Procedures to manipulate texts and strings\.




︙


938
939
940
941
942
943
944


945
946
947
948
949
950
951

942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957








+
+








          + [valtype::verhoeff](tcllib/files/modules/valtype/verhoeff\.md) Validation for plain number with a VERHOEFF checkdigit

  - [By Type]()

      * [Applications]()

          + [dtplite](tcllib/files/apps/dtplite\.md) Lightweight DocTools Markup Processor

          + [mkdoc](tcllib/files/apps/mkdoc\.md) Source code documentation extractor/converter application

          + [nns](tcllib/files/apps/nns\.md) Name service facility, Commandline Client Application

          + [nnsd](tcllib/files/apps/nnsd\.md) Name service facility, Commandline Server Application

          + [nnslog](tcllib/files/apps/nnslog\.md) Name service facility, Commandline Logging Client Application





︙


1245
1246
1247
1248
1249
1250
1251
1252

1253
1254
1255
1256
1257
1258
1259

1251
1252
1253
1254
1255
1256
1257

1258
1259
1260
1261
1262
1263
1264
1265








-
+









              - [doctools::toc::parse](tcllib/files/modules/doctools2toc/toc\_parse\.md) Parsing text in doctoc format

              - [doctools::toc::structure](tcllib/files/modules/doctools2toc/toc\_structure\.md) Doctoc serialization utilities

          + [dtplite]()

              - [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor
              - [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor

          + [fileutil]()

              - [fileutil](tcllib/files/modules/fileutil/fileutil\.md) Procedures implementing some file utilities

              - [fileutil::multi](tcllib/files/modules/fileutil/multi\.md) Multi\-file operation, scatter/gather, standard object





︙


1509
1510
1511
1512
1513
1514
1515




1516
1517
1518
1519
1520
1521
1522

1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532








+
+
+
+









          + [mime]()

              - [mime](tcllib/files/modules/mime/mime\.md) Manipulation of MIME body parts

              - [smtp](tcllib/files/modules/mime/smtp\.md) Client\-side tcl implementation of the smtp protocol

          + [mkdoc]()

              - [mkdoc](tcllib/files/modules/mkdoc/mkdoc\.md) Extracts and optionally converts Markdown comments in source code to HTML

          + [multiplexer]()

              - [multiplexer](tcllib/files/modules/multiplexer/multiplexer\.md) One\-to\-many communication with sockets\.

          + [namespacex]()

              - [namespacex](tcllib/files/modules/namespacex/namespacex\.md) Namespace utility commands




︙





Changes to embedded/md/toc0.md.






︙


251
252
253
254
255
256
257
258
259
260
261
262


263
264
265
266
267
268
269

251
252
253
254
255
256
257


258
259
260
261
262
263
264
265
266
267
268
269








-
-



+
+









          + [doctools\_lang\_intro](tcllib/files/modules/doctools/doctools\_lang\_intro\.md) doctools language introduction

          + [doctools\_lang\_syntax](tcllib/files/modules/doctools/doctools\_lang\_syntax\.md) doctools language syntax

          + [doctools\_plugin\_apiref](tcllib/files/modules/doctools/doctools\_plugin\_apiref\.md) doctools plugin API reference

          + [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor

          + [dtplite](tcllib/files/apps/dtplite\.md) Lightweight DocTools Markup Processor

          + [mpexpand](tcllib/files/modules/doctools/mpexpand\.md) Markup processor

          + [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor

          + [tcldocstrip](tcllib/files/apps/tcldocstrip\.md) Tcl\-based Docstrip Processor

          + [tepam::doc\_gen](tcllib/files/modules/tepam/tepam\_doc\_gen\.md) TEPAM DOC Generation, reference manual

          + [textutil::expander](tcllib/files/modules/textutil/expander\.md) Procedures to process templates and expand text\.





︙


794
795
796
797
798
799
800




801
802
803
804
805
806
807

794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811








+
+
+
+








          + [htmlparse](tcllib/files/modules/htmlparse/htmlparse\.md) Procedures to parse HTML strings

          + [inifile](tcllib/files/modules/inifile/ini\.md) Parsing of Windows INI files

          + [markdown](tcllib/files/modules/markdown/markdown\.md) Converts Markdown text to HTML

          + [mime](tcllib/files/modules/mime/mime\.md) Manipulation of MIME body parts

          + [mkdoc](tcllib/files/modules/mkdoc/mkdoc\.md) Extracts and optionally converts Markdown comments in source code to HTML

          + [mkdoc](tcllib/files/apps/mkdoc\.md) Source code documentation extractor/converter application

          + [rcs](tcllib/files/modules/rcs/rcs\.md) RCS low level utilities

          + [string::token](tcllib/files/modules/string/token\.md) Regex based iterative lexing

          + [string::token::shell](tcllib/files/modules/string/token\_shell\.md) Parsing of shell command line





︙





Changes to embedded/md/toc1.md.






︙


293
294
295
296
297
298
299
300

301
302
303
304
305
306
307

293
294
295
296
297
298
299

300
301
302
303
304
305
306
307








-
+









          + [doctools::toc::parse](tcllib/files/modules/doctools2toc/toc\_parse\.md) Parsing text in doctoc format

          + [doctools::toc::structure](tcllib/files/modules/doctools2toc/toc\_structure\.md) Doctoc serialization utilities

      * [dtplite]()

          + [dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor
          + [pkg\_dtplite](tcllib/files/modules/dtplite/pkg\_dtplite\.md) Lightweight DocTools Markup Processor

      * [fileutil]()

          + [fileutil](tcllib/files/modules/fileutil/fileutil\.md) Procedures implementing some file utilities

          + [fileutil::multi](tcllib/files/modules/fileutil/multi\.md) Multi\-file operation, scatter/gather, standard object





︙


557
558
559
560
561
562
563




564
565
566
567
568
569
570

557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574








+
+
+
+









      * [mime]()

          + [mime](tcllib/files/modules/mime/mime\.md) Manipulation of MIME body parts

          + [smtp](tcllib/files/modules/mime/smtp\.md) Client\-side tcl implementation of the smtp protocol

      * [mkdoc]()

          + [mkdoc](tcllib/files/modules/mkdoc/mkdoc\.md) Extracts and optionally converts Markdown comments in source code to HTML

      * [multiplexer]()

          + [multiplexer](tcllib/files/modules/multiplexer/multiplexer\.md) One\-to\-many communication with sockets\.

      * [namespacex]()

          + [namespacex](tcllib/files/modules/namespacex/namespacex\.md) Namespace utility commands




︙





Changes to embedded/md/toc2.md.





1
2
3
4
5
6
7
8


9
10
11
12
13
14
15

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17









+
+









[//000000001]: # (Table of contents generated by tcllib/doctools/toc with format 'markdown')

# Table Of Contents \-\-

  - [Applications]()

      * [dtplite](tcllib/files/apps/dtplite\.md) Lightweight DocTools Markup Processor

      * [mkdoc](tcllib/files/apps/mkdoc\.md) Source code documentation extractor/converter application

      * [nns](tcllib/files/apps/nns\.md) Name service facility, Commandline Client Application

      * [nnsd](tcllib/files/apps/nnsd\.md) Name service facility, Commandline Server Application

      * [nnslog](tcllib/files/apps/nnslog\.md) Name service facility, Commandline Logging Client Application





︙





Added idoc/man/files/apps/mkdoc.n.



























































































































































































































































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

'\"
'\" Generated from file 'mkdoc\&.man' by tcllib/doctools with format 'nroff'
'\" Copyright (c) 2019-2022, Detlef Groth <detlef(at)dgroth(dot)de>
'\"
.TH "mkdoc" n 0\&.7\&.0 tcllib "Source code documentation using Markdown"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,
.\"	and indent is equivalent to second arg of .IP (shouldn't ever be
.\"	needed;  use .AS below instead)
.\"
.\" .AS ?type? ?name?
.\"	Give maximum sizes of arguments for setting tab stops.  Type and
.\"	name are examples of largest possible arguments that will be passed
.\"	to .AP later.  If args are omitted, default tab stops are used.
.\"
.\" .BS
.\"	Start box enclosure.  From here until next .BE, everything will be
.\"	enclosed in one large box.
.\"
.\" .BE
.\"	End of box enclosure.
.\"
.\" .CS
.\"	Begin code excerpt.
.\"
.\" .CE
.\"	End code excerpt.
.\"
.\" .VS ?version? ?br?
.\"	Begin vertical sidebar, for use in marking newly-changed parts
.\"	of man pages.  The first argument is ignored and used for recording
.\"	the version when the .VS was added, so that the sidebars can be
.\"	found and removed when they reach a certain age.  If another argument
.\"	is present, then a line break is forced before starting the sidebar.
.\"
.\" .VE
.\"	End of vertical sidebar.
.\"
.\" .DS
.\"	Begin an indented unfilled display.
.\"
.\" .DE
.\"	End of indented unfilled display.
.\"
.\" .SO ?manpage?
.\"	Start of list of standard options for a Tk widget. The manpage
.\"	argument defines where to look up the standard options; if
.\"	omitted, defaults to "options". The options follow on successive
.\"	lines, in three columns separated by tabs.
.\"
.\" .SE
.\"	End of list of standard options for a Tk widget.
.\"
.\" .OP cmdName dbName dbClass
.\"	Start of description of a specific option.  cmdName gives the
.\"	option's name as specified in the class command, dbName gives
.\"	the option's name in the option database, and dbClass gives
.\"	the option's class in the option database.
.\"
.\" .UL arg1 arg2
.\"	Print arg1 underlined, then print arg2 normally.
.\"
.\" .QW arg1 ?arg2?
.\"	Print arg1 in quotes, then arg2 normally (for trailing punctuation).
.\"
.\" .PQ arg1 ?arg2?
.\"	Print an open parenthesis, arg1 in quotes, then arg2 normally
.\"	(for trailing punctuation) and then a closing parenthesis.
.\"
.\"	# Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
.if t .wh -1.3i ^B
.nr ^l \n(.l
.ad b
.\"	# Start an argument description
.de AP
.ie !"\\$4"" .TP \\$4
.el \{\
.   ie !"\\$2"" .TP \\n()Cu
.   el          .TP 15
.\}
.ta \\n()Au \\n()Bu
.ie !"\\$3"" \{\
\&\\$1 \\fI\\$2\\fP (\\$3)
.\".b
.\}
.el \{\
.br
.ie !"\\$2"" \{\
\&\\$1	\\fI\\$2\\fP
.\}
.el \{\
\&\\fI\\$1\\fP
.\}
.\}
..
.\"	# define tabbing values for .AP
.de AS
.nr )A 10n
.if !"\\$1"" .nr )A \\w'\\$1'u+3n
.nr )B \\n()Au+15n
.\"
.if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
.nr )C \\n()Bu+\\w'(in/out)'u+2n
..
.AS Tcl_Interp Tcl_CreateInterp in/out
.\"	# BS - start boxed text
.\"	# ^y = starting y location
.\"	# ^b = 1
.de BS
.br
.mk ^y
.nr ^b 1u
.if n .nf
.if n .ti 0
.if n \l'\\n(.lu\(ul'
.if n .fi
..
.\"	# BE - end boxed text (draw box now)
.de BE
.nf
.ti 0
.mk ^t
.ie n \l'\\n(^lu\(ul'
.el \{\
.\"	Draw four-sided box normally, but don't draw top of
.\"	box if the box started on an earlier page.
.ie !\\n(^b-1 \{\
\h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
.\}
.el \}\
\h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
.\}
.\}
.fi
.br
.nr ^b 0
..
.\"	# VS - start vertical sidebar
.\"	# ^Y = starting y location
.\"	# ^v = 1 (for troff;  for nroff this doesn't matter)
.de VS
.if !"\\$2"" .br
.mk ^Y
.ie n 'mc \s12\(br\s0
.el .nr ^v 1u
..
.\"	# VE - end of vertical sidebar
.de VE
.ie n 'mc
.el \{\
.ev 2
.nf
.ti 0
.mk ^t
\h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
.sp -1
.fi
.ev
.\}
.nr ^v 0
..
.\"	# Special macro to handle page bottom:  finish off current
.\"	# box/sidebar if in box/sidebar mode, then invoked standard
.\"	# page bottom macro.
.de ^B
.ev 2
'ti 0
'nf
.mk ^t
.if \\n(^b \{\
.\"	Draw three-sided box if this is the box's first page,
.\"	draw two sides but no top otherwise.
.ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
.el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
.\}
.if \\n(^v \{\
.nr ^x \\n(^tu+1v-\\n(^Yu
\kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
.\}
.bp
'fi
.ev
.if \\n(^b \{\
.mk ^y
.nr ^b 2
.\}
.if \\n(^v \{\
.mk ^Y
.\}
..
.\"	# DS - begin display
.de DS
.RS
.nf
.sp
..
.\"	# DE - end display
.de DE
.fi
.RE
.sp
..
.\"	# SO - start of list of standard options
.de SO
'ie '\\$1'' .ds So \\fBoptions\\fR
'el .ds So \\fB\\$1\\fR
.SH "STANDARD OPTIONS"
.LP
.nf
.ta 5.5c 11c
.ft B
..
.\"	# SE - end of list of standard options
.de SE
.fi
.ft R
.LP
See the \\*(So manual entry for details on the standard options.
..
.\"	# OP - start of full description for a single option
.de OP
.LP
.nf
.ta 4c
Command-Line Name:	\\fB\\$1\\fR
Database Name:	\\fB\\$2\\fR
Database Class:	\\fB\\$3\\fR
.fi
.IP
..
.\"	# CS - begin code excerpt
.de CS
.RS
.nf
.ta .25i .5i .75i 1i
..
.\"	# CE - end code excerpt
.de CE
.fi
.RE
..
.\"	# UL - underline word
.de UL
\\$1\l'|0\(ul'\\$2
..
.\"	# QW - apply quotation marks to word
.de QW
.ie '\\*(lq'"' ``\\$1''\\$2
.\"" fix emacs highlighting
.el \\*(lq\\$1\\*(rq\\$2
..
.\"	# PQ - apply parens and quotation marks to word
.de PQ
.ie '\\*(lq'"' (``\\$1''\\$2)\\$3
.\"" fix emacs highlighting
.el (\\*(lq\\$1\\*(rq\\$2)\\$3
..
.\"	# QR - quoted range
.de QR
.ie '\\*(lq'"' ``\\$1''\\-``\\$2''\\$3
.\"" fix emacs highlighting
.el \\*(lq\\$1\\*(rq\\-\\*(lq\\$2\\*(rq\\$3
..
.\"	# MT - "empty" string
.de MT
.QW ""
..
.BS
.SH NAME
mkdoc \- Source code documentation extractor/converter application
.SH SYNOPSIS
\fBmkdoc\fR \fB--help\fR
.sp
\fBmkdoc\fR \fB--version\fR
.sp
\fBmkdoc\fR \fB--license\fR
.sp
\fBmkdoc\fR \fIinput\fR \fIoutput\fR ?\fB--css\fR \fIcssfile\fR?
.sp
.BE
.SH DESCRIPTION
This document describes \fBmkdoc\fR, an application to extract documentation embedded in
source code files, be they "\fI\&.tcl\fR", or other\&.
.SH "COMMAND LINE"
.TP
\fBmkdoc\fR \fB--help\fR
The application prints a short help to standard output and exits\&.
.TP
\fBmkdoc\fR \fB--version\fR
The application prints its version number to standard output and exits\&.
.TP
\fBmkdoc\fR \fB--license\fR
The application prints its license to standard output and exits\&.
.TP
\fBmkdoc\fR \fIinput\fR \fIoutput\fR ?\fB--css\fR \fIcssfile\fR?
The application reads the \fIinput\fR file, extracts the embedded documentation, and
writes it to the \fIoutput\fR file\&.
.sp
If the output file is not a "\fI\&.md\fR" file the extracted documentation is
converted to HTML before being written\&.
.sp
When generating and writing HTML the default CSS stylesheet can be overridden by
specifying the path to a custom stylesheet via option \fB--css\fR\&.
.sp
If the input file is a "\fI\&.md\fR" file it is expected to contain Markdown as-is,
instead of Markdown embedded into code\&.
.sp
On the other side, when the file is considered code then the documentation is
expected to be contained in all lines starting with the marker \fB#'\fR\&.
For script languages like Tcl the \fB#\fR character of this marker means that the
documentation is contained in the so-flagged comments\&.
For other languages the marker and documentation may have to be embedded into multi-line
comments\&.
.PP
.SH EXAMPLES
.CS


    # Create HTML manual for a CPP file using a custom style sheet
    mkdoc sample\&.cpp sample\&.html --css manual\&.css

    # Extract the documentation from code as simple Markdown, ready to be processed
    # further, for example with pandoc, or similar
    mkdoc sample\&.cpp sample\&.md

    # Convert a Markdown file to HTML
    mkdoc sample\&.md sample\&.html

.CE
.SH "BUGS, IDEAS, FEEDBACK"
This document, and the package it describes, will undoubtedly contain bugs and
other problems\&. Please report such to the author of this package\&. Please also report any ideas for enhancements you may have for
either package and/or documentation\&.
.SH "CODE COPYRIGHT"
BSD License type:
.PP
The following terms apply to all files a ssociated with the software unless
explicitly disclaimed in individual files\&.
.PP
The authors hereby grant permission to use, copy, modify, distribute, and license
this software and its documentation for any purpose, provided that existing copyright
notices are retained in all copies and that this notice is included verbatim in any
distributions\&. No written agreement, license, or royalty fee is required for any of the
authorized uses\&.  Modifications to this software may be copyrighted by their authors and
need not follow the licensing terms described here, provided that the new terms are
clearly indicated on the first page of each file where they apply\&.
.PP
In no event shall the authors or distributors be liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use of this
software, its documentation, or any derivatives thereof, even if the authors have been
advised of the possibility of such damage\&.
.PP
The authors and distributors specifically disclaim any warranties, including, but
not limited to, the implied warranties of merchantability, fitness for a particular
purpose, and non-infringement\&.
This software is provided on an "as is" basis, and the authors and distributors have no
obligation to provide maintenance, support, updates, enhancements, or modifications\&.
.PP
\fIRESTRICTED RIGHTS\fR: Use, duplication or disclosure by the government is
subject to the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in
Technical Data and Computer Software Clause as DFARS 252\&.227-7013 and FAR 52\&.227-19\&.
.SH CATEGORY
Text processing
.SH COPYRIGHT
.nf
Copyright (c) 2019-2022, Detlef Groth <detlef(at)dgroth(dot)de>

.fi






Changes to idoc/man/files/modules/dtplite/pkg_dtplite.n.





1
2
3
4
5

6
7
8
9
10
11
12

1
2
3
4

5
6
7
8
9
10
11
12





-
+








'\"
'\" Generated from file 'pkg_dtplite\&.man' by tcllib/doctools with format 'nroff'
'\" Copyright (c) 2004-2013 Andreas Kupries <andreas_kupries@users\&.sourceforge\&.net>
'\"
.TH "dtplite" n 1\&.3\&.1 tcllib "Documentation toolbox"
.TH "pkg_dtplite" n 1\&.3\&.1 tcllib "Documentation toolbox"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,




︙


268
269
270
271
272
273
274
275

276
277
278
279

280
281

282
283
284
285
286
287
288
289
290

291
292
293
294
295
296

297
298
299
300
301
302
303
304
305
306
307
308
309
310

311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329

330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377

378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442

443
444
445
446
447
448
449
450
451
452
453
454
455
456

457
458
459
460
461
462
463
464
465
466
467
468
469

470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554


555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600

601
602
603
604
605
606
607


608
609
610
611
612
613
614
615
616
617

268
269
270
271
272
273
274

275
276
277
278

279
280

281




282
283
284
285

286






287














288



















289
290















































291

































































292
293













294



295









296





















































































297
298











































299


300



301



302
303



304
305
306
307
308
309
310








-
+



-
+

-
+
-
-
-
-




-
+
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+

-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-

-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-
-
+
-
-
-

-
-
-
+
+
-
-
-








..
.\"	# MT - "empty" string
.de MT
.QW ""
..
.BS
.SH NAME
dtplite \- Lightweight DocTools Markup Processor
pkg_dtplite \- Lightweight DocTools Markup Processor
.SH SYNOPSIS
package require \fBdtplite  ?1\&.3\&.1?\fR
.sp
\fBdtplite\fR \fB-o\fR \fIoutput\fR ?options? \fIformat\fR \fIinputfile\fR
\fBdtplite::print-via\fR \fIcmd\fR
.sp
\fBdtplite\fR \fBvalidate\fR \fIinputfile\fR
\fBdtplite::do\fR \fIarguments\fR
.sp
\fBdtplite\fR \fB-o\fR \fIoutput\fR ?options? \fIformat\fR \fIinputdirectory\fR
.sp
\fBdtplite\fR \fB-merge\fR \fB-o\fR \fIoutput\fR ?options? \fIformat\fR \fIinputdirectory\fR
.sp
.BE
.SH DESCRIPTION
.PP
The application described by this document, \fBdtplite\fR, is the
The package provided by this document, \fBdtplite\fR, is the foundation for the
successor to the extremely simple \fBmpexpand\fR\&. Influenced in its
functionality by the \fBdtp\fR doctools processor it is much more
powerful than \fBmpexpand\fR, yet still as easy to use; definitely
easier than \fBdtp\fR with its myriad of subcommands and options\&.
.PP
\fBdtplite\fR is based upon the package \fBdoctools\fR, like
\fBdtplite\fR application\&. It is a light wrapper around the various \fBdoctools\fR
the other two processors\&.
.SS "USE CASES"
\fBdtplite\fR was written with the following three use cases in
mind\&.
.PP
.IP [1]
Validation of a single document, i\&.e\&. checking that it was written in
valid doctools format\&. This mode can also be used to get a preliminary
version of the formatted output for a single document, for display in
a browser, nroff, etc\&., allowing proofreading of the formatting\&.
.IP [2]
Generation of the formatted documentation for a single package,
i\&.e\&. all the manpages, plus a table of contents and an index of
keywords\&.
packages\&.
.IP [3]
An extension of the previous mode of operation, a method for the easy
generation of one documentation tree for several packages, and
especially of a unified table of contents and keyword index\&.
.PP
.PP
Beyond the above we also want to make use of the customization
features provided by the HTML formatter\&. It is not the only format the
application should be able to generate, but we anticipiate it to be
the most commonly used, and it is one of the few which do provide
customization hooks\&.
.PP
We allow the caller to specify a header string, footer string, a
stylesheet, and data for a bar of navigation links at the top of the
generated document\&.
While all can be set as long as the formatting engine provides an
appropriate engine parameter (See section \fBOPTIONS\fR) the last
two have internal processing which make them specific to HTML\&.
.SS "COMMAND LINE"
.SH COMMANDS
.TP
\fBdtplite\fR \fB-o\fR \fIoutput\fR ?options? \fIformat\fR \fIinputfile\fR
This is the form for use case [1]\&. The \fIoptions\fR will be
explained later, in section \fBOPTIONS\fR\&.
.RS
.TP
path \fIoutput\fR (in)
This argument specifies where to write the generated document\&. It can
be the path to a file or directory, or \fB-\fR\&.
The last value causes the application to write the generated
documented to \fBstdout\fR\&.
.sp
If the \fIoutput\fR does not exist then [file dirname $output]
has to exist and must be a writable directory\&.
The generated document will be written to a file in that directory,
and the name of that file will be derived from the \fIinputfile\fR,
the \fIformat\fR, and the value given to option \fB-ext\fR (if
present)\&.
.TP
(path|handle) \fIformat\fR (in)
This argument specifies the formatting engine to use when processing
the input, and thus the format of the generated document\&. See section
\fBFORMATS\fR for the possibilities recognized by the application\&.
.TP
path \fIinputfile\fR (in)
This argument specifies the path to the file to process\&. It has to
exist, must be readable, and written in \fIdoctools\fR format\&.
.RE
.sp
.TP
\fBdtplite\fR \fBvalidate\fR \fIinputfile\fR
This is a simpler form for use case [1]\&. The "validate" format
generates no output at all, only syntax checks are performed\&. As such
the specification of an output file or other options is not necessary
and left out\&.
.TP
\fBdtplite\fR \fB-o\fR \fIoutput\fR ?options? \fIformat\fR \fIinputdirectory\fR
This is the form for use case [2]\&. It differs from the form for
use case [1] by having the input documents specified through a
directory instead of a file\&. The other arguments are identical, except
for \fIoutput\fR, which now has to be the path to an existing and
writable directory\&.
.sp
The input documents are all files in \fIinputdirectory\fR or any of
its subdirectories which were recognized by \fBfileutil::fileType\fR
as containing text in \fIdoctools\fR format\&.
.TP
\fBdtplite\fR \fB-merge\fR \fB-o\fR \fIoutput\fR ?options? \fIformat\fR \fIinputdirectory\fR
\fBdtplite::print-via\fR \fIcmd\fR
This is the form for use case [3]\&. The only difference to the
form for use case [2] is the additional option \fB-merge\fR\&.
.sp
Each such call will merge the generated documents coming from
processing the input documents under \fIinputdirectory\fR or any of
its subdirectories to the files under \fIoutput\fR\&. In this manner it
is possible to incrementally build the unified documentation for any
number of packages\&. Note that it is necessary to run through all the
packages twice to get fully correct cross-references (for formats
supporting them)\&.
.PP
.SS OPTIONS
This section describes all the options available to the user of the
application, with
the exception of the options \fB-o\fR and \fB-merge\fR\&. These
two were described already, in section \fBCOMMAND LINE\fR\&.
.PP
.TP
\fB-exclude\fR string
This option specifies an exclude (glob) pattern\&. Any files identified
as manpages to process which match the exclude pattern are
ignored\&. The option can be provided multiple times, each usage adding
an additional pattern to the list of exclusions\&.
.TP
\fB-ext\fR string
If the name of an output file has to be derived from the name of an
input file it will use the name of the \fIformat\fR as the extension
by default\&. This option here will override this however, forcing it to
use \fIstring\fR as the file extension\&. This option is ignored if the
name of the output file is fully specified through option \fB-o\fR\&.
.sp
When used multiple times only the last definition is relevant\&.
.TP
\fB-header\fR file
This option can be used if and only if the selected \fIformat\fR
provides an engine parameter named "header"\&. It takes the contents of
the specified file and assign them to that parameter, for whatever use
by the engine\&. The HTML engine will insert the text just after the tag
\fB<body>\fR\&.
If navigation buttons are present (see option \fB-nav\fR below),
then the HTML generated for them is appended to the header data
originating here before the final assignment to the parameter\&.
.sp
When used multiple times only the last definition is relevant\&.
.TP
\fB-footer\fR file
Like \fB-header\fR, except that: Any navigation buttons are ignored,
the corresponding required engine parameter is named "footer", and the
data is inserted just before the tag \fB</body>\fR\&.
.sp
When used multiple times only the last definition is relevant\&.
.TP
\fB-style\fR file
This option can be used if and only if the selected \fIformat\fR
provides an engine parameter named "meta"\&. When specified it will
generate a piece of HTML code declaring the \fIfile\fR as the
stylesheet for the generated document and assign that to the
parameter\&. The HTML engine will insert this inot the document, just
after the tag \fB<head>\fR\&.
.sp
When processing an input directory the stylesheet file is copied into
the output directory and the generated HTML will refer to the copy, to
make the result more self-contained\&. When processing an input file we
have no location to copy the stylesheet to and so just reference it as
specified\&.
Redirect print operations of the package to the specified \fIcmd\fR\&.
.sp
When used multiple times only the last definition is relevant\&.
.TP
\fB-toc\fR path|text
This option specifies a doctoc file (or text) to use for the table of contents
instead of generating our own\&.
.sp
When used multiple times only the last definition is relevant\&.
.TP
\fB-pre+toc\fR label path|text
.TP
\fB-post+toc\fR label path|text
This option specifies additional doctoc files (or texts) to use in
the navigation bar\&.
The result of the command is the empty string\&.
.sp
Positioning and handling of multiple uses is like for options
\fB-prenav\fR and \fB-postnav\fR, see below\&.
.TP
\fB-nav\fR label url
.TP
\fB-prenav\fR label url
Use this option to specify a navigation button with \fIlabel\fR to
display and the \fIurl\fR to link to\&. This option can be used if and
only if the selected \fIformat\fR provides an engine parameter named
"header"\&. The HTML generated for this is appended to whatever data we
got from option \fB-header\fR before it is inserted into the
generated documents\&.
\fBdtplite::do\fR \fIarguments\fR
.sp
When used multiple times all definitions are collected and a
navigation bar is created, with the first definition shown at the left
edge and the last definition to the right\&.
.sp
The url can be relative\&. In that case it is assumed to be relative
to the main files (TOC and Keyword index), and will be transformed for
all others to still link properly\&.
.TP
\fB-postnav\fR label url
Use this option to specify a navigation button with \fIlabel\fR to
display and the \fIurl\fR to link to\&. This option can be used if and
only if the selected \fIformat\fR provides an engine parameter named
"header"\&. The HTML generated for this is appended to whatever data we
got from option \fB-header\fR before it is inserted into the
generated documents\&.
.sp
When used multiple times all definitions are collected and a
navigation bar is created, with the last definition shown at the right
edge and the first definition to the left\&.
.sp
The url can be relative\&. In that case it is assumed to be relative
to the main files (TOC and Keyword index), and will be transformed for
all others to still link properly\&.
.PP
.SS FORMATS
At first the \fIformat\fR argument will be treated as a path to a tcl
file containing the code for the requested formatting engine\&. The
argument will be treated as the name of one of the predefined formats
listed below if and only if the path does not exist\&.
.PP
\fINote a limitation\fR: If treating the format as path to the tcl
script implementing the engine was sucessful, then this script has to
implement not only the engine API for doctools, i\&.e\&.
\fIdoctools_api\fR, but for \fIdoctoc_api\fR and \fIdocidx_api\fR
as well\&. Otherwise the generation of a table of contents and of a
keyword index will fail\&.
.PP
List of predefined formats, i\&.e\&. as provided by the
package \fBdoctools\fR:
.PP
.TP
\fBnroff\fR
The processor generates *roff output, the standard format for unix
manpages\&.
.TP
\fBhtml\fR
The processor generates HTML output, for usage in and display by web
browsers\&. This engine is currently the only one providing the various
engine parameters required for the additional customaization of the
output\&.
.TP
\fBtmml\fR
The processor generates TMML output, the Tcl Manpage Markup Language,
a derivative of XML\&.
.TP
\fBlatex\fR
The processor generates LaTeX output\&.
.TP
\fBwiki\fR
The processor generates Wiki markup as understood by \fBwikit\fR\&.
.TP
\fBlist\fR
The processor extracts the information provided by \fBmanpage_begin\fR\&.
This format is used internally to extract the meta data from which
both table of contents and keyword index are derived from\&.
.TP
\fBnull\fR
The processor does not generate any output\&. This is equivalent to
\fBvalidate\fR\&.
.PP
.SS "DIRECTORY STRUCTURES"
In this section we describe the directory structures generated by the
application under \fIoutput\fR when processing all documents in an
\fIinputdirectory\fR\&. In other words, this is only relevant to the use
cases [2] and [3]\&.
.TP
[2]
The following directory structure is created when processing a single
set of input documents\&.  The file extension used is for output in
HTML, but that is not relevant to the structure and was just used to
have proper file names\&.
.CS


The main command it takes a \fIsingle list\fR of \fIarguments\fR, processes them, and
performs the specified action\&.
    output/
        toc\&.html
        index\&.html
        files/
            path/to/FOO\&.html

.CE
.IP
The last line in the example shows the document
generated for a file FOO located at
.CS


    inputdirectory/path/to/FOO

.CE
.TP
[3]
When merging many packages into a unified set of documents the
generated directory structure is a bit deeper:
.CS


    output
        \&.toc
        \&.idx
        \&.tocdoc
        \&.idxdoc
        \&.xrf
        toc\&.html
        index\&.html
        FOO1/
            \&.\&.\&.
        FOO2/
            toc\&.html
            files/
                path/to/BAR\&.html

.CE
.IP
Each of the directories FOO1, \&.\&.\&. contains the documents generated for
the package FOO1, \&.\&.\&. and follows the structure shown for use case
[2]\&. The only exception is that there is no per-package index\&.
.sp
The files "\fI\&.toc\fR", "\fI\&.idx\fR", and "\fI\&.xrf\fR" contain the
internal status of the whole output and will be read and updated by
The result of the command is the empty string\&.
the next invokation\&. Their contents will not be documented\&. Remove
these files when all packages wanted for the output have been
processed, i\&.e\&. when the output is complete\&.
.sp
The files "\fI\&.tocdoc\fR", and "\fI\&.idxdoc\fR", are intermediate files
in doctoc and docidx markup, respectively, containing the main table
of contents and keyword index for the set of documents before their
The details of the syntax inside of the \fIarguments\fR list are explained in
section \fICOMMAND LINE\fR of the documentation for the \fBdtplite\fR application\&.
conversion to the chosen output format\&.
They are left in place, i\&.e\&. not deleted, to serve as demonstrations
of doctoc and docidx markup\&.
.PP
.SH "BUGS, IDEAS, FEEDBACK"
This document, and the package it describes, will undoubtedly contain
bugs and other problems\&.
Please report such in the category \fIdoctools\fR of the
\fITcllib Trackers\fR [http://core\&.tcl\&.tk/tcllib/reportlist]\&.
Please also report any ideas for enhancements you may have for either




︙





Changes to idoc/man/files/modules/irc/picoirc.n.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+








'\"
'\" Generated from file 'picoirc\&.man' by tcllib/doctools with format 'nroff'
'\"
.TH "picoirc" n 0\&.11\&.0 tcllib "Simple embeddable IRC interface"
.TH "picoirc" n 0\&.13\&.0 tcllib "Simple embeddable IRC interface"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,




︙


271
272
273
274
275
276
277
278

279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294

271
272
273
274
275
276
277

278
279
280
281
282
283




284
285
286
287
288
289
290








-
+





-
-
-
-








..
.BS
.SH NAME
picoirc \- Small and simple embeddable IRC client\&.
.SH SYNOPSIS
package require \fBTcl  8\&.6\fR
.sp
package require \fBpicoirc  ?0\&.11\&.0?\fR
package require \fBpicoirc  ?0\&.13\&.0?\fR
.sp
\fB::picoirc::connect\fR \fIcallback\fR \fInick\fR ?\fIpassword\fR? \fIurl\fR
.sp
\fB::picoirc::post\fR \fIcontext\fR \fIchannel\fR \fImessage\fR
.sp
\fB::picoirc::splituri\fR \fIuri\fR
.sp
\fB::picoirc::send\fR \fIcontext\fR \fIline\fR
.sp
.BE
.SH DESCRIPTION
This package provides a general purpose minimal IRC client suitable for
embedding in other applications\&. All communication with the parent
application is done via an application provided callback procedure\&.
Each connection has its own state so you can hook up multiple servers
in a single application instance\&.




︙


329
330
331
332
333
334
335

336
337
338



339
340
341
342
343
344
345
346
347
348
349
350
351
352
353






354
355
356
357
358
359
360
361

325
326
327
328
329
330
331
332



333
334
335















336
337
338
339
340
341

342
343
344
345
346
347
348








+
-
-
-
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
-








    }
}

.CE
.TP
\fB::picoirc::post\fR \fIcontext\fR \fIchannel\fR \fImessage\fR
This should be called to process user input and send it to the
server\&. If \fImessage\fR is multiline then each line will be processed
server\&. A number of commands are recognised when prefixed with a
forward-slash (/)\&. Such commands are converted to IRC command
sequences and then sent\&.
and sent individually\&. A number of commands are recognised when
prefixed with a forward-slash (/)\&. Such commands are converted to
IRC command sequences and then sent\&. If \fIchannel\fR is empty then
.TP
\fB::picoirc::splituri\fR \fIuri\fR
Splits an IRC scheme uniform resource indicator into its component
parts\&. Returns a list of server, port, channels and secure where
secure is a boolean flag which is \fBtrue\fR if a TLS connection was
requested via the \fIircs://\fR schema\&. The default port is 6667 (or
6697 if secured) and there are no default channels\&.
.TP
\fB::picoirc::send\fR \fIcontext\fR \fIline\fR
This command is where all raw output to the server is handled\&. The
default action is to write the \fIline\fR to the irc socket\&. However,
before this happens the callback is called with "debug write"\&. This
permits the application author to inspect the raw IRC data and if
desired to return a break error code to halt further processing\&. In
this way the application can override the default send via the
all raw output to the server is handled\&. The default action is to
write the \fImessage\fR to the irc socket\&. However, before this
happens the callback is called with "debug write"\&. This permits the
application author to inspect the raw IRC data and if desired to
return a break error code to halt further processing\&. In this way the
application can override the default send via the callback procedure\&.
callback procedure\&.
.PP
.SH CALLBACK
The callback must look like:
.CS


proc Callback {context state args} {




︙


394
395
396
397
398
399
400
401

402
403
404
405
406
407
408

381
382
383
384
385
386
387

388
389
390
391
392
393
394
395








-
+








called when a message arrives\&. \fItarget\fR is the identity that the
message was targetted for\&. This can be the logged in nick or a channel
name\&. \fInick\fR is the name of the sender of the message\&.
\fImessage\fR is the message text\&. \fItype\fR is set to "ACTION" if the
message was sent as a CTCP ACTION\&. \fItype\fR is set to "NOTICE" if the
message was sent as a NOTICE command, in that case \fItarget\fR is empty
if it matches current user nick or it's "*", in later case empty
\fInick\fR means that notice comes from server\&.
\fItarget\fR means that notice comes from server\&.
.TP
\fBmode\fR \fInick\fR \fItarget\fR \fIflags\fR
called when mode of user or channel changes\&. \fInick\fR is the name
of the user who requested a change, can be empty if it's the server\&.
\fItarget\fR is the identity that has its mode changed\&. \fIflags\fR
are the changes in mode\&.
.TP




︙





Changes to idoc/man/files/modules/markdown/markdown.n.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+








'\"
'\" Generated from file 'markdown\&.man' by tcllib/doctools with format 'nroff'
'\"
.TH "markdown" n 1\&.2\&.1 tcllib "Markdown to HTML Converter"
.TH "markdown" n 1\&.2\&.2 tcllib "Markdown to HTML Converter"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,




︙


271
272
273
274
275
276
277
278

279
280
281
282
283
284
285

271
272
273
274
275
276
277

278
279
280
281
282
283
284
285








-
+








..
.BS
.SH NAME
markdown \- Converts Markdown text to HTML
.SH SYNOPSIS
package require \fBTcl  8\&.5\fR
.sp
package require \fBMarkdown  1\&.2\&.1\fR
package require \fBMarkdown  1\&.2\&.2\fR
.sp
package require \fBtextutil  ?0\&.8?\fR
.sp
\fB::Markdown::convert\fR \fImarkdown\fR
.sp
\fB::Markdown::register\fR \fIlangspec\fR \fIconverter\fR
.sp




︙





Changes to idoc/man/files/modules/math/figurate.n.






︙


373
374
375
376
377
378
379


380
381
382
383
384
385
386

373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388








+
+








       *  *  *  *
       \&.\&.\&.

.CE
The \fBmath::figurate\fR package consists of a collection of procedures to
evaluate a wide variety of figurate numbers\&. While all formulae are
straightforward, the details are sometimes puzzling\&.
\fINote:\fR The procedures consider arguments lower than zero as to mean "no objects to be counted"
and therefore return 0\&.
.SH PROCEDURES
The procedures can be arranged in a few categories: sums of integers raised to a
particular power, sums of odd integers and general figurate numbers, for
instance the pentagonal numbers\&.
.TP
\fB::math::figurate::sum_sequence\fR \fIn\fR
Return the sum of integers 1, 2, \&.\&.\&., n\&.




︙





Added idoc/man/files/modules/mkdoc/mkdoc.n.






























































































































































































































































































































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

'\"
'\" Generated from file 'mkdoc\&.man' by tcllib/doctools with format 'nroff'
'\" Copyright (c) 2019-2022, Detlef Groth <detlef(at)dgroth(dot)de>
'\"
.TH "mkdoc" n 0\&.7\&.0 tcllib "Source code documentation using Markdown"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,
.\"	and indent is equivalent to second arg of .IP (shouldn't ever be
.\"	needed;  use .AS below instead)
.\"
.\" .AS ?type? ?name?
.\"	Give maximum sizes of arguments for setting tab stops.  Type and
.\"	name are examples of largest possible arguments that will be passed
.\"	to .AP later.  If args are omitted, default tab stops are used.
.\"
.\" .BS
.\"	Start box enclosure.  From here until next .BE, everything will be
.\"	enclosed in one large box.
.\"
.\" .BE
.\"	End of box enclosure.
.\"
.\" .CS
.\"	Begin code excerpt.
.\"
.\" .CE
.\"	End code excerpt.
.\"
.\" .VS ?version? ?br?
.\"	Begin vertical sidebar, for use in marking newly-changed parts
.\"	of man pages.  The first argument is ignored and used for recording
.\"	the version when the .VS was added, so that the sidebars can be
.\"	found and removed when they reach a certain age.  If another argument
.\"	is present, then a line break is forced before starting the sidebar.
.\"
.\" .VE
.\"	End of vertical sidebar.
.\"
.\" .DS
.\"	Begin an indented unfilled display.
.\"
.\" .DE
.\"	End of indented unfilled display.
.\"
.\" .SO ?manpage?
.\"	Start of list of standard options for a Tk widget. The manpage
.\"	argument defines where to look up the standard options; if
.\"	omitted, defaults to "options". The options follow on successive
.\"	lines, in three columns separated by tabs.
.\"
.\" .SE
.\"	End of list of standard options for a Tk widget.
.\"
.\" .OP cmdName dbName dbClass
.\"	Start of description of a specific option.  cmdName gives the
.\"	option's name as specified in the class command, dbName gives
.\"	the option's name in the option database, and dbClass gives
.\"	the option's class in the option database.
.\"
.\" .UL arg1 arg2
.\"	Print arg1 underlined, then print arg2 normally.
.\"
.\" .QW arg1 ?arg2?
.\"	Print arg1 in quotes, then arg2 normally (for trailing punctuation).
.\"
.\" .PQ arg1 ?arg2?
.\"	Print an open parenthesis, arg1 in quotes, then arg2 normally
.\"	(for trailing punctuation) and then a closing parenthesis.
.\"
.\"	# Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
.if t .wh -1.3i ^B
.nr ^l \n(.l
.ad b
.\"	# Start an argument description
.de AP
.ie !"\\$4"" .TP \\$4
.el \{\
.   ie !"\\$2"" .TP \\n()Cu
.   el          .TP 15
.\}
.ta \\n()Au \\n()Bu
.ie !"\\$3"" \{\
\&\\$1 \\fI\\$2\\fP (\\$3)
.\".b
.\}
.el \{\
.br
.ie !"\\$2"" \{\
\&\\$1	\\fI\\$2\\fP
.\}
.el \{\
\&\\fI\\$1\\fP
.\}
.\}
..
.\"	# define tabbing values for .AP
.de AS
.nr )A 10n
.if !"\\$1"" .nr )A \\w'\\$1'u+3n
.nr )B \\n()Au+15n
.\"
.if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
.nr )C \\n()Bu+\\w'(in/out)'u+2n
..
.AS Tcl_Interp Tcl_CreateInterp in/out
.\"	# BS - start boxed text
.\"	# ^y = starting y location
.\"	# ^b = 1
.de BS
.br
.mk ^y
.nr ^b 1u
.if n .nf
.if n .ti 0
.if n \l'\\n(.lu\(ul'
.if n .fi
..
.\"	# BE - end boxed text (draw box now)
.de BE
.nf
.ti 0
.mk ^t
.ie n \l'\\n(^lu\(ul'
.el \{\
.\"	Draw four-sided box normally, but don't draw top of
.\"	box if the box started on an earlier page.
.ie !\\n(^b-1 \{\
\h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
.\}
.el \}\
\h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
.\}
.\}
.fi
.br
.nr ^b 0
..
.\"	# VS - start vertical sidebar
.\"	# ^Y = starting y location
.\"	# ^v = 1 (for troff;  for nroff this doesn't matter)
.de VS
.if !"\\$2"" .br
.mk ^Y
.ie n 'mc \s12\(br\s0
.el .nr ^v 1u
..
.\"	# VE - end of vertical sidebar
.de VE
.ie n 'mc
.el \{\
.ev 2
.nf
.ti 0
.mk ^t
\h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
.sp -1
.fi
.ev
.\}
.nr ^v 0
..
.\"	# Special macro to handle page bottom:  finish off current
.\"	# box/sidebar if in box/sidebar mode, then invoked standard
.\"	# page bottom macro.
.de ^B
.ev 2
'ti 0
'nf
.mk ^t
.if \\n(^b \{\
.\"	Draw three-sided box if this is the box's first page,
.\"	draw two sides but no top otherwise.
.ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
.el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
.\}
.if \\n(^v \{\
.nr ^x \\n(^tu+1v-\\n(^Yu
\kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
.\}
.bp
'fi
.ev
.if \\n(^b \{\
.mk ^y
.nr ^b 2
.\}
.if \\n(^v \{\
.mk ^Y
.\}
..
.\"	# DS - begin display
.de DS
.RS
.nf
.sp
..
.\"	# DE - end display
.de DE
.fi
.RE
.sp
..
.\"	# SO - start of list of standard options
.de SO
'ie '\\$1'' .ds So \\fBoptions\\fR
'el .ds So \\fB\\$1\\fR
.SH "STANDARD OPTIONS"
.LP
.nf
.ta 5.5c 11c
.ft B
..
.\"	# SE - end of list of standard options
.de SE
.fi
.ft R
.LP
See the \\*(So manual entry for details on the standard options.
..
.\"	# OP - start of full description for a single option
.de OP
.LP
.nf
.ta 4c
Command-Line Name:	\\fB\\$1\\fR
Database Name:	\\fB\\$2\\fR
Database Class:	\\fB\\$3\\fR
.fi
.IP
..
.\"	# CS - begin code excerpt
.de CS
.RS
.nf
.ta .25i .5i .75i 1i
..
.\"	# CE - end code excerpt
.de CE
.fi
.RE
..
.\"	# UL - underline word
.de UL
\\$1\l'|0\(ul'\\$2
..
.\"	# QW - apply quotation marks to word
.de QW
.ie '\\*(lq'"' ``\\$1''\\$2
.\"" fix emacs highlighting
.el \\*(lq\\$1\\*(rq\\$2
..
.\"	# PQ - apply parens and quotation marks to word
.de PQ
.ie '\\*(lq'"' (``\\$1''\\$2)\\$3
.\"" fix emacs highlighting
.el (\\*(lq\\$1\\*(rq\\$2)\\$3
..
.\"	# QR - quoted range
.de QR
.ie '\\*(lq'"' ``\\$1''\\-``\\$2''\\$3
.\"" fix emacs highlighting
.el \\*(lq\\$1\\*(rq\\-\\*(lq\\$2\\*(rq\\$3
..
.\"	# MT - "empty" string
.de MT
.QW ""
..
.BS
.SH NAME
mkdoc \- Extracts and optionally converts Markdown comments in source code to HTML
.SH SYNOPSIS
package require \fBTcl  8\&.6\fR
.sp
package require \fBMarkdown  ?1\&.2\&.1?\fR
.sp
package require \fByaml  ?0\&.4\&.1?\fR
.sp
package require \fBmkdoc  ?0\&.7\&.0?\fR
.sp
package require \fBhook \fR
.sp
\fB::mkdoc::mkdoc\fR \fIinfile\fR \fIoutfile\fR ?\fB-css\fR \fIcssfile\fR?
.sp
\fB::mkdoc::run\fR \fIinfile\fR
.sp
.BE
.SH DESCRIPTION
The package \fBmkdoc\fR provides a command to extract documentation embedded in code
and optionally convert these comments into HTML\&.
The latter uses Tcllib's \fBMarkdown\fR package\&.
Each line of the embedded documentation begins with the special comment marker
\fB#'\fR\&.
.TP
\fB::mkdoc::mkdoc\fR \fIinfile\fR \fIoutfile\fR ?\fB-css\fR \fIcssfile\fR?
The command reads the specified \fIinfile\fR and extracts the code comments introduced by
the \fB #'\fR marker\&.  If the \fIoutfile\fR is either a "\fI\&.html\fR" or "\fI\&.htm\fR"
file the Markdown is converted into HTML using either a default style or the specified
style sheet \fIcssfile\fR\&.
.sp
All arguments are paths to the files to read from or write to\&.
.sp
The result of the command is the empty string\&.
.sp
See section \fBFormatting\fR for the supported Markdown syntax and extensions
to it\&.
.TP
\fB::mkdoc::run\fR \fIinfile\fR
The command reads the specified \fIinfile\fR, extracts the embedded documentation, and
then executes the contents of the first example, i\&.e\&. \fB```\fR-quoted block, found in
the \fBExample\fR section\&.
.sp
Here is such an example which will be executed by the Tcl interpreter
.CS


    #' ## <a name="example">Example</a>
    #'
    #' ```
    #' puts "Hello mkdoc package"
    #' puts "I am in the example section"
    #' ```

.CE
.sp
\fIDANGER, BEWARE\fR\&.
Failing to open the \fIinfile\fR causes the command to \fIexit\fR the entire process\&.
.sp
Use of this command in a general context is not recommended\&.
.PP
.SH EXAMPLES
The example below demonstrates the conversion of the documentation embedded into the file
"\fImkdoc\&.tcl\fR" itself:
.PP
.CS


    package require mkdoc
    # extracting the Markdown
    mkdoc::mkdoc mkdoc\&.tcl mkdoc\&.md
    # converting Markdown to HTML
    mkdoc::mkdoc mkdoc\&.md mkdoc\&.html
    # direct conversion without intermediate file
    mkdoc::mkdoc mkdoc\&.tcl mkdoc\&.html

.CE
.SH FORMATTING
The package supports the syntax supported by Tcllib's \fBMarkdown\fR package\&.
.PP
It further supports a set of simple YAML headers whose information is inserted into
appropriate HTML \fBmeta\fR-tags\&. The supported keys are
.TP
\fBauthor\fR
Set the document author\&. Defaults to \fBNN\fR\&.
.TP
\fBtitle\fR
Set the document title\&. Defaults to \fBDocumentation \fR\fBfilename\fR]\&.
.TP
\fBdate\fR
Sets the document date\&. Defaults to the current day\&.
.TP
\fBcss\fR
Sets a custom CSS stylesheet\&. Defaults to the internal mkdoc sheet\&.
.PP
.PP
\fINote\fR that in Markdown output mode these headers are simply passed through
into the result\&. This is proper, as processors like \fBpandoc\fR are able to use them
as well\&.
.PP
See the example below for the syntax:
.CS


    #' ---
    #' title: mkdoc::mkdoc 0\&.7\&.0
    #' author: Detlef Groth, Schwielowsee, Germany
    #' date: 2022-04-17
    #' css: mini\&.css
    #' ---
    #'

.CE
.PP
Another extension over standard Markdown is the support of a single level of includes\&.
.PP
See the example below for the syntax:
.CS


    #' #include "path/to/include/file"

.CE
.PP
\fINote\fR, the double-quotes around the path are part of the syntax\&.
.PP
\fIBeware\fR further that relative paths are resolved relative to the current
working directory, and \fInot\fR relative to the location of the including file\&.
.SH "BUGS, IDEAS, FEEDBACK"
This document, and the package it describes, will undoubtedly contain bugs and other
problems\&. Please report such to the author of this package\&. Please also report any ideas
for enhancements you may have for either package and/or documentation\&.
.SH "CODE COPYRIGHT"
BSD License type:
.PP
The following terms apply to all files a ssociated with the software unless
explicitly disclaimed in individual files\&.
.PP
The authors hereby grant permission to use, copy, modify, distribute, and license
this software and its documentation for any purpose, provided that existing copyright
notices are retained in all copies and that this notice is included verbatim in any
distributions\&. No written agreement, license, or royalty fee is required for any of the
authorized uses\&.  Modifications to this software may be copyrighted by their authors and
need not follow the licensing terms described here, provided that the new terms are
clearly indicated on the first page of each file where they apply\&.
.PP
In no event shall the authors or distributors be liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use of this
software, its documentation, or any derivatives thereof, even if the authors have been
advised of the possibility of such damage\&.
.PP
The authors and distributors specifically disclaim any warranties, including, but
not limited to, the implied warranties of merchantability, fitness for a particular
purpose, and non-infringement\&.
This software is provided on an "as is" basis, and the authors and distributors have no
obligation to provide maintenance, support, updates, enhancements, or modifications\&.
.PP
\fIRESTRICTED RIGHTS\fR: Use, duplication or disclosure by the government is
subject to the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in
Technical Data and Computer Software Clause as DFARS 252\&.227-7013 and FAR 52\&.227-19\&.
.SH CATEGORY
Text processing
.SH COPYRIGHT
.nf
Copyright (c) 2019-2022, Detlef Groth <detlef(at)dgroth(dot)de>

.fi






Changes to idoc/man/files/modules/rest/rest.n.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+








'\"
'\" Generated from file 'rest\&.man' by tcllib/doctools with format 'nroff'
'\"
.TH "rest" n 1\&.4 tcllib "A framework for RESTful web services"
.TH "rest" n 1\&.5 tcllib "A framework for RESTful web services"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,




︙


271
272
273
274
275
276
277
278

279
280
281
282
283
284
285

271
272
273
274
275
276
277

278
279
280
281
282
283
284
285








-
+








..
.BS
.SH NAME
rest \- define REST web APIs and call them inline or asychronously
.SH SYNOPSIS
package require \fBTcl  8\&.5\fR
.sp
package require \fBrest  ?1\&.4?\fR
package require \fBrest  ?1\&.5?\fR
.sp
\fB::rest::simple\fR \fIurl\fR \fIquery\fR ?\fIconfig\fR? ?\fIbody\fR?
.sp
\fB::rest::get\fR \fIurl\fR \fIquery\fR ?\fIconfig\fR? ?\fIbody\fR?
.sp
\fB::rest::post\fR \fIurl\fR \fIquery\fR ?\fIconfig\fR? ?\fIbody\fR?
.sp




︙


581
582
583
584
585
586
587




588
589
590
591
592
593
594

581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598








+
+
+
+








.TP
\fBbasic\fR
The user may configure the \fIbasic authentication\fR by overriding
the procedure \fBbasic_auth\fR in the namespace of interface\&. This
procedure takes two arguments, the username and password, in this
order\&.
.TP
\fBbearer\fR
The user may configure a bearer token as authentication\&. The value is
the token passed to the HTTP authorization header\&.
.TP
\fBsign\fR
The value must actually be a list with the second element the name of
a procedure which will be called to perform request signing\&.
.RE
.TP
\fBcallback\fR
If this option is present then the method will be created as an




︙





Changes to idoc/man/files/modules/struct/struct_list.n.





1
2
3
4
5
6

7
8
9
10
11
12
13

1
2
3
4
5

6
7
8
9
10
11
12
13






-
+








'\"
'\" Generated from file 'struct_list\&.man' by tcllib/doctools with format 'nroff'
'\" Copyright (c) 2003-2005 by Kevin B\&. Kenny\&. All rights reserved
'\" Copyright (c) 2003-2012 Andreas Kupries <andreas_kupries@users\&.sourceforge\&.net>
'\"
.TH "struct::list" n 1\&.8\&.4 tcllib "Tcl Data Structures"
.TH "struct::list" n 1\&.8\&.5 tcllib "Tcl Data Structures"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,




︙


273
274
275
276
277
278
279
280

281
282
283
284
285
286
287

273
274
275
276
277
278
279

280
281
282
283
284
285
286
287








-
+








..
.BS
.SH NAME
struct::list \- Procedures for manipulating lists
.SH SYNOPSIS
package require \fBTcl  8\&.4\fR
.sp
package require \fBstruct::list  ?1\&.8\&.4?\fR
package require \fBstruct::list  ?1\&.8\&.5?\fR
.sp
\fB::struct::list\fR \fBlongestCommonSubsequence\fR \fIsequence1\fR \fIsequence2\fR ?\fImaxOccurs\fR?
.sp
\fB::struct::list\fR \fBlongestCommonSubsequence2\fR \fIsequence1 sequence2\fR ?\fImaxOccurs\fR?
.sp
\fB::struct::list\fR \fBlcsInvert\fR \fIlcsData\fR \fIlen1\fR \fIlen2\fR
.sp




︙





Changes to idoc/man/files/modules/tar/tar.n.






︙


290
291
292
293
294
295
296
297
298
299



300



























301
302
303
304
305
306
307

290
291
292
293
294
295
296



297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334








-
-
-
+
+
+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+








\fB::tar::add\fR \fItarball\fR \fIfiles\fR \fIargs\fR
.sp
\fB::tar::remove\fR \fItarball\fR \fIfiles\fR
.sp
.BE
.SH DESCRIPTION
.PP
Note: Starting with version 0\&.8 the tar reader commands
(contents, stats, get, untar) support the GNU LongName extension
(header type 'L') for large paths\&.
\fINote\fR: Starting with version 0\&.8 the tar reader commands
(contents, stats, get, untar) support the GNU LongName extension (header type
\'L') for large paths\&.
.PP
.SH BEWARE
For all commands, when using \fB-chan\fR \&.\&.\&.
.IP [1]
It is assumed that the channel was opened for reading, and configured for
binary input\&.
.IP [2]
It is assumed that the channel position is at the beginning of a legal
tar file\&.
.IP [3]
The commands will \fImodify\fR the channel position as they perform their
task\&.
.IP [4]
The commands will \fInot\fR close the channel\&.
.IP [5]
In other words, the commands leave the channel in a state very likely
unsuitable for use by further \fBtar\fR commands\&. Still doing so will
very likely results in errors, bad data, etc\&. pp\&.
.IP [6]
It is the responsibility of the user to seek the channel back to a
suitable position\&.
.IP [7]
When using a channel transformation which is not generally seekable, for
example \fBgunzip\fR, then it is the responsibility of the user to (a)
unstack the transformation before seeking the channel back to a suitable
position, and (b) for restacking it after\&.
.PP
.SH COMMANDS
.TP
\fB::tar::contents\fR \fItarball\fR ?\fB-chan\fR?
Returns a list of the files contained in \fItarball\fR\&. The order is not sorted and depends on the order
files were stored in the archive\&.
.sp
If the option \fB-chan\fR is present \fItarball\fR is interpreted as an open channel\&.
It is assumed that the channel was opened for reading, and configured for binary input\&.




︙





Changes to idoc/man/files/modules/websocket/websocket.n.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+








'\"
'\" Generated from file 'websocket\&.man' by tcllib/doctools with format 'nroff'
'\"
.TH "websocket" n 1\&.3\&.1 tcllib "websocket client and server"
.TH "websocket" n 1\&.4\&.2 tcllib "websocket client and server"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,




︙


279
280
281
282
283
284
285
286

287
288
289
290
291
292
293

279
280
281
282
283
284
285

286
287
288
289
290
291
292
293








-
+








.sp
package require \fBlogger \fR
.sp
package require \fBsha1 \fR
.sp
package require \fBbase64 \fR
.sp
package require \fBwebsocket  ?1\&.3\&.1?\fR
package require \fBwebsocket  ?1\&.4\&.2?\fR
.sp
\fB::websocket::open\fR \fIurl\fR \fIhandler\fR ?\fIoptions\fR?
.sp
\fB::websocket::send\fR \fIsock\fR \fItype\fR ?\fImsg\fR? ?\fIfinal\fR?
.sp
\fB::websocket::server\fR \fIsock\fR
.sp




︙





Changes to idoc/man/index.n.






︙


772
773
774
775
776
777
778
779
780


781
782
783


784
785
786
787
788
789
790

772
773
774
775
776
777
778


779
780
781


782
783
784
785
786
787
788
789
790








-
-
+
+

-
-
+
+








.TP
\fBfiles/modules/doctools2toc/toc_export_html\&.n\fR
doctools::toc::export::html
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
.TP
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
pkg_dtplite
.RE
IBAN
.RS
.TP
\fBfiles/modules/valtype/iban\&.n\fR
valtype::iban
.RE




︙


1432
1433
1434
1435
1436
1437
1438
1439
1440


1441
1442
1443


1444
1445
1446
1447
1448
1449
1450

1432
1433
1434
1435
1436
1437
1438


1439
1440
1441


1442
1443
1444
1445
1446
1447
1448
1449
1450








-
-
+
+

-
-
+
+








.TP
\fBfiles/modules/doctools2toc/toc_container\&.n\fR
doctools::toc
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
.TP
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
pkg_dtplite
.RE
TOOL
.RS
.TP
\fBfiles/modules/oometa/oometa\&.n\fR
oometa
.TP




︙


3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060



3061
3062
3063
3064
3065
3066
3067

3046
3047
3048
3049
3050
3051
3052



3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067








-
-
-





+
+
+








.TP
\fBfiles/modules/doctools2toc/toc_import\&.n\fR
doctools::toc::import
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/math/roman\&.n\fR
math::roman
.TP
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
pkg_dtplite
.TP
\fBfiles/modules/pt/pt_peg_from_json\&.n\fR
pt::peg::from::json
.TP
\fBfiles/modules/pt/pt_peg_from_peg\&.n\fR
pt::peg::from::peg
.TP




︙


3662
3663
3664
3665
3666
3667
3668
3669

3670
3671
3672
3673
3674
3675
3676

3662
3663
3664
3665
3666
3667
3668

3669
3670
3671
3672
3673
3674
3675
3676








-
+








\fBfiles/modules/doctools2idx/idx_msgcat_fr\&.n\fR
doctools::msgcat::idx::fr
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
pkg_dtplite
.RE
docidx commands
.RS
.TP
\fBfiles/modules/doctools/docidx_lang_cmdref\&.n\fR
docidx_lang_cmdref
.TP




︙


3779
3780
3781
3782
3783
3784
3785
3786

3787
3788
3789
3790
3791
3792
3793

3779
3780
3781
3782
3783
3784
3785

3786
3787
3788
3789
3790
3791
3792
3793








-
+








\fBfiles/modules/doctools2toc/toc_structure\&.n\fR
doctools::toc::structure
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
pkg_dtplite
.RE
doctoc commands
.RS
.TP
\fBfiles/modules/doctools/doctoc_lang_cmdref\&.n\fR
doctoc_lang_cmdref
.TP




︙


3950
3951
3952
3953
3954
3955
3956
3957

3958
3959
3960
3961
3962
3963
3964

3950
3951
3952
3953
3954
3955
3956

3957
3958
3959
3960
3961
3962
3963
3964








-
+








\fBfiles/modules/doctools2toc/toc_structure\&.n\fR
doctools::toc::structure
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
pkg_dtplite
.RE
doctools commands
.RS
.TP
\fBfiles/modules/doctools/doctools_lang_cmdref\&.n\fR
doctools_lang_cmdref
.TP




︙


6298
6299
6300
6301
6302
6303
6304
6305
6306


6307
6308
6309


6310
6311
6312
6313
6314
6315
6316

6298
6299
6300
6301
6302
6303
6304


6305
6306
6307


6308
6309
6310
6311
6312
6313
6314
6315
6316








-
-
+
+

-
-
+
+








.TP
\fBfiles/modules/doctools/doctools_plugin_apiref\&.n\fR
doctools_plugin_apiref
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
.TP
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
pkg_dtplite
.RE
map
.RS
.TP
\fBfiles/modules/generator/generator\&.n\fR
generator
.TP




︙


6433
6434
6435
6436
6437
6438
6439
6440
6441


6442
6443
6444


6445
6446
6447
6448
6449
6450
6451

6433
6434
6435
6436
6437
6438
6439


6440
6441
6442


6443
6444
6445
6446
6447
6448
6449
6450
6451








-
-
+
+

-
-
+
+








.TP
\fBfiles/modules/doctools/doctools_plugin_apiref\&.n\fR
doctools_plugin_apiref
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
.TP
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
pkg_dtplite
.TP
\fBfiles/apps/tcldocstrip\&.n\fR
tcldocstrip
.RE
matching
.RS
.TP




︙


7246
7247
7248
7249
7250
7251
7252
7253
7254


7255
7256
7257


7258
7259
7260
7261
7262
7263
7264

7246
7247
7248
7249
7250
7251
7252


7253
7254
7255


7256
7257
7258
7259
7260
7261
7262
7263
7264








-
-
+
+

-
-
+
+








.TP
\fBfiles/modules/doctools2toc/toc_export_nroff\&.n\fR
doctools::toc::export::nroff
.TP
\fBfiles/apps/dtplite\&.n\fR
dtplite
.TP
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
dtplite
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
.TP
\fBfiles/modules/doctools/mpexpand\&.n\fR
mpexpand
\fBfiles/modules/dtplite/pkg_dtplite\&.n\fR
pkg_dtplite
.RE
null
.RS
.TP
\fBfiles/modules/virtchannel_base/tcllib_null\&.n\fR
tcl::chan::null
.TP




︙





Changes to idoc/man/toc.n.






︙


599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615

599
600
601
602
603
604
605



606
607
608
609
610
611
612








-
-
-








.TP
\fBdoctools_plugin_apiref\fR
\fIfiles/modules/doctools/doctools_plugin_apiref\&.n\fR: doctools plugin API reference
.TP
\fBdtplite\fR
\fIfiles/apps/dtplite\&.n\fR: Lightweight DocTools Markup Processor
.TP
\fBdtplite\fR
\fIfiles/modules/dtplite/pkg_dtplite\&.n\fR: Lightweight DocTools Markup Processor
.TP
\fBfileutil\fR
\fIfiles/modules/fileutil/fileutil\&.n\fR: Procedures implementing some file utilities
.TP
\fBfileutil::magic::cfront\fR
\fIfiles/modules/fumagic/cfront\&.n\fR: Generator core for compiler of magic(5) files
.TP
\fBfileutil::magic::cgen\fR




︙


878
879
880
881
882
883
884






885
886
887
888
889
890
891

875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894








+
+
+
+
+
+








.TP
\fBmd5crypt\fR
\fIfiles/modules/md5crypt/md5crypt\&.n\fR: MD5-based password encryption
.TP
\fBmime\fR
\fIfiles/modules/mime/mime\&.n\fR: Manipulation of MIME body parts
.TP
\fBmkdoc\fR
\fIfiles/apps/mkdoc\&.n\fR: Source code documentation extractor/converter application
.TP
\fBmkdoc\fR
\fIfiles/modules/mkdoc/mkdoc\&.n\fR: Extracts and optionally converts Markdown comments in source code to HTML
.TP
\fBmpexpand\fR
\fIfiles/modules/doctools/mpexpand\&.n\fR: Markup processor
.TP
\fBmultiplexer\fR
\fIfiles/modules/multiplexer/multiplexer\&.n\fR: One-to-many communication with sockets\&.
.TP
\fBnameserv\fR




︙


971
972
973
974
975
976
977



978
979
980
981
982
983
984

974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990








+
+
+








.TP
\fBpage_util_quote\fR
\fIfiles/modules/page/page_util_quote\&.n\fR: page character quoting utilities
.TP
\fBpicoirc\fR
\fIfiles/modules/irc/picoirc\&.n\fR: Small and simple embeddable IRC client\&.
.TP
\fBpkg_dtplite\fR
\fIfiles/modules/dtplite/pkg_dtplite\&.n\fR: Lightweight DocTools Markup Processor
.TP
\fBpki\fR
\fIfiles/modules/pki/pki\&.n\fR: Implementation of the public key cipher
.TP
\fBpluginmgr\fR
\fIfiles/modules/pluginmgr/pluginmgr\&.n\fR: Manage a plugin
.TP
\fBpng\fR




︙





Changes to idoc/www/index.html.






︙


731
732
733
734
735
736
737
738

739
740
741
742
743
744
745

731
732
733
734
735
736
737

738
739
740
741
742
743
744
745








-
+








<td class="#doctools_idxleft" width="35%"><a name="control_structure"> control structure </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/generator/generator.html"> generator </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="conversion"> conversion </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_introduction.html"> doctools2idx_introduction </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_introduction.html"> doctools2toc_introduction </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import.html"> doctools::idx::import </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import.html"> doctools::toc::import </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/math/roman.html"> math::roman </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_from_json.html"> pt::peg::from::json </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_from_peg.html"> pt::peg::from::peg </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_container.html"> pt::peg::to::container </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_cparam.html"> pt::peg::to::cparam </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_json.html"> pt::peg::to::json </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_param.html"> pt::peg::to::param </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_peg.html"> pt::peg::to::peg </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_tclparam.html"> pt::peg::to::tclparam </a> &#183; <a href="tcllib/files/apps/tcldocstrip.html"> tcldocstrip </a> &#183; <a href="tcllib/files/modules/units/units.html"> units </a>
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_introduction.html"> doctools2idx_introduction </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_introduction.html"> doctools2toc_introduction </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import.html"> doctools::idx::import </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import.html"> doctools::toc::import </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/math/roman.html"> math::roman </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_from_json.html"> pt::peg::from::json </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_from_peg.html"> pt::peg::from::peg </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_container.html"> pt::peg::to::container </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_cparam.html"> pt::peg::to::cparam </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_json.html"> pt::peg::to::json </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_param.html"> pt::peg::to::param </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_peg.html"> pt::peg::to::peg </a> &#183; <a href="tcllib/files/modules/pt/pt_peg_to_tclparam.html"> pt::peg::to::tclparam </a> &#183; <a href="tcllib/files/apps/tcldocstrip.html"> tcldocstrip </a> &#183; <a href="tcllib/files/modules/units/units.html"> units </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="cooked"> cooked </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/term/ansi_ctrlu.html"> term::ansi::ctrl::unix </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>




︙


1099
1100
1101
1102
1103
1104
1105
1106

1107
1108
1109
1110
1111
1112
1113

1099
1100
1101
1102
1103
1104
1105

1106
1107
1108
1109
1110
1111
1112
1113








-
+








<td class="#doctools_idxleft" width="35%"><a name="do"> do </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/control/control.html"> control </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="docidx"> docidx </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/export_docidx.html"> doctools::idx::export::docidx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import.html"> doctools::idx::import </a> &#183; <a href="tcllib/files/modules/doctools2idx/import_docidx.html"> doctools::idx::import::docidx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_parse.html"> doctools::idx::parse </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_structure.html"> doctools::idx::structure </a> &#183; <a href="tcllib/files/modules/doctools2base/tcllib_msgcat.html"> doctools::msgcat </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_c.html"> doctools::msgcat::idx::c </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_de.html"> doctools::msgcat::idx::de </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_en.html"> doctools::msgcat::idx::en </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_fr.html"> doctools::msgcat::idx::fr </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a>
<a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/export_docidx.html"> doctools::idx::export::docidx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import.html"> doctools::idx::import </a> &#183; <a href="tcllib/files/modules/doctools2idx/import_docidx.html"> doctools::idx::import::docidx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_parse.html"> doctools::idx::parse </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_structure.html"> doctools::idx::structure </a> &#183; <a href="tcllib/files/modules/doctools2base/tcllib_msgcat.html"> doctools::msgcat </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_c.html"> doctools::msgcat::idx::c </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_de.html"> doctools::msgcat::idx::de </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_en.html"> doctools::msgcat::idx::en </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_fr.html"> doctools::msgcat::idx::fr </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="docidx_commands"> docidx commands </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/docidx_lang_cmdref.html"> docidx_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_faq.html"> docidx_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_intro.html"> docidx_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_syntax.html"> docidx_lang_syntax </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>




︙


1129
1130
1131
1132
1133
1134
1135
1136

1137
1138
1139
1140
1141
1142
1143

1129
1130
1131
1132
1133
1134
1135

1136
1137
1138
1139
1140
1141
1142
1143








-
+








<td class="#doctools_idxleft" width="35%"><a name="docstrip"> docstrip </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/docstrip/docstrip.html"> docstrip </a> &#183; <a href="tcllib/files/modules/docstrip/docstrip_util.html"> docstrip_util </a> &#183; <a href="tcllib/files/apps/tcldocstrip.html"> tcldocstrip </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="doctoc"> doctoc </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools2base/tcllib_msgcat.html"> doctools::msgcat </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_c.html"> doctools::msgcat::toc::c </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_de.html"> doctools::msgcat::toc::de </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_en.html"> doctools::msgcat::toc::en </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_fr.html"> doctools::msgcat::toc::fr </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/export_doctoc.html"> doctools::toc::export::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import.html"> doctools::toc::import </a> &#183; <a href="tcllib/files/modules/doctools2toc/import_doctoc.html"> doctools::toc::import::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_parse.html"> doctools::toc::parse </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_structure.html"> doctools::toc::structure </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a>
<a href="tcllib/files/modules/doctools2base/tcllib_msgcat.html"> doctools::msgcat </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_c.html"> doctools::msgcat::toc::c </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_de.html"> doctools::msgcat::toc::de </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_en.html"> doctools::msgcat::toc::en </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_fr.html"> doctools::msgcat::toc::fr </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/export_doctoc.html"> doctools::toc::export::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import.html"> doctools::toc::import </a> &#183; <a href="tcllib/files/modules/doctools2toc/import_doctoc.html"> doctools::toc::import::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_parse.html"> doctools::toc::parse </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_structure.html"> doctools::toc::structure </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="doctoc_commands"> doctoc commands </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctoc_lang_cmdref.html"> doctoc_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_faq.html"> doctoc_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_intro.html"> doctoc_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_syntax.html"> doctoc_lang_syntax </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>




︙


1154
1155
1156
1157
1158
1159
1160
1161

1162
1163
1164
1165
1166
1167
1168

1154
1155
1156
1157
1158
1159
1160

1161
1162
1163
1164
1165
1166
1167
1168








-
+








<td class="#doctools_idxleft" width="35%"><a name="doctoc_syntax"> doctoc syntax </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctoc_lang_faq.html"> doctoc_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_intro.html"> doctoc_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_syntax.html"> doctoc_lang_syntax </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="doctools"> doctools </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/docstrip/docstrip_util.html"> docstrip_util </a> &#183; <a href="tcllib/files/modules/doctools/changelog.html"> doctools::changelog </a> &#183; <a href="tcllib/files/modules/doctools2base/html_cssdefaults.html"> doctools::html::cssdefaults </a> &#183; <a href="tcllib/files/modules/doctools2idx/export_docidx.html"> doctools::idx::export::docidx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_html.html"> doctools::idx::export::html </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_json.html"> doctools::idx::export::json </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_nroff.html"> doctools::idx::export::nroff </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_text.html"> doctools::idx::export::text </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_wiki.html"> doctools::idx::export::wiki </a> &#183; <a href="tcllib/files/modules/doctools2idx/import_docidx.html"> doctools::idx::import::docidx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import_json.html"> doctools::idx::import::json </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_parse.html"> doctools::idx::parse </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_structure.html"> doctools::idx::structure </a> &#183; <a href="tcllib/files/modules/doctools2base/tcllib_msgcat.html"> doctools::msgcat </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_c.html"> doctools::msgcat::idx::c </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_de.html"> doctools::msgcat::idx::de </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_en.html"> doctools::msgcat::idx::en </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_fr.html"> doctools::msgcat::idx::fr </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_c.html"> doctools::msgcat::toc::c </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_de.html"> doctools::msgcat::toc::de </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_en.html"> doctools::msgcat::toc::en </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_fr.html"> doctools::msgcat::toc::fr </a> &#183; <a href="tcllib/files/modules/doctools2base/nroff_manmacros.html"> doctools::nroff::man_macros </a> &#183; <a href="tcllib/files/modules/doctools2base/tcl_parse.html"> doctools::tcl::parse </a> &#183; <a href="tcllib/files/modules/doctools2toc/export_doctoc.html"> doctools::toc::export::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_html.html"> doctools::toc::export::html </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_json.html"> doctools::toc::export::json </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_nroff.html"> doctools::toc::export::nroff </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_text.html"> doctools::toc::export::text </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_wiki.html"> doctools::toc::export::wiki </a> &#183; <a href="tcllib/files/modules/doctools2toc/import_doctoc.html"> doctools::toc::import::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import_json.html"> doctools::toc::import::json </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_parse.html"> doctools::toc::parse </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_structure.html"> doctools::toc::structure </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a>
<a href="tcllib/files/modules/docstrip/docstrip_util.html"> docstrip_util </a> &#183; <a href="tcllib/files/modules/doctools/changelog.html"> doctools::changelog </a> &#183; <a href="tcllib/files/modules/doctools2base/html_cssdefaults.html"> doctools::html::cssdefaults </a> &#183; <a href="tcllib/files/modules/doctools2idx/export_docidx.html"> doctools::idx::export::docidx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_html.html"> doctools::idx::export::html </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_json.html"> doctools::idx::export::json </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_nroff.html"> doctools::idx::export::nroff </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_text.html"> doctools::idx::export::text </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_wiki.html"> doctools::idx::export::wiki </a> &#183; <a href="tcllib/files/modules/doctools2idx/import_docidx.html"> doctools::idx::import::docidx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import_json.html"> doctools::idx::import::json </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_parse.html"> doctools::idx::parse </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_structure.html"> doctools::idx::structure </a> &#183; <a href="tcllib/files/modules/doctools2base/tcllib_msgcat.html"> doctools::msgcat </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_c.html"> doctools::msgcat::idx::c </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_de.html"> doctools::msgcat::idx::de </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_en.html"> doctools::msgcat::idx::en </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_msgcat_fr.html"> doctools::msgcat::idx::fr </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_c.html"> doctools::msgcat::toc::c </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_de.html"> doctools::msgcat::toc::de </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_en.html"> doctools::msgcat::toc::en </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_msgcat_fr.html"> doctools::msgcat::toc::fr </a> &#183; <a href="tcllib/files/modules/doctools2base/nroff_manmacros.html"> doctools::nroff::man_macros </a> &#183; <a href="tcllib/files/modules/doctools2base/tcl_parse.html"> doctools::tcl::parse </a> &#183; <a href="tcllib/files/modules/doctools2toc/export_doctoc.html"> doctools::toc::export::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_html.html"> doctools::toc::export::html </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_json.html"> doctools::toc::export::json </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_nroff.html"> doctools::toc::export::nroff </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_text.html"> doctools::toc::export::text </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_wiki.html"> doctools::toc::export::wiki </a> &#183; <a href="tcllib/files/modules/doctools2toc/import_doctoc.html"> doctools::toc::import::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import_json.html"> doctools::toc::import::json </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_parse.html"> doctools::toc::parse </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_structure.html"> doctools::toc::structure </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="doctools_commands"> doctools commands </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctools_lang_cmdref.html"> doctools_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_faq.html"> doctools_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_intro.html"> doctools_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_syntax.html"> doctools_lang_syntax </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>




︙


1746
1747
1748
1749
1750
1751
1752
1753

1754
1755
1756
1757
1758
1759
1760

1746
1747
1748
1749
1750
1751
1752

1753
1754
1755
1756
1757
1758
1759
1760








-
+








<td class="#doctools_idxleft" width="35%"><a name="horspool"> horspool </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/grammar_aycock/aycock.html"> grammar::aycock </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="html"> HTML </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools2base/html_cssdefaults.html"> doctools::html::cssdefaults </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_html.html"> doctools::idx::export::html </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_html.html"> doctools::toc::export::html </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a>
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools2base/html_cssdefaults.html"> doctools::html::cssdefaults </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_html.html"> doctools::idx::export::html </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_html.html"> doctools::toc::export::html </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="html"> html </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/html/html.html"> html </a> &#183; <a href="tcllib/files/modules/htmlparse/htmlparse.html"> htmlparse </a> &#183; <a href="tcllib/files/modules/javascript/javascript.html"> javascript </a> &#183; <a href="tcllib/files/modules/ncgi/ncgi.html"> ncgi </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>




︙


2271
2272
2273
2274
2275
2276
2277
2278

2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293

2294
2295
2296
2297
2298
2299
2300

2271
2272
2273
2274
2275
2276
2277

2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292

2293
2294
2295
2296
2297
2298
2299
2300








-
+














-
+








<td class="#doctools_idxleft" width="35%"><a name="man_macros"> man_macros </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools2base/nroff_manmacros.html"> doctools::nroff::man_macros </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="manpage"> manpage </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import.html"> doctools::idx::import </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import.html"> doctools::toc::import </a> &#183; <a href="tcllib/files/modules/doctools/doctools_plugin_apiref.html"> doctools_plugin_apiref </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a>
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import.html"> doctools::idx::import </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import.html"> doctools::toc::import </a> &#183; <a href="tcllib/files/modules/doctools/doctools_plugin_apiref.html"> doctools_plugin_apiref </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="map"> map </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/generator/generator.html"> generator </a> &#183; <a href="tcllib/files/modules/map/map_geocode_nominatim.html"> map::geocode::nominatim </a> &#183; <a href="tcllib/files/modules/map/map_slippy.html"> map::slippy </a> &#183; <a href="tcllib/files/modules/map/map_slippy_cache.html"> map::slippy::cache </a> &#183; <a href="tcllib/files/modules/map/map_slippy_fetcher.html"> map::slippy::fetcher </a> &#183; <a href="tcllib/files/modules/mapproj/mapproj.html"> mapproj </a> &#183; <a href="tcllib/files/modules/struct/struct_list.html"> struct::list </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="markdown"> markdown </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="markup"> markup </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/docidx_intro.html"> docidx_intro </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_cmdref.html"> docidx_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_faq.html"> docidx_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_intro.html"> docidx_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_syntax.html"> docidx_lang_syntax </a> &#183; <a href="tcllib/files/modules/doctools/docidx_plugin_apiref.html"> docidx_plugin_apiref </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_intro.html"> doctoc_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_cmdref.html"> doctoc_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_faq.html"> doctoc_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_intro.html"> doctoc_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_syntax.html"> doctoc_lang_syntax </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_plugin_apiref.html"> doctoc_plugin_apiref </a> &#183; <a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_introduction.html"> doctools2idx_introduction </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_introduction.html"> doctools2toc_introduction </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import.html"> doctools::idx::import </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import.html"> doctools::toc::import </a> &#183; <a href="tcllib/files/modules/doctools/doctools_intro.html"> doctools_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_cmdref.html"> doctools_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_faq.html"> doctools_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_intro.html"> doctools_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_syntax.html"> doctools_lang_syntax </a> &#183; <a href="tcllib/files/modules/doctools/doctools_plugin_apiref.html"> doctools_plugin_apiref </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a> &#183; <a href="tcllib/files/apps/tcldocstrip.html"> tcldocstrip </a>
<a href="tcllib/files/modules/doctools/docidx_intro.html"> docidx_intro </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_cmdref.html"> docidx_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_faq.html"> docidx_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_intro.html"> docidx_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/docidx_lang_syntax.html"> docidx_lang_syntax </a> &#183; <a href="tcllib/files/modules/doctools/docidx_plugin_apiref.html"> docidx_plugin_apiref </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_intro.html"> doctoc_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_cmdref.html"> doctoc_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_faq.html"> doctoc_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_intro.html"> doctoc_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_lang_syntax.html"> doctoc_lang_syntax </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_plugin_apiref.html"> doctoc_plugin_apiref </a> &#183; <a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_introduction.html"> doctools2idx_introduction </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_introduction.html"> doctools2toc_introduction </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_import.html"> doctools::idx::import </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import.html"> doctools::toc::import </a> &#183; <a href="tcllib/files/modules/doctools/doctools_intro.html"> doctools_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_cmdref.html"> doctools_lang_cmdref </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_faq.html"> doctools_lang_faq </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_intro.html"> doctools_lang_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctools_lang_syntax.html"> doctools_lang_syntax </a> &#183; <a href="tcllib/files/modules/doctools/doctools_plugin_apiref.html"> doctools_plugin_apiref </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a> &#183; <a href="tcllib/files/apps/tcldocstrip.html"> tcldocstrip </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="mastercard"> MasterCard </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/valtype/cc_mastercard.html"> valtype::creditcard::mastercard </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>




︙


2594
2595
2596
2597
2598
2599
2600
2601

2602
2603
2604
2605
2606
2607
2608

2594
2595
2596
2597
2598
2599
2600

2601
2602
2603
2604
2605
2606
2607
2608








-
+








<td class="#doctools_idxleft" width="35%"><a name="npi"> NPI </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/valtype/usnpi.html"> valtype::usnpi </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="nroff"> nroff </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_nroff.html"> doctools::idx::export::nroff </a> &#183; <a href="tcllib/files/modules/doctools2base/nroff_manmacros.html"> doctools::nroff::man_macros </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_nroff.html"> doctools::toc::export::nroff </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a>
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export.html"> doctools::idx::export </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_export_nroff.html"> doctools::idx::export::nroff </a> &#183; <a href="tcllib/files/modules/doctools2base/nroff_manmacros.html"> doctools::nroff::man_macros </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export.html"> doctools::toc::export </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_nroff.html"> doctools::toc::export::nroff </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="ntlm"> NTLM </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/sasl/ntlm.html"> SASL::NTLM </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>




︙


4022
4023
4024
4025
4026
4027
4028
4029

4030
4031
4032
4033
4034
4035
4036

4022
4023
4024
4025
4026
4027
4028

4029
4030
4031
4032
4033
4034
4035
4036








-
+








<td class="#doctools_idxleft" width="35%"><a name="tls"> tls </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/comm/comm.html"> comm </a> &#183; <a href="tcllib/files/modules/imap4/imap4.html"> imap4 </a> &#183; <a href="tcllib/files/modules/pop3/pop3.html"> pop3 </a> &#183; <a href="tcllib/files/modules/pop3d/pop3d.html"> pop3d </a> &#183; <a href="tcllib/files/modules/mime/smtp.html"> smtp </a> &#183; <a href="tcllib/files/modules/transfer/connect.html"> transfer::connect </a> &#183; <a href="tcllib/files/modules/transfer/receiver.html"> transfer::receiver </a> &#183; <a href="tcllib/files/modules/transfer/transmitter.html"> transfer::transmitter </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="tmml"> TMML </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a>
<a href="tcllib/files/modules/doctools/doctools.html"> doctools </a> &#183; <a href="tcllib/files/modules/doctools/docidx.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2idx/idx_container.html"> doctools::idx </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_container.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/apps/dtplite.html"> dtplite </a> &#183; <a href="tcllib/files/modules/doctools/mpexpand.html"> mpexpand </a> &#183; <a href="tcllib/files/modules/dtplite/pkg_dtplite.html"> pkg_dtplite </a>
</td></tr>
<tr class="#doctools_idxodd" valign=top>
<td class="#doctools_idxleft" width="35%"><a name="toc"> toc </a></td>
<td class="#doctools_idxright" width="65%">
<a href="tcllib/files/modules/doctools/doctoc_intro.html"> doctoc_intro </a> &#183; <a href="tcllib/files/modules/doctools/doctoc_plugin_apiref.html"> doctoc_plugin_apiref </a> &#183; <a href="tcllib/files/modules/doctools/doctoc.html"> doctools::toc </a> &#183; <a href="tcllib/files/modules/doctools2toc/export_doctoc.html"> doctools::toc::export::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_html.html"> doctools::toc::export::html </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_json.html"> doctools::toc::export::json </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_nroff.html"> doctools::toc::export::nroff </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_text.html"> doctools::toc::export::text </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_export_wiki.html"> doctools::toc::export::wiki </a> &#183; <a href="tcllib/files/modules/doctools2toc/import_doctoc.html"> doctools::toc::import::doctoc </a> &#183; <a href="tcllib/files/modules/doctools2toc/toc_import_json.html"> doctools::toc::import::json </a>
</td></tr>
<tr class="#doctools_idxeven" valign=top>




︙





Changes to idoc/www/tcllib/files/apps/dtplite.html.






︙


138
139
140
141
142
143
144
145

146
147
148
149
150

151
152
153

154
155
156
157
158
159
160

138
139
140
141
142
143
144

145
146
147
148
149

150
151
152

153
154
155
156
157
158
159
160








-
+




-
+


-
+








<li><a href="#2"><b class="cmd">dtplite</b> <b class="const">validate</b> <i class="arg">inputfile</i></a></li>
<li><a href="#3"><b class="cmd">dtplite</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></li>
<li><a href="#4"><b class="cmd">dtplite</b> <b class="option">-merge</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></li>
</ul>
</div>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>The application described by this document, <b class="syscmd"><a href="../modules/dtplite/pkg_dtplite.html">dtplite</a></b>, is the
<p>The application described by this document, <b class="syscmd">dtplite</b>, is the
successor to the extremely simple <b class="syscmd"><a href="../modules/doctools/mpexpand.html">mpexpand</a></b>. Influenced in its
functionality by the <b class="syscmd">dtp</b> doctools processor it is much more
powerful than <b class="syscmd"><a href="../modules/doctools/mpexpand.html">mpexpand</a></b>, yet still as easy to use; definitely
easier than <b class="syscmd">dtp</b> with its myriad of subcommands and options.</p>
<p><b class="syscmd"><a href="../modules/dtplite/pkg_dtplite.html">dtplite</a></b> is based upon the package <b class="package"><a href="../modules/doctools/doctools.html">doctools</a></b>, like
<p><b class="syscmd">dtplite</b> is based upon the package <b class="package"><a href="../modules/doctools/doctools.html">doctools</a></b>, like
the other two processors.</p>
<div id="subsection1" class="doctools_subsection"><h3><a name="subsection1">USE CASES</a></h3>
<p><b class="syscmd"><a href="../modules/dtplite/pkg_dtplite.html">dtplite</a></b> was written with the following three use cases in
<p><b class="syscmd">dtplite</b> was written with the following three use cases in
mind.</p>
<ol class="doctools_enumerated">
<li><p>Validation of a single document, i.e. checking that it was written in
valid doctools format. This mode can also be used to get a preliminary
version of the formatted output for a single document, for display in
a browser, nroff, etc., allowing proofreading of the formatting.</p></li>
<li><p>Generation of the formatted documentation for a single package,




︙


174
175
176
177
178
179
180
181

182
183
184
185
186
187
188

174
175
176
177
178
179
180

181
182
183
184
185
186
187
188








-
+








generated document.
While all can be set as long as the formatting engine provides an
appropriate engine parameter (See section <span class="sectref"><a href="#subsection3">OPTIONS</a></span>) the last
two have internal processing which make them specific to HTML.</p>
</div>
<div id="subsection2" class="doctools_subsection"><h3><a name="subsection2">COMMAND LINE</a></h3>
<dl class="doctools_definitions">
<dt><a name="1"><b class="cmd"><a href="../modules/dtplite/pkg_dtplite.html">dtplite</a></b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputfile</i></a></dt>
<dt><a name="1"><b class="cmd">dtplite</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputfile</i></a></dt>
<dd><p>This is the form for use case [1]. The <i class="arg">options</i> will be
explained later, in section <span class="sectref"><a href="#subsection3">OPTIONS</a></span>.</p>
<dl class="doctools_arguments">
<dt>path <i class="arg">output</i> (in)</dt>
<dd><p>This argument specifies where to write the generated document. It can
be the path to a file or directory, or <b class="const">-</b>.
The last value causes the application to write the generated




︙


197
198
199
200
201
202
203
204

205
206
207
208
209

210
211
212
213
214
215
216
217
218

219
220
221
222
223
224
225

197
198
199
200
201
202
203

204
205
206
207
208

209
210
211
212
213
214
215
216
217

218
219
220
221
222
223
224
225








-
+




-
+








-
+








<dd><p>This argument specifies the formatting engine to use when processing
the input, and thus the format of the generated document. See section
<span class="sectref"><a href="#subsection4">FORMATS</a></span> for the possibilities recognized by the application.</p></dd>
<dt>path <i class="arg">inputfile</i> (in)</dt>
<dd><p>This argument specifies the path to the file to process. It has to
exist, must be readable, and written in <i class="term"><a href="../../../index.html#doctools">doctools</a></i> format.</p></dd>
</dl></dd>
<dt><a name="2"><b class="cmd"><a href="../modules/dtplite/pkg_dtplite.html">dtplite</a></b> <b class="const">validate</b> <i class="arg">inputfile</i></a></dt>
<dt><a name="2"><b class="cmd">dtplite</b> <b class="const">validate</b> <i class="arg">inputfile</i></a></dt>
<dd><p>This is a simpler form for use case [1]. The &quot;validate&quot; format
generates no output at all, only syntax checks are performed. As such
the specification of an output file or other options is not necessary
and left out.</p></dd>
<dt><a name="3"><b class="cmd"><a href="../modules/dtplite/pkg_dtplite.html">dtplite</a></b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></dt>
<dt><a name="3"><b class="cmd">dtplite</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></dt>
<dd><p>This is the form for use case [2]. It differs from the form for
use case [1] by having the input documents specified through a
directory instead of a file. The other arguments are identical, except
for <i class="arg">output</i>, which now has to be the path to an existing and
writable directory.</p>
<p>The input documents are all files in <i class="arg">inputdirectory</i> or any of
its subdirectories which were recognized by <b class="cmd">fileutil::fileType</b>
as containing text in <i class="term"><a href="../../../index.html#doctools">doctools</a></i> format.</p></dd>
<dt><a name="4"><b class="cmd"><a href="../modules/dtplite/pkg_dtplite.html">dtplite</a></b> <b class="option">-merge</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></dt>
<dt><a name="4"><b class="cmd">dtplite</b> <b class="option">-merge</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></dt>
<dd><p>This is the form for use case [3]. The only difference to the
form for use case [2] is the additional option <b class="option">-merge</b>.</p>
<p>Each such call will merge the generated documents coming from
processing the input documents under <i class="arg">inputdirectory</i> or any of
its subdirectories to the files under <i class="arg">output</i>. In this manner it
is possible to incrementally build the unified documentation for any
number of packages. Note that it is necessary to run through all the




︙





Added idoc/www/tcllib/files/apps/mkdoc.html.


























































































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

<!DOCTYPE html><html><head>
<title>mkdoc - Source code documentation using Markdown</title>
<style type="text/css"><!--
    HTML {
	background: 	#FFFFFF;
	color: 		black;
    }
    BODY {
	background: 	#FFFFFF;
	color:	 	black;
    }
    DIV.doctools {
	margin-left:	10%;
	margin-right:	10%;
    }
    DIV.doctools H1,DIV.doctools H2 {
	margin-left:	-5%;
    }
    H1, H2, H3, H4 {
	margin-top: 	1em;
	font-family:	sans-serif;
	font-size:	large;
	color:		#005A9C;
	background: 	transparent;
	text-align:		left;
    }
    H1.doctools_title {
	text-align: center;
    }
    UL,OL {
	margin-right: 0em;
	margin-top: 3pt;
	margin-bottom: 3pt;
    }
    UL LI {
	list-style: disc;
    }
    OL LI {
	list-style: decimal;
    }
    DT {
	padding-top: 	1ex;
    }
    UL.doctools_toc,UL.doctools_toc UL, UL.doctools_toc UL UL {
	font:		normal 12pt/14pt sans-serif;
	list-style:	none;
    }
    LI.doctools_section, LI.doctools_subsection {
	list-style: 	none;
	margin-left: 	0em;
	text-indent:	0em;
	padding: 	0em;
    }
    PRE {
	display: 	block;
	font-family:	monospace;
	white-space:	pre;
	margin:		0%;
	padding-top:	0.5ex;
	padding-bottom:	0.5ex;
	padding-left:	1ex;
	padding-right:	1ex;
	width:		100%;
    }
    PRE.doctools_example {
	color: 		black;
	background: 	#f5dcb3;
	border:		1px solid black;
    }
    UL.doctools_requirements LI, UL.doctools_syntax LI {
	list-style: 	none;
	margin-left: 	0em;
	text-indent:	0em;
	padding:	0em;
    }
    DIV.doctools_synopsis {
	color: 		black;
	background: 	#80ffff;
	border:		1px solid black;
	font-family:	serif;
	margin-top: 	1em;
	margin-bottom: 	1em;
    }
    UL.doctools_syntax {
	margin-top: 	1em;
	border-top:	1px solid black;
    }
    UL.doctools_requirements {
	margin-bottom: 	1em;
	border-bottom:	1px solid black;
    }
--></style>
</head>
<!-- Generated from file 'mkdoc.man' by tcllib/doctools with format 'html'
   -->
<!-- Copyright &amp;copy; 2019-2022, Detlef Groth &amp;lt;detlef(at)dgroth(dot)de&amp;gt;
   -->
<!-- mkdoc.n
   -->
<body><hr> [
   <a href="../../../../../../../home">Tcllib Home</a>
&#124; <a href="../../../toc.html">Main Table Of Contents</a>
&#124; <a href="../../toc.html">Table Of Contents</a>
&#124; <a href="../../../index.html">Keyword Index</a>
&#124; <a href="../../../toc0.html">Categories</a>
&#124; <a href="../../../toc1.html">Modules</a>
&#124; <a href="../../../toc2.html">Applications</a>
 ] <hr>
<div class="doctools">
<h1 class="doctools_title">mkdoc(n) 0.7.0 tcllib &quot;Source code documentation using Markdown&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>mkdoc - Source code documentation extractor/converter application</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>
<li class="doctools_section"><a href="#section1">Description</a></li>
<li class="doctools_section"><a href="#section2">Command Line</a></li>
<li class="doctools_section"><a href="#section3">Examples</a></li>
<li class="doctools_section"><a href="#section4">Bugs, Ideas, Feedback</a></li>
<li class="doctools_section"><a href="#section5">Code Copyright</a></li>
<li class="doctools_section"><a href="#category">Category</a></li>
<li class="doctools_section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="synopsis" class="doctools_section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="doctools_synopsis">
<ul class="doctools_syntax">
<li><a href="#1"><b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b> <b class="option">--help</b></a></li>
<li><a href="#2"><b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b> <b class="option">--version</b></a></li>
<li><a href="#3"><b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b> <b class="option">--license</b></a></li>
<li><a href="#4"><b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b> <i class="arg">input</i> <i class="arg">output</i> <span class="opt">?<b class="option">--css</b> <i class="arg">cssfile</i>?</span></a></li>
</ul>
</div>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>This document describes <b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b>, an application to extract documentation embedded in
source code files, be they &quot;<b class="file">.tcl</b>&quot;, or other.</p>
</div>
<div id="section2" class="doctools_section"><h2><a name="section2">Command Line</a></h2>
<dl class="doctools_definitions">
<dt><a name="1"><b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b> <b class="option">--help</b></a></dt>
<dd><p>The application prints a short help to standard output and exits.</p></dd>
<dt><a name="2"><b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b> <b class="option">--version</b></a></dt>
<dd><p>The application prints its version number to standard output and exits.</p></dd>
<dt><a name="3"><b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b> <b class="option">--license</b></a></dt>
<dd><p>The application prints its license to standard output and exits.</p></dd>
<dt><a name="4"><b class="cmd"><a href="../modules/mkdoc/mkdoc.html">mkdoc</a></b> <i class="arg">input</i> <i class="arg">output</i> <span class="opt">?<b class="option">--css</b> <i class="arg">cssfile</i>?</span></a></dt>
<dd><p>The application reads the <i class="arg">input</i> file, extracts the embedded documentation, and
writes it to the <i class="arg">output</i> file.</p>
<p>If the output file is not a &quot;<b class="file">.md</b>&quot; file the extracted documentation is
converted to HTML before being written.</p>
<p>When generating and writing HTML the default CSS stylesheet can be overridden by
specifying the path to a custom stylesheet via option <b class="option">--css</b>.</p>
<p>If the input file is a &quot;<b class="file">.md</b>&quot; file it is expected to contain Markdown as-is,
instead of Markdown embedded into code.</p>
<p>On the other side, when the file is considered code then the documentation is
expected to be contained in all lines starting with the marker <b class="const">#'</b>.
For script languages like Tcl the <b class="const">#</b> character of this marker means that the
documentation is contained in the so-flagged comments.
For other languages the marker and documentation may have to be embedded into multi-line
comments.</p></dd>
</dl>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">Examples</a></h2>
<pre class="doctools_example">
    # Create HTML manual for a CPP file using a custom style sheet
    mkdoc sample.cpp sample.html --css manual.css
    # Extract the documentation from code as simple Markdown, ready to be processed
    # further, for example with pandoc, or similar
    mkdoc sample.cpp sample.md 
    # Convert a Markdown file to HTML
    mkdoc sample.md sample.html
</pre>
</div>
<div id="section4" class="doctools_section"><h2><a name="section4">Bugs, Ideas, Feedback</a></h2>
<p>This document, and the package it describes, will undoubtedly contain bugs and
other problems. Please report such to the author of this package. Please also report any ideas for enhancements you may have for
either package and/or documentation.</p>
</div>
<div id="section5" class="doctools_section"><h2><a name="section5">Code Copyright</a></h2>
<p>BSD License type:</p>
<p>The following terms apply to all files a ssociated with the software unless
explicitly disclaimed in individual files.</p>
<p>The authors hereby grant permission to use, copy, modify, distribute, and license
this software and its documentation for any purpose, provided that existing copyright
notices are retained in all copies and that this notice is included verbatim in any
distributions. No written agreement, license, or royalty fee is required for any of the
authorized uses.  Modifications to this software may be copyrighted by their authors and
need not follow the licensing terms described here, provided that the new terms are
clearly indicated on the first page of each file where they apply.</p>
<p>In no event shall the authors or distributors be liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use of this
software, its documentation, or any derivatives thereof, even if the authors have been
advised of the possibility of such damage.</p>
<p>The authors and distributors specifically disclaim any warranties, including, but
not limited to, the implied warranties of merchantability, fitness for a particular
purpose, and non-infringement.
This software is provided on an &quot;as is&quot; basis, and the authors and distributors have no
obligation to provide maintenance, support, updates, enhancements, or modifications.</p>
<p><em>RESTRICTED RIGHTS</em>: Use, duplication or disclosure by the government is
subject to the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in
Technical Data and Computer Software Clause as DFARS 252.227-7013 and FAR 52.227-19.</p>
</div>
<div id="category" class="doctools_section"><h2><a name="category">Category</a></h2>
<p>Text processing</p>
</div>
<div id="copyright" class="doctools_section"><h2><a name="copyright">Copyright</a></h2>
<p>Copyright &copy; 2019-2022, Detlef Groth &lt;detlef(at)dgroth(dot)de&gt;</p>
</div>
</div></body></html>






Changes to idoc/www/tcllib/files/modules/doctools/docidx_intro.html.






︙


146
147
148
149
150
151
152
153

154
155
156
157
158
159

160
161
162
163
164
165
166

146
147
148
149
150
151
152

153
154
155
156
157
158

159
160
161
162
163
164
165
166








-
+





-
+








the formal <i class="term"><a href="docidx_lang_syntax.html">docidx language syntax</a></i> specification should
become understandable. A writer experienced with docidx may only
need the <i class="term"><a href="docidx_lang_cmdref.html">docidx language command reference</a></i> from time to
time to refresh her memory.</p>
<p>While a document is written the <b class="syscmd">dtp</b> application can be used
to validate it, and after completion it also performs the conversion
into the chosen system of visual markup, be it *roff, HTML, plain
text, wiki, etc. The simpler <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> application makes
text, wiki, etc. The simpler <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> application makes
internal use of docidx when handling directories of documentation,
automatically generating a proper keyword index for them.</p></li>
<li><p>A <i class="term">processor</i> of documentation written in the <i class="term"><a href="../../../../index.html#docidx">docidx</a></i>
markup language has to know which tools are available for use.</p>
<p>The main tool is the aforementioned <b class="syscmd">dtp</b> application provided
by Tcllib. The simpler <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> does not expose docidx to the
by Tcllib. The simpler <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> does not expose docidx to the
user.
At the bottom level, common to both applications, however sits the
package <b class="package">doctoools::idx</b>, providing the basic facilities to
read and process files containing text in the docidx format.</p></li>
<li><p>At last, but not least, <i class="term">plugin writers</i> have to understand the
interaction between the <b class="package"><a href="../doctools2idx/idx_container.html">doctools::idx</a></b> package and its
plugins, as described in the <i class="term"><a href="docidx_plugin_apiref.html">docidx plugin API reference</a></i>.</p></li>




︙





Changes to idoc/www/tcllib/files/modules/doctools/docidx_lang_faq.html.






︙


143
144
145
146
147
148
149
150

151
152
153
154
155

156
157
158
159
160
161
162

143
144
145
146
147
148
149

150
151
152
153
154

155
156
157
158
159
160
161
162








-
+




-
+








consider for this document as explained in the section
<span class="sectref"><a href="#section4">Bugs, Ideas, Feedback</a></span> below.</p>
</div>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">EXAMPLES</a></h2>
<div id="subsection2" class="doctools_subsection"><h3><a name="subsection2">Where do I find docidx examples?</a></h3>
<p>We have no direct examples of documents written using docidx
markup. However the doctools processor <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> does generate
markup. However the doctools processor <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> does generate
a table of contents when processing a set of documents written in
doctools markup. The intermediate file for it uses docidx
markup and is not deleted when generation completes. Such files can
therefore serve as examples.</p>
<p><b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> is distributed as part of Tcllib, so to get it you
<p><b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> is distributed as part of Tcllib, so to get it you
need one of</p>
<ol class="doctools_enumerated">
<li><p>A snapshot of Tcllib. How to retrieve such a snapshot and the
tools required for this are described at
<a href="/wiki?name=Development+Snapshots">Development Snapshots</a></p></li>
<li><p>A Tcllib release archive. They are available at the <a href="/home">home</a>
page.</p></li>




︙





Changes to idoc/www/tcllib/files/modules/doctools/docidx_lang_intro.html.






︙


265
266
267
268
269
270
271
272

273
274
275
276
277
278
279

265
266
267
268
269
270
271

272
273
274
275
276
277
278
279








-
+








detailed specification and cheat sheet for all available commands and
their syntax.</p>
<p>To be able to validate a document while writing it, it is also
recommended to familiarize oneself with Tclapps' ultra-configurable
<b class="syscmd">dtp</b>.</p>
<p>On the other hand, docidx is perfectly suited for the automatic
generation from doctools documents, and this is the route Tcllib's
easy and simple <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> goes, creating an index for a set of
easy and simple <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> goes, creating an index for a set of
documents behind the scenes, without the writer having to do so on
their own.</p>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">Bugs, Ideas, Feedback</a></h2>
<p>This document, and the package it describes, will undoubtedly contain
bugs and other problems.
Please report such in the category <em>doctools</em> of the




︙





Changes to idoc/www/tcllib/files/modules/doctools/doctoc_intro.html.






︙


146
147
148
149
150
151
152
153

154
155
156
157
158
159

160
161
162
163
164
165
166

146
147
148
149
150
151
152

153
154
155
156
157
158

159
160
161
162
163
164
165
166








-
+





-
+








the formal <i class="term"><a href="doctoc_lang_syntax.html">doctoc language syntax</a></i> specification should
become understandable. A writer experienced with doctoc may only
need the <i class="term"><a href="doctoc_lang_cmdref.html">doctoc language command reference</a></i> from time to
time to refresh her memory.</p>
<p>While a document is written the <b class="syscmd">dtp</b> application can be used
to validate it, and after completion it also performs the conversion
into the chosen system of visual markup, be it *roff, HTML, plain
text, wiki, etc. The simpler <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> application makes
text, wiki, etc. The simpler <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> application makes
internal use of doctoc when handling directories of documentation,
automatically generating a proper table of contents for them.</p></li>
<li><p>A <i class="term">processor</i> of documentation written in the <i class="term"><a href="../../../../index.html#doctoc">doctoc</a></i>
markup language has to know which tools are available for use.</p>
<p>The main tool is the aforementioned <b class="syscmd">dtp</b> application provided
by Tcllib. The simpler <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> does not expose doctoc to the
by Tcllib. The simpler <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> does not expose doctoc to the
user.
At the bottom level, common to both applications, however sits the
package <b class="package">doctoools::toc</b>, providing the basic facilities to
read and process files containing text in the doctoc format.</p></li>
<li><p>At last, but not least, <i class="term">plugin writers</i> have to understand the
interaction between the <b class="package"><a href="doctoc.html">doctools::toc</a></b> package and its
plugins, as described in the <i class="term"><a href="doctoc_plugin_apiref.html">doctoc plugin API reference</a></i>.</p></li>




︙





Changes to idoc/www/tcllib/files/modules/doctools/doctoc_lang_faq.html.






︙


143
144
145
146
147
148
149
150

151
152
153
154
155

156
157
158
159
160
161
162

143
144
145
146
147
148
149

150
151
152
153
154

155
156
157
158
159
160
161
162








-
+




-
+








consider for this document as explained in the section
<span class="sectref"><a href="#section4">Bugs, Ideas, Feedback</a></span> below.</p>
</div>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">EXAMPLES</a></h2>
<div id="subsection2" class="doctools_subsection"><h3><a name="subsection2">Where do I find doctoc examples?</a></h3>
<p>We have no direct examples of documents written using doctoc
markup. However the doctools processor <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> does generate
markup. However the doctools processor <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> does generate
a table of contents when processing a set of documents written in
doctools markup. The intermediate file for it uses doctoc
markup and is not deleted when generation completes. Such files can
therefore serve as examples.</p>
<p><b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> is distributed as part of Tcllib, so to get it you
<p><b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> is distributed as part of Tcllib, so to get it you
need one of</p>
<ol class="doctools_enumerated">
<li><p>A snapshot of Tcllib. How to retrieve such a snapshot and the
tools required for this are described at
<a href="/wiki?name=Development+Snapshots">Development Snapshots</a></p></li>
<li><p>A Tcllib release archive. They are available at the <a href="/home">home</a>
page.</p></li>




︙





Changes to idoc/www/tcllib/files/modules/doctools/doctoc_lang_intro.html.






︙


330
331
332
333
334
335
336
337

338
339
340
341
342
343
344

330
331
332
333
334
335
336

337
338
339
340
341
342
343
344








-
+








detailed specification and cheat sheet for all available commands and
their syntax.</p>
<p>To be able to validate a document while writing it, it is also
recommended to familiarize oneself with Tclapps' ultra-configurable
<b class="syscmd">dtp</b>.</p>
<p>On the other hand, doctoc is perfectly suited for the automatic
generation from doctools documents, and this is the route Tcllib's
easy and simple <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> goes, creating a table of contents
easy and simple <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> goes, creating a table of contents
for a set of documents behind the scenes, without the writer having to
do so on their own.</p>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">Bugs, Ideas, Feedback</a></h2>
<p>This document, and the package it describes, will undoubtedly contain
bugs and other problems.
Please report such in the category <em>doctools</em> of the




︙





Changes to idoc/www/tcllib/files/modules/doctools/doctools_intro.html.






︙


142
143
144
145
146
147
148
149

150
151
152
153
154
155

156
157
158
159
160
161
162

142
143
144
145
146
147
148

149
150
151
152
153
154

155
156
157
158
159
160
161
162








-
+





-
+








<li><p>A <i class="term">writer</i> of documentation has to understand the markup language
itself. A beginner to doctools should read the more informally written
<i class="term"><a href="doctools_lang_intro.html">doctools language introduction</a></i> first. Having digested this
the formal <i class="term"><a href="doctools_lang_syntax.html">doctools language syntax</a></i> specification should
become understandable. A writer experienced with doctools may only
need the <i class="term"><a href="doctools_lang_cmdref.html">doctools language command reference</a></i> from time to
time to refresh her memory.</p>
<p>While a document is written the <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> application can be
<p>While a document is written the <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> application can be
used to validate it, and after completion it also performs the
conversion into the chosen system of visual markup, be it *roff, HTML,
plain text, wiki, etc.</p></li>
<li><p>A <i class="term">processor</i> of documentation written in the <i class="term"><a href="../../../../index.html#doctools">doctools</a></i>
markup language has to know which tools are available for use.</p>
<p>The main tool is the aforementioned <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> application
<p>The main tool is the aforementioned <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> application
provided by Tcllib. A more powerful one (in terms of options and
ability to configure it) is the <b class="syscmd">dtp</b> application, provided by
Tclapps.
At the bottom level, common to both applications, however sits the
package <b class="package"><a href="doctools.html">doctools</a></b>, providing the basic facilities to read and
process files containing text in the doctools format.</p></li>
<li><p>At last, but not least, <i class="term">plugin writers</i> have to understand the




︙





Changes to idoc/www/tcllib/files/modules/doctools/doctools_lang_faq.html.






︙


143
144
145
146
147
148
149
150

151
152
153
154
155

156
157
158
159
160
161
162

143
144
145
146
147
148
149

150
151
152
153
154

155
156
157
158
159
160
161
162








-
+




-
+








consider for this document as explained in the section
<span class="sectref"><a href="#section4">Bugs, Ideas, Feedback</a></span> below.</p>
</div>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">EXAMPLES</a></h2>
<div id="subsection2" class="doctools_subsection"><h3><a name="subsection2">Where do I find doctools examples?</a></h3>
<p>We have no direct examples of documents written using doctools
markup. However the doctools processor <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> does generate
markup. However the doctools processor <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> does generate
a table of contents when processing a set of documents written in
doctools markup. The intermediate file for it uses doctools
markup and is not deleted when generation completes. Such files can
therefore serve as examples.</p>
<p><b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> is distributed as part of Tcllib, so to get it you
<p><b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> is distributed as part of Tcllib, so to get it you
need one of</p>
<ol class="doctools_enumerated">
<li><p>A snapshot of Tcllib. How to retrieve such a snapshot and the
tools required for this are described at
<a href="/wiki?name=Development+Snapshots">Development Snapshots</a></p></li>
<li><p>A Tcllib release archive. They are available at the <a href="/home">home</a>
page.</p></li>




︙





Changes to idoc/www/tcllib/files/modules/doctools/doctools_lang_intro.html.






︙


605
606
607
608
609
610
611
612

613
614
615
616
617
618
619

605
606
607
608
609
610
611

612
613
614
615
616
617
618
619








-
+








specification as well. From here on out the
<i class="term"><a href="doctools_lang_cmdref.html">doctools language command reference</a></i> will also serve as the
detailed specification and cheat sheet for all available commands and
their syntax.</p>
<p>To be able to validate a document while writing it, it is also
recommended to familiarize oneself with one of the applications for
the processing and conversion of doctools documents, i.e. either
Tcllib's easy and simple <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b>, or Tclapps'
Tcllib's easy and simple <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b>, or Tclapps'
ultra-configurable <b class="syscmd">dtp</b>.</p>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">Bugs, Ideas, Feedback</a></h2>
<p>This document, and the package it describes, will undoubtedly contain
bugs and other problems.
Please report such in the category <em>doctools</em> of the
<a href="http://core.tcl.tk/tcllib/reportlist">Tcllib Trackers</a>.




︙





Changes to idoc/www/tcllib/files/modules/doctools2idx/idx_introduction.html.






︙


155
156
157
158
159
160
161
162

163
164
165
166
167
168

169
170
171
172
173
174
175

155
156
157
158
159
160
161

162
163
164
165
166
167

168
169
170
171
172
173
174
175








-
+





-
+








the formal <i class="term"><a href="../doctools/docidx_lang_syntax.html">docidx language syntax</a></i> specification should
become understandable. A writer experienced with docidx may only
need the <i class="term"><a href="../doctools/docidx_lang_cmdref.html">docidx language command reference</a></i> from time to
time to refresh her memory.</p>
<p>While a document is written the <b class="syscmd">dtp</b> application can be used
to validate it, and after completion it also performs the conversion
into the chosen system of visual markup, be it *roff, HTML, plain
text, wiki, etc. The simpler <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> application makes
text, wiki, etc. The simpler <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> application makes
internal use of docidx when handling directories of documentation,
automatically generating a proper keyword index for them.</p></li>
<li><p>A <i class="term">processor</i> of documentation written in the <i class="term"><a href="../../../../index.html#docidx">docidx</a></i>
markup language has to know which tools are available for use.</p>
<p>The main tool is the aforementioned <b class="syscmd">dtp</b> application provided
by Tcllib. The simpler <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> does not expose docidx to the
by Tcllib. The simpler <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> does not expose docidx to the
user. At the bottom level, common to both applications, however we
find the three packages providing the basic facilities to handle
keyword indices, i.e. import from textual formats, programmatic
manipulation in memory, and export to textual formats. These are</p>
<dl class="doctools_definitions">
<dt><b class="package"><a href="idx_container.html">doctools::idx</a></b></dt>
<dd><p>Programmatic manipulation of keyword indices in memory.</p></dd>




︙





Changes to idoc/www/tcllib/files/modules/doctools2toc/toc_introduction.html.






︙


155
156
157
158
159
160
161
162

163
164
165
166
167
168

169
170
171
172
173
174
175

155
156
157
158
159
160
161

162
163
164
165
166
167

168
169
170
171
172
173
174
175








-
+





-
+








the formal <i class="term"><a href="../doctools/doctoc_lang_syntax.html">doctoc language syntax</a></i> specification should
become understandable. A writer experienced with doctoc may only
need the <i class="term"><a href="../doctools/doctoc_lang_cmdref.html">doctoc language command reference</a></i> from time to
time to refresh her memory.</p>
<p>While a document is written the <b class="syscmd">dtp</b> application can be used
to validate it, and after completion it also performs the conversion
into the chosen system of visual markup, be it *roff, HTML, plain
text, wiki, etc. The simpler <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> application makes
text, wiki, etc. The simpler <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> application makes
internal use of doctoc when handling directories of documentation,
automatically generating a proper table of contents for them.</p></li>
<li><p>A <i class="term">processor</i> of documentation written in the <i class="term"><a href="../../../../index.html#doctoc">doctoc</a></i>
markup language has to know which tools are available for use.</p>
<p>The main tool is the aforementioned <b class="syscmd">dtp</b> application provided
by Tcllib. The simpler <b class="syscmd"><a href="../dtplite/pkg_dtplite.html">dtplite</a></b> does not expose doctoc to the
by Tcllib. The simpler <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> does not expose doctoc to the
user. At the bottom level, common to both applications, however we
find the three packages providing the basic facilities to handle
tables of contents, i.e. import from textual formats, programmatic
manipulation in memory, and export to textual formats. These are</p>
<dl class="doctools_definitions">
<dt><b class="package">doctoools::toc</b></dt>
<dd><p>Programmatic manipulation of tables of contents in memory.</p></dd>




︙





Changes to idoc/www/tcllib/files/modules/dtplite/pkg_dtplite.html.





1
2

3
4
5
6
7
8
9

1

2
3
4
5
6
7
8
9


-
+








<!DOCTYPE html><html><head>
<title>dtplite - Documentation toolbox</title>
<title>pkg_dtplite - Documentation toolbox</title>
<style type="text/css"><!--
    HTML {
	background: 	#FFFFFF;
	color: 		black;
    }
    BODY {
	background: 	#FFFFFF;




︙


91
92
93
94
95
96
97
98

99
100
101
102
103
104
105
106
107
108
109
110

111
112

113
114
115
116
117
118

119
120
121
122

123
124
125
126
127

128
129
130
131
132
133
134
135
136
137
138
139
140
141


142
143
144
145
146
147
148

149
150
151
152
153

154
155
156
157

158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182

183
184

185
186
187
188

189
190
191
192
193
194
195
196
197
198

199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321

322
323
324
325
326
327
328
329
330
331
332
333
334
335
336


337
338
339
340
341

342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361

362
363
364
365
366
367
368
369
370
371
372
373
374
375
376

377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418

419
420
421
422
423
424
425

91
92
93
94
95
96
97

98
99
100
101
102
103
104
105
106
107
108
109

110
111

112
113
114
115
116
117

118




119





120
121
122
123
124
125
126
127
128
129
130
131
132


133
134


135
136
137
138

139





140




141























142

143
144

145




146










147



























































































































148















149
150





151




















152















153






































154
155


156
157
158
159
160
161
162
163








-
+











-
+

-
+





-
+
-
-
-
-
+
-
-
-
-
-
+












-
-
+
+
-
-




-
+
-
-
-
-
-
+
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-
+

-
+
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-


-
-
+








    }
--></style>
</head>
<!-- Generated from file 'pkg_dtplite.man' by tcllib/doctools with format 'html'
   -->
<!-- Copyright &amp;copy; 2004-2013 Andreas Kupries &amp;lt;[email protected]&amp;gt;
   -->
<!-- dtplite.n
<!-- pkg_dtplite.n
   -->
<body><hr> [
   <a href="../../../../../../../../home">Tcllib Home</a>
&#124; <a href="../../../../toc.html">Main Table Of Contents</a>
&#124; <a href="../../../toc.html">Table Of Contents</a>
&#124; <a href="../../../../index.html">Keyword Index</a>
&#124; <a href="../../../../toc0.html">Categories</a>
&#124; <a href="../../../../toc1.html">Modules</a>
&#124; <a href="../../../../toc2.html">Applications</a>
 ] <hr>
<div class="doctools">
<h1 class="doctools_title">dtplite(n) 1.3.1 tcllib &quot;Documentation toolbox&quot;</h1>
<h1 class="doctools_title">pkg_dtplite(n) 1.3.1 tcllib &quot;Documentation toolbox&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>dtplite - Lightweight DocTools Markup Processor</p>
<p>pkg_dtplite - Lightweight DocTools Markup Processor</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>
<li class="doctools_section"><a href="#section1">Description</a>
<li class="doctools_section"><a href="#section1">Description</a></li>
<ul>
<li class="doctools_subsection"><a href="#subsection1">USE CASES</a></li>
<li class="doctools_subsection"><a href="#subsection2">COMMAND LINE</a></li>
<li class="doctools_subsection"><a href="#subsection3">OPTIONS</a></li>
<li class="doctools_section"><a href="#section2">COMMANDS</a></li>
<li class="doctools_subsection"><a href="#subsection4">FORMATS</a></li>
<li class="doctools_subsection"><a href="#subsection5">DIRECTORY STRUCTURES</a></li>
</ul>
</li>
<li class="doctools_section"><a href="#section2">Bugs, Ideas, Feedback</a></li>
<li class="doctools_section"><a href="#section3">Bugs, Ideas, Feedback</a></li>
<li class="doctools_section"><a href="#see-also">See Also</a></li>
<li class="doctools_section"><a href="#keywords">Keywords</a></li>
<li class="doctools_section"><a href="#category">Category</a></li>
<li class="doctools_section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="synopsis" class="doctools_section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="doctools_synopsis">
<ul class="doctools_requirements">
<li>package require <b class="pkgname">dtplite <span class="opt">?1.3.1?</span></b></li>
</ul>
<ul class="doctools_syntax">
<li><a href="#1"><b class="cmd">dtplite</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputfile</i></a></li>
<li><a href="#2"><b class="cmd">dtplite</b> <b class="const">validate</b> <i class="arg">inputfile</i></a></li>
<li><a href="#1"><b class="cmd">dtplite::print-via</b> <i class="arg">cmd</i></a></li>
<li><a href="#2"><b class="cmd">dtplite::do</b> <i class="arg">arguments</i></a></li>
<li><a href="#3"><b class="cmd">dtplite</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></li>
<li><a href="#4"><b class="cmd">dtplite</b> <b class="option">-merge</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></li>
</ul>
</div>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>The application described by this document, <b class="syscmd">dtplite</b>, is the
<p>The package provided by this document, <b class="package"><a href="../../apps/dtplite.html">dtplite</a></b>, is the foundation for the
successor to the extremely simple <b class="syscmd"><a href="../doctools/mpexpand.html">mpexpand</a></b>. Influenced in its
functionality by the <b class="syscmd">dtp</b> doctools processor it is much more
powerful than <b class="syscmd"><a href="../doctools/mpexpand.html">mpexpand</a></b>, yet still as easy to use; definitely
easier than <b class="syscmd">dtp</b> with its myriad of subcommands and options.</p>
<p><b class="syscmd">dtplite</b> is based upon the package <b class="package"><a href="../doctools/doctools.html">doctools</a></b>, like
<b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> application. It is a light wrapper around the various <b class="package"><a href="../doctools/doctools.html">doctools</a></b>
the other two processors.</p>
<div id="subsection1" class="doctools_subsection"><h3><a name="subsection1">USE CASES</a></h3>
<p><b class="syscmd">dtplite</b> was written with the following three use cases in
mind.</p>
packages.</p>
<ol class="doctools_enumerated">
<li><p>Validation of a single document, i.e. checking that it was written in
valid doctools format. This mode can also be used to get a preliminary
version of the formatted output for a single document, for display in
a browser, nroff, etc., allowing proofreading of the formatting.</p></li>
<li><p>Generation of the formatted documentation for a single package,
i.e. all the manpages, plus a table of contents and an index of
keywords.</p></li>
<li><p>An extension of the previous mode of operation, a method for the easy
generation of one documentation tree for several packages, and
especially of a unified table of contents and keyword index.</p></li>
</ol>
<p>Beyond the above we also want to make use of the customization
features provided by the HTML formatter. It is not the only format the
application should be able to generate, but we anticipiate it to be
the most commonly used, and it is one of the few which do provide
customization hooks.</p>
<p>We allow the caller to specify a header string, footer string, a
stylesheet, and data for a bar of navigation links at the top of the
generated document.
While all can be set as long as the formatting engine provides an
appropriate engine parameter (See section <span class="sectref"><a href="#subsection3">OPTIONS</a></span>) the last
two have internal processing which make them specific to HTML.</p>
</div>
<div id="subsection2" class="doctools_subsection"><h3><a name="subsection2">COMMAND LINE</a></h3>
<div id="section2" class="doctools_section"><h2><a name="section2">COMMANDS</a></h2>
<dl class="doctools_definitions">
<dt><a name="1"><b class="cmd">dtplite</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputfile</i></a></dt>
<dt><a name="1"><b class="cmd">dtplite::print-via</b> <i class="arg">cmd</i></a></dt>
<dd><p>This is the form for use case [1]. The <i class="arg">options</i> will be
explained later, in section <span class="sectref"><a href="#subsection3">OPTIONS</a></span>.</p>
<dl class="doctools_arguments">
<dt>path <i class="arg">output</i> (in)</dt>
<dd><p>Redirect print operations of the package to the specified <i class="arg">cmd</i>.</p>
<dd><p>This argument specifies where to write the generated document. It can
be the path to a file or directory, or <b class="const">-</b>.
The last value causes the application to write the generated
documented to <b class="const">stdout</b>.</p>
<p>If the <i class="arg">output</i> does not exist then [file dirname $output]
has to exist and must be a writable directory.
The generated document will be written to a file in that directory,
and the name of that file will be derived from the <i class="arg">inputfile</i>,
the <i class="arg">format</i>, and the value given to option <b class="option">-ext</b> (if
present).</p></dd>
<p>The result of the command is the empty string.</p></dd>
<dt>(path|handle) <i class="arg">format</i> (in)</dt>
<dd><p>This argument specifies the formatting engine to use when processing
the input, and thus the format of the generated document. See section
<span class="sectref"><a href="#subsection4">FORMATS</a></span> for the possibilities recognized by the application.</p></dd>
<dt>path <i class="arg">inputfile</i> (in)</dt>
<dd><p>This argument specifies the path to the file to process. It has to
exist, must be readable, and written in <i class="term"><a href="../../../../index.html#doctools">doctools</a></i> format.</p></dd>
</dl></dd>
<dt><a name="2"><b class="cmd">dtplite</b> <b class="const">validate</b> <i class="arg">inputfile</i></a></dt>
<dd><p>This is a simpler form for use case [1]. The &quot;validate&quot; format
generates no output at all, only syntax checks are performed. As such
the specification of an output file or other options is not necessary
and left out.</p></dd>
<dt><a name="3"><b class="cmd">dtplite</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></dt>
<dd><p>This is the form for use case [2]. It differs from the form for
use case [1] by having the input documents specified through a
directory instead of a file. The other arguments are identical, except
for <i class="arg">output</i>, which now has to be the path to an existing and
writable directory.</p>
<p>The input documents are all files in <i class="arg">inputdirectory</i> or any of
its subdirectories which were recognized by <b class="cmd">fileutil::fileType</b>
as containing text in <i class="term"><a href="../../../../index.html#doctools">doctools</a></i> format.</p></dd>
<dt><a name="4"><b class="cmd">dtplite</b> <b class="option">-merge</b> <b class="option">-o</b> <i class="arg">output</i> <span class="opt">?options?</span> <i class="arg">format</i> <i class="arg">inputdirectory</i></a></dt>
<dd><p>This is the form for use case [3]. The only difference to the
form for use case [2] is the additional option <b class="option">-merge</b>.</p>
<p>Each such call will merge the generated documents coming from
processing the input documents under <i class="arg">inputdirectory</i> or any of
its subdirectories to the files under <i class="arg">output</i>. In this manner it
is possible to incrementally build the unified documentation for any
number of packages. Note that it is necessary to run through all the
packages twice to get fully correct cross-references (for formats
supporting them).</p></dd>
</dl>
</div>
<div id="subsection3" class="doctools_subsection"><h3><a name="subsection3">OPTIONS</a></h3>
<p>This section describes all the options available to the user of the
application, with
the exception of the options <b class="option">-o</b> and <b class="option">-merge</b>. These
two were described already, in section <span class="sectref"><a href="#subsection2">COMMAND LINE</a></span>.</p>
<dl class="doctools_options">
<dt><b class="option">-exclude</b> string</dt>
<dd><p>This option specifies an exclude (glob) pattern. Any files identified
as manpages to process which match the exclude pattern are
ignored. The option can be provided multiple times, each usage adding
an additional pattern to the list of exclusions.</p></dd>
<dt><b class="option">-ext</b> string</dt>
<dd><p>If the name of an output file has to be derived from the name of an
input file it will use the name of the <i class="arg">format</i> as the extension
by default. This option here will override this however, forcing it to
use <i class="arg">string</i> as the file extension. This option is ignored if the
name of the output file is fully specified through option <b class="option">-o</b>.</p>
<p>When used multiple times only the last definition is relevant.</p></dd>
<dt><b class="option">-header</b> file</dt>
<dd><p>This option can be used if and only if the selected <i class="arg">format</i>
provides an engine parameter named &quot;header&quot;. It takes the contents of
the specified file and assign them to that parameter, for whatever use
by the engine. The HTML engine will insert the text just after the tag
<b class="const">&lt;body&gt;</b>.
If navigation buttons are present (see option <b class="option">-nav</b> below),
then the HTML generated for them is appended to the header data
originating here before the final assignment to the parameter.</p>
<p>When used multiple times only the last definition is relevant.</p></dd>
<dt><b class="option">-footer</b> file</dt>
<dd><p>Like <b class="option">-header</b>, except that: Any navigation buttons are ignored,
the corresponding required engine parameter is named &quot;footer&quot;, and the
data is inserted just before the tag <b class="const">&lt;/body&gt;</b>.</p>
<p>When used multiple times only the last definition is relevant.</p></dd>
<dt><b class="option">-style</b> file</dt>
<dd><p>This option can be used if and only if the selected <i class="arg">format</i>
provides an engine parameter named &quot;meta&quot;. When specified it will
generate a piece of HTML code declaring the <i class="arg">file</i> as the
stylesheet for the generated document and assign that to the
parameter. The HTML engine will insert this inot the document, just
after the tag <b class="const">&lt;head&gt;</b>.</p>
<p>When processing an input directory the stylesheet file is copied into
the output directory and the generated HTML will refer to the copy, to
make the result more self-contained. When processing an input file we
have no location to copy the stylesheet to and so just reference it as
specified.</p>
<p>When used multiple times only the last definition is relevant.</p></dd>
<dt><b class="option">-toc</b> path|text</dt>
<dd><p>This option specifies a doctoc file (or text) to use for the table of contents
instead of generating our own.</p>
<p>When used multiple times only the last definition is relevant.</p></dd>
<dt><b class="option">-pre+toc</b> label path|text</dt>
<dd></dd>
<dt><b class="option">-post+toc</b> label path|text</dt>
<dd><p>This option specifies additional doctoc files (or texts) to use in
the navigation bar.</p>
<p>Positioning and handling of multiple uses is like for options
<b class="option">-prenav</b> and <b class="option">-postnav</b>, see below.</p></dd>
<dt><b class="option">-nav</b> label url</dt>
<dd></dd>
<dt><b class="option">-prenav</b> label url</dt>
<dd><p>Use this option to specify a navigation button with <i class="arg">label</i> to
display and the <i class="arg">url</i> to link to. This option can be used if and
only if the selected <i class="arg">format</i> provides an engine parameter named
&quot;header&quot;. The HTML generated for this is appended to whatever data we
got from option <b class="option">-header</b> before it is inserted into the
generated documents.</p>
<p>When used multiple times all definitions are collected and a
navigation bar is created, with the first definition shown at the left
edge and the last definition to the right.</p>
<p>The url can be relative. In that case it is assumed to be relative
to the main files (TOC and Keyword index), and will be transformed for
all others to still link properly.</p></dd>
<dt><b class="option">-postnav</b> label url</dt>
<dd><p>Use this option to specify a navigation button with <i class="arg">label</i> to
display and the <i class="arg">url</i> to link to. This option can be used if and
only if the selected <i class="arg">format</i> provides an engine parameter named
&quot;header&quot;. The HTML generated for this is appended to whatever data we
got from option <b class="option">-header</b> before it is inserted into the
generated documents.</p>
<p>When used multiple times all definitions are collected and a
navigation bar is created, with the last definition shown at the right
edge and the first definition to the left.</p>
<p>The url can be relative. In that case it is assumed to be relative
to the main files (TOC and Keyword index), and will be transformed for
all others to still link properly.</p></dd>
</dl>
</div>
<div id="subsection4" class="doctools_subsection"><h3><a name="subsection4">FORMATS</a></h3>
<p>At first the <i class="arg">format</i> argument will be treated as a path to a tcl
<dt><a name="2"><b class="cmd">dtplite::do</b> <i class="arg">arguments</i></a></dt>
file containing the code for the requested formatting engine. The
argument will be treated as the name of one of the predefined formats
listed below if and only if the path does not exist.</p>
<p><em>Note a limitation</em>: If treating the format as path to the tcl
script implementing the engine was sucessful, then this script has to
implement not only the engine API for doctools, i.e.
<i class="term">doctools_api</i>, but for <i class="term">doctoc_api</i> and <i class="term">docidx_api</i>
as well. Otherwise the generation of a table of contents and of a
keyword index will fail.</p>
<p>List of predefined formats, i.e. as provided by the
package <b class="package"><a href="../doctools/doctools.html">doctools</a></b>:</p>
<dl class="doctools_definitions">
<dt><b class="const">nroff</b></dt>
<dd><p>The processor generates *roff output, the standard format for unix
manpages.</p></dd>
<dd><p>The main command it takes a <em>single list</em> of <i class="arg">arguments</i>, processes them, and
performs the specified action.</p>
<dt><b class="const">html</b></dt>
<dd><p>The processor generates HTML output, for usage in and display by web
browsers. This engine is currently the only one providing the various
engine parameters required for the additional customaization of the
output.</p></dd>
<p>The result of the command is the empty string.</p>
<dt><b class="const">tmml</b></dt>
<dd><p>The processor generates TMML output, the Tcl Manpage Markup Language,
a derivative of XML.</p></dd>
<dt><b class="const">latex</b></dt>
<dd><p>The processor generates LaTeX output.</p></dd>
<dt><b class="const">wiki</b></dt>
<dd><p>The processor generates Wiki markup as understood by <b class="syscmd">wikit</b>.</p></dd>
<dt><b class="const">list</b></dt>
<dd><p>The processor extracts the information provided by <b class="cmd">manpage_begin</b>.
This format is used internally to extract the meta data from which
both table of contents and keyword index are derived from.</p></dd>
<dt><b class="const">null</b></dt>
<dd><p>The processor does not generate any output. This is equivalent to
<b class="const">validate</b>.</p></dd>
</dl>
</div>
<div id="subsection5" class="doctools_subsection"><h3><a name="subsection5">DIRECTORY STRUCTURES</a></h3>
<p>In this section we describe the directory structures generated by the
application under <i class="arg">output</i> when processing all documents in an
<i class="arg">inputdirectory</i>. In other words, this is only relevant to the use
<p>The details of the syntax inside of the <i class="arg">arguments</i> list are explained in
cases [2] and [3].</p>
<dl class="doctools_definitions">
<dt>[2]</dt>
<dd><p>The following directory structure is created when processing a single
set of input documents.  The file extension used is for output in
HTML, but that is not relevant to the structure and was just used to
have proper file names.</p>
<pre class="doctools_example">
    output/
        toc.html
        index.html
        files/
            path/to/FOO.html
</pre>
<p>The last line in the example shows the document
section <i class="term">COMMAND LINE</i> of the documentation for the <b class="syscmd"><a href="../../apps/dtplite.html">dtplite</a></b> application.</p></dd>
generated for a file FOO located at</p>
<pre class="doctools_example">
    inputdirectory/path/to/FOO
</pre>
</dd>
<dt>[3]</dt>
<dd><p>When merging many packages into a unified set of documents the
generated directory structure is a bit deeper:</p>
<pre class="doctools_example">
    output
        .toc
        .idx
        .tocdoc
        .idxdoc
        .xrf
        toc.html
        index.html
        FOO1/
            ...
        FOO2/
            toc.html
            files/
                path/to/BAR.html
</pre>
<p>Each of the directories FOO1, ... contains the documents generated for
the package FOO1, ... and follows the structure shown for use case
[2]. The only exception is that there is no per-package index.</p>
<p>The files &quot;<b class="file">.toc</b>&quot;, &quot;<b class="file">.idx</b>&quot;, and &quot;<b class="file">.xrf</b>&quot; contain the
internal status of the whole output and will be read and updated by
the next invokation. Their contents will not be documented. Remove
these files when all packages wanted for the output have been
processed, i.e. when the output is complete.</p>
<p>The files &quot;<b class="file">.tocdoc</b>&quot;, and &quot;<b class="file">.idxdoc</b>&quot;, are intermediate files
in doctoc and docidx markup, respectively, containing the main table
of contents and keyword index for the set of documents before their
conversion to the chosen output format.
They are left in place, i.e. not deleted, to serve as demonstrations
of doctoc and docidx markup.</p></dd>
</dl>
</div>
</div>
<div id="section2" class="doctools_section"><h2><a name="section2">Bugs, Ideas, Feedback</a></h2>
<div id="section3" class="doctools_section"><h2><a name="section3">Bugs, Ideas, Feedback</a></h2>
<p>This document, and the package it describes, will undoubtedly contain
bugs and other problems.
Please report such in the category <em>doctools</em> of the
<a href="http://core.tcl.tk/tcllib/reportlist">Tcllib Trackers</a>.
Please also report any ideas for enhancements you may have for either
package and/or documentation.</p>
<p>When proposing code changes, please provide <em>unified diffs</em>,




︙





Changes to idoc/www/tcllib/files/modules/irc/picoirc.html.






︙


101
102
103
104
105
106
107
108

109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

129
130
131
132
133
134
135
136
137
138
139
140
141

101
102
103
104
105
106
107

108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

128
129
130
131
132


133
134
135
136
137
138
139








-
+



















-
+




-
-








&#124; <a href="../../../toc.html">Table Of Contents</a>
&#124; <a href="../../../../index.html">Keyword Index</a>
&#124; <a href="../../../../toc0.html">Categories</a>
&#124; <a href="../../../../toc1.html">Modules</a>
&#124; <a href="../../../../toc2.html">Applications</a>
 ] <hr>
<div class="doctools">
<h1 class="doctools_title">picoirc(n) 0.11.0 tcllib &quot;Simple embeddable IRC interface&quot;</h1>
<h1 class="doctools_title">picoirc(n) 0.13.0 tcllib &quot;Simple embeddable IRC interface&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>picoirc - Small and simple embeddable IRC client.</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>
<li class="doctools_section"><a href="#section1">Description</a></li>
<li class="doctools_section"><a href="#section2">COMMANDS</a></li>
<li class="doctools_section"><a href="#section3">CALLBACK</a></li>
<li class="doctools_section"><a href="#see-also">See Also</a></li>
<li class="doctools_section"><a href="#keywords">Keywords</a></li>
<li class="doctools_section"><a href="#category">Category</a></li>
</ul>
</div>
<div id="synopsis" class="doctools_section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="doctools_synopsis">
<ul class="doctools_requirements">
<li>package require <b class="pkgname">Tcl 8.6</b></li>
<li>package require <b class="pkgname">picoirc <span class="opt">?0.11.0?</span></b></li>
<li>package require <b class="pkgname">picoirc <span class="opt">?0.13.0?</span></b></li>
</ul>
<ul class="doctools_syntax">
<li><a href="#1"><b class="cmd">::picoirc::connect</b> <i class="arg">callback</i> <i class="arg">nick</i> <span class="opt">?<i class="arg">password</i>?</span> <i class="arg">url</i></a></li>
<li><a href="#2"><b class="cmd">::picoirc::post</b> <i class="arg">context</i> <i class="arg">channel</i> <i class="arg">message</i></a></li>
<li><a href="#3"><b class="cmd">::picoirc::splituri</b> <i class="arg">uri</i></a></li>
<li><a href="#4"><b class="cmd">::picoirc::send</b> <i class="arg">context</i> <i class="arg">line</i></a></li>
</ul>
</div>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>This package provides a general purpose minimal IRC client suitable for
embedding in other applications. All communication with the parent
application is done via an application provided callback procedure.




︙


172
173
174
175
176
177
178

179
180
181



182
183
184
185
186
187
188
189
190
191
192
193
194






195
196
197
198
199
200
201
202

170
171
172
173
174
175
176
177



178
179
180













181
182
183
184
185
186

187
188
189
190
191
192
193








+
-
-
-
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
-








        return [lindex $args 3]
    }
}
</pre>
</dd>
<dt><a name="2"><b class="cmd">::picoirc::post</b> <i class="arg">context</i> <i class="arg">channel</i> <i class="arg">message</i></a></dt>
<dd><p>This should be called to process user input and send it to the
server. If <i class="arg">message</i> is multiline then each line will be processed
server. A number of commands are recognised when prefixed with a
forward-slash (/). Such commands are converted to IRC command
sequences and then sent.</p></dd>
and sent individually. A number of commands are recognised when
prefixed with a forward-slash (/). Such commands are converted to
IRC command sequences and then sent. If <i class="arg">channel</i> is empty then
<dt><a name="3"><b class="cmd">::picoirc::splituri</b> <i class="arg">uri</i></a></dt>
<dd><p>Splits an IRC scheme uniform resource indicator into its component
parts. Returns a list of server, port, channels and secure where
secure is a boolean flag which is <b class="const">true</b> if a TLS connection was
requested via the <em>ircs://</em> schema. The default port is 6667 (or
6697 if secured) and there are no default channels.</p></dd>
<dt><a name="4"><b class="cmd">::picoirc::send</b> <i class="arg">context</i> <i class="arg">line</i></a></dt>
<dd><p>This command is where all raw output to the server is handled. The
default action is to write the <i class="arg">line</i> to the irc socket. However,
before this happens the callback is called with &quot;debug write&quot;. This
permits the application author to inspect the raw IRC data and if
desired to return a break error code to halt further processing. In
this way the application can override the default send via the
all raw output to the server is handled. The default action is to
write the <i class="arg">message</i> to the irc socket. However, before this
happens the callback is called with &quot;debug write&quot;. This permits the
application author to inspect the raw IRC data and if desired to
return a break error code to halt further processing. In this way the
application can override the default send via the callback procedure.</p></dd>
callback procedure.</p></dd>
</dl>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">CALLBACK</a></h2>
<p>The callback must look like:</p>
<pre class="doctools_example">
proc Callback {context state args} {
}




︙


228
229
230
231
232
233
234
235

236
237
238
239
240
241
242

219
220
221
222
223
224
225

226
227
228
229
230
231
232
233








-
+








<dd><p>called when a message arrives. <i class="arg">target</i> is the identity that the
message was targetted for. This can be the logged in nick or a channel
name. <i class="arg">nick</i> is the name of the sender of the message.
<i class="arg">message</i> is the message text. <i class="arg">type</i> is set to &quot;ACTION&quot; if the
message was sent as a CTCP ACTION. <i class="arg">type</i> is set to &quot;NOTICE&quot; if the
message was sent as a NOTICE command, in that case <i class="arg">target</i> is empty
if it matches current user nick or it's &quot;*&quot;, in later case empty
<i class="arg">nick</i> means that notice comes from server.</p></dd>
<i class="arg">target</i> means that notice comes from server.</p></dd>
<dt><b class="option">mode</b> <i class="arg">nick</i> <i class="arg">target</i> <i class="arg">flags</i></dt>
<dd><p>called when mode of user or channel changes. <i class="arg">nick</i> is the name
of the user who requested a change, can be empty if it's the server.
<i class="arg">target</i> is the identity that has its mode changed. <i class="arg">flags</i>
are the changes in mode.</p></dd>
<dt><b class="option">system</b> <i class="arg">channel</i> <i class="arg">message</i></dt>
<dd><p>called when a system message is received</p></dd>




︙





Changes to idoc/www/tcllib/files/modules/markdown/markdown.html.






︙


101
102
103
104
105
106
107
108

109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

127
128
129
130
131
132
133

101
102
103
104
105
106
107

108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

126
127
128
129
130
131
132
133








-
+

















-
+








&#124; <a href="../../../toc.html">Table Of Contents</a>
&#124; <a href="../../../../index.html">Keyword Index</a>
&#124; <a href="../../../../toc0.html">Categories</a>
&#124; <a href="../../../../toc1.html">Modules</a>
&#124; <a href="../../../../toc2.html">Applications</a>
 ] <hr>
<div class="doctools">
<h1 class="doctools_title">markdown(n) 1.2.1 tcllib &quot;Markdown to HTML Converter&quot;</h1>
<h1 class="doctools_title">markdown(n) 1.2.2 tcllib &quot;Markdown to HTML Converter&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>markdown - Converts Markdown text to HTML</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>
<li class="doctools_section"><a href="#section1">Description</a></li>
<li class="doctools_section"><a href="#section2">Supported markdown syntax</a></li>
<li class="doctools_section"><a href="#section3">Bugs, Ideas, Feedback</a></li>
<li class="doctools_section"><a href="#category">Category</a></li>
</ul>
</div>
<div id="synopsis" class="doctools_section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="doctools_synopsis">
<ul class="doctools_requirements">
<li>package require <b class="pkgname">Tcl 8.5</b></li>
<li>package require <b class="pkgname">Markdown 1.2.1</b></li>
<li>package require <b class="pkgname">Markdown 1.2.2</b></li>
<li>package require <b class="pkgname">textutil <span class="opt">?0.8?</span></b></li>
</ul>
<ul class="doctools_syntax">
<li><a href="#1"><b class="cmd">::Markdown::convert</b> <i class="arg">markdown</i></a></li>
<li><a href="#2"><b class="cmd">::Markdown::register</b> <i class="arg">langspec</i> <i class="arg">converter</i></a></li>
<li><a href="#3"><b class="cmd">::Markdown::get_lang_counter</b></a></li>
<li><a href="#4"><b class="cmd">::Markdown::reset_lang_counter</b></a></li>




︙





Changes to idoc/www/tcllib/files/modules/math/figurate.html.






︙


180
181
182
183
184
185
186
187



188
189
190
191
192
193
194

180
181
182
183
184
185
186

187
188
189
190
191
192
193
194
195
196








-
+
+
+








       *  *
       *  *  *
       *  *  *  *
       ...
</pre>
<p>The <b class="package">math::figurate</b> package consists of a collection of procedures to
evaluate a wide variety of figurate numbers. While all formulae are
straightforward, the details are sometimes puzzling.</p>
straightforward, the details are sometimes puzzling.
<em>Note:</em> The procedures consider arguments lower than zero as to mean &quot;no objects to be counted&quot;
and therefore return 0.</p>
</div>
<div id="section2" class="doctools_section"><h2><a name="section2">PROCEDURES</a></h2>
<p>The procedures can be arranged in a few categories: sums of integers raised to a
particular power, sums of odd integers and general figurate numbers, for
instance the pentagonal numbers.</p>
<dl class="doctools_definitions">
<dt><a name="1"><b class="cmd">::math::figurate::sum_sequence</b> <i class="arg">n</i></a></dt>




︙





Added idoc/www/tcllib/files/modules/mkdoc/mkdoc.html.










































































































































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

<!DOCTYPE html><html><head>
<title>mkdoc - Source code documentation using Markdown</title>
<style type="text/css"><!--
    HTML {
	background: 	#FFFFFF;
	color: 		black;
    }
    BODY {
	background: 	#FFFFFF;
	color:	 	black;
    }
    DIV.doctools {
	margin-left:	10%;
	margin-right:	10%;
    }
    DIV.doctools H1,DIV.doctools H2 {
	margin-left:	-5%;
    }
    H1, H2, H3, H4 {
	margin-top: 	1em;
	font-family:	sans-serif;
	font-size:	large;
	color:		#005A9C;
	background: 	transparent;
	text-align:		left;
    }
    H1.doctools_title {
	text-align: center;
    }
    UL,OL {
	margin-right: 0em;
	margin-top: 3pt;
	margin-bottom: 3pt;
    }
    UL LI {
	list-style: disc;
    }
    OL LI {
	list-style: decimal;
    }
    DT {
	padding-top: 	1ex;
    }
    UL.doctools_toc,UL.doctools_toc UL, UL.doctools_toc UL UL {
	font:		normal 12pt/14pt sans-serif;
	list-style:	none;
    }
    LI.doctools_section, LI.doctools_subsection {
	list-style: 	none;
	margin-left: 	0em;
	text-indent:	0em;
	padding: 	0em;
    }
    PRE {
	display: 	block;
	font-family:	monospace;
	white-space:	pre;
	margin:		0%;
	padding-top:	0.5ex;
	padding-bottom:	0.5ex;
	padding-left:	1ex;
	padding-right:	1ex;
	width:		100%;
    }
    PRE.doctools_example {
	color: 		black;
	background: 	#f5dcb3;
	border:		1px solid black;
    }
    UL.doctools_requirements LI, UL.doctools_syntax LI {
	list-style: 	none;
	margin-left: 	0em;
	text-indent:	0em;
	padding:	0em;
    }
    DIV.doctools_synopsis {
	color: 		black;
	background: 	#80ffff;
	border:		1px solid black;
	font-family:	serif;
	margin-top: 	1em;
	margin-bottom: 	1em;
    }
    UL.doctools_syntax {
	margin-top: 	1em;
	border-top:	1px solid black;
    }
    UL.doctools_requirements {
	margin-bottom: 	1em;
	border-bottom:	1px solid black;
    }
--></style>
</head>
<!-- Generated from file 'mkdoc.man' by tcllib/doctools with format 'html'
   -->
<!-- Copyright &amp;copy; 2019-2022, Detlef Groth &amp;lt;detlef(at)dgroth(dot)de&amp;gt;
   -->
<!-- mkdoc.n
   -->
<body><hr> [
   <a href="../../../../../../../../home">Tcllib Home</a>
&#124; <a href="../../../../toc.html">Main Table Of Contents</a>
&#124; <a href="../../../toc.html">Table Of Contents</a>
&#124; <a href="../../../../index.html">Keyword Index</a>
&#124; <a href="../../../../toc0.html">Categories</a>
&#124; <a href="../../../../toc1.html">Modules</a>
&#124; <a href="../../../../toc2.html">Applications</a>
 ] <hr>
<div class="doctools">
<h1 class="doctools_title">mkdoc(n) 0.7.0 tcllib &quot;Source code documentation using Markdown&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>mkdoc - Extracts and optionally converts Markdown comments in source code to HTML</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>
<li class="doctools_section"><a href="#section1">Description</a></li>
<li class="doctools_section"><a href="#section2">Examples</a></li>
<li class="doctools_section"><a href="#section3">Formatting</a></li>
<li class="doctools_section"><a href="#section4">Bugs, Ideas, Feedback</a></li>
<li class="doctools_section"><a href="#section5">Code Copyright</a></li>
<li class="doctools_section"><a href="#category">Category</a></li>
<li class="doctools_section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="synopsis" class="doctools_section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="doctools_synopsis">
<ul class="doctools_requirements">
<li>package require <b class="pkgname">Tcl 8.6</b></li>
<li>package require <b class="pkgname">Markdown <span class="opt">?1.2.1?</span></b></li>
<li>package require <b class="pkgname">yaml <span class="opt">?0.4.1?</span></b></li>
<li>package require <b class="pkgname">mkdoc <span class="opt">?0.7.0?</span></b></li>
<li>package require <b class="pkgname">hook</b></li>
</ul>
<ul class="doctools_syntax">
<li><a href="#1"><b class="cmd">::mkdoc::mkdoc</b> <i class="arg">infile</i> <i class="arg">outfile</i> <span class="opt">?<b class="option">-css</b> <i class="arg">cssfile</i>?</span></a></li>
<li><a href="#2"><b class="cmd">::mkdoc::run</b> <i class="arg">infile</i></a></li>
</ul>
</div>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>The package <b class="package">mkdoc</b> provides a command to extract documentation embedded in code
and optionally convert these comments into HTML.
The latter uses Tcllib's <b class="package"><a href="../markdown/markdown.html">Markdown</a></b> package.
Each line of the embedded documentation begins with the special comment marker
<b class="const">#'</b>.</p>
<dl class="doctools_definitions">
<dt><a name="1"><b class="cmd">::mkdoc::mkdoc</b> <i class="arg">infile</i> <i class="arg">outfile</i> <span class="opt">?<b class="option">-css</b> <i class="arg">cssfile</i>?</span></a></dt>
<dd><p>The command reads the specified <i class="arg">infile</i> and extracts the code comments introduced by
the <b class="const"> #'</b> marker.  If the <i class="arg">outfile</i> is either a &quot;<b class="file">.html</b>&quot; or &quot;<b class="file">.htm</b>&quot;
file the Markdown is converted into HTML using either a default style or the specified
style sheet <i class="arg">cssfile</i>.</p>
<p>All arguments are paths to the files to read from or write to.</p>
<p>The result of the command is the empty string.</p>
<p>See section <span class="sectref"><a href="#section3">Formatting</a></span> for the supported Markdown syntax and extensions
to it.</p></dd>
<dt><a name="2"><b class="cmd">::mkdoc::run</b> <i class="arg">infile</i></a></dt>
<dd><p>The command reads the specified <i class="arg">infile</i>, extracts the embedded documentation, and
then executes the contents of the first example, i.e. <b class="const">```</b>-quoted block, found in
the <b class="const">Example</b> section.</p>
<p>Here is such an example which will be executed by the Tcl interpreter</p>
<pre class="doctools_example">
    #' ## &lt;a name=&quot;example&quot;&gt;Example&lt;/a&gt;
    #' 
    #' ```
    #' puts &quot;Hello mkdoc package&quot;
    #' puts &quot;I am in the example section&quot;
    #' ```
</pre>
<p><em>DANGER, BEWARE</em>.
Failing to open the <i class="arg">infile</i> causes the command to <em>exit</em> the entire process.</p>
<p>Use of this command in a general context is not recommended.</p></dd>
</dl>
</div>
<div id="section2" class="doctools_section"><h2><a name="section2">Examples</a></h2>
<p>The example below demonstrates the conversion of the documentation embedded into the file
&quot;<b class="file">mkdoc.tcl</b>&quot; itself:</p>
<pre class="doctools_example">
    package require mkdoc
    # extracting the Markdown
    mkdoc::mkdoc mkdoc.tcl mkdoc.md
    # converting Markdown to HTML
    mkdoc::mkdoc mkdoc.md mkdoc.html
    # direct conversion without intermediate file
    mkdoc::mkdoc mkdoc.tcl mkdoc.html
</pre>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">Formatting</a></h2>
<p>The package supports the syntax supported by Tcllib's <b class="package"><a href="../markdown/markdown.html">Markdown</a></b> package.</p>
<p>It further supports a set of simple YAML headers whose information is inserted into
appropriate HTML <b class="const">meta</b>-tags. The supported keys are</p>
<dl class="doctools_definitions">
<dt><b class="const">author</b></dt>
<dd><p>Set the document author. Defaults to <b class="const">NN</b>.</p></dd>
<dt><b class="const">title</b></dt>
<dd><p>Set the document title. Defaults to <b class="const">Documentation </b><b class="variable">filename</b>].</p></dd>
<dt><b class="const">date</b></dt>
<dd><p>Sets the document date. Defaults to the current day.</p></dd>
<dt><b class="const">css</b></dt>
<dd><p>Sets a custom CSS stylesheet. Defaults to the internal mkdoc sheet.</p></dd>
</dl>
<p><em>Note</em> that in Markdown output mode these headers are simply passed through
into the result. This is proper, as processors like <b class="syscmd">pandoc</b> are able to use them
as well.</p>
<p>See the example below for the syntax:</p>
<pre class="doctools_example">
    #' ---
    #' title: mkdoc::mkdoc 0.7.0
    #' author: Detlef Groth, Schwielowsee, Germany
    #' date: 2022-04-17 
    #' css: mini.css 
    #' ---
    #'
</pre>
<p>Another extension over standard Markdown is the support of a single level of includes.</p>
<p>See the example below for the syntax:</p>
<pre class="doctools_example">
    #' #include &quot;path/to/include/file&quot;
</pre>
<p><em>Note</em>, the double-quotes around the path are part of the syntax.</p>
<p><em>Beware</em> further that relative paths are resolved relative to the current
working directory, and <em>not</em> relative to the location of the including file.</p>
</div>
<div id="section4" class="doctools_section"><h2><a name="section4">Bugs, Ideas, Feedback</a></h2>
<p>This document, and the package it describes, will undoubtedly contain bugs and other
problems. Please report such to the author of this package. Please also report any ideas
for enhancements you may have for either package and/or documentation.</p>
</div>
<div id="section5" class="doctools_section"><h2><a name="section5">Code Copyright</a></h2>
<p>BSD License type:</p>
<p>The following terms apply to all files a ssociated with the software unless
explicitly disclaimed in individual files.</p>
<p>The authors hereby grant permission to use, copy, modify, distribute, and license
this software and its documentation for any purpose, provided that existing copyright
notices are retained in all copies and that this notice is included verbatim in any
distributions. No written agreement, license, or royalty fee is required for any of the
authorized uses.  Modifications to this software may be copyrighted by their authors and
need not follow the licensing terms described here, provided that the new terms are
clearly indicated on the first page of each file where they apply.</p>
<p>In no event shall the authors or distributors be liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use of this
software, its documentation, or any derivatives thereof, even if the authors have been
advised of the possibility of such damage.</p>
<p>The authors and distributors specifically disclaim any warranties, including, but
not limited to, the implied warranties of merchantability, fitness for a particular
purpose, and non-infringement.
This software is provided on an &quot;as is&quot; basis, and the authors and distributors have no
obligation to provide maintenance, support, updates, enhancements, or modifications.</p>
<p><em>RESTRICTED RIGHTS</em>: Use, duplication or disclosure by the government is
subject to the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in
Technical Data and Computer Software Clause as DFARS 252.227-7013 and FAR 52.227-19.</p>
</div>
<div id="category" class="doctools_section"><h2><a name="category">Category</a></h2>
<p>Text processing</p>
</div>
<div id="copyright" class="doctools_section"><h2><a name="copyright">Copyright</a></h2>
<p>Copyright &copy; 2019-2022, Detlef Groth &lt;detlef(at)dgroth(dot)de&gt;</p>
</div>
</div></body></html>






Changes to idoc/www/tcllib/files/modules/rest/rest.html.






︙


101
102
103
104
105
106
107
108

109
110
111
112
113
114
115

101
102
103
104
105
106
107

108
109
110
111
112
113
114
115








-
+








&#124; <a href="../../../toc.html">Table Of Contents</a>
&#124; <a href="../../../../index.html">Keyword Index</a>
&#124; <a href="../../../../toc0.html">Categories</a>
&#124; <a href="../../../../toc1.html">Modules</a>
&#124; <a href="../../../../toc2.html">Applications</a>
 ] <hr>
<div class="doctools">
<h1 class="doctools_title">rest(n) 1.4 tcllib &quot;A framework for RESTful web services&quot;</h1>
<h1 class="doctools_title">rest(n) 1.5 tcllib &quot;A framework for RESTful web services&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>rest - define REST web APIs and call them inline or asychronously</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>




︙


123
124
125
126
127
128
129
130

131
132
133
134
135
136
137

123
124
125
126
127
128
129

130
131
132
133
134
135
136
137








-
+








<li class="doctools_section"><a href="#section8">Bugs, Ideas, Feedback</a></li>
</ul>
</div>
<div id="synopsis" class="doctools_section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="doctools_synopsis">
<ul class="doctools_requirements">
<li>package require <b class="pkgname">Tcl 8.5</b></li>
<li>package require <b class="pkgname">rest <span class="opt">?1.4?</span></b></li>
<li>package require <b class="pkgname">rest <span class="opt">?1.5?</span></b></li>
</ul>
<ul class="doctools_syntax">
<li><a href="#1"><b class="cmd">::rest::simple</b> <i class="arg">url</i> <i class="arg">query</i> <span class="opt">?<i class="arg">config</i>?</span> <span class="opt">?<i class="arg">body</i>?</span></a></li>
<li><a href="#2"><b class="cmd">::rest::get</b> <i class="arg">url</i> <i class="arg">query</i> <span class="opt">?<i class="arg">config</i>?</span> <span class="opt">?<i class="arg">body</i>?</span></a></li>
<li><a href="#3"><b class="cmd">::rest::post</b> <i class="arg">url</i> <i class="arg">query</i> <span class="opt">?<i class="arg">config</i>?</span> <span class="opt">?<i class="arg">body</i>?</span></a></li>
<li><a href="#4"><b class="cmd">::rest::patch</b> <i class="arg">url</i> <i class="arg">query</i> <span class="opt">?<i class="arg">config</i>?</span> <span class="opt">?<i class="arg">body</i>?</span></a></li>
<li><a href="#5"><b class="cmd">::rest::head</b> <i class="arg">url</i> <i class="arg">query</i> <span class="opt">?<i class="arg">config</i>?</span> <span class="opt">?<i class="arg">body</i>?</span></a></li>




︙


371
372
373
374
375
376
377



378
379
380
381
382
383
384

371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387








+
+
+








No authentication is done if the option is not specified.</p>
<dl class="doctools_definitions">
<dt><b class="const">basic</b></dt>
<dd><p>The user may configure the <i class="term">basic authentication</i> by overriding
the procedure <b class="cmd">basic_auth</b> in the namespace of interface. This
procedure takes two arguments, the username and password, in this
order.</p></dd>
<dt><b class="const">bearer</b></dt>
<dd><p>The user may configure a bearer token as authentication. The value is
the token passed to the HTTP authorization header.</p></dd>
<dt><b class="const">sign</b></dt>
<dd><p>The value must actually be a list with the second element the name of
a procedure which will be called to perform request signing.</p></dd>
</dl></dd>
<dt><b class="const">callback</b></dt>
<dd><p>If this option is present then the method will be created as an
<i class="term">async</i> call. Such calls will return immediately with the value




︙





Changes to idoc/www/tcllib/files/modules/struct/struct_list.html.






︙


103
104
105
106
107
108
109
110

111
112
113
114
115
116
117

103
104
105
106
107
108
109

110
111
112
113
114
115
116
117








-
+








&#124; <a href="../../../toc.html">Table Of Contents</a>
&#124; <a href="../../../../index.html">Keyword Index</a>
&#124; <a href="../../../../toc0.html">Categories</a>
&#124; <a href="../../../../toc1.html">Modules</a>
&#124; <a href="../../../../toc2.html">Applications</a>
 ] <hr>
<div class="doctools">
<h1 class="doctools_title">struct::list(n) 1.8.4 tcllib &quot;Tcl Data Structures&quot;</h1>
<h1 class="doctools_title">struct::list(n) 1.8.5 tcllib &quot;Tcl Data Structures&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>struct::list - Procedures for manipulating lists</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>




︙


126
127
128
129
130
131
132
133

134
135
136
137
138
139
140

126
127
128
129
130
131
132

133
134
135
136
137
138
139
140








-
+








<li class="doctools_section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="synopsis" class="doctools_section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="doctools_synopsis">
<ul class="doctools_requirements">
<li>package require <b class="pkgname">Tcl 8.4</b></li>
<li>package require <b class="pkgname">struct::list <span class="opt">?1.8.4?</span></b></li>
<li>package require <b class="pkgname">struct::list <span class="opt">?1.8.5?</span></b></li>
</ul>
<ul class="doctools_syntax">
<li><a href="#1"><b class="cmd">::struct::list</b> <b class="method">longestCommonSubsequence</b> <i class="arg">sequence1</i> <i class="arg">sequence2</i> <span class="opt">?<i class="arg">maxOccurs</i>?</span></a></li>
<li><a href="#2"><b class="cmd">::struct::list</b> <b class="method">longestCommonSubsequence2</b> <i class="arg">sequence1 sequence2</i> <span class="opt">?<i class="arg">maxOccurs</i>?</span></a></li>
<li><a href="#3"><b class="cmd">::struct::list</b> <b class="method">lcsInvert</b> <i class="arg">lcsData</i> <i class="arg">len1</i> <i class="arg">len2</i></a></li>
<li><a href="#4"><b class="cmd">::struct::list</b> <b class="method">lcsInvert2</b> <i class="arg">lcs1</i> <i class="arg">lcs2</i> <i class="arg">len1</i> <i class="arg">len2</i></a></li>
<li><a href="#5"><b class="cmd">::struct::list</b> <b class="method">lcsInvertMerge</b> <i class="arg">lcsData</i> <i class="arg">len1</i> <i class="arg">len2</i></a></li>




︙





Changes to idoc/www/tcllib/files/modules/tar/tar.html.






︙


110
111
112
113
114
115
116
117



118
119
120
121
122
123
124

110
111
112
113
114
115
116

117
118
119
120
121
122
123
124
125
126








-
+
+
+








<p>tar - Tar file creation, extraction &amp; manipulation</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>
<li class="doctools_section"><a href="#section1">Description</a></li>
<li class="doctools_section"><a href="#section2">Bugs, Ideas, Feedback</a></li>
<li class="doctools_section"><a href="#section2">BEWARE</a></li>
<li class="doctools_section"><a href="#section3">COMMANDS</a></li>
<li class="doctools_section"><a href="#section4">Bugs, Ideas, Feedback</a></li>
<li class="doctools_section"><a href="#keywords">Keywords</a></li>
<li class="doctools_section"><a href="#category">Category</a></li>
</ul>
</div>
<div id="synopsis" class="doctools_section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="doctools_synopsis">
<ul class="doctools_requirements">




︙


133
134
135
136
137
138
139
140
141
142


























143
144
145
146
147
148
149

135
136
137
138
139
140
141



142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174








-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+








<li><a href="#5"><b class="cmd">::tar::create</b> <i class="arg">tarball</i> <i class="arg">files</i> <i class="arg">args</i></a></li>
<li><a href="#6"><b class="cmd">::tar::add</b> <i class="arg">tarball</i> <i class="arg">files</i> <i class="arg">args</i></a></li>
<li><a href="#7"><b class="cmd">::tar::remove</b> <i class="arg">tarball</i> <i class="arg">files</i></a></li>
</ul>
</div>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>Note: Starting with version 0.8 the tar reader commands
(contents, stats, get, untar) support the GNU LongName extension
(header type 'L') for large paths.</p>
<p><em>Note</em>: Starting with version 0.8 the tar reader commands
(contents, stats, get, untar) support the GNU LongName extension (header type
'L') for large paths.</p>
</div>
<div id="section2" class="doctools_section"><h2><a name="section2">BEWARE</a></h2>
<p>For all commands, when using <b class="option">-chan</b> ...</p>
<ol class="doctools_enumerated">
<li><p>It is assumed that the channel was opened for reading, and configured for
       binary input.</p></li>
<li><p>It is assumed that the channel position is at the beginning of a legal
       tar file.</p></li>
<li><p>The commands will <em>modify</em> the channel position as they perform their
       task.</p></li>
<li><p>The commands will <em>not</em> close the channel.</p></li>
<li><p>In other words, the commands leave the channel in a state very likely
       unsuitable for use by further <b class="cmd">tar</b> commands. Still doing so will
       very likely results in errors, bad data, etc. pp.</p></li>
<li><p>It is the responsibility of the user to seek the channel back to a
       suitable position.</p></li>
<li><p>When using a channel transformation which is not generally seekable, for
       example <b class="cmd">gunzip</b>, then it is the responsibility of the user to (a)
       unstack the transformation before seeking the channel back to a suitable
       position, and (b) for restacking it after.</p></li>
</ol>
</div>
<div id="section3" class="doctools_section"><h2><a name="section3">COMMANDS</a></h2>
<dl class="doctools_definitions">
<dt><a name="1"><b class="cmd">::tar::contents</b> <i class="arg">tarball</i> <span class="opt">?<b class="option">-chan</b>?</span></a></dt>
<dd><p>Returns a list of the files contained in <i class="arg">tarball</i>. The order is not sorted and depends on the order
files were stored in the archive.</p>
<p>If the option <b class="option">-chan</b> is present <i class="arg">tarball</i> is interpreted as an open channel.
It is assumed that the channel was opened for reading, and configured for binary input.
The command will <em>not</em> close the channel.</p></dd>




︙


250
251
252
253
254
255
256
257

258
259
260
261
262
263
264

275
276
277
278
279
280
281

282
283
284
285
286
287
288
289








-
+








% ::tar::remove new.tar {file2 file3}
% ::tar::contents new.tar
file3
</pre>
</dd>
</dl>
</div>
<div id="section2" class="doctools_section"><h2><a name="section2">Bugs, Ideas, Feedback</a></h2>
<div id="section4" class="doctools_section"><h2><a name="section4">Bugs, Ideas, Feedback</a></h2>
<p>This document, and the package it describes, will undoubtedly contain
bugs and other problems.
Please report such in the category <em>tar</em> of the
<a href="http://core.tcl.tk/tcllib/reportlist">Tcllib Trackers</a>.
Please also report any ideas for enhancements you may have for either
package and/or documentation.</p>
<p>When proposing code changes, please provide <em>unified diffs</em>,




︙





Changes to idoc/www/tcllib/files/modules/websocket/websocket.html.






︙


101
102
103
104
105
106
107
108

109
110
111
112
113
114
115

101
102
103
104
105
106
107

108
109
110
111
112
113
114
115








-
+








&#124; <a href="../../../toc.html">Table Of Contents</a>
&#124; <a href="../../../../index.html">Keyword Index</a>
&#124; <a href="../../../../toc0.html">Categories</a>
&#124; <a href="../../../../toc1.html">Modules</a>
&#124; <a href="../../../../toc2.html">Applications</a>
 ] <hr>
<div class="doctools">
<h1 class="doctools_title">websocket(n) 1.3.1 tcllib &quot;websocket client and server&quot;</h1>
<h1 class="doctools_title">websocket(n) 1.4.2 tcllib &quot;websocket client and server&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>websocket - Tcl implementation of the websocket protocol</p>
</div>
<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="doctools_toc">
<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
<li class="doctools_section"><a href="#synopsis">Synopsis</a></li>




︙


128
129
130
131
132
133
134
135

136
137
138
139
140
141
142

128
129
130
131
132
133
134

135
136
137
138
139
140
141
142








-
+








<div class="doctools_synopsis">
<ul class="doctools_requirements">
<li>package require <b class="pkgname">Tcl 8.4</b></li>
<li>package require <b class="pkgname">http 2.7</b></li>
<li>package require <b class="pkgname">logger</b></li>
<li>package require <b class="pkgname">sha1</b></li>
<li>package require <b class="pkgname">base64</b></li>
<li>package require <b class="pkgname">websocket <span class="opt">?1.3.1?</span></b></li>
<li>package require <b class="pkgname">websocket <span class="opt">?1.4.2?</span></b></li>
</ul>
<ul class="doctools_syntax">
<li><a href="#1"><b class="cmd">::websocket::open</b> <i class="arg">url</i> <i class="arg">handler</i> <span class="opt">?<i class="arg">options</i>?</span></a></li>
<li><a href="#2"><b class="cmd">::websocket::send</b> <i class="arg">sock</i> <i class="arg">type</i> <span class="opt">?<i class="arg">msg</i>?</span> <span class="opt">?<i class="arg">final</i>?</span></a></li>
<li><a href="#3"><b class="cmd">::websocket::server</b> <i class="arg">sock</i></a></li>
<li><a href="#4"><b class="cmd">::websocket::live</b> <i class="arg">sock</i> <i class="arg">path</i> <i class="arg">cb</i> <span class="opt">?<i class="arg">proto</i>?</span></a></li>
<li><a href="#5"><b class="cmd">::websocket::test</b> <i class="arg">srvSock</i> <i class="arg">cliSock</i> <i class="arg">path</i> <span class="opt">?<i class="arg">hdrs</i>?</span> <span class="opt">?<i class="arg">qry</i>?</span></a></li>




︙





Changes to idoc/www/tcllib/toc.html.






︙


453
454
455
456
457
458
459
460
461
462
463
464
465
466
467

468
469
470
471

472
473
474
475

476
477
478
479

480
481
482
483

484
485
486
487

488
489
490
491

492
493
494
495

496
497
498
499

500
501
502
503

504
505
506
507

508
509
510
511

512
513
514
515

516
517
518
519

520
521
522
523

524
525
526
527

528
529
530
531

532
533
534
535

536
537
538
539

540
541
542
543

544
545
546
547

548
549
550
551

552
553
554
555

556
557
558
559

560
561
562
563

564
565
566
567

568
569
570
571

572
573
574
575

576
577
578
579

580
581
582
583

584
585
586
587

588
589
590
591

592
593
594
595

596
597
598
599

600
601
602
603

604
605
606
607

608
609
610
611

612
613
614
615

616
617
618
619

620
621
622
623

624
625
626
627

628
629
630
631

632
633
634
635

636
637
638
639

640
641
642
643

644
645
646
647

648
649
650
651

652
653
654
655

656
657
658
659

660
661
662
663

664
665
666
667

668
669
670
671

672
673
674
675

676
677
678
679

680
681
682
683

684
685
686
687

688
689
690
691

692
693
694
695

696
697
698
699

700
701
702
703

704
705
706
707

708
709
710
711

712
713
714
715

716
717
718
719

720
721
722
723

724
725
726
727

728
729
730
731

732
733
734
735

736
737
738
739

740
741
742
743

744
745
746
747

748
749
750
751

752
753
754
755

756
757
758
759

760
761
762
763

764
765
766
767

768
769
770
771

772
773
774
775

776
777
778
779

780
781
782
783

784
785
786
787

788
789
790
791

792
793
794
795

796
797
798
799

800
801
802
803

804
805
806
807

808
809
810
811

812
813
814
815

816
817
818
819

820
821
822
823

824
825
826
827

828
829
830




831




832
833
834
835

836
837
838
839

840
841
842
843

844
845
846
847

848
849
850
851

852
853
854
855

856
857
858
859

860
861
862
863

864
865
866
867

868
869
870
871

872
873
874
875

876
877
878
879

880
881
882
883

884
885
886
887

888
889
890
891

892
893
894
895

896
897
898
899

900
901
902
903

904
905
906
907

908
909
910
911

912
913
914
915

916
917
918
919

920
921
922
923

924
925
926
927

928
929
930
931

932
933
934
935

936
937
938
939

940
941
942
943

944
945
946
947

948
949
950
951

952
953
954




955
956
957
958
959
960
961

453
454
455
456
457
458
459




460
461
462

463
464
465
466

467
468
469
470

471
472
473
474

475
476
477
478

479
480
481
482

483
484
485
486

487
488
489
490

491
492
493
494

495
496
497
498

499
500
501
502

503
504
505
506

507
508
509
510

511
512
513
514

515
516
517
518

519
520
521
522

523
524
525
526

527
528
529
530

531
532
533
534

535
536
537
538

539
540
541
542

543
544
545
546

547
548
549
550

551
552
553
554

555
556
557
558

559
560
561
562

563
564
565
566

567
568
569
570

571
572
573
574

575
576
577
578

579
580
581
582

583
584
585
586

587
588
589
590

591
592
593
594

595
596
597
598

599
600
601
602

603
604
605
606

607
608
609
610

611
612
613
614

615
616
617
618

619
620
621
622

623
624
625
626

627
628
629
630

631
632
633
634

635
636
637
638

639
640
641
642

643
644
645
646

647
648
649
650

651
652
653
654

655
656
657
658

659
660
661
662

663
664
665
666

667
668
669
670

671
672
673
674

675
676
677
678

679
680
681
682

683
684
685
686

687
688
689
690

691
692
693
694

695
696
697
698

699
700
701
702

703
704
705
706

707
708
709
710

711
712
713
714

715
716
717
718

719
720
721
722

723
724
725
726

727
728
729
730

731
732
733
734

735
736
737
738

739
740
741
742

743
744
745
746

747
748
749
750

751
752
753
754

755
756
757
758

759
760
761
762

763
764
765
766

767
768
769
770

771
772
773
774

775
776
777
778

779
780
781
782

783
784
785
786

787
788
789
790

791
792
793
794

795
796
797
798

799
800
801
802

803
804
805
806

807
808
809
810

811
812
813
814

815
816
817
818

819
820
821
822

823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838

839
840
841
842

843
844
845
846

847
848
849
850

851
852
853
854

855
856
857
858

859
860
861
862

863
864
865
866

867
868
869
870

871
872
873
874

875
876
877
878

879
880
881
882

883
884
885
886

887
888
889
890

891
892
893
894

895
896
897
898

899
900
901
902

903
904
905
906

907
908
909
910

911
912
913
914

915
916
917
918

919
920
921
922

923
924
925
926

927
928
929
930

931
932
933
934

935
936
937
938

939
940
941
942

943
944
945
946

947
948
949
950

951
952
953
954

955
956
957
958
959
960
961
962
963
964
965
966
967
968
969








-
-
-
-



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



+
+
+
+

+
+
+
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



-
+



+
+
+
+








<td class="#doctools_tocright">doctools plugin API reference</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="files/apps/dtplite.html">dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="files/modules/dtplite/pkg_dtplite.html">dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='fileutil'><a href="files/modules/fileutil/fileutil.html">fileutil</a></td>
<td class="#doctools_tocright">Procedures implementing some file utilities</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='fileutil_magic_cfront'><a href="files/modules/fumagic/cfront.html">fileutil::magic::cfront</a></td>
<td class="#doctools_tocright">Generator core for compiler of magic(5) files</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='fileutil_magic_cgen'><a href="files/modules/fumagic/cgen.html">fileutil::magic::cgen</a></td>
<td class="#doctools_tocright">Generator core for compiler of magic(5) files</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='fileutil_magic_filetype'><a href="files/modules/fumagic/filetypes.html">fileutil::magic::filetype</a></td>
<td class="#doctools_tocright">Procedures implementing file-type recognition</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='fileutil_magic_rt'><a href="files/modules/fumagic/rtcore.html">fileutil::magic::rt</a></td>
<td class="#doctools_tocright">Runtime core for file type recognition engines written in pure Tcl</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='fileutil_multi'><a href="files/modules/fileutil/multi.html">fileutil::multi</a></td>
<td class="#doctools_tocright">Multi-file operation, scatter/gather, standard object</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='fileutil_multi_op'><a href="files/modules/fileutil/multiop.html">fileutil::multi::op</a></td>
<td class="#doctools_tocright">Multi-file operation, scatter/gather</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='fileutil_paths'><a href="files/modules/fileutil/paths.html">fileutil::paths</a></td>
<td class="#doctools_tocright">Manage search path pools</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='fileutil_traverse'><a href="files/modules/fileutil/traverse.html">fileutil_traverse</a></td>
<td class="#doctools_tocright">Iterative directory traversal</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='ftp'><a href="files/modules/ftp/ftp.html">ftp</a></td>
<td class="#doctools_tocright">Client-side tcl implementation of the ftp protocol</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='ftp_geturl'><a href="files/modules/ftp/ftp_geturl.html">ftp::geturl</a></td>
<td class="#doctools_tocright">Uri handler for ftp urls</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='ftpd'><a href="files/modules/ftpd/ftpd.html">ftpd</a></td>
<td class="#doctools_tocright">Tcl FTP server implementation</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='generator'><a href="files/modules/generator/generator.html">generator</a></td>
<td class="#doctools_tocright">Procedures for creating and using generators.</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='gpx'><a href="files/modules/gpx/gpx.html">gpx</a></td>
<td class="#doctools_tocright">Extracts waypoints, tracks and routes from GPX files</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='grammar_aycock'><a href="files/modules/grammar_aycock/aycock.html">grammar::aycock</a></td>
<td class="#doctools_tocright">Aycock-Horspool-Earley parser generator for Tcl</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='grammar_fa'><a href="files/modules/grammar_fa/fa.html">grammar::fa</a></td>
<td class="#doctools_tocright">Create and manipulate finite automatons</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='grammar_fa_dacceptor'><a href="files/modules/grammar_fa/dacceptor.html">grammar::fa::dacceptor</a></td>
<td class="#doctools_tocright">Create and use deterministic acceptors</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='grammar_fa_dexec'><a href="files/modules/grammar_fa/dexec.html">grammar::fa::dexec</a></td>
<td class="#doctools_tocright">Execute deterministic finite automatons</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='grammar_fa_op'><a href="files/modules/grammar_fa/faop.html">grammar::fa::op</a></td>
<td class="#doctools_tocright">Operations on finite automatons</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='grammar_me_cpu'><a href="files/modules/grammar_me/me_cpu.html">grammar::me::cpu</a></td>
<td class="#doctools_tocright">Virtual machine implementation II for parsing token streams</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='grammar_me_cpu_core'><a href="files/modules/grammar_me/me_cpucore.html">grammar::me::cpu::core</a></td>
<td class="#doctools_tocright">ME virtual machine state manipulation</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='grammar_me_cpu_gasm'><a href="files/modules/grammar_me/gasm.html">grammar::me::cpu::gasm</a></td>
<td class="#doctools_tocright">ME assembler</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='grammar_me_tcl'><a href="files/modules/grammar_me/me_tcl.html">grammar::me::tcl</a></td>
<td class="#doctools_tocright">Virtual machine implementation I for parsing token streams</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='grammar_me_util'><a href="files/modules/grammar_me/me_util.html">grammar::me::util</a></td>
<td class="#doctools_tocright">AST utilities</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='grammar_me_ast'><a href="files/modules/grammar_me/me_ast.html">grammar::me_ast</a></td>
<td class="#doctools_tocright">Various representations of ASTs</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='grammar_me_intro'><a href="files/modules/grammar_me/me_intro.html">grammar::me_intro</a></td>
<td class="#doctools_tocright">Introduction to virtual machines for parsing token streams</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='grammar_me_vm'><a href="files/modules/grammar_me/me_vm.html">grammar::me_vm</a></td>
<td class="#doctools_tocright">Virtual machine for parsing token streams</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='grammar_peg'><a href="files/modules/grammar_peg/peg.html">grammar::peg</a></td>
<td class="#doctools_tocright">Create and manipulate parsing expression grammars</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='grammar_peg_interp'><a href="files/modules/grammar_peg/peg_interp.html">grammar::peg::interp</a></td>
<td class="#doctools_tocright">Interpreter for parsing expression grammars</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='hook'><a href="files/modules/hook/hook.html">hook</a></td>
<td class="#doctools_tocright">Hooks</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='html'><a href="files/modules/html/html.html">html</a></td>
<td class="#doctools_tocright">Procedures to generate HTML structures</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='htmlparse'><a href="files/modules/htmlparse/htmlparse.html">htmlparse</a></td>
<td class="#doctools_tocright">Procedures to parse HTML strings</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='httpd'><a href="files/modules/httpd/httpd.html">httpd</a></td>
<td class="#doctools_tocright">A TclOO and coroutine based web server</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='huddle'><a href="files/modules/yaml/huddle.html">huddle</a></td>
<td class="#doctools_tocright">Create and manipulate huddle object</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='ident'><a href="files/modules/ident/ident.html">ident</a></td>
<td class="#doctools_tocright">Ident protocol client</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='imap4'><a href="files/modules/imap4/imap4.html">imap4</a></td>
<td class="#doctools_tocright">imap client-side tcl implementation of imap protocol</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='inifile'><a href="files/modules/inifile/ini.html">inifile</a></td>
<td class="#doctools_tocright">Parsing of Windows INI files</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='interp'><a href="files/modules/interp/tcllib_interp.html">interp</a></td>
<td class="#doctools_tocright">Interp creation and aliasing</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='irc'><a href="files/modules/irc/irc.html">irc</a></td>
<td class="#doctools_tocright">Create IRC connection and interface.</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='javascript'><a href="files/modules/javascript/javascript.html">javascript</a></td>
<td class="#doctools_tocright">Procedures to generate HTML and Java Script structures.</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='jpeg'><a href="files/modules/jpeg/jpeg.html">jpeg</a></td>
<td class="#doctools_tocright">JPEG querying and manipulation of meta data</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='json'><a href="files/modules/json/json.html">json</a></td>
<td class="#doctools_tocright">JSON parser</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='json_write'><a href="files/modules/json/json_write.html">json::write</a></td>
<td class="#doctools_tocright">JSON generation</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='lambda'><a href="files/modules/lambda/lambda.html">lambda</a></td>
<td class="#doctools_tocright">Utility commands for anonymous procedures</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='lazyset'><a href="files/modules/lazyset/lazyset.html">lazyset</a></td>
<td class="#doctools_tocright">Lazy evaluation</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='ldap'><a href="files/modules/ldap/ldap.html">ldap</a></td>
<td class="#doctools_tocright">LDAP client</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='ldapx'><a href="files/modules/ldap/ldapx.html">ldapx</a></td>
<td class="#doctools_tocright">LDAP extended object interface</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='log'><a href="files/modules/log/log.html">log</a></td>
<td class="#doctools_tocright">Procedures to log messages of libraries and applications.</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='logger'><a href="files/modules/log/logger.html">logger</a></td>
<td class="#doctools_tocright">System to control logging of events.</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='logger_appender'><a href="files/modules/log/loggerAppender.html">logger::appender</a></td>
<td class="#doctools_tocright">Collection of predefined appenders for logger</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='logger_utils'><a href="files/modules/log/loggerUtils.html">logger::utils</a></td>
<td class="#doctools_tocright">Utilities for logger</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='map_geocode_nominatim'><a href="files/modules/map/map_geocode_nominatim.html">map::geocode::nominatim</a></td>
<td class="#doctools_tocright">Resolving geographical names with a Nominatim service</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='map_slippy'><a href="files/modules/map/map_slippy.html">map::slippy</a></td>
<td class="#doctools_tocright">Common code for slippy based map packages</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='map_slippy_cache'><a href="files/modules/map/map_slippy_cache.html">map::slippy::cache</a></td>
<td class="#doctools_tocright">Management of a tile cache in the local filesystem</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='map_slippy_fetcher'><a href="files/modules/map/map_slippy_fetcher.html">map::slippy::fetcher</a></td>
<td class="#doctools_tocright">Accessing a server providing tiles for slippy-based maps</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mapproj'><a href="files/modules/mapproj/mapproj.html">mapproj</a></td>
<td class="#doctools_tocright">Map projection routines</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='markdown'><a href="files/modules/markdown/markdown.html">markdown</a></td>
<td class="#doctools_tocright">Converts Markdown text to HTML</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math'><a href="files/modules/math/math.html">math</a></td>
<td class="#doctools_tocright">Tcl Math Library</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_bigfloat'><a href="files/modules/math/bigfloat.html">math::bigfloat</a></td>
<td class="#doctools_tocright">Arbitrary precision floating-point numbers</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_bignum'><a href="files/modules/math/bignum.html">math::bignum</a></td>
<td class="#doctools_tocright">Arbitrary precision integer numbers</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_calculus'><a href="files/modules/math/calculus.html">math::calculus</a></td>
<td class="#doctools_tocright">Integration and ordinary differential equations</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_calculus_romberg'><a href="files/modules/math/romberg.html">math::calculus::romberg</a></td>
<td class="#doctools_tocright">Romberg integration</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_calculus_symdiff'><a href="files/modules/math/symdiff.html">math::calculus::symdiff</a></td>
<td class="#doctools_tocright">Symbolic differentiation for Tcl</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_changepoint'><a href="files/modules/math/changepoint.html">math::changepoint</a></td>
<td class="#doctools_tocright">Change point detection methods</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_combinatorics'><a href="files/modules/math/combinatorics.html">math::combinatorics</a></td>
<td class="#doctools_tocright">Combinatorial functions in the Tcl Math Library</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_complexnumbers'><a href="files/modules/math/qcomplex.html">math::complexnumbers</a></td>
<td class="#doctools_tocright">Straightforward complex number package</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_constants'><a href="files/modules/math/constants.html">math::constants</a></td>
<td class="#doctools_tocright">Mathematical and numerical constants</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_decimal'><a href="files/modules/math/decimal.html">math::decimal</a></td>
<td class="#doctools_tocright">General decimal arithmetic</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_exact'><a href="files/modules/math/exact.html">math::exact</a></td>
<td class="#doctools_tocright">Exact Real Arithmetic</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_figurate'><a href="files/modules/math/figurate.html">math::figurate</a></td>
<td class="#doctools_tocright">Evaluate figurate numbers</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_filters'><a href="files/modules/math/filtergen.html">math::filters</a></td>
<td class="#doctools_tocright">Digital filters</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_fourier'><a href="files/modules/math/fourier.html">math::fourier</a></td>
<td class="#doctools_tocright">Discrete and fast fourier transforms</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_fuzzy'><a href="files/modules/math/fuzzy.html">math::fuzzy</a></td>
<td class="#doctools_tocright">Fuzzy comparison of floating-point numbers</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_geometry'><a href="files/modules/math/math_geometry.html">math::geometry</a></td>
<td class="#doctools_tocright">Geometrical computations</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_interpolate'><a href="files/modules/math/interpolate.html">math::interpolate</a></td>
<td class="#doctools_tocright">Interpolation routines</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_linearalgebra'><a href="files/modules/math/linalg.html">math::linearalgebra</a></td>
<td class="#doctools_tocright">Linear Algebra</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_machineparameters'><a href="files/modules/math/machineparameters.html">math::machineparameters</a></td>
<td class="#doctools_tocright">Compute double precision machine parameters.</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_numtheory'><a href="files/modules/math/numtheory.html">math::numtheory</a></td>
<td class="#doctools_tocright">Number Theory</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_optimize'><a href="files/modules/math/optimize.html">math::optimize</a></td>
<td class="#doctools_tocright">Optimisation routines</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_pca'><a href="files/modules/math/pca.html">math::PCA</a></td>
<td class="#doctools_tocright">Package for Principal Component Analysis</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_polynomials'><a href="files/modules/math/polynomials.html">math::polynomials</a></td>
<td class="#doctools_tocright">Polynomial functions</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_probopt'><a href="files/modules/math/probopt.html">math::probopt</a></td>
<td class="#doctools_tocright">Probabilistic optimisation methods</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_quasirandom'><a href="files/modules/math/quasirandom.html">math::quasirandom</a></td>
<td class="#doctools_tocright">Quasi-random points for integration and Monte Carlo type methods</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_rationalfunctions'><a href="files/modules/math/rational_funcs.html">math::rationalfunctions</a></td>
<td class="#doctools_tocright">Polynomial functions</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_roman'><a href="files/modules/math/roman.html">math::roman</a></td>
<td class="#doctools_tocright">Tools for creating and manipulating roman numerals</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_special'><a href="files/modules/math/special.html">math::special</a></td>
<td class="#doctools_tocright">Special mathematical functions</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='math_statistics'><a href="files/modules/math/statistics.html">math::statistics</a></td>
<td class="#doctools_tocright">Basic statistical functions and procedures</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='math_trig'><a href="files/modules/math/trig.html">math::trig</a></td>
<td class="#doctools_tocright">Trigonometric anf hyperbolic functions</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='md4'><a href="files/modules/md4/md4.html">md4</a></td>
<td class="#doctools_tocright">MD4 Message-Digest Algorithm</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='md5'><a href="files/modules/md5/md5.html">md5</a></td>
<td class="#doctools_tocright">MD5 Message-Digest Algorithm</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='md5crypt'><a href="files/modules/md5crypt/md5crypt.html">md5crypt</a></td>
<td class="#doctools_tocright">MD5-based password encryption</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mime'><a href="files/modules/mime/mime.html">mime</a></td>
<td class="#doctools_tocright">Manipulation of MIME body parts</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="files/apps/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Source code documentation extractor/converter application</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="files/modules/mkdoc/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Extracts and optionally converts Markdown comments in source code to HTML</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='mpexpand'><a href="files/modules/doctools/mpexpand.html">mpexpand</a></td>
<td class="#doctools_tocright">Markup processor</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='multiplexer'><a href="files/modules/multiplexer/multiplexer.html">multiplexer</a></td>
<td class="#doctools_tocright">One-to-many communication with sockets.</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nameserv'><a href="files/modules/nns/nns_client.html">nameserv</a></td>
<td class="#doctools_tocright">Name service facility, Client</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='nameserv_auto'><a href="files/modules/nns/nns_auto.html">nameserv::auto</a></td>
<td class="#doctools_tocright">Name service facility, Client Extension</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nameserv_common'><a href="files/modules/nns/nns_common.html">nameserv::common</a></td>
<td class="#doctools_tocright">Name service facility, shared definitions</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='nameserv_protocol'><a href="files/modules/nns/nns_protocol.html">nameserv::protocol</a></td>
<td class="#doctools_tocright">Name service facility, client/server protocol</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nameserv_server'><a href="files/modules/nns/nns_server.html">nameserv::server</a></td>
<td class="#doctools_tocright">Name service facility, Server</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='namespacex'><a href="files/modules/namespacex/namespacex.html">namespacex</a></td>
<td class="#doctools_tocright">Namespace utility commands</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='ncgi'><a href="files/modules/ncgi/ncgi.html">ncgi</a></td>
<td class="#doctools_tocright">Procedures to manipulate CGI values.</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='nettool'><a href="files/modules/nettool/nettool.html">nettool</a></td>
<td class="#doctools_tocright">Tools for networked applications</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nmea'><a href="files/modules/nmea/nmea.html">nmea</a></td>
<td class="#doctools_tocright">Process NMEA data</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='nns'><a href="files/apps/nns.html">nns</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Client Application</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nns_intro'><a href="files/modules/nns/nns_intro.html">nns_intro</a></td>
<td class="#doctools_tocright">Name service facility, introduction</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='nnsd'><a href="files/apps/nnsd.html">nnsd</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Server Application</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nnslog'><a href="files/apps/nnslog.html">nnslog</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Logging Client Application</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='nntp'><a href="files/modules/nntp/nntp.html">nntp</a></td>
<td class="#doctools_tocright">Tcl client for the NNTP protocol</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='ntp_time'><a href="files/modules/ntp/ntp_time.html">ntp_time</a></td>
<td class="#doctools_tocright">Tcl Time Service Client</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='oauth'><a href="files/modules/oauth/oauth.html">oauth</a></td>
<td class="#doctools_tocright">oauth API base signature</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='oo_util'><a href="files/modules/tool/meta.html">oo::util</a></td>
<td class="#doctools_tocright">Utility commands for TclOO</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='oo_util'><a href="files/modules/ooutil/ooutil.html">oo::util</a></td>
<td class="#doctools_tocright">Utility commands for TclOO</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='oometa'><a href="files/modules/oometa/oometa.html">oometa</a></td>
<td class="#doctools_tocright">oo::meta A data registry for classess</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='otp'><a href="files/modules/otp/otp.html">otp</a></td>
<td class="#doctools_tocright">One-Time Passwords</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='page'><a href="files/apps/page.html">page</a></td>
<td class="#doctools_tocright">Parser Generator</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='page_intro'><a href="files/modules/page/page_intro.html">page_intro</a></td>
<td class="#doctools_tocright">page introduction</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='page_pluginmgr'><a href="files/modules/page/page_pluginmgr.html">page_pluginmgr</a></td>
<td class="#doctools_tocright">page plugin manager</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='page_util_flow'><a href="files/modules/page/page_util_flow.html">page_util_flow</a></td>
<td class="#doctools_tocright">page dataflow/treewalker utility</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='page_util_norm_lemon'><a href="files/modules/page/page_util_norm_lemon.html">page_util_norm_lemon</a></td>
<td class="#doctools_tocright">page AST normalization, LEMON</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='page_util_norm_peg'><a href="files/modules/page/page_util_norm_peg.html">page_util_norm_peg</a></td>
<td class="#doctools_tocright">page AST normalization, PEG</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='page_util_peg'><a href="files/modules/page/page_util_peg.html">page_util_peg</a></td>
<td class="#doctools_tocright">page PEG transformation utilities</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='page_util_quote'><a href="files/modules/page/page_util_quote.html">page_util_quote</a></td>
<td class="#doctools_tocright">page character quoting utilities</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='picoirc'><a href="files/modules/irc/picoirc.html">picoirc</a></td>
<td class="#doctools_tocright">Small and simple embeddable IRC client.</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='pkg_dtplite'><a href="files/modules/dtplite/pkg_dtplite.html">pkg_dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='pki'><a href="files/modules/pki/pki.html">pki</a></td>
<td class="#doctools_tocright">Implementation of the public key cipher</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='pluginmgr'><a href="files/modules/pluginmgr/pluginmgr.html">pluginmgr</a></td>
<td class="#doctools_tocright">Manage a plugin</td>




︙





Changes to idoc/www/toc.html.






︙


504
505
506
507
508
509
510
511

512
513
514
515
516
517
518
519
520
521




522
523
524
525
526
527
528

504
505
506
507
508
509
510

511
512
513
514




515
516
517
518
519
520
521
522
523
524
525
526
527
528








-
+



-
-
-
-



+
+
+
+








<td class="#doctools_tocright">doctools language syntax</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='doctools_plugin_apiref'><a href="tcllib/files/modules/doctools/doctools_plugin_apiref.html">doctools_plugin_apiref</a></td>
<td class="#doctools_tocright">doctools plugin API reference</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/modules/dtplite/pkg_dtplite.html">dtplite</a></td>
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/apps/dtplite.html">dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/apps/dtplite.html">dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mpexpand'><a href="tcllib/files/modules/doctools/mpexpand.html">mpexpand</a></td>
<td class="#doctools_tocright">Markup processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='pkg_dtplite'><a href="tcllib/files/modules/dtplite/pkg_dtplite.html">pkg_dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='tcldocstrip'><a href="tcllib/files/apps/tcldocstrip.html">tcldocstrip</a></td>
<td class="#doctools_tocright">Tcl-based Docstrip Processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='tepam_doc_gen'><a href="tcllib/files/modules/tepam/tepam_doc_gen.html">tepam::doc_gen</a></td>
<td class="#doctools_tocright">TEPAM DOC Generation, reference manual</td>




︙


1576
1577
1578
1579
1580
1581
1582








1583
1584
1585
1586
1587
1588
1589

1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597








+
+
+
+
+
+
+
+








<td class="#doctools_tocleft" ><a name='markdown'><a href="tcllib/files/modules/markdown/markdown.html">markdown</a></td>
<td class="#doctools_tocright">Converts Markdown text to HTML</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='mime'><a href="tcllib/files/modules/mime/mime.html">mime</a></td>
<td class="#doctools_tocright">Manipulation of MIME body parts</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="tcllib/files/modules/mkdoc/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Extracts and optionally converts Markdown comments in source code to HTML</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="tcllib/files/apps/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Source code documentation extractor/converter application</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='rcs'><a href="tcllib/files/modules/rcs/rcs.html">rcs</a></td>
<td class="#doctools_tocright">RCS low level utilities</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='string_token'><a href="tcllib/files/modules/string/token.html">string::token</a></td>
<td class="#doctools_tocright">Regex based iterative lexing</td>




︙


1857
1858
1859
1860
1861
1862
1863




1864
1865
1866
1867

1868
1869
1870
1871

1872
1873
1874
1875

1876
1877
1878
1879

1880
1881
1882
1883

1884
1885
1886
1887
1888
1889
1890

1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878

1879
1880
1881
1882

1883
1884
1885
1886

1887
1888
1889
1890

1891
1892
1893
1894

1895
1896
1897
1898
1899
1900
1901
1902








+
+
+
+



-
+



-
+



-
+



-
+



-
+








<dl><dt><a name='applications'>Applications</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/apps/dtplite.html">dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="tcllib/files/apps/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Source code documentation extractor/converter application</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nns'><a href="tcllib/files/apps/nns.html">nns</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Client Application</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='nnsd'><a href="tcllib/files/apps/nnsd.html">nnsd</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Server Application</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nnslog'><a href="tcllib/files/apps/nnslog.html">nnslog</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Logging Client Application</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='page'><a href="tcllib/files/apps/page.html">page</a></td>
<td class="#doctools_tocright">Parser Generator</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='pt'><a href="tcllib/files/apps/pt.html">pt</a></td>
<td class="#doctools_tocright">Parser Tools Application</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='tcldocstrip'><a href="tcllib/files/apps/tcldocstrip.html">tcldocstrip</a></td>
<td class="#doctools_tocright">Tcl-based Docstrip Processor</td>
</tr>
</table></dl>
<dl><dt><a name='modules'>Modules</dt><dd>
<dl><dt><a name='aes'>aes</dt><dd>
<table class="#doctools_toc">




︙


2435
2436
2437
2438
2439
2440
2441
2442

2443
2444
2445
2446
2447
2448
2449

2447
2448
2449
2450
2451
2452
2453

2454
2455
2456
2457
2458
2459
2460
2461








-
+








<td class="#doctools_tocleft" ><a name='doctools_toc_structure'><a href="tcllib/files/modules/doctools2toc/toc_structure.html">doctools::toc::structure</a></td>
<td class="#doctools_tocright">Doctoc serialization utilities</td>
</tr>
</table></dl>
<dl><dt><a name='dtplite'>dtplite</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/modules/dtplite/pkg_dtplite.html">dtplite</a></td>
<td class="#doctools_tocleft" ><a name='pkg_dtplite'><a href="tcllib/files/modules/dtplite/pkg_dtplite.html">pkg_dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
</table></dl>
<dl><dt><a name='fileutil'>fileutil</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='fileutil'><a href="tcllib/files/modules/fileutil/fileutil.html">fileutil</a></td>




︙


2927
2928
2929
2930
2931
2932
2933







2934
2935
2936
2937
2938
2939
2940

2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959








+
+
+
+
+
+
+








<td class="#doctools_tocleft" ><a name='mime'><a href="tcllib/files/modules/mime/mime.html">mime</a></td>
<td class="#doctools_tocright">Manipulation of MIME body parts</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='smtp'><a href="tcllib/files/modules/mime/smtp.html">smtp</a></td>
<td class="#doctools_tocright">Client-side tcl implementation of the smtp protocol</td>
</tr>
</table></dl>
<dl><dt><a name='mkdoc'>mkdoc</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="tcllib/files/modules/mkdoc/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Extracts and optionally converts Markdown comments in source code to HTML</td>
</tr>
</table></dl>
<dl><dt><a name='multiplexer'>multiplexer</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='multiplexer'><a href="tcllib/files/modules/multiplexer/multiplexer.html">multiplexer</a></td>
<td class="#doctools_tocright">One-to-many communication with sockets.</td>
</tr>




︙





Changes to idoc/www/toc0.html.






︙


504
505
506
507
508
509
510
511

512
513
514
515
516
517
518
519
520
521




522
523
524
525
526
527
528

504
505
506
507
508
509
510

511
512
513
514




515
516
517
518
519
520
521
522
523
524
525
526
527
528








-
+



-
-
-
-



+
+
+
+








<td class="#doctools_tocright">doctools language syntax</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='doctools_plugin_apiref'><a href="tcllib/files/modules/doctools/doctools_plugin_apiref.html">doctools_plugin_apiref</a></td>
<td class="#doctools_tocright">doctools plugin API reference</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/modules/dtplite/pkg_dtplite.html">dtplite</a></td>
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/apps/dtplite.html">dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/apps/dtplite.html">dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mpexpand'><a href="tcllib/files/modules/doctools/mpexpand.html">mpexpand</a></td>
<td class="#doctools_tocright">Markup processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='pkg_dtplite'><a href="tcllib/files/modules/dtplite/pkg_dtplite.html">pkg_dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='tcldocstrip'><a href="tcllib/files/apps/tcldocstrip.html">tcldocstrip</a></td>
<td class="#doctools_tocright">Tcl-based Docstrip Processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='tepam_doc_gen'><a href="tcllib/files/modules/tepam/tepam_doc_gen.html">tepam::doc_gen</a></td>
<td class="#doctools_tocright">TEPAM DOC Generation, reference manual</td>




︙


1576
1577
1578
1579
1580
1581
1582








1583
1584
1585
1586
1587
1588
1589

1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597








+
+
+
+
+
+
+
+








<td class="#doctools_tocleft" ><a name='markdown'><a href="tcllib/files/modules/markdown/markdown.html">markdown</a></td>
<td class="#doctools_tocright">Converts Markdown text to HTML</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='mime'><a href="tcllib/files/modules/mime/mime.html">mime</a></td>
<td class="#doctools_tocright">Manipulation of MIME body parts</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="tcllib/files/modules/mkdoc/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Extracts and optionally converts Markdown comments in source code to HTML</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="tcllib/files/apps/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Source code documentation extractor/converter application</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='rcs'><a href="tcllib/files/modules/rcs/rcs.html">rcs</a></td>
<td class="#doctools_tocright">RCS low level utilities</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='string_token'><a href="tcllib/files/modules/string/token.html">string::token</a></td>
<td class="#doctools_tocright">Regex based iterative lexing</td>




︙





Changes to idoc/www/toc1.html.






︙


565
566
567
568
569
570
571
572

573
574
575
576
577
578
579

565
566
567
568
569
570
571

572
573
574
575
576
577
578
579








-
+








<td class="#doctools_tocleft" ><a name='doctools_toc_structure'><a href="tcllib/files/modules/doctools2toc/toc_structure.html">doctools::toc::structure</a></td>
<td class="#doctools_tocright">Doctoc serialization utilities</td>
</tr>
</table></dl>
<dl><dt><a name='dtplite'>dtplite</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/modules/dtplite/pkg_dtplite.html">dtplite</a></td>
<td class="#doctools_tocleft" ><a name='pkg_dtplite'><a href="tcllib/files/modules/dtplite/pkg_dtplite.html">pkg_dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
</table></dl>
<dl><dt><a name='fileutil'>fileutil</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='fileutil'><a href="tcllib/files/modules/fileutil/fileutil.html">fileutil</a></td>




︙


1057
1058
1059
1060
1061
1062
1063







1064
1065
1066
1067
1068
1069
1070

1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077








+
+
+
+
+
+
+








<td class="#doctools_tocleft" ><a name='mime'><a href="tcllib/files/modules/mime/mime.html">mime</a></td>
<td class="#doctools_tocright">Manipulation of MIME body parts</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='smtp'><a href="tcllib/files/modules/mime/smtp.html">smtp</a></td>
<td class="#doctools_tocright">Client-side tcl implementation of the smtp protocol</td>
</tr>
</table></dl>
<dl><dt><a name='mkdoc'>mkdoc</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="tcllib/files/modules/mkdoc/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Extracts and optionally converts Markdown comments in source code to HTML</td>
</tr>
</table></dl>
<dl><dt><a name='multiplexer'>multiplexer</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='multiplexer'><a href="tcllib/files/modules/multiplexer/multiplexer.html">multiplexer</a></td>
<td class="#doctools_tocright">One-to-many communication with sockets.</td>
</tr>




︙





Changes to idoc/www/toc2.html.






︙


18
19
20
21
22
23
24




25
26
27
28

29
30
31
32

33
34
35
36

37
38
39
40

41
42
43
44

45
46
47
48
49

18
19
20
21
22
23
24
25
26
27
28
29
30
31

32
33
34
35

36
37
38
39

40
41
42
43

44
45
46
47

48
49
50
51
52
53








+
+
+
+



-
+



-
+



-
+



-
+



-
+






<dl><dt><a name='applications'>Applications</dt><dd>
<table class="#doctools_toc">
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='dtplite'><a href="tcllib/files/apps/dtplite.html">dtplite</a></td>
<td class="#doctools_tocright">Lightweight DocTools Markup Processor</td>
</tr>
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='mkdoc'><a href="tcllib/files/apps/mkdoc.html">mkdoc</a></td>
<td class="#doctools_tocright">Source code documentation extractor/converter application</td>
</tr>
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nns'><a href="tcllib/files/apps/nns.html">nns</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Client Application</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='nnsd'><a href="tcllib/files/apps/nnsd.html">nnsd</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Server Application</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='nnslog'><a href="tcllib/files/apps/nnslog.html">nnslog</a></td>
<td class="#doctools_tocright">Name service facility, Commandline Logging Client Application</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='page'><a href="tcllib/files/apps/page.html">page</a></td>
<td class="#doctools_tocright">Parser Generator</td>
</tr>
<tr class="#doctools_tocodd"  >
<tr class="#doctools_toceven" >
<td class="#doctools_tocleft" ><a name='pt'><a href="tcllib/files/apps/pt.html">pt</a></td>
<td class="#doctools_tocright">Parser Tools Application</td>
</tr>
<tr class="#doctools_toceven" >
<tr class="#doctools_tocodd"  >
<td class="#doctools_tocleft" ><a name='tcldocstrip'><a href="tcllib/files/apps/tcldocstrip.html">tcldocstrip</a></td>
<td class="#doctools_tocright">Tcl-based Docstrip Processor</td>
</tr>
</table></dl>
</dd></dl><hr></body></html>






Changes to modules/0compatibility/d_config.tcl.





1
2


3
4
5
6
7
8
9
10

11
12
13
14
15
16



1
2
3
4
5
6
7



8




9
10

-
-
+
+





-
-
-
+
-
-
-
-



# (c) 2019 Andreas Kupries
# Redirection wrapper for deprecated package
# (c) 2022 Andreas Kupries
# Error wrapper for deprecated package
# Deprecated:
# - doctools::config
# Replacement:
# - struct::map

package require Tcl 8.4
package require struct::map

error "The package doctools::config is stage 2 deprecated. Use struct::map instead."
namespace eval ::doctools {}

proc ::doctools::config {args} { uplevel 1 [linsert $args 0 ::struct::map] }

package provide doctools::config 0.1
return






Deleted modules/0compatibility/d_config.test.





1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144


















































































































































-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

# -*- tcl -*-
# config.test:  Testsuite for DEPRECATED package doctools::config
#
# Copyright (c) 2019 by Andreas Kupries <[email protected]>
# All rights reserved.

# -------------------------------------------------------------------------

source [file join \
	[file dirname [file dirname [file join [pwd] [info script]]]] \
	devtools testutilities.tcl]

testsNeedTcl     8.4
testsNeedTcltest 2.0

support {
    use snit/snit.tcl  snit
    use struct/map.tcl struct::map
}
testing {
    useLocal d_config.tcl doctools::config
}

# ---------------------------------------------------------------------
# [] constructor
# [] destructor
# [] get
# [] names
# [] set
# [] unset

#----------------------------------------------------------------------
## Constructor, destructor

test doctools-config-1.0 {constructor, wrong args, too many} -body {
    doctools::config M X
} -returnCodes error -result {Error in constructor: wrong # args: should be "::struct::map::I::Snit_constructor type selfns win self"}

test doctools-config-1.1 {instance, bogus method} -setup {
    doctools::config M
} -cleanup {
    M destroy
} -body {
    M bogus
} -returnCodes error -result {"::M bogus" is not defined}

#----------------------------------------------------------------------
## get

test doctools-config-2.0 {get, wrong args, too many} -setup {
    doctools::config M
} -cleanup {
    M destroy
} -body {
    M get X
} -returnCodes error -result {wrong # args: should be "::struct::map::I::Snit_methodget type selfns win self"}

test doctools-config-2.1 {get, base state, none} -setup {
    doctools::config M
} -cleanup {
    M destroy
} -body {
    M get
} -result {}

#----------------------------------------------------------------------
## names

test doctools-config-3.0 {names, wrong args, too many} -setup {
    doctools::config M
} -cleanup {
    M destroy
} -body {
    M names X
} -returnCodes error -result {wrong # args: should be "::struct::map::I::Snit_methodnames type selfns win self"}

test doctools-config-3.1 {names, base state, none} -setup {
    doctools::config M
} -cleanup {
    M destroy
} -body {
    M names
} -result {}

#----------------------------------------------------------------------
## set

test doctools-config-4.0 {set, wrong args, not enough} -setup {
    doctools::config M
} -cleanup {
    M destroy
} -body {
    M set
} -returnCodes error -result {wrong # args: should be "::struct::map::I::Snit_methodset type selfns win self name ?value?"}

test doctools-config-4.1 {set, wrong args, too many} -setup {
    doctools::config M
} -cleanup {
    M destroy
} -body {
    M set K V X
} -returnCodes error -result {wrong # args: should be "::struct::map::I::Snit_methodset type selfns win self name ?value?"}

test doctools-config-4.2 {set, state change, result} -setup {
    doctools::config M
} -cleanup {
    M destroy
} -body {
    list [M names] [M get] [M set K V] [M names] [M get]
} -result {{} {} V K {K V}}

#----------------------------------------------------------------------
## unset

test doctools-config-5.2 {unset, known key, state change, result} -setup {
    doctools::config M
    M set K V
} -cleanup {
    M destroy
} -body {
    list [M names] [M get] [M unset K] [M names] [M get]
} -result {K {K V} {} {} {}}

test doctools-config-5.3 {unset, missing key, no state change, result} -setup {
    doctools::config M
    M set K V
} -cleanup {
    M destroy
} -body {
    list [M names] [M get] [M unset K'] [M names] [M get]
} -result {K {K V} {} K {K V}}

test doctools-config-5.4 {unset, no pattern, clear, result} -setup {
    doctools::config M
    M set K V
} -cleanup {
    M destroy
} -body {
    list [M names] [M get] [M unset] [M names] [M get]
} -result {K {K V} {} {} {}}

#----------------------------------------------------------------------
testsuiteCleanup
return






Changes to modules/0compatibility/d_paths.tcl.





1
2
3
4
5
6
7
8
9
10

11
12
13
14
15
16

1
2
3
4
5
6
7



8




9
10








-
-
-
+
-
-
-
-



# (c) 2019 Andreas Kupries
# Redirection wrapper for deprecated package
# Deprecated:
# - doctools::paths
# Replacement:
# - fileutil::paths

package require Tcl 8.4
package require fileutil::paths

error "The package doctools::paths is stage 2 deprecated. Use fileutil::paths instead."
namespace eval ::doctools {}

proc ::doctools::paths {args} { uplevel 1 [linsert $args 0 ::fileutil::paths] }

package provide doctools::paths 0.1
return






Deleted modules/0compatibility/d_paths.test.





1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152


























































































































































-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

# -*- tcl -*-
# paths.test:  Testsuite for DEPRECATED package doctools::paths
#
# Copyright (c) 2019 by Andreas Kupries <[email protected]>
# All rights reserved.

# -------------------------------------------------------------------------

source [file join \
	[file dirname [file dirname [file join [pwd] [info script]]]] \
	devtools testutilities.tcl]

testsNeedTcl     8.4
testsNeedTcltest 2.0

support {
    use snit/snit.tcl      snit
    use fileutil/paths.tcl fileutil::paths
}    
testing {
    useLocal d_paths.tcl doctools::paths
}

# ---------------------------------------------------------------------
# [] constructor
# [] destructor
# [] paths
# [] add
# [] remove
# [] clear

#----------------------------------------------------------------------
## Constructor, destructor

test doctools-paths-1.0 {constructor, wrong args, too many} -body {
    doctools::paths P X
} -returnCodes error -result {Error in constructor: wrong # args: should be "::fileutil::paths::Snit_constructor type selfns win self"}

test doctools-paths-1.1 {instance, bogus method} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    P bogus
} -returnCodes error -result {"::P bogus" is not defined}

#----------------------------------------------------------------------
## paths

test doctools-paths-2.0 {paths, wrong args, too many} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    P paths X
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodpaths type selfns win self"}

test doctools-paths-2.1 {paths, base state, none} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    P paths
} -result {}

#----------------------------------------------------------------------
## add

test doctools-paths-3.0 {add, wrong args, not enough} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    P add
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodadd type selfns win self path"}

test doctools-paths-3.1 {add, wrong args, too many} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    P add F X
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodadd type selfns win self path"}

test doctools-paths-3.2 {add, state change, result} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    list [P add F] [P paths]
} -result {{} F}

#----------------------------------------------------------------------
## remove

test doctools-paths-4.0 {remove, wrong args, not enough} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    P remove
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodremove type selfns win self path"}

test doctools-paths-4.1 {remove, wrong args, too many} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    P remove F X
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodremove type selfns win self path"}

test doctools-paths-4.2 {remove, known path, state change, result} -setup {
    doctools::paths P
    P add F
} -cleanup {
    P destroy
} -body {
    list [P remove F] [P paths]
} -result {{} {}}

test doctools-paths-4.3 {remove, missing path, no state change, result} -setup {
    doctools::paths P
    P add Z
} -cleanup {
    P destroy
} -body {
    list [P remove F] [P paths]
} -result {{} Z}

#----------------------------------------------------------------------
## clear

test doctools-paths-5.0 {clear, wrong args, too many} -setup {
    doctools::paths P
} -cleanup {
    P destroy
} -body {
    P clear X
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodclear type selfns win self"}

test doctools-paths-5.1 {clear, return to base state} -setup {
    doctools::paths P
    P add F
} -cleanup {
    P destroy
} -body {
    list [P clear] [P paths]
} -result {{} {}}

#----------------------------------------------------------------------
testsuiteCleanup
return






Changes to modules/0compatibility/p_config.tcl.





1
2
3
4
5
6
7
8
9
10

11
12
13
14

1
2
3
4
5
6
7



8


9
10








-
-
-
+
-
-



# (c) 2019 Andreas Kupries
# Redirection wrapper for deprecated package
# Deprecated:
# - configuration
# Replacement:
# - struct::map

package require Tcl 8.4
package require struct::map

error "The package configuration is stage 2 deprecated. Use struct::map instead."
proc ::configuration {args} { uplevel 1 [linsert $args 0 ::struct::map] }

package provide configuration 1
return






Deleted modules/0compatibility/p_config.test.





1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144


















































































































































-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

# -*- tcl -*-
# config.test:  Testsuite for DEPRECATED package configuration
#
# Copyright (c) 2019 by Andreas Kupries <[email protected]>
# All rights reserved.

# -------------------------------------------------------------------------

source [file join \
	[file dirname [file dirname [file join [pwd] [info script]]]] \
	devtools testutilities.tcl]

testsNeedTcl     8.4
testsNeedTcltest 2.0

support {
    use snit/snit.tcl  snit
    use struct/map.tcl struct::map
}
testing {
    useLocal p_config.tcl configuration
}

# ---------------------------------------------------------------------
# [] constructor
# [] destructor
# [] get
# [] names
# [] set
# [] unset

#----------------------------------------------------------------------
## Constructor, destructor

test configuration-1.0 {constructor, wrong args, too many} -body {
    configuration M X
} -returnCodes error -result {Error in constructor: wrong # args: should be "::struct::map::I::Snit_constructor type selfns win self"}

test configuration-1.1 {instance, bogus method} -setup {
    configuration M
} -cleanup {
    M destroy
} -body {
    M bogus
} -returnCodes error -result {"::M bogus" is not defined}

#----------------------------------------------------------------------
## get

test configuration-2.0 {get, wrong args, too many} -setup {
    configuration M
} -cleanup {
    M destroy
} -body {
    M get X
} -returnCodes error -result {wrong # args: should be "::struct::map::I::Snit_methodget type selfns win self"}

test configuration-2.1 {get, base state, none} -setup {
    configuration M
} -cleanup {
    M destroy
} -body {
    M get
} -result {}

#----------------------------------------------------------------------
## names

test configuration-3.0 {names, wrong args, too many} -setup {
    configuration M
} -cleanup {
    M destroy
} -body {
    M names X
} -returnCodes error -result {wrong # args: should be "::struct::map::I::Snit_methodnames type selfns win self"}

test configuration-3.1 {names, base state, none} -setup {
    configuration M
} -cleanup {
    M destroy
} -body {
    M names
} -result {}

#----------------------------------------------------------------------
## set

test configuration-4.0 {set, wrong args, not enough} -setup {
    configuration M
} -cleanup {
    M destroy
} -body {
    M set
} -returnCodes error -result {wrong # args: should be "::struct::map::I::Snit_methodset type selfns win self name ?value?"}

test configuration-4.1 {set, wrong args, too many} -setup {
    configuration M
} -cleanup {
    M destroy
} -body {
    M set K V X
} -returnCodes error -result {wrong # args: should be "::struct::map::I::Snit_methodset type selfns win self name ?value?"}

test configuration-4.2 {set, state change, result} -setup {
    configuration M
} -cleanup {
    M destroy
} -body {
    list [M names] [M get] [M set K V] [M names] [M get]
} -result {{} {} V K {K V}}

#----------------------------------------------------------------------
## unset

test configuration-5.2 {unset, known key, state change, result} -setup {
    configuration M
    M set K V
} -cleanup {
    M destroy
} -body {
    list [M names] [M get] [M unset K] [M names] [M get]
} -result {K {K V} {} {} {}}

test configuration-5.3 {unset, missing key, no state change, result} -setup {
    configuration M
    M set K V
} -cleanup {
    M destroy
} -body {
    list [M names] [M get] [M unset K'] [M names] [M get]
} -result {K {K V} {} K {K V}}

test configuration-5.4 {unset, no pattern, clear, result} -setup {
    configuration M
    M set K V
} -cleanup {
    M destroy
} -body {
    list [M names] [M get] [M unset] [M names] [M get]
} -result {K {K V} {} {} {}}

#----------------------------------------------------------------------
testsuiteCleanup
return






Changes to modules/0compatibility/p_paths.tcl.





1
2
3
4
5
6
7
8
9
10

11
12
13
14

1
2
3
4
5
6
7



8



9








-
-
-
+
-
-
-


# (c) 2019 Andreas Kupries
# Redirection wrapper for deprecated package
# Deprecated:
# - paths
# Replacement:
# - fileutil::paths

package require Tcl 8.4
package require fileutil::paths

error "The package paths is stage 2 deprecated. Use fileutil::paths instead."
proc ::paths {args} { uplevel 1 [linsert $args 0 ::fileutil::paths] }

package provide paths 1
return






Deleted modules/0compatibility/p_paths.test.





1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152


























































































































































-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

# -*- tcl -*-
# paths.test:  Testsuite for DEPRECATED package paths (pt)
#
# Copyright (c) 2019 by Andreas Kupries <[email protected]>
# All rights reserved.

# -------------------------------------------------------------------------

source [file join \
	[file dirname [file dirname [file join [pwd] [info script]]]] \
	devtools testutilities.tcl]

testsNeedTcl     8.4
testsNeedTcltest 2.0

support {
    use snit/snit.tcl      snit
    use fileutil/paths.tcl fileutil::paths
}    
testing {
    useLocal p_paths.tcl paths
}

# ---------------------------------------------------------------------
# [] constructor
# [] destructor
# [] paths
# [] add
# [] remove
# [] clear

#----------------------------------------------------------------------
## Constructor, destructor

test paths-1.0 {constructor, wrong args, too many} -body {
    paths P X
} -returnCodes error -result {Error in constructor: wrong # args: should be "::fileutil::paths::Snit_constructor type selfns win self"}

test paths-1.1 {instance, bogus method} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    P bogus
} -returnCodes error -result {"::P bogus" is not defined}

#----------------------------------------------------------------------
## paths

test paths-2.0 {paths, wrong args, too many} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    P paths X
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodpaths type selfns win self"}

test paths-2.1 {paths, base state, none} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    P paths
} -result {}

#----------------------------------------------------------------------
## add

test paths-3.0 {add, wrong args, not enough} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    P add
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodadd type selfns win self path"}

test paths-3.1 {add, wrong args, too many} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    P add F X
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodadd type selfns win self path"}

test paths-3.2 {add, state change, result} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    list [P add F] [P paths]
} -result {{} F}

#----------------------------------------------------------------------
## remove

test paths-4.0 {remove, wrong args, not enough} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    P remove
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodremove type selfns win self path"}

test paths-4.1 {remove, wrong args, too many} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    P remove F X
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodremove type selfns win self path"}

test paths-4.2 {remove, known path, state change, result} -setup {
    paths P
    P add F
} -cleanup {
    P destroy
} -body {
    list [P remove F] [P paths]
} -result {{} {}}

test paths-4.3 {remove, missing path, no state change, result} -setup {
    paths P
    P add Z
} -cleanup {
    P destroy
} -body {
    list [P remove F] [P paths]
} -result {{} Z}

#----------------------------------------------------------------------
## clear

test paths-5.0 {clear, wrong args, too many} -setup {
    paths P
} -cleanup {
    P destroy
} -body {
    P clear X
} -returnCodes error -result {wrong # args: should be "::fileutil::paths::Snit_methodclear type selfns win self"}

test paths-5.1 {clear, return to base state} -setup {
    paths P
    P add F
} -cleanup {
    P destroy
} -body {
    list [P clear] [P paths]
} -result {{} {}}

#----------------------------------------------------------------------
testsuiteCleanup
return






Changes to modules/clay/clay.test.







1
2
3



4
5
6
7
8
9
10

1
2
3


4
5
6
7
8
9
10
11
12
13

+
+

-
-
+
+
+








## -*- tcl -*-
# -------------------------------------------------------------------------

namespace eval ::oo::dialect {}
set ::oo::dialect::has(tip470) 0
namespace eval ::oo::dialect {
    variable has ; set has(tip470) 0
}

# clay.test - Copyright (c) 2018 Sean Woods
# -------------------------------------------------------------------------

set MODDIR [file dirname [file dirname [file join [pwd] [info script]]]]
if {[file exists [file join $MODDIR devtools testutilities.tcl]]} {
  # Running inside tcllib




︙


19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

22
23
24
25
26
27
28

29


30
31
32
33
34
35
36








-

-
-








testsNeed        TclOO 1

support {}
testing {
    useLocal clay.tcl clay
}


set ::clay::trace 0



# -------------------------------------------------------------------------
# Handle multiple implementation testing
#

array set preserve [array get ::clay::uuid::accel]





︙


3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135
3136
3137
3138

3139
3140
3141
3142

3143
3144



3145
3146
3147
3148
3149
3150
3151

3122
3123
3124
3125
3126
3127
3128


3129
3130
3131
3132
3133
3134
3135

3136

3137
3138
3139
3140


3141
3142
3143
3144
3145
3146
3147
3148
3149
3150








-
-







-
+
-



+
-
-
+
+
+








###
# Add extra arguments
###
test tip479-004 {Test that a later ensemble definition trumps a more primitive one} {
  $obj item new id 4 shape round trim leather
} {id 4 shape round trim leather color green}



testsuiteCleanup

# Local variables:
# mode: tcl
# indent-tabs-mode: nil
# End:


# -------------------------------------------------------------------------


if {![package vsatisfies [package provide Tcl] 8.7]} {return}
puts "Repeating tests with 8.7 features"

namespace eval ::oo::dialect {}
set ::oo::dialect::has(tip470) 1
namespace eval ::oo::dialect {
    variable has ; set has(tip470) 1
}

# clay.test - Copyright (c) 2018 Sean Woods
# -------------------------------------------------------------------------

set MODDIR [file dirname [file dirname [file join [pwd] [info script]]]]
if {[file exists [file join $MODDIR devtools testutilities.tcl]]} {
  # Running inside tcllib




︙


3160
3161
3162
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177

3159
3160
3161
3162
3163
3164
3165

3166


3167
3168
3169
3170
3171
3172
3173








-

-
-








testsNeed        TclOO 1

support {}
testing {
    useLocal clay.tcl clay
}


set ::clay::trace 0



# -------------------------------------------------------------------------
# Handle multiple implementation testing
#

array set preserve [array get ::clay::uuid::accel]





︙


6266
6267
6268
6269
6270
6271
6272
6273

6274
6275
6276
6277
6278
6279

6262
6263
6264
6265
6266
6267
6268

6269
6270
6271
6272
6273










-
+




-
-

test tip479-004 {Test that a later ensemble definition trumps a more primitive one} {
  $obj item new id 4 shape round trim leather
} {id 4 shape round trim leather color green}



testsuiteCleanup

return
# Local variables:
# mode: tcl
# indent-tabs-mode: nil
# End:








Changes to modules/dtplite/pkg_dtplite.man.





1

2
3

4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

30
31

32
33
34

35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168

169
170
171
172
173
174
175

176
177
178
179
180
181
182
183

184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236

237
238
239
240
241

242
243
244
245
246

247
248
249

250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341

342
343
344
345

346
347
348
349
350
351
352
353
354
355
356
357
358
359

360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449


1
2

3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23






24


25



26

27










































28


















































29







































30

31





32

33






34


















































35


36


37


38

39



40



41

























































































42


43

44


45














46




















































































47
48
49
50
51
52

-
+

-
+




















-
-
-
-
-
-
+
-
-
+
-
-
-
+
-

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-

-
-
-
-
-
+
-

-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-
-
+
-
-

-
-
+
-

-
-
-
+
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-
-
+
-

-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-







[comment {-*- tcl -*- doctools manpage}]
[comment {-*- mode: tcl ; fill-column: 90 -*- doctools manpage}]
[vset PACKAGE_VERSION 1.3.1]
[manpage_begin dtplite n [vset PACKAGE_VERSION]]
[manpage_begin pkg_dtplite n [vset PACKAGE_VERSION]]
[see_also {docidx introduction}]
[see_also {doctoc introduction}]
[see_also {doctools introduction}]
[keywords conversion]
[keywords docidx]
[keywords doctoc]
[keywords doctools]
[keywords HTML]
[keywords manpage]
[keywords markup]
[keywords nroff]
[keywords TMML]
[copyright {2004-2013 Andreas Kupries <[email protected]>}]
[titledesc {Lightweight DocTools Markup Processor}]
[moddesc   {Documentation toolbox}]
[category  {Documentation tools}]
[require dtplite [opt [vset PACKAGE_VERSION]]]
[description]
[para]

The application described by this document, [syscmd dtplite], is the
successor to the extremely simple [syscmd mpexpand]. Influenced in its
functionality by the [syscmd dtp] doctools processor it is much more
powerful than [syscmd mpexpand], yet still as easy to use; definitely
easier than [syscmd dtp] with its myriad of subcommands and options.

The package provided by this document, [package dtplite], is the foundation for the
[para]

[syscmd dtplite] application. It is a light wrapper around the various [package doctools]
[syscmd dtplite] is based upon the package [package doctools], like
the other two processors.

packages.
[subsection {USE CASES}]

[syscmd dtplite] was written with the following three use cases in
mind.

[para]
[list_begin enumerated]
[enum]
Validation of a single document, i.e. checking that it was written in
valid doctools format. This mode can also be used to get a preliminary
version of the formatted output for a single document, for display in
a browser, nroff, etc., allowing proofreading of the formatting.

[enum]
Generation of the formatted documentation for a single package,
i.e. all the manpages, plus a table of contents and an index of
keywords.

[enum]
An extension of the previous mode of operation, a method for the easy
generation of one documentation tree for several packages, and
especially of a unified table of contents and keyword index.

[list_end]

[para]

Beyond the above we also want to make use of the customization
features provided by the HTML formatter. It is not the only format the
application should be able to generate, but we anticipiate it to be
the most commonly used, and it is one of the few which do provide
customization hooks.

[para]

We allow the caller to specify a header string, footer string, a
stylesheet, and data for a bar of navigation links at the top of the
generated document.

While all can be set as long as the formatting engine provides an
appropriate engine parameter (See section [sectref OPTIONS]) the last
two have internal processing which make them specific to HTML.

[subsection {COMMAND LINE}]
[section COMMANDS]

[list_begin definitions]

[call [cmd dtplite] [option -o] [arg output] [opt options] [arg format] [arg inputfile]]

This is the form for use case [lb]1[rb]. The [arg options] will be
explained later, in section [sectref OPTIONS].

[list_begin arguments]

[arg_def path output in]

This argument specifies where to write the generated document. It can
be the path to a file or directory, or [const -].

The last value causes the application to write the generated
documented to [const stdout].

[para]

If the [arg output] does not exist then [lb]file dirname $output[rb]
has to exist and must be a writable directory.

The generated document will be written to a file in that directory,
and the name of that file will be derived from the [arg inputfile],
the [arg format], and the value given to option [option -ext] (if
present).

[arg_def (path|handle) format in]

This argument specifies the formatting engine to use when processing
the input, and thus the format of the generated document. See section
[sectref FORMATS] for the possibilities recognized by the application.

[arg_def path inputfile in]

This argument specifies the path to the file to process. It has to
exist, must be readable, and written in [term doctools] format.

[list_end]
[para]

[call [cmd dtplite] [const validate] [arg inputfile]]

This is a simpler form for use case [lb]1[rb]. The "validate" format
generates no output at all, only syntax checks are performed. As such
the specification of an output file or other options is not necessary
and left out.

[call [cmd dtplite] [option -o] [arg output] [opt options] [arg format] [arg inputdirectory]]

This is the form for use case [lb]2[rb]. It differs from the form for
use case [lb]1[rb] by having the input documents specified through a
directory instead of a file. The other arguments are identical, except
for [arg output], which now has to be the path to an existing and
writable directory.

[para]

The input documents are all files in [arg inputdirectory] or any of
its subdirectories which were recognized by [cmd fileutil::fileType]
as containing text in [term doctools] format.

[call [cmd dtplite] [option -merge] [option -o] [arg output] [opt options] [arg format] [arg inputdirectory]]

This is the form for use case [lb]3[rb]. The only difference to the
form for use case [lb]2[rb] is the additional option [option -merge].

[para]

Each such call will merge the generated documents coming from
processing the input documents under [arg inputdirectory] or any of
its subdirectories to the files under [arg output]. In this manner it
is possible to incrementally build the unified documentation for any
number of packages. Note that it is necessary to run through all the
packages twice to get fully correct cross-references (for formats
supporting them).

[list_end]

[subsection OPTIONS]

This section describes all the options available to the user of the
application, with

the exception of the options [option -o] and [option -merge]. These
two were described already, in section [sectref {COMMAND LINE}].

[para]
[list_begin options]
[list_begin definitions]
[opt_def -exclude string]

This option specifies an exclude (glob) pattern. Any files identified
as manpages to process which match the exclude pattern are
ignored. The option can be provided multiple times, each usage adding
an additional pattern to the list of exclusions.

[call [cmd dtplite::print-via] [arg cmd]]
[opt_def -ext string]

If the name of an output file has to be derived from the name of an
input file it will use the name of the [arg format] as the extension
by default. This option here will override this however, forcing it to
use [arg string] as the file extension. This option is ignored if the
name of the output file is fully specified through option [option -o].

Redirect print operations of the package to the specified [arg cmd].
[para]

When used multiple times only the last definition is relevant.

[opt_def -header file]

This option can be used if and only if the selected [arg format]
provides an engine parameter named "header". It takes the contents of
the specified file and assign them to that parameter, for whatever use
by the engine. The HTML engine will insert the text just after the tag
[const <body>].

If navigation buttons are present (see option [option -nav] below),
then the HTML generated for them is appended to the header data
originating here before the final assignment to the parameter.

[para]

When used multiple times only the last definition is relevant.

[opt_def -footer file]

Like [option -header], except that: Any navigation buttons are ignored,
the corresponding required engine parameter is named "footer", and the
data is inserted just before the tag [const </body>].

[para]

When used multiple times only the last definition is relevant.

[opt_def -style file]

This option can be used if and only if the selected [arg format]
provides an engine parameter named "meta". When specified it will
generate a piece of HTML code declaring the [arg file] as the
stylesheet for the generated document and assign that to the
parameter. The HTML engine will insert this inot the document, just
after the tag [const <head>].

[para]

When processing an input directory the stylesheet file is copied into
the output directory and the generated HTML will refer to the copy, to
make the result more self-contained. When processing an input file we
have no location to copy the stylesheet to and so just reference it as
specified.

[para]

When used multiple times only the last definition is relevant.

[opt_def -toc path|text]

[para] The result of the command is the empty string.
This option specifies a doctoc file (or text) to use for the table of contents
instead of generating our own.

[para]

[call [cmd dtplite::do] [arg arguments]]
When used multiple times only the last definition is relevant.

[opt_def -pre+toc "label path|text"]
[opt_def -post+toc "label path|text"]

The main command it takes a [emph {single list}] of [arg arguments], processes them, and
This option specifies additional doctoc files (or texts) to use in
the navigation bar.

performs the specified action.
[para] Positioning and handling of multiple uses is like for options
[option -prenav] and [option -postnav], see below.

[opt_def -nav "label url"]
[opt_def -prenav "label url"]

Use this option to specify a navigation button with [arg label] to
display and the [arg url] to link to. This option can be used if and
only if the selected [arg format] provides an engine parameter named
"header". The HTML generated for this is appended to whatever data we
got from option [option -header] before it is inserted into the
generated documents.

[para]

When used multiple times all definitions are collected and a
navigation bar is created, with the first definition shown at the left
edge and the last definition to the right.

[para] The url can be relative. In that case it is assumed to be relative
to the main files (TOC and Keyword index), and will be transformed for
all others to still link properly.

[opt_def -postnav "label url"]

Use this option to specify a navigation button with [arg label] to
display and the [arg url] to link to. This option can be used if and
only if the selected [arg format] provides an engine parameter named
"header". The HTML generated for this is appended to whatever data we
got from option [option -header] before it is inserted into the
generated documents.

[para]

When used multiple times all definitions are collected and a
navigation bar is created, with the last definition shown at the right
edge and the first definition to the left.

[para] The url can be relative. In that case it is assumed to be relative
to the main files (TOC and Keyword index), and will be transformed for
all others to still link properly.

[list_end]

[subsection FORMATS]

At first the [arg format] argument will be treated as a path to a tcl
file containing the code for the requested formatting engine. The
argument will be treated as the name of one of the predefined formats
listed below if and only if the path does not exist.

[para]

[emph {Note a limitation}]: If treating the format as path to the tcl
script implementing the engine was sucessful, then this script has to
implement not only the engine API for doctools, i.e.

[term doctools_api], but for [term doctoc_api] and [term docidx_api]
as well. Otherwise the generation of a table of contents and of a
keyword index will fail.

[para]

List of predefined formats, i.e. as provided by the
package [package doctools]:

[para]
[list_begin definitions]

[def [const nroff]]

The processor generates *roff output, the standard format for unix
manpages.

[def [const html]]

The processor generates HTML output, for usage in and display by web
browsers. This engine is currently the only one providing the various
engine parameters required for the additional customaization of the
output.

[def [const tmml]]

The processor generates TMML output, the Tcl Manpage Markup Language,
a derivative of XML.

[def [const latex]]

The processor generates LaTeX output.

[def [const wiki]]

[para] The result of the command is the empty string.
The processor generates Wiki markup as understood by [syscmd wikit].

[def [const list]]

[para] The details of the syntax inside of the [arg arguments] list are explained in
The processor extracts the information provided by [cmd manpage_begin].
[see_also {docidx introduction}]
[see_also {doctoc introduction}]
[see_also {doctools introduction}]
[keywords conversion]
[keywords docidx]
[keywords doctoc]
[keywords doctools]
[keywords HTML]
[keywords manpage]
[keywords markup]
[keywords nroff]
[keywords TMML]

section [term {COMMAND LINE}] of the documentation for the [syscmd dtplite] application.
This format is used internally to extract the meta data from which
both table of contents and keyword index are derived from.

[def [const null]]

The processor does not generate any output. This is equivalent to
[const validate].

[list_end]

[subsection {DIRECTORY STRUCTURES}]

In this section we describe the directory structures generated by the
application under [arg output] when processing all documents in an
[arg inputdirectory]. In other words, this is only relevant to the use
cases [lb]2[rb] and [lb]3[rb].

[list_begin definitions]

[def "[lb]2[rb]"]

The following directory structure is created when processing a single
set of input documents.  The file extension used is for output in
HTML, but that is not relevant to the structure and was just used to
have proper file names.

[example {
    output/
        toc.html
        index.html
        files/
            path/to/FOO.html
}]

The last line in the example shows the document
generated for a file FOO located at

[example {
    inputdirectory/path/to/FOO
}]

[def "[lb]3[rb]"]

When merging many packages into a unified set of documents the
generated directory structure is a bit deeper:

[example {
    output
        .toc
        .idx
        .tocdoc
        .idxdoc
        .xrf
        toc.html
        index.html
        FOO1/
            ...
        FOO2/
            toc.html
            files/
                path/to/BAR.html
}]

Each of the directories FOO1, ... contains the documents generated for
the package FOO1, ... and follows the structure shown for use case
[lb]2[rb]. The only exception is that there is no per-package index.

[para]

The files [file .toc], [file .idx], and [file .xrf] contain the
internal status of the whole output and will be read and updated by
the next invokation. Their contents will not be documented. Remove
these files when all packages wanted for the output have been
processed, i.e. when the output is complete.

[para]

The files [file .tocdoc], and [file .idxdoc], are intermediate files
in doctoc and docidx markup, respectively, containing the main table
of contents and keyword index for the set of documents before their
conversion to the chosen output format.

They are left in place, i.e. not deleted, to serve as demonstrations
of doctoc and docidx markup.

[list_end]

[vset CATEGORY doctools]
[include ../common-text/feedback.inc]
[manpage_end]






Changes to modules/fumagic/filetypes.tcl.





1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

1
2
3
4
5
6
7
8
9
10
11
12


13
14
15
16
17
18
19













-
-








# filetypes.tcl --
#
#	Tcl based file type recognizer using the runtime core and
#	generated from /usr/share/misc/magic.mime. Limited output,
#	but only mime-types, i.e. standardized.
#
# Copyright (c) 2016-2017 Poor Yorick     <[email protected]>
# Copyright (c) 2004-2005 Colin McCormack <[email protected]>
# Copyright (c) 2005-2006 Andreas Kupries <[email protected]>
#
# See the file "license.terms" for information on usage and redistribution
# of this file, and for a DISCLAIMER OF ALL WARRANTIES.
# 
# RCS: @(#) $Id: filetypes.tcl,v 1.6 2006/09/27 21:19:35 andreas_kupries Exp $

#####
#
# "mime type discriminator"
# http://wiki.tcl.tk/12537
#
# Tcl code harvested on:  10 Feb 2005, 04:16 GMT




︙


77
78
79
80
81
82
83
84

85
86
87
88
89
90
91

75
76
77
78
79
80
81

82
83
84
85
86
87
88
89








-
+








	    return $res
	}
    }
    return [list $class {} {}]
}


package provide fileutil::magic::filetype 2.0
package provide fileutil::magic::filetype 2.0.1


namespace eval ::fileutil::magic::filetype {
# The actual recognizer is the command below.

##
## -- Do not edit after this line !




︙





Changes to modules/fumagic/pkgIndex.tcl.





1
2
3
4

5
6
7
8
9
10
11

1
2
3

4
5
6
7
8
9
10
11




-
+








if {![package vsatisfies [package provide Tcl] 8.6]} {return}

# Recognizers
package ifneeded fileutil::magic::filetype 2.0 [list source [file join $dir filetypes.tcl]]
package ifneeded fileutil::magic::filetype 2.0.1 [list source [file join $dir filetypes.tcl]]

# Runtime
package ifneeded fileutil::magic::rt 3.0 [list source [file join $dir rtcore.tcl]]

# Compiler packages
package ifneeded fileutil::magic::cgen   1.3.0 [list source [file join $dir cgen.tcl]]
package ifneeded fileutil::magic::cfront 1.3.0 [list source [file join $dir cfront.tcl]]




︙





Changes to modules/irc/irc.tcl.






︙


521
522
523
524
525
526
527
528

529
530
531

521
522
523
524
525
526
527

528
529
530
531








-
+




    set returncommand [format "%s::irc%s::network" [namespace current] $conn]
    incr conn
    return $returncommand
}

# -------------------------------------------------------------------------

package provide irc 0.6.2
package provide irc 0.7.0

# -------------------------------------------------------------------------
return






Changes to modules/ldap/ldapx.tcl.





1
2
3
4
5
6
7
8
9
10
11
12
13
14

1
2
3
4
5


6
7
8
9
10
11
12






-
-








#
# Extended object interface to entries in LDAP directories or LDIF files.
#
# (c) 2006-2018 Pierre David ([email protected])
#
# $Id: ldapx.tcl,v 1.12 2008/02/07 21:19:39 pdav Exp $
#
# History:
#   2006/08/08 : pda : design
#

package require Tcl 8.5
package require snit		;# tcllib
package require uri 1.1.5	;# tcllib




︙





Changes to modules/ldap/pkgIndex.tcl.





1
2
3
4
5
6
7


1
2
3
4
5
6

7







-
+

# Tcl package index file, version 1.1

if {![package vsatisfies [package provide Tcl] 8.5]} {return}
package ifneeded ldap 1.10.1 [list source [file join $dir ldap.tcl]]

# the OO level wrapper for ldap
package ifneeded ldapx 1.1 [list source [file join $dir ldapx.tcl]]
package ifneeded ldapx 1.2 [list source [file join $dir ldapx.tcl]]






Changes to modules/markdown/markdown.tcl.






︙


400
401
402
403
404
405
406
407

408
409
410
411
412
413
414

400
401
402
403
404
405
406

407
408
409
410
411
412
413
414








-
+








			<$list_type>\n \
			[join $list_result \n] \
			</$list_type>\n\n
                }
                {^<(?:p|div|h[1-6]|blockquote|pre|table|dl|ol|ul|script|noscript|form|fieldset|iframe|math|ins|del)} {
                    # HTML BLOCKS
                    set block_tag [string range $line_match 1 end]
                    set re_htmltag {<(/?)(\w+)(?:\s+\w+=(?:\"[^\"]+\"|'[^']+'))*\s*>}
		    set re_htmltag {<(/?)(\w+)(?:\s+\w+(?:=\"[^\"]+\"|'[^']+')?)*\s*>}

                    set block_lines 0
                    set buffer {}
                    while {$index < $no_lines} {
                        append buffer $line \n

                        incr block_lines




︙


429
430
431
432
433
434
435
436

437
438
439
440
441
442
443
444

429
430
431
432
433
434
435

436

437
438
439
440
441
442
443








-
+
-









                        if {$stack_count == 0} break

                        set line [lindex $lines $index]
                    }

                    # Skip empty lines after the block.
                    while {$index < $no_lines
                    while {$index < $no_lines && [is_empty_line [lindex $lines $index]]} {
                           && [regexp {^\s*$} [lindex $lines $index]]} {
                        incr index
                    }

                    if {$index < $no_lines} {
                        append buffer \n
                    }





︙





Changes to modules/markdown/markdown.test.






︙


471
472
473
474
475
476
477
478
479

480




481





































































482
483
484
485
486
487
488

471
472
473
474
475
476
477
478
479
480

481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561










+
-
+
+
+
+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+








test img-1.5 {image link with single space as alt text} -body {
    convert {
        ![ ](https://www.url.com)
    }
} -result {
    <p><img src="https://www.url.com" alt=" "/></p>
}

#-------------------------------------------------------------------------
# Attribute mishandling in HTML block tags. Ticket [0d23817f75]
# Tests with texts from the original markdown page at daringfireball.net

test div-1.1 {[0d23817f75] embedded html on a line surrounded by empty lines having html attribute without value} -body {
    convert {
        hello

        <div allowfullscreen></div>

        hello again
    }
} -result {
    <p>hello</p>

    <div allowfullscreen></div>

    <p>hello again</p>
}

test div-1.2 {[0d23817f75] embedded html on a line surrounded by empty lines having html attribute with value} -body {
    convert {
        hello

        <div allowfullscreen="1"></div>

        hello again
    }
} -result {
    <p>hello</p>

    <div allowfullscreen="1"></div>

    <p>hello again</p>
}

#-------------------------------------------------------------------------
# known bugs in div handling - Ticket [57f151c354]

test div-1.3 {[57f151c354] embedded div on a line in a paragraph} -body {
    convert {
        hello
        <div allowfullscreen></div>
        hello again
    }
} -constraints knownbug -result {
    <p>hello</p>

    <div allowfullscreen></div>

    <p>hello again</p>
}
# actual result:
# <p>hello
# &lt;div allowfullscreen&gt;</div>
# hello again</p>

test div-1.4 {[57f151c354] embedded div with attribute on a line in a paragraph} -body {
    convert {
        hello
        <div allowfullscreen="1"></div>
        hello again
    }
} -constraints knownbug -result {
    <p>hello</p>

    <div allowfullscreen="1"></div>

    <p>hello again</p>
}
# actual result:
# <p>hello
# <div allowfullscreen="1"></div>
# hello again</p>

#-------------------------------------------------------------------------
# Tests with texts from the original markdown page at daringfireball.net

test gruber-1.1 {a sample text} -body {
    convert {
        A First Level Header
        ====================

        A Second Level Header




︙





Changes to modules/math/bigfloat.tcl.






︙


2309
2310
2311
2312
2313
2314
2315
2316


2309
2310
2311
2312
2313
2314
2315

2316








-
+

        namespace export $function
    }
}

# (AM) No "namespace import" - this should be left to the user!
#namespace import ::math::bigfloat::*

package provide math::bigfloat 1.2.2
package provide math::bigfloat 1.2.3






Changes to modules/math/pkgIndex.tcl.






︙


10
11
12
13
14
15
16
17

18
19
20
21
22
23
24
25
26
27

28
29
30
31
32
33
34

10
11
12
13
14
15
16

17
18
19
20
21
22
23
24
25
26

27
28
29
30
31
32
33
34








-
+









-
+








if {![package vsatisfies [package provide Tcl] 8.3]} {return}
package ifneeded math::roman             1.0   [list source [file join $dir romannumerals.tcl]]

if {![package vsatisfies [package provide Tcl] 8.4]} {return}
package ifneeded math::optimize          1.0.1 [list source [file join $dir optimize.tcl]]
package ifneeded math::interpolate       1.1.2 [list source [file join $dir interpolate.tcl]]
package ifneeded math::bignum            3.1.1 [list source [file join $dir bignum.tcl]]
package ifneeded math::bigfloat          1.2.2 [list source [file join $dir bigfloat.tcl]]
package ifneeded math::bigfloat          1.2.3 [list source [file join $dir bigfloat.tcl]]
package ifneeded math::machineparameters 0.1   [list source [file join $dir machineparameters.tcl]]

if {![package vsatisfies [package provide Tcl] 8.5]} {return}
package ifneeded math::calculus          0.8.2 [list source [file join $dir calculus.tcl]]
# statistics depends on linearalgebra (for multi-variate linear regression).
# statistics depends on optimize (for logistic regression).
package ifneeded math::statistics        1.5.0 [list source [file join $dir statistics.tcl]]
package ifneeded math::linearalgebra     1.1.6 [list source [file join $dir linalg.tcl]]
package ifneeded math::calculus::symdiff 1.0.1 [list source [file join $dir symdiff.tcl]]
package ifneeded math::bigfloat          2.0.2 [list source [file join $dir bigfloat2.tcl]]
package ifneeded math::bigfloat          2.0.3 [list source [file join $dir bigfloat2.tcl]]
package ifneeded math::numtheory         1.1.3 [list source [file join $dir numtheory.tcl]]
package ifneeded math::decimal           1.0.4 [list source [file join $dir decimal.tcl]]
package ifneeded math::geometry          1.4.1 [list source [file join $dir geometry.tcl]]
package ifneeded math::trig              1.0   [list source [file join $dir trig.tcl]]
package ifneeded math::quasirandom       1.0   [list source [file join $dir quasirandom.tcl]]
package ifneeded math::special           0.5.2 [list source [file join $dir special.tcl]]





︙





Added modules/mkdoc/LICENSE.



































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

BSD 3-Clause License

Copyright (c) 2022, D Groth
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its
   contributors may be used to endorse or promote products derived from
   this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.






Added modules/mkdoc/Makefile.












1
2
3
4
5
6

+
+
+
+
+
+

VERSION=$(shell tclsh mkdoc.tcl --version)

mkdoc:
	dtplite -o mkdoc.html html mkdoc.man
	tclsh mkdoc.tcl mkdoc.tcl mkdoc.md
	tclsh mkdoc.tcl mkdoc.tcl mkdoc-mkdoc.html






Added modules/mkdoc/README.md.































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

# mkdoc

Source code documentation tool using embedded Markdown for programming
languages supporting either multiline comments or at least the # character for comments.


* Download current code and manuals:  [mkdoc.zip](https://downgit.github.io/#/home?url=https://github.com/mittelmark/mkdoc/tree/main/mkdoc)
* Short Manual generated from doctools manpage [mkdoc.html](http://htmlpreview.github.io/?https://github.com/mittelmark/mkdoc/blob/master/mkdoc/mkdoc.html)
* Long Manual generated from mkdoc.tcl directly [mkdoc-mkdoc.html](http://htmlpreview.github.io/?https://github.com/mittelmark/mkdoc/blob/master/mkdoc/mkdoc-mkdoc.html)

Here an example of an embedded mkdoc comment for a Python script:

```python

#' **hw()**
#'  
#' > Function prints "Hello World!" to the terminal!"
#'  
#' > Arguments: 
#'  
#' > - _n_ - how often the string "Hello World!" should be printed, default: 3 
#'  
#' > Returns: None
#'  
#' > Example:
#'  
#' ```
#' hw(5)
#' ```
#'   
def hw(n=3):
    for i in range(0,n):  
       print("Hello World!")
    
```

Markdown documentation comments for programming languages which have not the hash character as a comment character can be embedded using multliline comments. Here an example for a C or C++ programm:

```c
/*
#' **void hw(int n);**
#' ...
*/
void hw(int n) {
    int i = 0;
    for (i = 0 ; i < n; i=i+1) {
        printf("Hello World!\n");
    }
}
```   

A more extended example can be seen within the script
[mkdoc/mkdoc.tcl](https://github.com/mittelmark/mkdoc/blob/main/mkdoc/mkdoc.tcl)
itself. These comments are used to create the longer manual which can be seen here: [mkdoc-mkdoc.html](http://htmlpreview.github.io/?https://github.com/mittelmark/mkdoc/blob/master/mkdoc/mkdoc-mkdoc.html).


  






Added modules/mkdoc/mkdoc.man.






































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

[comment {-*- mode: tcl ;fill-column: 90 -*- doctools manpage}]
[vset VERSION 0.7.0]
[manpage_begin mkdoc n [vset VERSION]]
[copyright {2019-2022, Detlef Groth <detlef(at)dgroth(dot)de>}]
[moddesc   {Source code documentation using Markdown}]
[titledesc {Extracts and optionally converts Markdown comments in source code to HTML}]
[category  {Text processing}]
[require Tcl 8.6]
[require Markdown [opt 1.2.1]]
[require yaml [opt 0.4.1]]
[require mkdoc [opt [vset VERSION]]]
[require hook]
[description]

The package [package mkdoc] provides a command to extract documentation embedded in code
and optionally convert these comments into HTML.

The latter uses Tcllib's [package Markdown] package.

Each line of the embedded documentation begins with the special comment marker
[const "#'"].

[list_begin definitions]

[call [cmd ::mkdoc::mkdoc] [arg infile] [arg outfile] [opt "[option -css] [arg cssfile]"]]

The command reads the specified [arg infile] and extracts the code comments introduced by
the [const " #'"] marker.  If the [arg outfile] is either a [file .html] or [file .htm]
file the Markdown is converted into HTML using either a default style or the specified
style sheet [arg cssfile].

[para] All arguments are paths to the files to read from or write to.

[para] The result of the command is the empty string.

[para] See section [sectref Formatting] for the supported Markdown syntax and extensions
to it.

[call [cmd ::mkdoc::run] [arg infile]]

The command reads the specified [arg infile], extracts the embedded documentation, and
then executes the contents of the first example, i.e. [const ```]-quoted block, found in
the [const Example] section.

[para] Here is such an example which will be executed by the Tcl interpreter

[example {
    #' ## <a name="example">Example</a>
    #' 
    #' ```
    #' puts "Hello mkdoc package"
    #' puts "I am in the example section"
    #' ```
}]

[para] [strong {DANGER, BEWARE}].
Failing to open the [arg infile] causes the command to [strong exit] the entire process.

[para] Use of this command in a general context is not recommended.

[list_end]

[section Examples]

The example below demonstrates the conversion of the documentation embedded into the file
[file mkdoc.tcl] itself:

[para][example {
    package require mkdoc
    # extracting the Markdown
    mkdoc::mkdoc mkdoc.tcl mkdoc.md
    # converting Markdown to HTML
    mkdoc::mkdoc mkdoc.md mkdoc.html
    # direct conversion without intermediate file
    mkdoc::mkdoc mkdoc.tcl mkdoc.html
}]

[section Formatting]

The package supports the syntax supported by Tcllib's [package Markdown] package.

[para] It further supports a set of simple YAML headers whose information is inserted into
appropriate HTML [const meta]-tags. The supported keys are

[list_begin definitions]
[def [const author]] Set the document author. Defaults to [const NN].
[def [const title]] Set the document title. Defaults to [const "Documentation "][var filename]].
[def [const date]] Sets the document date. Defaults to the current day.
[def [const css]] Sets a custom CSS stylesheet. Defaults to the internal mkdoc sheet.
[list_end]

[para] [emph Note] that in Markdown output mode these headers are simply passed through
into the result. This is proper, as processors like [syscmd pandoc] are able to use them
as well.

[para] See the example below for the syntax:

[example {
    #' ---
    #' title: mkdoc::mkdoc 0.7.0
    #' author: Detlef Groth, Schwielowsee, Germany
    #' date: 2022-04-17 
    #' css: mini.css 
    #' ---
    #'
}]


[para] Another extension over standard Markdown is the support of a single level of includes.

[para] See the example below for the syntax:

[example {
    #' #include "path/to/include/file"
}]

[para] [emph Note], the double-quotes around the path are part of the syntax.

[para] [strong Beware] further that relative paths are resolved relative to the current
working directory, and [strong not] relative to the location of the including file.

[section "Bugs, Ideas, Feedback"]

This document, and the package it describes, will undoubtedly contain bugs and other
problems. Please report such to the author of this package. Please also report any ideas
for enhancements you may have for either package and/or documentation.

[section "Code Copyright"]

BSD License type:

[para] The following terms apply to all files a ssociated with the software unless
explicitly disclaimed in individual files.

[para] The authors hereby grant permission to use, copy, modify, distribute, and license
this software and its documentation for any purpose, provided that existing copyright
notices are retained in all copies and that this notice is included verbatim in any
distributions. No written agreement, license, or royalty fee is required for any of the
authorized uses.  Modifications to this software may be copyrighted by their authors and
need not follow the licensing terms described here, provided that the new terms are
clearly indicated on the first page of each file where they apply.

[para] In no event shall the authors or distributors be liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use of this
software, its documentation, or any derivatives thereof, even if the authors have been
advised of the possibility of such damage.

[para] The authors and distributors specifically disclaim any warranties, including, but
not limited to, the implied warranties of merchantability, fitness for a particular
purpose, and non-infringement.

This software is provided on an "as is" basis, and the authors and distributors have no
obligation to provide maintenance, support, updates, enhancements, or modifications.

[para] [strong {RESTRICTED RIGHTS}]: Use, duplication or disclosure by the government is
subject to the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in
Technical Data and Computer Software Clause as DFARS 252.227-7013 and FAR 52.227-19.

[vset CATEGORY mkdoc]
[manpage_end]






Added modules/mkdoc/mkdoc.tcl.



































































































































































































































































































































































































































































































































































































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

# -*- mode: tcl ; fill-column: 80 -*-
##############################################################################
#  Author        : Dr. Detlef Groth
#  Created       : Fri Nov 15 10:20:22 2019
#  Last Modified : <220423.0622>
#
#  Description	 : Command line utility and package to extract Markdown documentation 
#                  from programming code if embedded as after comment sequence #' 
#                  manual pages and installation of Tcl files as Tcl modules.
#                  Copy and adaptation of dgw/dgwutils.tcl
#
#  History       : 2019-11-08 version 0.1
#                  2019-11-28 version 0.2
#                  2020-02-26 version 0.3
#                  2020-11-10 Release 0.4
#                  2020-12-30 Release 0.5 (rox2md)
#                  2022-02-09 Release 0.6
#                  2022-04-XX Release 0.7 (minimal)
#	
##############################################################################
#
# Copyright (c) 2019-2022  Dr. Detlef Groth, E-mail: detlef(at)dgroth(dot)de
# 
# This library is free software; you can use, modify, and redistribute it for
# any purpose, provided that existing copyright notices are retained in all
# copies and that this notice is included verbatim in any distributions.
# 
# This software is distributed WITHOUT ANY WARRANTY; without even the implied
# warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
#
##############################################################################
#' ---
#' title: mkdoc::mkdoc 0.7.0
#' author: Detlef Groth, Schwielowsee, Germany
#' css: mkdoc.css
#' ---
#' 
#' <center> Manual: [short (doctools)](mkdoc.html) - [long (mkdoc)](mkdoc-mkdoc.html) </center>
#'
#' ## NAME
#'
#' **mkdoc::mkdoc**  - Tcl package and command line application to extract and format 
#' embedded programming documentation from source code files written in Markdown or
#' doctools format and optionally converting it into HTML.
#'
#' ## <a name='toc'></a>TABLE OF CONTENTS
#' 
#'  - [SYNOPSIS](#synopsis)
#'  - [DESCRIPTION](#description)
#'  - [COMMAND](#command)
#'      - [mkdoc::mkdoc](#mkdoc)
#'      - [mkdoc::run](#run)
#'  - [EXAMPLE](#example)
#'  - [BASIC FORMATTING](#format)
#'  - [INSTALLATION](#install)
#'  - [SEE ALSO](#see)
#'  - [CHANGES](#changes)
#'  - [TODO](#todo)
#'  - [AUTHOR](#authors)
#'  - [LICENSE AND COPYRIGHT](#license)
#'
#' ## <a name='synopsis'>SYNOPSIS</a>
#' 
#' Usage as package:
#'
#' ```
#' package require mkdoc::mkdoc
#' mkdoc::mkdoc inputfile outputfile ?-css file.css?
#' ```
#'
#' Usage as command line application for extraction of Markdown comments prefixed with `#'`:
#'
#' ```
#' mkdoc inputfile outputfile ?--css file.css?
#' ```
#'
#' Usage as command line application for conversion of Markdown to HTML:
#'
#' ```
#' mkdoc inputfile.md outputfile.html ?--css file.css?
#' ```
#'
#' ## <a name='description'>DESCRIPTION</a>
#' 
#' **mkdoc::mkdoc**  extracts embedded Markdown or doctools documentation from source code files
#' and  as well converts Markdown the output to HTML if desired.
#' The documentation inside the source code must be prefixed with the `#'` character sequence.
#' The file extension of the output file determines the output format. 
#' File extensions can bei either `.md` for Markdown output, `.man` for doctools output or `.html` for html output.
#' The latter requires the tcllib Markdown or the doctools extensions to be installed.
#' If the file extension of the inputfile is *.md* and file extension of the output files is *.html* 
#' there will be simply a conversion from a Markdown to a HTML file.
#'
#' The file `mkdoc.tcl` can be as well directly used as a console application. 
#' An explanation on how to do this, is given in the section [Installation](#install).
#'
#' ## <a name='command'>COMMAND</a>
#'
#'  <a name="mkdoc"> </a>
#' **mkdoc::mkdoc** *infile outfile ?-css file.css?*
#' 
#' > Extracts the documentation in Markdown format from *infile* and writes the documentation 
#'    to *outfile* either in Markdown, Doctools  or HTML format. 
#' 
#' > - *infile* - file with embedded markdown documentation
#'   - *outfile* -  name of output file extension
#'   - *-css cssfile* if outfile is an HTML file use the given *cssfile*
#'     
#' > If the file extension of the outfile is either html or htm a HTML file is created. If the output file has other 
#'   file extension the documentation after _#'_ comments is simply extracted and stored in the given _outfile_, *-mode* flag  (one of -html, -md, -pandoc) is not given, the output format is taken from the file extension of the output file, either *.html* for HTML or *.md* for Markdown format. This deduction from the filetype can be overwritten giving either `-html` or `-md` as command line flags. If as mode `-pandoc` is given, the Markdown markup code as well contains the YAML header.
#'   If infile has the extension .md (Markdown) or -man (Doctools) than conversion to html will be performed, outfile file extension
#'   In this case must be .html. If output is html a *-css* flag can be given to use the given stylesheet file instead of the default style sheet embedded within the mkdoc code.
#'  
#' > Example:
#'
#' > ```
#' package require mkdoc::mkdoc
#' mkdoc::mkdoc mkdoc.tcl mkdoc.html
#' mkdoc::mkdoc mkdoc.tcl mkdoc.md 
#' > ```

package require Tcl 8.6

package require yaml
package require Markdown
package require hook

package provide mkdoc 0.7.0

namespace eval mkdoc {
    variable deindent [list \n\t \n "\n    " \n]
    
    variable htmltemplate [string map $deindent {
	<!DOCTYPE html>
	<html>
	<head>
	<meta http-equiv="Content-Security-Policy" content="default-src 'self' data: ; script-src 'self' 'nonce-d717cfb5d902616b7024920ae20346a8494f7832145c90e0' ; style-src 'self' 'unsafe-inline'" />
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<meta name="title" content="$document(title)">
	<meta name="author" content="$document(author)">
	<title>$document(title)</title>
	$style
	</head>
	<body>
    }]

    variable htmlstart [string map $deindent {
	<h1 class="title">$document(title)</h1>
	<h2 class="author">$document(author)</h2>
	<h2 class="date">$document(date)</h2>
    }]

    variable mkdocstyle [string map $deindent {
	body {
	    margin-left: 10%; margin-right: 10%;
	    font-family: Palatino, "Palatino Linotype", "Palatino LT STD", "Book Antiqua", Georgia, serif;
	    max-width: 90%;
	}
	pre {
	    padding-top:	1ex;
	    padding-bottom:	1ex;
	    padding-left:	2ex;
	    padding-right:	1ex;
	    width:		100%;
	    color: 		black;
	    background: 	#fff4e4;
	    border-top:		1px solid black;
	    border-bottom:		1px solid black;
	    font-family: Monaco, Consolas, "Liberation Mono", Menlo, Courier, monospace;
	}
	a {
	    text-decoration: none
	}
	pre.synopsis {
	    background: #cceeff;
	}
	pre.code code.tclin {
	    background-color: #ffeeee;
	}
	pre.code code.tclout {
	    background-color: #ffffee;
	}
	code {
	    font-family: Consolas, "Liberation Mono", Menlo, Courier, monospace;
	}
	h1,h2, h3,h4 {
	    font-family:	sans-serif;
	    background: 	transparent;
	}
	h1 {
	    font-size: 120%;
	    text-align: center;
	}

	h2.author, h2.date {
	    text-align: center;
	    color: black;
	}
	h2 {    font-size: 110%; }
	h3, h4 {  font-size: 100% }
	div.title h1 {
	    font-family: sans-serif;
	    font-size:   120%;
	    background:  transparent;
	    text-align:  center;
	    color:       black;
	}
	div.author h3, div.date h3 {
	    font-family:	sans-serif;
	    font-size:	110%;
	    background: 	transparent;
	    text-align:	center;
	    color: black ;
	}
	h2, h3 {
	    margin-top:  1em;
	    font-family: sans-serif;
	    font-size:	 110%;
	    color:	 #005A9C;
	    background:  transparent;
	    text-align:	 left;
	}
    }]
} 

proc mkdoc::mkdoc {filename outfile args} {
    variable htmltemplate
    variable htmlstart
    variable mkdocstyle

    array set arg [list -css ""]
    array set arg $args
    if {[file extension $filename] eq [file extension $outfile]} {
	return -code error "Error: infile and outfile must have different file extensions!"
    }
    set outmode html
    if {[file extension $outfile] in [list .md .man]} {
        set outmode markup
    }
    set inmode  code
    if {[file extension $filename] in [list .md .man]} {
        set inmode markup
    }

    hook call mkdoc::mkdoc Processing $filename $inmode $outmode
    
    set markdown ""
    if [catch {
	open $filename r
    } infh] {
        return -code error "Cannot open $filename: $infh"
    } else {
        set flag false
        while {[gets $infh line] >= 0} {
	    if {[regexp {^\s*#' +#include +"(.*)"} $line -> include]} {
                if [catch {
		    open $include r
		} iinfh] {
                    return -code error "Cannot open include file $include: $iinfh"
                } else {
                    #set ilines [read $iinfh]
                    while {[gets $iinfh iline] >= 0} {
                        # Process line
                        append markdown "$iline\n"
                    }
                    close $iinfh
                }
            } elseif {$inmode eq "code" && [regexp {^\s*#' ?(.*)} $line -> md]} {
                append markdown "$md\n"
            } elseif {$inmode eq "markup"} {
                append markdown "$line\n"
            }
        }
        close $infh
        set yamldict \
	    [dict create \
		 title  "Documentation [file tail [file rootname $filename]]" \
		 author NN \
		 date   [clock format [clock seconds] -format "%Y-%m-%d"] \
		 css    mkdoc.css]

	hook call mkdoc::mkdoc Header/Defaults $yamldict

	set mdhtml ""
        set yamlflag false
        set yamltext ""
        set hasyaml false
        set indent ""
        set header $htmltemplate
        set lnr 0
        foreach line [split $markdown "\n"] {
            incr lnr 
            if {$lnr < 5 && !$yamlflag && [regexp {^---} $line]} {
                set yamlflag true
            } elseif {$yamlflag && [regexp {^---} $line]} {
                set hasyaml true
		
                set yamldict [dict merge $yamldict [yaml::yaml2dict $yamltext]]

		hook call mkdoc::mkdoc Header/YAML $yamldict

                set yamlflag false
            } elseif {$yamlflag} {
                append yamltext "$line\n"
            } else {
                set line [regsub -all {!\[\]\((.+?)\)} $line "<image src=\"\\1\"></img>"]
                append mdhtml "$indent$line\n"
            }
        }
        if {$arg(-css) ne ""} {
            dict set yamldict css $arg(-css)
        }

	# Regenerate yamltext from the final dict (to report the final CSS reference)
	set yamltext "---\n"
	foreach k [lsort -dict [dict keys $yamldict]] {
	    append yamltext "${k}: [dict get $yamldict $k]\n"
	}
	append yamltext "---"

	hook call mkdoc::mkdoc Header/Final $yamldict
	
	set style <style>$mkdocstyle</style>

        if {$outmode eq "html"} {
            if {[dict get $yamldict css] ne "mkdoc.css"} {
		# Switch from embedded style to external link
                set style "<link rel=\"stylesheet\" href=\"[dict get $yamldict css]\">"
            }
            set html [Markdown::convert $mdhtml]
            set out [open $outfile w 0644]
            foreach key [dict keys $yamldict] {
                set document($key) [dict get $yamldict $key]
            }
            if {![dict exists $yamldict date]} {
                dict set yamldict date [clock format [clock seconds]]
            }
            set header [subst -nobackslashes -nocommands $header]
            puts $out $header
            if {$hasyaml} {
                set start [subst -nobackslashes -nocommands $htmlstart]            
                puts $out $start
            }
            puts $out $html
            puts $out "</body>\n</html>"
            close $out
        } else {
            set out [open $outfile w 0644]
            puts $out $yamltext
            puts $out $mdhtml
            close $out
        }

	hook call mkdoc::mkdoc Done $outfile
    }
}

#' 
#' <a name="run"> </a>
#' **mkdoc::run** *infile* 
#' 
#' > Source the code in infile and runs the examples in the documentation section
#'    written with Markdown documentation. Below follows an example section which can be
#'    run with `tclsh mkdoc.tcl mkdoc.tcl --run`
#' 
#' ## <a name="example">EXAMPLE</a>
#' 
#' ```
#' puts "Hello mkdoc package"
#' puts "I am in the example section"
#' ```
#' 
proc ::mkdoc::run {argv} {
    set filename [lindex $argv 0]
    if {[llength $argv] == 3} {
        set t [lindex $argv 2]
    } else {
        set t 1
    }
    source $filename
    set extext ""
    set example false
    set excode false
    if [catch {
	open $filename r
    } infh] {
	return -code error "Cannot open $filename: $infh"
    } else {
	while {[gets $infh line] >= 0} {
	    # Process line
	    if {$extext eq "" && \
		    [regexp -nocase {^\s*#'\s+#{2,3}\s.+Example} $line]} {
                set example true
            } elseif {$extext ne "" && \
			  [regexp -nocase "^\\s*#'.*\\s# demo: $extext" $line]} {
                set excode true
            } elseif {$example && [regexp {^\s*#'\s+>?\s*```} $line]} {
                set example false
                set excode true
            } elseif {$excode && [regexp {^\s*#'\s+>?\s*```} $line]} {
                namespace eval :: $code
                break
                # eval code
            } elseif {$excode && [regexp {^\s*#'\s(.+)} $line -> c]} {
                append code "$c\n"
            }
        }
        close $infh
        if {$t > -1} {
            catch {
                update idletasks
                after [expr {$t*1000}]
                destroy .
            }
        }
    }
}

#'
#' ## <a name='format'>BASIC FORMATTING</a>
#' 
#' For a complete list of Markdown formatting commands consult the basic Markdown syntax at [https://daringfireball.net](https://daringfireball.net/projects/markdown/syntax). 
#' Here just the most basic essentials  to create documentation are described.
#' Please note, that formatting blocks in Markdown are separated by an empty line, and empty line in this documenting mode is a line prefixed with the `#'` and nothing thereafter. 
#'
#' **Title and Author**
#' 
#' Title and author can be set at the beginning of the documentation in a so called YAML header. 
#' This header will be as well used by the document converter [pandoc](https://pandoc.org)  to handle various options for later processing if you extract not HTML but Markdown code from your documentation.
#'
#' A YAML header starts and ends with three hyphens. Here is the YAML header of this document:
#' 
#' ```
#' #' ---
#' #' title: mkdoc - Markdown extractor and formatter
#' #' author: Dr. Detlef Groth, Schwielowsee, Germany
#' #' ---
#' ```
#' 
#' Those four lines produce the two lines on top of this document. You can extend the header if you would like to process your document after extracting the Markdown with other tools, for instance with Pandoc.
#' 
#' You can as well specify an other style sheet, than the default by adding
#' the following style information:
#'
#' ```
#' #' ---
#' #' title: mkdoc - Markdown extractor and formatter
#' #' author: Dr. Detlef Groth, Schwielowsee, Germany
#' #' css: tufte.css
#' #' ---
#' ```
#' 
#' Please note, that the indentation is required and it is two spaces.
#'
#' **Headers**
#'
#' Headers are prefixed with the hash symbol, single hash stands for level 1 heading, double hashes for level 2 heading, etc.
#' Please note, that the embedded style sheet centers level 1 and level 3 headers, there are intended to be used
#' for the page title (h1), author (h3) and date information (h3) on top of the page.
#' 
#' ```
#'   #'  ## <a name="sectionname">Section title</a>
#'   #'    
#'   #'  Some free text that follows after the required empty 
#'   #'  line above ...
#' ```
#'
#' This produces a level 2 header. Please note, if you have a section name `synopsis` the code fragments thereafer will be hilighted different than the other code fragments. You should only use level 2 and 3 headers for the documentation. Level 1 header are reserved for the title.
#' 
#' **Lists**
#'
#' Lists can be given either using hyphens or stars at the beginning of a line.
#'
#' ```
#' #' - item 1
#' #' - item 2
#' #' - item 3
#' ```
#' 
#' Here the output:
#'
#' - item 1
#' - item 2
#' - item 3
#' 
#' A special list on top of the help page could be the table of contents list. Here is an example:
#'
#' ```
#' #' ## Table of Contents
#' #'
#' #' - [Synopsis](#synopsis)
#' #' - [Description](#description)
#' #' - [Command](#command)
#' #' - [Example](#example)
#' #' - [Authors](#author)
#' ```
#'
#' This will produce in HTML mode a clickable hyperlink list. You should however create
#' the name targets using html code like so:
#'
#' ```
#' ## <a name='synopsis'>Synopsis</a> 
#' ```
#' 
#' **Hyperlinks**
#'
#' Hyperlinks are written with the following markup code:
#'
#' ```
#' [Link text](URL)
#' ```
#' 
#' Let's link to the Tcler's Wiki:
#' 
#' ```
#' [Tcler's Wiki](https://wiki.tcl-lang.org/)
#' ```
#' 
#' produces: [Tcler's Wiki](https://wiki.tcl-lang.org/)
#'
#' **Indentations**
#'
#' Indentations are achieved using the greater sign:
#' 
#' ```
#' #' Some text before
#' #'
#' #' > this will be indented
#' #'
#' #' This will be not indented again
#' ```
#' 
#' Here the output:
#'
#' Some text before
#' 
#' > this will be indented
#' 
#' This will be not indented again
#'
#' Also lists can be indented:
#' 
#' ```
#' > - item 1
#'   - item 2
#'   - item 3
#' ```
#'
#' produces:
#'
#' > - item 1
#'   - item 2
#'   - item 3
#'
#' **Fontfaces**
#' 
#' Italic font face can be requested by using single stars or underlines at the beginning 
#' and at the end of the text. Bold is achieved by dublicating those symbols:
#' Monospace font appears within backticks.
#' Here an example:
#' 
#' ```
#' #' > I am _italic_ and I am __bold__! But I am programming code: `ls -l`
#' ```
#'
#' > I am _italic_ and I am __bold__! But I am programming code: `ls -l`
#' 
#' **Code blocks**
#'
#' Code blocks can be started using either three or more spaces after the #' sequence 
#' or by embracing the code block with triple backticks on top and on bottom. Here an example:
#' 
#' ```
#' #' ```
#' #' puts "Hello World!"
#' #' ```
#' ```
#'
#' Here the output:
#'
#' ```
#' puts "Hello World!"
#' ```
#'
#' **Images**
#'
#' If you insist on images in your documentation, images can be embedded in Markdown with a syntax close to links.
#' The links here however start with an exclamation mark:
#' 
#' ```
#' #' ![image caption](filename.png)
#' ```
#' 
#' The source code of mkdoc.tcl is a good example for usage of this source code 
#' annotation tool. Don't overuse the possibilities of Markdown, sometimes less is more. 
#' Write clear and concise, don't use fancy visual effects.
#' 
#' **Includes**
#' 
#' mkdoc in contrast to standard markdown as well support includes. Using the `#' #include "filename.md"` syntax 
#' it is possible to include other markdown files. This might be useful for instance to include the same 
#' header or a footer in a set of related files.
#'
#' ## <a name='install'>INSTALLATION</a>
#' 
#' The mkdoc::mkdoc package can be installed either as command line application or as a Tcl module. It requires the markdown, cmdline, yaml and textutils packages from tcllib to be installed.
#' 
#' Installation as command line application is easiest by downloading the file [mkdoc-0.6.bin](https://raw.githubusercontent.com/mittelmark/DGTcl/master/bin/mkdoc-0.6.bin), which
#' contains the main script file and all required libraries, to your local machine. Rename this file to mkdoc, make it executable and coy it to a folder belonging to your PATH variable.
#' 
#' Installation as command line application can be as well done by copying the `mkdoc.tcl` as 
#' `mkdoc` to a directory which is in your executable path. You should make this file executable using `chmod`. 
#' 
#' Installation as Tcl package by copying the mkdoc folder to a folder 
#' which is in your library path for Tcl. Alternatively you can install it as Tcl mode by copying it 
#' in your module path as `mkdoc-0.6.0.tm` for instance. See the [tm manual page](https://www.tcl.tk/man/tcl8.6/TclCmd/tm.htm)
#'
#' ## <a name='see'>SEE ALSO</a>
#' 
#' - [tcllib](https://core.tcl-lang.org/tcllib/doc/trunk/embedded/index.md) for the Markdown and the textutil packages
#' - [pandoc](https://pandoc.org) - a universal document converter
#' - [Ruff!](https://github.com/apnadkarni/ruff) Ruff! documentation generator for Tcl using Markdown syntax as well

#' 
#' ## <a name='changes'>CHANGES</a>
#'
#' - 2019-11-19 Release 0.1
#' - 2019-11-22 Adding direct conversion from Markdown files to HTML files.
#' - 2019-11-27 Documentation fixes
#' - 2019-11-28 Kit version
#' - 2019-11-28 Release 0.2 to fossil
#' - 2019-12-06 Partial R-Roxygen/Markdown support
#' - 2020-01-05 Documentation fixes and version information
#' - 2020-02-02 Adding include syntax
#' - 2020-02-26 Adding stylesheet option --css 
#' - 2020-02-26 Adding files pandoc.css and dgw.css
#' - 2020-02-26 Making standalone file using pkgDeps and mk_tm
#' - 2020-02-26 Release 0.3 to fossil
#' - 2020-02-27 support for \_\_DATE\_\_, \_\_PKGNAME\_\_, \_\_PKGVERSION\_\_ macros  in Tcl code based on package provide line
#' - 2020-09-01 Roxygen2 plugin
#' - 2020-11-09 argument --run supprt
#' - 2020-11-10 Release 0.4
#' - 2020-11-11 command line option  --run with seconds
#' - 2020-12-30 Release 0.5 (rox2md @section support with preformatted, emph and strong/bold)
#' - 2022-02-11 Release 0.6.0 
#'      - parsing yaml header
#'      - workaround for images
#'      - making standalone using tpack.tcl [mkdoc-0.6.bin](https://github.com/mittelmark/DGTcl/blob/master/bin/mkdoc-0.6.bin)
#'      - terminal help update and cleanup
#'      - moved to Github in Wiki
#'      - code cleanup
#' - 2022-04-XX Release 0.7.0
#'      - removing features to simplify the code, so removed plugin support, underline placeholder and sorting facilitites to reduce code size
#'      - creating tcllib compatible manual page
#'
#' ## <a name='todo'>TODO</a>
#'
#' - dtplite support ?
#'
#' ## <a name='authors'>AUTHOR(s)</a>
#'
#' The **mkdoc::mkdoc** package was written by Dr. Detlef Groth, Schwielowsee, Germany.
#'
#' ## <a name='license'>LICENSE AND COPYRIGHT</a>
#'
#' Markdown extractor and converter mkdoc::mkdoc, version 0.7.0
#'
#' Copyright (c) 2019-22  Detlef Groth, E-mail: <detlef(at)dgroth(dot)de>
#' 
#' BSD License type:

#' Sun Microsystems, Inc. The following terms apply to all files a ssociated
#' with the software unless explicitly disclaimed in individual files. 

#' The authors hereby grant permission to use, copy, modify, distribute, and
#' license this software and its documentation for any purpose, provided that
#' existing copyright notices are retained in all copies and that this notice
#' is included verbatim in any distributions. No written agreement, license,
#' or royalty fee is required for any of the authorized uses. Modifications to
#' this software may be copyrighted by their authors and need not follow the
#' licensing terms described here, provided that the new terms are clearly
#' indicated on the first page of each file where they apply. 
#'
#' In no event shall the authors or distributors be liable to any party for
#' direct, indirect, special, incidental, or consequential damages arising out
#' of the use of this software, its documentation, or any derivatives thereof,
#' even if the authors have been advised of the possibility of such damage. 
#'
#' The authors and distributors specifically disclaim any warranties,
#' including, but not limited to, the implied warranties of merchantability,
#' fitness for a particular purpose, and non-infringement. This software is
#' provided on an "as is" basis, and the authors and distributors have no
#' obligation to provide maintenance, support, updates, enhancements, or
#' modifications. 
#'
#' RESTRICTED RIGHTS: Use, duplication or disclosure by the government is
#' subject to the restrictions as set forth in subparagraph (c) (1) (ii) of
#' the Rights in Technical Data and Computer Software Clause as DFARS
#' 252.227-7013 and FAR 52.227-19. 








Added modules/mkdoc/pkgIndex.tcl.








1
2

+
+

if {![package vsatisfies [package require Tcl] 8.6]} {return}
package ifneeded mkdoc 0.7.0 [list source [file join $dir mkdoc.tcl]]






Changes to modules/rest/pkgIndex.tcl.





1
2


1

2


-
+

if {![package vsatisfies [package provide Tcl] 8.5]} {return}
package ifneeded rest 1.4 [list source [file join $dir rest.tcl]]
package ifneeded rest 1.5 [list source [file join $dir rest.tcl]]






Changes to modules/rest/rest.man.





1
2

3
4
5
6
7
8
9

1

2
3
4
5
6
7
8
9


-
+








[comment {-*- tcl -*- doctools manpage}]
[vset VERSION 1.4]
[vset VERSION 1.5]
[manpage_begin rest n [vset VERSION]]
[moddesc   {A framework for RESTful web services}]
[titledesc {define REST web APIs and call them inline or asychronously}]
[require Tcl 8.5]
[require rest [opt [vset VERSION]]]
[description]





︙


327
328
329
330
331
332
333





334
335
336
337
338
339
340

327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345








+
+
+
+
+








[def [const basic]]

The user may configure the [term {basic authentication}] by overriding
the procedure [cmd basic_auth] in the namespace of interface. This
procedure takes two arguments, the username and password, in this
order.

[def [const bearer]]

The user may configure a bearer token as authentication. The value is
the token passed to the HTTP authorization header.

[def [const sign]]

The value must actually be a list with the second element the name of
a procedure which will be called to perform request signing.

[list_end]





︙





Changes to modules/rest/rest.tcl.





1
2
3
4
5
6
7
8
9
10
11
12
13

14
15
16
17
18
19
20

1
2
3
4
5
6
7
8
9
10
11
12

13
14
15
16
17
18
19
20













-
+








# rest.tcl --
#
# A framework for RESTful web services
#
# Copyright (c) 2009 Aaron Faupell

package require Tcl 8.5
package require http 2.7
package require json
package require tdom
package require base64

package provide rest 1.4
package provide rest 1.5

namespace eval ::rest {
    namespace export create_interface parameters parse_opts save \
    describe substitute
}

# simple --




︙


52
53
54
55
56
57
58


59

60
61
62
63
64
65
66

52
53
54
55
56
57
58
59
60

61
62
63
64
65
66
67
68








+
+
-
+








        set url [lindex [split $url ?] 0]
    }

    if {[dict exists $config auth]} {
        set auth [dict get $config auth]
        if {[lindex $auth 0] == "basic"} {
            lappend headers Authorization "Basic [base64::encode [lindex $auth 1]:[lindex $auth 2]]"
	} elseif {[lindex $auth 0] == "bearer"} {
            lappend headers Authorization "Bearer [lindex $auth 1]"
        }
	}
    }
    if {[dict exists $config content-type]} {
        lappend headers Content-type [join [dict get $config content-type] \;]
    }
    if {[dict exists $config headers]} {
        dict for {key val} [dict get $config headers] { lappend headers $key $val }
    }




︙





Changes to modules/struct/list.tcl.






︙


1827
1828
1829
1830
1831
1832
1833
1834


1827
1828
1829
1830
1831
1832
1833

1834








-
+

## Ready

namespace eval ::struct {
    # Get 'list::list' into the general structure namespace.
    namespace import -force list::list
    namespace export list
}
package provide struct::list 1.8.4
package provide struct::list 1.8.5






Changes to modules/struct/pkgIndex.tcl.






︙


13
14
15
16
17
18
19
20

21
22
23
24
25
26
27

13
14
15
16
17
18
19

20
21
22
23
24
25
26
27








-
+








package ifneeded struct::skiplist  1.3   [list source [file join $dir skiplist.tcl]]

package ifneeded struct::graph     1.2.1 [list source [file join $dir graph1.tcl]]
package ifneeded struct::tree      1.2.2 [list source [file join $dir tree1.tcl]]
package ifneeded struct::matrix    1.2.2 [list source [file join $dir matrix1.tcl]]

if {![package vsatisfies [package provide Tcl] 8.4]} {return}
package ifneeded struct::list      1.8.4  [list source [file join $dir list.tcl]]
package ifneeded struct::list        1.8.5  [list source [file join $dir list.tcl]]
package ifneeded struct::list::test  1.8.4  [list source [file join $dir list.test.tcl]]
package ifneeded struct::graph     2.4.3  [list source [file join $dir graph.tcl]]
package ifneeded struct::map       1      [list source [file join $dir map.tcl]]

if {![package vsatisfies [package provide Tcl] 8.5]} {return}

if {![package vsatisfies [package provide Tcl] 8.6]} {return}




︙





Changes to modules/struct/struct_list.man.





1
2
3

4
5
6
7
8
9
10

1


2
3
4
5
6
7
8
9


-
-
+








[comment {-*- tcl -*- doctools manpage}]
[comment {$Id: struct_list.man,v 1.24 2010/10/05 21:47:25 andreas_kupries Exp $}]
[vset LIST_VERSION 1.8.4]
[vset LIST_VERSION 1.8.5]
[manpage_begin struct::list n [vset LIST_VERSION]]
[keywords assign]
[keywords common]
[keywords comparison]
[keywords diff]
[keywords differential]
[keywords equal]




︙





Changes to modules/tar/tar.man.






1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16



17
18


































19
20
21
22
23
24
25

1
2

3
4
5
6
7
8
9
10
11
12
13



14
15
16
17

18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

+

-











-
-
-
+
+
+

-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+








[comment {-*- mode: tcl ; fill-column: 80 -*- doctools manpage}]
[vset PACKAGE_VERSION 0.11]
[comment {-*- tcl -*- doctools manpage}]
[manpage_begin tar n [vset PACKAGE_VERSION]]
[keywords archive]
[keywords {tape archive}]
[keywords tar]
[moddesc   {Tar file handling}]
[titledesc {Tar file creation, extraction & manipulation}]
[category  {File formats}]
[require Tcl 8.4]
[require tar [opt [vset PACKAGE_VERSION]]]
[description]

[para] Note: Starting with version 0.8 the tar reader commands
(contents, stats, get, untar) support the GNU LongName extension
(header type 'L') for large paths.
[para] [strong Note]: Starting with version 0.8 the tar reader commands
(contents, stats, get, untar) support the GNU LongName extension (header type
'L') for large paths.

[para]
[para] 

[section BEWARE]

For all commands, when using [option -chan] ...

[list_begin enumerated]

[enum] It is assumed that the channel was opened for reading, and configured for
       binary input.

[enum] It is assumed that the channel position is at the beginning of a legal
       tar file.

[enum] The commands will [emph modify] the channel position as they perform their
       task.

[enum] The commands will [emph not] close the channel.

[enum] In other words, the commands leave the channel in a state very likely
       unsuitable for use by further [cmd tar] commands. Still doing so will
       very likely results in errors, bad data, etc. pp.

[enum] It is the responsibility of the user to seek the channel back to a
       suitable position.

[enum] When using a channel transformation which is not generally seekable, for
       example [cmd gunzip], then it is the responsibility of the user to (a)
       unstack the transformation before seeking the channel back to a suitable
       position, and (b) for restacking it after.

[list_end]

[section COMMANDS]

[list_begin definitions]

[call [cmd ::tar::contents] [arg tarball] [opt [option -chan]]]

Returns a list of the files contained in [arg tarball]. The order is not sorted and depends on the order
files were stored in the archive.




︙





Changes to modules/websocket/pkgIndex.tcl.





1
2
3
4
5
6
7
8
9
10
11














1
2

-
-
-
-
-
-
-
-
-
-
-
+
+

# Tcl package index file, version 1.1
# This file is generated by the "pkg_mkIndex" command
# and sourced either when an application starts up or
# by a "package unknown" script.  It invokes the
# "package ifneeded" command to set up package-related
# information so that packages will be loaded automatically
# in response to "package require" commands.  When this
# script is sourced, the variable $dir must contain the
# full path name of this file's directory.

package ifneeded websocket 1.4.1 [list source [file join $dir websocket.tcl]]
if {![package vsatisfies [package provide Tcl] 8.5]} {return}
package ifneeded websocket 1.4.2 [list source [file join $dir websocket.tcl]]






Changes to modules/websocket/websocket.man.





1
2

3
4
5
6
7
8
9

1

2
3
4
5
6
7
8
9


-
+








[comment {-*- tcl -*- doctools manpage}]
[vset WEBSOCKET_VERSION 1.3.1]
[vset WEBSOCKET_VERSION 1.4.2]
[manpage_begin websocket n [vset WEBSOCKET_VERSION]]
[see_also http]
[keywords http]
[keywords internet]
[keywords net]
[keywords {rfc 6455}]
[moddesc {websocket client and server}]




︙





Changes to modules/websocket/websocket.tcl.






︙


373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389

373
374
375
376
377
378
379



380
381
382
383
384
385
386








-
-
-








	    connection {
		foreach v [SplitCommaSeparated $v] {
		    if {"upgrade" eq [ASCIILowercase $v]} {
			set upgrading 1
			break
		    }
		}
		if {!$upgrading} {
		    ThrowError "No 'Connect' header with 'upgrade' token found" HANDSHAKE CONNECTION
		}
	    }
	    upgrade {
		# May be a list, see
		# <http://tools.ietf.org/html/rfc7230#section-6.7> and
		# <http://tools.ietf.org/html/rfc6455#section-4.1>.
		foreach v [SplitCommaSeparated $v] {
		    # The protocol-name may be followed by a slash and a




︙


429
430
431
432
433
434
435



436
437
438
439
440
441
442

426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442








+
+
+








			}
		    }
		}
		dict lappend res protocols {*}$protocols;
	    }
	}
    }
    if {!$upgrading} {
	ThrowError "No 'Connect' header with 'upgrade' token found" HANDSHAKE CONNECTION
    }
    if {![dict exists $res version]} {
	ThrowError "No WebSocket version specified" HANDSHAKE VERSION
    }
    if {![dict exists $res key]} {
	ThrowError "No WebSocket key specified" HANDSHAKE KEY
    }





︙


1750
1751
1752
1753
1754
1755
1756
1757


1750
1751
1752
1753
1754
1755
1756

1757








-
+

    return \
	-level 2 \
	-code error \
	-errorcode [list WEBSOCKET {*}$args] \
	$msg;
}

package provide websocket 1.4.1
package provide websocket 1.4.2






Changes to support/devel/sak/doc/kwic.txt.






︙


485
486
487
488
489
490
491
492
493
494
495

496
497
498
499
500
501
502

485
486
487
488
489
490
491

492
493
494
495
496
497
498
499
500
501
502








-



+








[manpage modules/doctools/docidx.man               doctools::idx]
[manpage modules/doctools2idx/idx_export.man       doctools::idx::export]
[manpage modules/doctools2idx/idx_import.man       doctools::idx::import]
[manpage modules/doctools2toc/toc_container.man    doctools::toc]
[manpage modules/doctools/doctoc.man               doctools::toc]
[manpage modules/doctools2toc/toc_export.man       doctools::toc::export]
[manpage modules/doctools2toc/toc_import.man       doctools::toc::import]
[manpage modules/dtplite/pkg_dtplite.man           dtplite]
[manpage apps/dtplite.man                          dtplite]
[manpage modules/math/roman.man                    math::roman]
[manpage modules/doctools/mpexpand.man             mpexpand]
[manpage modules/dtplite/pkg_dtplite.man           pkg_dtplite]
[manpage modules/pt/pt_peg_from_json.man           pt::peg::from::json]
[manpage modules/pt/pt_peg_from_peg.man            pt::peg::from::peg]
[manpage modules/pt/pt_peg_to_container.man        pt::peg::to::container]
[manpage modules/pt/pt_peg_to_cparam.man           pt::peg::to::cparam]
[manpage modules/pt/pt_peg_to_json.man             pt::peg::to::json]
[manpage modules/pt/pt_peg_to_param.man            pt::peg::to::param]
[manpage modules/pt/pt_peg_to_peg.man              pt::peg::to::peg]




︙


720
721
722
723
724
725
726
727
728

729
730
731
732
733
734
735

720
721
722
723
724
725
726

727
728
729
730
731
732
733
734
735








-

+








[manpage modules/doctools2idx/idx_parse.man      doctools::idx::parse]
[manpage modules/doctools2idx/idx_structure.man  doctools::idx::structure]
[manpage modules/doctools2base/tcllib_msgcat.man doctools::msgcat]
[manpage modules/doctools2idx/idx_msgcat_c.man   doctools::msgcat::idx::c]
[manpage modules/doctools2idx/idx_msgcat_de.man  doctools::msgcat::idx::de]
[manpage modules/doctools2idx/idx_msgcat_en.man  doctools::msgcat::idx::en]
[manpage modules/doctools2idx/idx_msgcat_fr.man  doctools::msgcat::idx::fr]
[manpage modules/dtplite/pkg_dtplite.man         dtplite]
[manpage apps/dtplite.man                        dtplite]
[manpage modules/dtplite/pkg_dtplite.man         pkg_dtplite]
[key {docidx commands}]
[manpage modules/doctools/docidx_lang_cmdref.man docidx_lang_cmdref]
[manpage modules/doctools/docidx_lang_faq.man    docidx_lang_faq]
[manpage modules/doctools/docidx_lang_intro.man  docidx_lang_intro]
[manpage modules/doctools/docidx_lang_syntax.man docidx_lang_syntax]
[key {docidx language}]
[manpage modules/doctools/docidx_lang_cmdref.man docidx_lang_cmdref]




︙


759
760
761
762
763
764
765
766
767

768
769
770
771
772
773
774

759
760
761
762
763
764
765

766
767
768
769
770
771
772
773
774








-

+








[manpage modules/doctools/doctoc.man             doctools::toc]
[manpage modules/doctools2toc/toc_export.man     doctools::toc::export]
[manpage modules/doctools2toc/export_doctoc.man  doctools::toc::export::doctoc]
[manpage modules/doctools2toc/toc_import.man     doctools::toc::import]
[manpage modules/doctools2toc/import_doctoc.man  doctools::toc::import::doctoc]
[manpage modules/doctools2toc/toc_parse.man      doctools::toc::parse]
[manpage modules/doctools2toc/toc_structure.man  doctools::toc::structure]
[manpage modules/dtplite/pkg_dtplite.man         dtplite]
[manpage apps/dtplite.man                        dtplite]
[manpage modules/dtplite/pkg_dtplite.man         pkg_dtplite]
[key {doctoc commands}]
[manpage modules/doctools/doctoc_lang_cmdref.man doctoc_lang_cmdref]
[manpage modules/doctools/doctoc_lang_faq.man    doctoc_lang_faq]
[manpage modules/doctools/doctoc_lang_intro.man  doctoc_lang_intro]
[manpage modules/doctools/doctoc_lang_syntax.man doctoc_lang_syntax]
[key {doctoc language}]
[manpage modules/doctools/doctoc_lang_cmdref.man doctoc_lang_cmdref]




︙


816
817
818
819
820
821
822
823
824

825
826
827
828
829
830
831

816
817
818
819
820
821
822

823
824
825
826
827
828
829
830
831








-

+








[manpage modules/doctools2toc/toc_export_nroff.man  doctools::toc::export::nroff]
[manpage modules/doctools2toc/toc_export_text.man   doctools::toc::export::text]
[manpage modules/doctools2toc/toc_export_wiki.man   doctools::toc::export::wiki]
[manpage modules/doctools2toc/import_doctoc.man     doctools::toc::import::doctoc]
[manpage modules/doctools2toc/toc_import_json.man   doctools::toc::import::json]
[manpage modules/doctools2toc/toc_parse.man         doctools::toc::parse]
[manpage modules/doctools2toc/toc_structure.man     doctools::toc::structure]
[manpage modules/dtplite/pkg_dtplite.man            dtplite]
[manpage apps/dtplite.man                           dtplite]
[manpage modules/dtplite/pkg_dtplite.man            pkg_dtplite]
[key {doctools commands}]
[manpage modules/doctools/doctools_lang_cmdref.man doctools_lang_cmdref]
[manpage modules/doctools/doctools_lang_faq.man    doctools_lang_faq]
[manpage modules/doctools/doctools_lang_intro.man  doctools_lang_intro]
[manpage modules/doctools/doctools_lang_syntax.man doctools_lang_syntax]
[key {doctools language}]
[manpage modules/doctools/doctools_lang_cmdref.man doctools_lang_cmdref]




︙


1351
1352
1353
1354
1355
1356
1357
1358
1359
1360

1361
1362
1363
1364
1365
1366
1367

1351
1352
1353
1354
1355
1356
1357

1358
1359
1360
1361
1362
1363
1364
1365
1366
1367








-


+








[manpage modules/doctools/docidx.man                doctools::idx]
[manpage modules/doctools2idx/idx_export.man        doctools::idx::export]
[manpage modules/doctools2idx/idx_export_html.man   doctools::idx::export::html]
[manpage modules/doctools2toc/toc_container.man     doctools::toc]
[manpage modules/doctools/doctoc.man                doctools::toc]
[manpage modules/doctools2toc/toc_export.man        doctools::toc::export]
[manpage modules/doctools2toc/toc_export_html.man   doctools::toc::export::html]
[manpage modules/dtplite/pkg_dtplite.man            dtplite]
[manpage apps/dtplite.man                           dtplite]
[manpage modules/doctools/mpexpand.man              mpexpand]
[manpage modules/dtplite/pkg_dtplite.man            pkg_dtplite]
[key html]
[manpage modules/html/html.man             html]
[manpage modules/htmlparse/htmlparse.man   htmlparse]
[manpage modules/javascript/javascript.man javascript]
[manpage modules/ncgi/ncgi.man             ncgi]
[key http]
[manpage modules/http/autoproxy.man            autoproxy]




︙


1767
1768
1769
1770
1771
1772
1773
1774
1775
1776

1777
1778
1779
1780
1781
1782
1783

1767
1768
1769
1770
1771
1772
1773

1774
1775
1776
1777
1778
1779
1780
1781
1782
1783








-


+








[manpage modules/doctools/docidx.man                 doctools::idx]
[manpage modules/doctools2idx/idx_export.man         doctools::idx::export]
[manpage modules/doctools2idx/idx_import.man         doctools::idx::import]
[manpage modules/doctools/doctoc.man                 doctools::toc]
[manpage modules/doctools2toc/toc_export.man         doctools::toc::export]
[manpage modules/doctools2toc/toc_import.man         doctools::toc::import]
[manpage modules/doctools/doctools_plugin_apiref.man doctools_plugin_apiref]
[manpage modules/dtplite/pkg_dtplite.man             dtplite]
[manpage apps/dtplite.man                            dtplite]
[manpage modules/doctools/mpexpand.man               mpexpand]
[manpage modules/dtplite/pkg_dtplite.man             pkg_dtplite]
[key map]
[manpage modules/generator/generator.man       generator]
[manpage modules/map/map_geocode_nominatim.man map::geocode::nominatim]
[manpage modules/map/map_slippy.man            map::slippy]
[manpage modules/map/map_slippy_cache.man      map::slippy::cache]
[manpage modules/map/map_slippy_fetcher.man    map::slippy::fetcher]
[manpage modules/mapproj/mapproj.man           mapproj]




︙


1812
1813
1814
1815
1816
1817
1818
1819
1820
1821

1822
1823
1824
1825
1826
1827
1828

1812
1813
1814
1815
1816
1817
1818

1819
1820
1821
1822
1823
1824
1825
1826
1827
1828








-


+








[manpage modules/doctools2toc/toc_import.man         doctools::toc::import]
[manpage modules/doctools/doctools_intro.man         doctools_intro]
[manpage modules/doctools/doctools_lang_cmdref.man   doctools_lang_cmdref]
[manpage modules/doctools/doctools_lang_faq.man      doctools_lang_faq]
[manpage modules/doctools/doctools_lang_intro.man    doctools_lang_intro]
[manpage modules/doctools/doctools_lang_syntax.man   doctools_lang_syntax]
[manpage modules/doctools/doctools_plugin_apiref.man doctools_plugin_apiref]
[manpage modules/dtplite/pkg_dtplite.man             dtplite]
[manpage apps/dtplite.man                            dtplite]
[manpage modules/doctools/mpexpand.man               mpexpand]
[manpage modules/dtplite/pkg_dtplite.man             pkg_dtplite]
[manpage apps/tcldocstrip.man                        tcldocstrip]
[key MasterCard]
[manpage modules/valtype/cc_mastercard.man valtype::creditcard::mastercard]
[key matching]
[manpage modules/grammar_me/me_intro.man         grammar::me_intro]
[manpage modules/grammar_peg/peg_interp.man      grammar::peg::interp]
[manpage apps/pt.man                             pt]




︙


2089
2090
2091
2092
2093
2094
2095
2096
2097
2098

2099
2100
2101
2102
2103
2104
2105

2089
2090
2091
2092
2093
2094
2095

2096
2097
2098
2099
2100
2101
2102
2103
2104
2105








-


+








[manpage modules/doctools2idx/idx_export.man       doctools::idx::export]
[manpage modules/doctools2idx/idx_export_nroff.man doctools::idx::export::nroff]
[manpage modules/doctools2base/nroff_manmacros.man doctools::nroff::man_macros]
[manpage modules/doctools2toc/toc_container.man    doctools::toc]
[manpage modules/doctools/doctoc.man               doctools::toc]
[manpage modules/doctools2toc/toc_export.man       doctools::toc::export]
[manpage modules/doctools2toc/toc_export_nroff.man doctools::toc::export::nroff]
[manpage modules/dtplite/pkg_dtplite.man           dtplite]
[manpage apps/dtplite.man                          dtplite]
[manpage modules/doctools/mpexpand.man             mpexpand]
[manpage modules/dtplite/pkg_dtplite.man           pkg_dtplite]
[key NTLM]
[manpage modules/sasl/ntlm.man SASL::NTLM]
[key NTP]
[manpage modules/ntp/ntp_time.man ntp_time]
[key null]
[manpage modules/virtchannel_base/tcllib_null.man tcl::chan::null]
[manpage modules/virtchannel_base/nullzero.man    tcl::chan::nullzero]




︙


3429
3430
3431
3432
3433
3434
3435
3436
3437
3438

3439
3440
3441
3442
3443
3444
3445

3429
3430
3431
3432
3433
3434
3435

3436
3437
3438
3439
3440
3441
3442
3443
3444
3445








-


+








[manpage modules/transfer/transmitter.man transfer::transmitter]
[key TMML]
[manpage modules/doctools/doctools.man          doctools]
[manpage modules/doctools2idx/idx_container.man doctools::idx]
[manpage modules/doctools/docidx.man            doctools::idx]
[manpage modules/doctools2toc/toc_container.man doctools::toc]
[manpage modules/doctools/doctoc.man            doctools::toc]
[manpage modules/dtplite/pkg_dtplite.man        dtplite]
[manpage apps/dtplite.man                       dtplite]
[manpage modules/doctools/mpexpand.man          mpexpand]
[manpage modules/dtplite/pkg_dtplite.man        pkg_dtplite]
[key toc]
[manpage modules/doctools/doctoc_intro.man         doctoc_intro]
[manpage modules/doctools/doctoc_plugin_apiref.man doctoc_plugin_apiref]
[manpage modules/doctools/doctoc.man               doctools::toc]
[manpage modules/doctools2toc/export_doctoc.man    doctools::toc::export::doctoc]
[manpage modules/doctools2toc/toc_export_html.man  doctools::toc::export::html]
[manpage modules/doctools2toc/toc_export_json.man  doctools::toc::export::json]




︙





Changes to support/devel/sak/doc/manpages.txt.





1

2
3
4
5
6
7
8

1
2
3
4
5
6
7
8
9


+








apps/dtplite.man
apps/mkdoc.man
apps/nns.man
apps/nnsd.man
apps/nnslog.man
apps/page.man
apps/pt.man
apps/tcldocstrip.man
modules/aes/aes.man




︙


213
214
215
216
217
218
219

220
221
222
223
224
225
226

214
215
216
217
218
219
220
221
222
223
224
225
226
227
228








+








modules/math/symdiff.man
modules/math/trig.man
modules/md4/md4.man
modules/md5/md5.man
modules/md5crypt/md5crypt.man
modules/mime/mime.man
modules/mime/smtp.man
modules/mkdoc/mkdoc.man
modules/multiplexer/multiplexer.man
modules/namespacex/namespacex.man
modules/ncgi/ncgi.man
modules/nettool/nettool.man
modules/nmea/nmea.man
modules/nns/nns_auto.man
modules/nns/nns_client.man




︙





Changes to support/devel/sak/doc/toc.txt.






︙


128
129
130
131
132
133
134
135
136
137

138
139
140
141
142
143
144

128
129
130
131
132
133
134

135
136
137
138
139
140
141
142
143
144








-


+








[item modules/doctools2toc/toc_structure.man      doctools::toc::structure    {Doctoc serialization utilities}]
[item modules/doctools/doctools_intro.man         doctools_intro              {doctools introduction}]
[item modules/doctools/doctools_lang_cmdref.man   doctools_lang_cmdref        {doctools language command reference}]
[item modules/doctools/doctools_lang_faq.man      doctools_lang_faq           {doctools language faq}]
[item modules/doctools/doctools_lang_intro.man    doctools_lang_intro         {doctools language introduction}]
[item modules/doctools/doctools_lang_syntax.man   doctools_lang_syntax        {doctools language syntax}]
[item modules/doctools/doctools_plugin_apiref.man doctools_plugin_apiref      {doctools plugin API reference}]
[item modules/dtplite/pkg_dtplite.man             dtplite                     {Lightweight DocTools Markup Processor}]
[item apps/dtplite.man                            dtplite                     {Lightweight DocTools Markup Processor}]
[item modules/doctools/mpexpand.man               mpexpand                    {Markup processor}]
[item modules/dtplite/pkg_dtplite.man             pkg_dtplite                 {Lightweight DocTools Markup Processor}]
[item apps/tcldocstrip.man                        tcldocstrip                 {Tcl-based Docstrip Processor}]
[item modules/tepam/tepam_doc_gen.man             tepam::doc_gen              {TEPAM DOC Generation, reference manual}]
[item modules/textutil/expander.man               textutil::expander          {Procedures to process templates and expand text.}]
[division_end]
[division_start File]
[item modules/zip/decode.man zipfile::decode {Access to zip archives}]
[item modules/zip/encode.man zipfile::encode {Generation of zip archives}]




︙


415
416
417
418
419
420
421


422
423
424
425
426
427
428

415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430








+
+








[item modules/clock/iso8601.man            clock_iso8601        {Parsing ISO 8601 dates/times}]
[item modules/clock/rfc2822.man            clock_rfc2822        {Parsing RFC 2822 dates/times}]
[item modules/csv/csv.man                  csv                  {Procedures to handle CSV data.}]
[item modules/htmlparse/htmlparse.man      htmlparse            {Procedures to parse HTML strings}]
[item modules/inifile/ini.man              inifile              {Parsing of Windows INI files}]
[item modules/markdown/markdown.man        markdown             {Converts Markdown text to HTML}]
[item modules/mime/mime.man                mime                 {Manipulation of MIME body parts}]
[item modules/mkdoc/mkdoc.man              mkdoc                {Extracts and optionally converts Markdown comments in source code to HTML}]
[item apps/mkdoc.man                       mkdoc                {Source code documentation extractor/converter application}]
[item modules/rcs/rcs.man                  rcs                  {RCS low level utilities}]
[item modules/string/token.man             string::token        {Regex based iterative lexing}]
[item modules/string/token_shell.man       string::token::shell {Parsing of shell command line}]
[item modules/textutil/textutil.man        textutil             {Procedures to manipulate texts and strings.}]
[item modules/textutil/adjust.man          textutil::adjust     {Procedures to adjust, indent, and undent paragraphs}]
[item modules/textutil/patch.man           textutil::patch      {Application of uni-diff patches to directory trees}]
[item modules/textutil/repeat.man          textutil::repeat     {Procedures to repeat strings.}]




︙


494
495
496
497
498
499
500

501
502
503
504
505
506
507

496
497
498
499
500
501
502
503
504
505
506
507
508
509
510








+








[item modules/valtype/usnpi.man          valtype::usnpi                  {Validation for USNPI}]
[item modules/valtype/verhoeff.man       valtype::verhoeff               {Validation for plain number with a VERHOEFF checkdigit}]
[division_end]
[division_end]
[division_start {By Type}]
[division_start Applications]
[item apps/dtplite.man     dtplite     {Lightweight DocTools Markup Processor}]
[item apps/mkdoc.man       mkdoc       {Source code documentation extractor/converter application}]
[item apps/nns.man         nns         {Name service facility, Commandline Client Application}]
[item apps/nnsd.man        nnsd        {Name service facility, Commandline Server Application}]
[item apps/nnslog.man      nnslog      {Name service facility, Commandline Logging Client Application}]
[item apps/page.man        page        {Parser Generator}]
[item apps/pt.man          pt          {Parser Tools Application}]
[item apps/tcldocstrip.man tcldocstrip {Tcl-based Docstrip Processor}]
[division_end]




︙


678
679
680
681
682
683
684
685

686
687
688
689
690
691
692

681
682
683
684
685
686
687

688
689
690
691
692
693
694
695








-
+








[item modules/doctools2toc/toc_import.man       doctools::toc::import         {Importing keyword indices}]
[item modules/doctools2toc/import_doctoc.man    doctools::toc::import::doctoc {doctoc import plugin}]
[item modules/doctools2toc/toc_import_json.man  doctools::toc::import::json   {JSON import plugin}]
[item modules/doctools2toc/toc_parse.man        doctools::toc::parse          {Parsing text in doctoc format}]
[item modules/doctools2toc/toc_structure.man    doctools::toc::structure      {Doctoc serialization utilities}]
[division_end]
[division_start dtplite]
[item modules/dtplite/pkg_dtplite.man dtplite {Lightweight DocTools Markup Processor}]
[item modules/dtplite/pkg_dtplite.man pkg_dtplite {Lightweight DocTools Markup Processor}]
[division_end]
[division_start fileutil]
[item modules/fileutil/fileutil.man fileutil            {Procedures implementing some file utilities}]
[item modules/fileutil/multi.man    fileutil::multi     {Multi-file operation, scatter/gather, standard object}]
[item modules/fileutil/multiop.man  fileutil::multi::op {Multi-file operation, scatter/gather}]
[item modules/fileutil/paths.man    fileutil::paths     {Manage search path pools}]
[item modules/fileutil/traverse.man fileutil_traverse   {Iterative directory traversal}]




︙


846
847
848
849
850
851
852



853
854
855
856
857
858
859

849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865








+
+
+








[division_start md5crypt]
[item modules/md5crypt/md5crypt.man md5crypt {MD5-based password encryption}]
[division_end]
[division_start mime]
[item modules/mime/mime.man mime {Manipulation of MIME body parts}]
[item modules/mime/smtp.man smtp {Client-side tcl implementation of the smtp protocol}]
[division_end]
[division_start mkdoc]
[item modules/mkdoc/mkdoc.man mkdoc {Extracts and optionally converts Markdown comments in source code to HTML}]
[division_end]
[division_start multiplexer]
[item modules/multiplexer/multiplexer.man multiplexer {One-to-many communication with sockets.}]
[division_end]
[division_start namespacex]
[item modules/namespacex/namespacex.man namespacex {Namespace utility commands}]
[division_end]
[division_start ncgi]




︙





Changes to support/devel/sak/doc/toc_apps.txt.





1
2
3

4
5
6
7
8
9
10

1
2
3
4
5
6
7
8
9
10
11




+








[toc_begin {Table Of Contents} {}]
[division_start Applications]
[item apps/dtplite.man     dtplite     {Lightweight DocTools Markup Processor}]
[item apps/mkdoc.man       mkdoc       {Source code documentation extractor/converter application}]
[item apps/nns.man         nns         {Name service facility, Commandline Client Application}]
[item apps/nnsd.man        nnsd        {Name service facility, Commandline Server Application}]
[item apps/nnslog.man      nnslog      {Name service facility, Commandline Logging Client Application}]
[item apps/page.man        page        {Parser Generator}]
[item apps/pt.man          pt          {Parser Tools Application}]
[item apps/tcldocstrip.man tcldocstrip {Tcl-based Docstrip Processor}]
[division_end]




︙





Changes to support/devel/sak/doc/toc_cats.txt.






︙


128
129
130
131
132
133
134
135
136
137

138
139
140
141
142
143
144

128
129
130
131
132
133
134

135
136
137
138
139
140
141
142
143
144








-


+








[item modules/doctools2toc/toc_structure.man      doctools::toc::structure    {Doctoc serialization utilities}]
[item modules/doctools/doctools_intro.man         doctools_intro              {doctools introduction}]
[item modules/doctools/doctools_lang_cmdref.man   doctools_lang_cmdref        {doctools language command reference}]
[item modules/doctools/doctools_lang_faq.man      doctools_lang_faq           {doctools language faq}]
[item modules/doctools/doctools_lang_intro.man    doctools_lang_intro         {doctools language introduction}]
[item modules/doctools/doctools_lang_syntax.man   doctools_lang_syntax        {doctools language syntax}]
[item modules/doctools/doctools_plugin_apiref.man doctools_plugin_apiref      {doctools plugin API reference}]
[item modules/dtplite/pkg_dtplite.man             dtplite                     {Lightweight DocTools Markup Processor}]
[item apps/dtplite.man                            dtplite                     {Lightweight DocTools Markup Processor}]
[item modules/doctools/mpexpand.man               mpexpand                    {Markup processor}]
[item modules/dtplite/pkg_dtplite.man             pkg_dtplite                 {Lightweight DocTools Markup Processor}]
[item apps/tcldocstrip.man                        tcldocstrip                 {Tcl-based Docstrip Processor}]
[item modules/tepam/tepam_doc_gen.man             tepam::doc_gen              {TEPAM DOC Generation, reference manual}]
[item modules/textutil/expander.man               textutil::expander          {Procedures to process templates and expand text.}]
[division_end]
[division_start File]
[item modules/zip/decode.man zipfile::decode {Access to zip archives}]
[item modules/zip/encode.man zipfile::encode {Generation of zip archives}]




︙


415
416
417
418
419
420
421


422
423
424
425
426
427
428

415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430








+
+








[item modules/clock/iso8601.man            clock_iso8601        {Parsing ISO 8601 dates/times}]
[item modules/clock/rfc2822.man            clock_rfc2822        {Parsing RFC 2822 dates/times}]
[item modules/csv/csv.man                  csv                  {Procedures to handle CSV data.}]
[item modules/htmlparse/htmlparse.man      htmlparse            {Procedures to parse HTML strings}]
[item modules/inifile/ini.man              inifile              {Parsing of Windows INI files}]
[item modules/markdown/markdown.man        markdown             {Converts Markdown text to HTML}]
[item modules/mime/mime.man                mime                 {Manipulation of MIME body parts}]
[item modules/mkdoc/mkdoc.man              mkdoc                {Extracts and optionally converts Markdown comments in source code to HTML}]
[item apps/mkdoc.man                       mkdoc                {Source code documentation extractor/converter application}]
[item modules/rcs/rcs.man                  rcs                  {RCS low level utilities}]
[item modules/string/token.man             string::token        {Regex based iterative lexing}]
[item modules/string/token_shell.man       string::token::shell {Parsing of shell command line}]
[item modules/textutil/textutil.man        textutil             {Procedures to manipulate texts and strings.}]
[item modules/textutil/adjust.man          textutil::adjust     {Procedures to adjust, indent, and undent paragraphs}]
[item modules/textutil/patch.man           textutil::patch      {Application of uni-diff patches to directory trees}]
[item modules/textutil/repeat.man          textutil::repeat     {Procedures to repeat strings.}]




︙





Changes to support/devel/sak/doc/toc_mods.txt.






︙


172
173
174
175
176
177
178
179

180
181
182
183
184
185
186

172
173
174
175
176
177
178

179
180
181
182
183
184
185
186








-
+








[item modules/doctools2toc/toc_import.man       doctools::toc::import         {Importing keyword indices}]
[item modules/doctools2toc/import_doctoc.man    doctools::toc::import::doctoc {doctoc import plugin}]
[item modules/doctools2toc/toc_import_json.man  doctools::toc::import::json   {JSON import plugin}]
[item modules/doctools2toc/toc_parse.man        doctools::toc::parse          {Parsing text in doctoc format}]
[item modules/doctools2toc/toc_structure.man    doctools::toc::structure      {Doctoc serialization utilities}]
[division_end]
[division_start dtplite]
[item modules/dtplite/pkg_dtplite.man dtplite {Lightweight DocTools Markup Processor}]
[item modules/dtplite/pkg_dtplite.man pkg_dtplite {Lightweight DocTools Markup Processor}]
[division_end]
[division_start fileutil]
[item modules/fileutil/fileutil.man fileutil            {Procedures implementing some file utilities}]
[item modules/fileutil/multi.man    fileutil::multi     {Multi-file operation, scatter/gather, standard object}]
[item modules/fileutil/multiop.man  fileutil::multi::op {Multi-file operation, scatter/gather}]
[item modules/fileutil/paths.man    fileutil::paths     {Manage search path pools}]
[item modules/fileutil/traverse.man fileutil_traverse   {Iterative directory traversal}]




︙


340
341
342
343
344
345
346



347
348
349
350
351
352
353

340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356








+
+
+








[division_start md5crypt]
[item modules/md5crypt/md5crypt.man md5crypt {MD5-based password encryption}]
[division_end]
[division_start mime]
[item modules/mime/mime.man mime {Manipulation of MIME body parts}]
[item modules/mime/smtp.man smtp {Client-side tcl implementation of the smtp protocol}]
[division_end]
[division_start mkdoc]
[item modules/mkdoc/mkdoc.man mkdoc {Extracts and optionally converts Markdown comments in source code to HTML}]
[division_end]
[division_start multiplexer]
[item modules/multiplexer/multiplexer.man multiplexer {One-to-many communication with sockets.}]
[division_end]
[division_start namespacex]
[item modules/namespacex/namespacex.man namespacex {Namespace utility commands}]
[division_end]
[division_start ncgi]




︙





Changes to support/devel/sak/readme/readme.tcl.






︙


218
219
220
221
222
223
224
225




226
227
228
229
230
231
232

218
219
220
221
222
223
224

225
226
227
228
229
230
231
232
233
234
235








-
+
+
+
+








	CNT add row [list $uchp {unchanged packages} in $uchm modules]
    }

    CNT add row [list $np {packages, total} in $nm {modules, total}]

    Table CNT Overview {
	CNT delete row 0 ; # strip title row
    } {}
    } {
	set align [lreplace $align 0 0 r]
	set align [lreplace $align 3 3 r]
    }
    
    Table LEG Legend {
	Sep LEG - 1
    } {
    }

    Table NEW "New in $pname $package_version" {




︙


285
286
287
288
289
290
291




292
293
294
295





296
297
298
299
300
301
302

288
289
290
291
292
293
294
295
296
297
298
299
300
301

302
303
304
305
306
307
308
309
310
311
312
313








+
+
+
+



-
+
+
+
+
+








    puts ""
    switch -exact -- $theformat {
	txt {
	    uplevel 1 $pretxt
	    puts [Indent "    " [Detrail [$obj format 2string]]]
	}
	md {
	    upvar 1 align align
	    # Column alignment setup.
	    set align [lrepeat [$obj columns] l]
	    
	    uplevel 1 $premd
	    # Header row, then separator, then the remainder.
	    puts |[join [$obj get row 0] |]|
	    puts |[join [lrepeat [$obj columns] ---] |]|
	    puts |[join [string map {
		c ---
		l :---
		r ---:
	    } $align] |]|
	    set n [$obj rows]
	    for {set i 1} {$i < $n} {incr i} {
		puts |[join [$obj get row $i] |]|
	    }
	}
	default {
	    error "Bad format"




︙





Changes to support/devel/sak/review/review.tcl.





1
2
3

4
5
6
7
8
9
10

1
2

3
4
5
6
7
8
9
10



-
+








# -*- tcl -*-
# # ## ### ##### ######## ############# ##################### 
# (C) 2013 Andreas Kupries <[email protected]>
# (C) 2013-2022 Andreas Kupries <[email protected]>
##
# ###

package require linenoise
package require sak::color

getpackage fileutil                 fileutil/fileutil.tcl




︙


56
57
58
59
60
61
62




63
64

65
66
67
68
69
70
71
72
73



74
75
76
77
78
79
80
81
82
83
84
85
86

87
88
89
90
91
92
93
94
95
96
97
98

99

100
101
102
103
104
105
106

56
57
58
59
60
61
62
63
64
65
66
67

68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

93
94
95
96
97
98
99
100
101
102
103
104

105
106
107
108
109
110
111
112
113
114








+
+
+
+

-
+









+
+
+












-
+











-
+

+








    # module -> list(path)

    # rm: module -> list (revs); rev = uuid+desc+files (string)
    array set rm {}

    foreach {trunk   tuid} [Leaf          trunk]   break ;# rid + uuid
    foreach {release ruid} [YoungestOfTag release] break ;# datetime + uuid

    #puts T:($trunk)\t($tuid)
    #puts Y:($release)\t($ruid)
    
    AllParentsAfter $trunk $tuid $release $ruid -> rid uuid numparents {
	Next ; Progress " $rid"
	Next ; Progress " $rid $uuid"

	if {$numparents > 1} {
	    Progress " SKIP"
	} else {
	    # Consider only commits with one parent, i.e. non-merges,
	    # as possible contributors to modules and packages.
	    
	    set d [Description $rid]
	    Progress " D"

	    set ts [Timestamp $rid]
	    Progress " $ts"

	    # Determine file set, split by modules, then generate a package of
	    # uuid, description and filtered files per modules touched.

	    array set fs {}

	    FileSet $rid -> path action {
		Progress .

		set px [file split $path]
		set themodule [lindex $px 1]
		lappend modifiedm $themodule
		lappend cm($themodule) $d
		lappend cm($themodule) "($ts) $d"

		# ignore files in modules/
		if {[llength $px] < 3} continue

		#puts $themodule||$rid||$action|$px|

		lappend fs($themodule) [file join {*}[lrange $px 2 end]]
		lappend pt($themodule) [file join {*}[lrange $px 2 end]]
	    }

	    foreach {m files} [array get fs] {
		set str \[htts://core.tcl.tk/tcllib/info/$uuid\]\n$d\n\n[join [lsort -dict $files] \n]
		set str "($ts)\n\[https://core.tcl-lang.org/tcllib/info/$uuid\]\n$d\n\n[join [lsort -dict [lsort -unique $files]] \n]"
		lappend rm($m) $str
		set rm($m) [lsort $rm($m)]
	    }
	    unset fs
	}
    }

    Next





︙


309
310
311
312
313
314
315
316

317
318
319
320
321
322
323
324
325
326
327
328
329
330
331


332









333
334
335

336
337
338
339
340
341
342

317
318
319
320
321
322
323

324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341

342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361








-
+















+
+
-
+
+
+
+
+
+
+
+
+



+








                    WHEN nullif(mlink.fid,0) is null THEN 'deleted'
                    ELSE                                  'edited'
	       END
	FROM  mlink, filename
	WHERE mlink.mid  = @rid@
	AND   mlink.fnid = filename.fnid
	ORDER BY filename.name;
    }]]] \n] {
    }] file-set]] \n] {
	foreach {thepath theaction} [split $line |] break
	# ignore all changes not in modules
	if {![string match modules* $thepath]} continue
	uplevel 1 $script
    }
    return
}

proc ::sak::review::Description {rid} {
    lappend map @rid@ $rid
    string trim [F [string map $map {
	SELECT coalesce(event.ecomment,event.comment)
	FROM   event
	WHERE  event.objid = @rid@
	;
    }] description]
}
    }]]

proc ::sak::review::Timestamp {rid} {
    lappend map @rid@ $rid
    string trim [F [string map $map {
	SELECT datetime(event.mtime)
	FROM   event
	WHERE  event.objid = @rid@
	;
    }] timestamp]
}

proc ::sak::review::AllParentsAfter {rid ruid cut cutuid _ rv uv nv script} {
    #puts X:[info level 0]
    upvar 1 $rv therev $uv theuid $nv thenump

    array set rev {}
    set rev($rid) .
    lappend front $rid

    # Initial run, for the starting revision.




︙


388
389
390
391
392
393
394
395

396
397
398

399
400
401
402
403
404
405
406
407

408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423

424
425
426
427
428
429
430
431
432
433
434
435
436

437
438
439
440
441

442
443
444
445
446
447
448

449
450
451
452
453
454
455
456











457
458
459
460
461
462
463

407
408
409
410
411
412
413

414
415
416
417
418
419
420
421
422
423
424
425
426

427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442

443
444
445
446
447
448
449
450
451
452
453
454
455

456
457
458
459
460

461
462
463
464
465
466
467
468
469
470







471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488








-
+



+








-
+















-
+












-
+




-
+







+

-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+








	SELECT pid, blob.uuid, event.mtime, datetime(event.mtime)
	FROM  plink, blob, event
	WHERE plink.cid   = @rid@
	AND   plink.pid = blob.rid
	AND   plink.pid = event.objid
	AND   event.mtime > @cutoff@
	;
    }]] \n
    }] parents] \n
}

proc ::sak::review::AllParents {rid} {
    #puts X:[info level 0]
    lappend map @rid@    $rid
    split [F [string map $map {
	SELECT pid, blob.uuid, event.mtime, datetime(event.mtime)
	FROM  plink, blob, event
	WHERE plink.cid   = @rid@
	AND   plink.pid = blob.rid
	AND   plink.pid = event.objid
	;
    }]] \n
    }] all-parents] \n
}

proc ::sak::review::YoungestOfTag {tag} {
    lappend map @tag@ $tag
    puts stderr "last $tag = [F [string map $map {
	SELECT datetime (event.mtime)
	FROM   tag, tagxref, event
	WHERE tag.tagname     = 'sym-' || '@tag@'
	AND   tagxref.tagid   = tag.tagid
	AND   tagxref.tagtype > 0
	AND   tagxref.rid     = event.objid
	AND   event.type      = 'ci'
	ORDER BY event.mtime DESC
	LIMIT 1
	;
    }]]"
    }] youngest-tag]"
    split [F [string map $map {
	SELECT event.mtime, blob.uuid
	FROM   tag, tagxref, event, blob
	WHERE tag.tagname     = 'sym-' || '@tag@'
	AND   tagxref.tagid   = tag.tagid
	AND   tagxref.tagtype > 0
	AND   tagxref.rid     = event.objid
	AND   event.type      = 'ci'
        AND   blob.rid        = event.objid
	ORDER BY event.mtime DESC
	LIMIT 1
	;
    }]] |
    }] youngest-tag] |
}

proc ::sak::review::Leaf {branch} {
    lappend map @branch@ $branch
    split [F [string map $map {
    set script [string map $map {
	SELECT blob.rid, blob.uuid
	FROM   leaf, blob, tag, tagxref
	WHERE blob.rid        = leaf.rid
	AND   tag.tagname     = 'sym-' || '@branch@'
	AND   tagxref.tagid   = tag.tagid
	AND   tagxref.tagtype > 0
	AND   tagxref.rid     = leaf.rid
	ORDER BY blob.rid
	;
    }]] |
}

proc ::sak::review::F {script} {
    #puts |$script|
    set r [exec fossil sqlite3 << $script]
    #puts ($r)
    }]
    set r [split [lindex [split [F $script leaf] \n] end] |]

    #puts ($script)-->($r)
    return $r
}

proc ::sak::review::F {script {label unknown}} {
    #puts stderr $label:|$script|
    set r [exec fossil sqlite3 << ".mode list\n$script"]
    #puts stderr =($r)
    return $r
}



# # ## ### ##### ######## ############# ##################### 
## Phase II. Interactively review the changes packages.




︙


590
591
592
593
594
595
596


597
598
599
600
601
602
603
604
605

606
607

608
609
610
611
612
613
614

615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631

632
633

634
635
636
637
638
639
640
641








+
+








-
+

-
+








    variable ir
    variable nm
    variable nr
    variable clog
    variable rlog
    variable what
    variable smode
    variable ip
    variable np

    if {$smode eq "rev"} {
	set text $rlog
    } else {
	set text $clog
    }

    if {$smode eq "rev"} {
	Banner "($ir/$nr) \[$im/$nm\] [=cya [string totitle $what]] [=green $m]"
	Banner "(C $ir/$nr) \[M $im/$nm\] [=cya [string totitle $what]] \[P $ip/$np\] [=green $m]"
    } else {
	Banner "\[$im/$nm\] [=cya [string totitle $what]] [=green $m]"
	Banner "\[M $im/$nm\] [=cya [string totitle $what]] \[P $ip/$np\] [=green $m]"
    }
    puts "| [join [split $text \n] "\n| "]\n"
    return
}

proc ::sak::review::Exit {} {
    variable stop




︙


629
630
631
632
633
634
635
636

637
638
639
640


641
642
643
644
645
646
647

656
657
658
659
660
661
662

663
664
665


666
667
668
669
670
671
672
673
674








-
+


-
-
+
+








    variable ir
    variable nm
    variable nr
    variable what
    variable m

    if {$smode eq "rev"} {
	append p "($ir/$nr) "
	append p "(C $ir/$nr) "
    }

    append p "\[$im/$nm\] [=green $m] [=cya [string totitle $what]] "
    append p "\[$ip/$np\] [=whi $name] ($tags): "
    append p "\[M $im/$nm\] [=green $m] [=cya [string totitle $what]] "
    append p "\[P $ip/$np\] [=whi $name] ($tags): "
    return $p
}

proc ::sak::review::Complete {line} {
    variable allcommands
    if {$line eq {}} {
	return $allcommands




︙





Changes to support/installation/modules.tcl.






︙


84
85
86
87
88
89
90


91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

111
112
113
114
115

116
117
118
119
120
121
122

84
85
86
87
88
89
90
91
92
93
94
95


96
97
98
99
100
101
102
103
104
105
106
107

108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123








+
+



-
-












-


+





+








Module  generator   _tcl  _man  _null
Module  gpx         _tcl _null  _null
Module  grammar_aycock _tcl _man _null
Module  grammar_fa  _tcl  _man  _null
Module  grammar_me  _tcl  _man  _null
Module  grammar_peg _tcl  _man  _null
Module  hook        _tcl  _man  _null
Module  html        _tcl  _man  _null
Module  htmlparse   _tcl  _man  _exa
Module  http        _tcl  _man  _null
Module  httpd       _tcl  _man  _exa
Module  httpwget    _tcl  _null _null
Module  html        _tcl  _man  _null
Module  htmlparse   _tcl  _man  _exa
Module  ident       _tcl  _man  _null
Module  imap4       _tcl  _man  _null
Module  inifile     _tcl  _man  _null
Module  interp      _tcl  _man  _null
Module  irc         _tcl  _man _exa
Module  javascript  _tcl  _man  _null
Module  jpeg        _tcl  _man  _null
Module  json        _tcl  _man  _null
Module  lambda      _tcl  _man  _null
Module  lazyset     _tcl  _man  _null
Module  ldap        _tcl  _man _exa
Module  log          _msg _man  {_exax logger}
Module  markdown     _tcl  _man  _null
Module  map         _tcl  _man  _null
Module  mapproj     _tcl  _man _exa
Module  markdown     _tcl  _man  _null
Module  math         _tci _man _exa
Module  md4         _tcl  _man  _null
Module  md5         _tcl  _man  _null
Module  md5crypt    _tcl  _man _null
Module  mime        _tcl  _man _exa
Module  mkdoc       _tcl  _man  _null
Module  multiplexer _tcl  _man  _null
Module  namespacex  _tcl  _man  _null
Module  ncgi        _tcl  _man  _null
Module  nettool     _tcl  _man  _null
Module  nmea        _tcl  _man  _null
Module  nns         _tcl  _man  _null
Module  nntp        _tcl  _man _exa




︙


172
173
174
175
176
177
178

179
180
181
182
183
184
185
186
187

173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189








+










Module  virtchannel_transform  _tcl _man  _null
Module  websocket   _tcl  _man  _null
Module  wip         _tcl  _man  _null
Module  yaml        _tcl  _man  _null
Module  zip        _tcl  _null  _null

Application  dtplite
Application  mkdoc
Application  nns
Application  nnsd
Application  nnslog
Application  page
Application  pt
Application  tcldocstrip

# @@ Registration END
# --------------------------------------------------------------






Changes to support/installation/version.tcl.





1

2
3
4
5
6
7
8


1
2
3
4
5
6
7
8

-
+








package_version 1.20
package_version 1.21
package_name    tcllib

dist_exclude    config
dist_exclude    modules/ftp/example
dist_exclude    modules/ftpd/examples
dist_exclude    modules/stats
dist_exclude    modules/fileinput




︙





Changes to support/releases/PACKAGES.





1

2
3

4
5
6
7
8
9
10
11
12
13
14
15
16

17
18
19
20
21
22

23
24
25
26

27
28
29
30
31
32


33
34
35
36


37
38
39


40
41
42
43
44
45
46
47
48
49

50
51
52
53
54
55
56


1
2

3
4
5
6
7
8
9
10
11
12
13
14
15

16
17
18
19
20
21

22
23
24
25

26
27
28
29
30


31
32
33
34


35
36
37


38
39
40
41
42
43
44
45
46
47
48

49
50
51
52
53
54
55
56

-
+

-
+












-
+





-
+



-
+




-
-
+
+


-
-
+
+

-
-
+
+









-
+








@@ RELEASE 1.20
@@ RELEASE 1.21

Markdown                           1.1.1
Markdown                           1.2.2
S3                                 1.0.3
SASL                               1.3.3
SASL::NTLM                         1.1.2
SASL::SCRAM                        0.1
SASL::XGoogleToken                 1.0.1
aes                                1.2.1
ascii85                            1.0
asn                                0.8.4
autoproxy                          1.7
base32                             0.1
base32::core                       0.1
base32::hex                        0.1
base64                             2.4.2
base64                             2.5
bee                                0.1
bench                              0.4
bench::in                          0.1
bench::out::csv                    0.1.2
bench::out::text                   0.1.2
bibtex                             0.6
bibtex                             0.7
blowfish                           1.0.5
cache::async                       0.3.1
calendar                           0.2
char                               1.0.1
char                               1.0.2
cksum                              1.1.4
clay                               0.8.6
clock::iso8601                     0.1
clock::rfc2822                     0.1
cmdline                            1.5
comm                               4.6.3.1
cmdline                            1.5.2
comm                               4.7
configuration                      1
control                            0.1.3
coroutine                          1.2
coroutine::auto                    1.1.3
coroutine                          1.3
coroutine::auto                    1.2
counter                            2.0.4
crc16                              1.1.3
crc32                              1.3.2
crc16                              1.1.4
crc32                              1.3.3
cron                               2.1
csv                                0.8.1
debug                              1.0.6
debug::caller                      1.1
debug::heartbeat                   1.0.1
debug::timestamp                   1
defer                              1
des                                1.1.0
dicttool                           1.1
dns                                1.4.1
dns                                1.5.0
docstrip                           1.2
docstrip::util                     1.3.1
doctools                           1.5.6
doctools::changelog                1.1
doctools::config                   0.1
doctools::cvs                      1
doctools::html                     0.1




︙


94
95
96
97
98
99
100
101

102
103
104
105
106




107
108
109
110
111
112
113
114

115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

131
132
133
134
135


136
137
138
139

140
141
142
143
144

145
146
147
148

149
150
151
152


153
154
155
156
157
158
159
160
161
162
163
164
165


166
167
168


169
170
171

172


173
174
175

176
177
178
179

180
181

182
183
184
185

186
187
188
189
190


191
192


193
194
195
196
197
198
199

200
201
202
203
204
205
206

207
208
209
210
211
212
213

94
95
96
97
98
99
100

101
102




103
104
105
106
107
108
109
110
111
112
113

114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

130
131
132
133


134
135
136
137
138

139
140
141
142
143

144
145
146
147

148
149
150


151
152
153
154
155
156
157
158
159
160
161
162
163


164
165
166
167
168
169
170
171
172

173
174
175
176
177
178

179
180
181
182

183
184
185
186
187
188
189

190
191
192
193


194
195
196

197
198
199
200
201
202
203
204

205
206
207
208
209
210
211

212
213
214
215
216
217
218
219








-
+

-
-
-
-
+
+
+
+







-
+















-
+



-
-
+
+



-
+




-
+



-
+


-
-
+
+











-
-
+
+



+
+


-
+

+
+


-
+



-
+


+



-
+



-
-
+
+

-
+
+






-
+






-
+








doctools::toc::import              0.2.1
doctools::toc::import::doctoc      0.1
doctools::toc::import::json        0.1
doctools::toc::parse               0.1
doctools::toc::structure           0.1
dtplite                            1.3.1
exif                               1.1.2
fileutil                           1.16
fileutil                           1.16.1
fileutil::decode                   0.2.1
fileutil::magic::cfront            1.2.0
fileutil::magic::cgen              1.2.0
fileutil::magic::filetype          2.0
fileutil::magic::rt                2.0
fileutil::magic::cfront            1.3.0
fileutil::magic::cgen              1.3.0
fileutil::magic::filetype          2.0.1
fileutil::magic::rt                3.0
fileutil::multi                    0.1
fileutil::multi::op                0.5.3
fileutil::paths                    1
fileutil::traverse                 0.6
ftp                                2.4.13
ftp::geturl                        0.2.2
ftpd                               1.3
generator                          0.1
generator                          0.2
gpx                                1
grammar::aycock                    1.0
grammar::aycock::debug             1.0
grammar::aycock::runtime           1.0
grammar::fa                        0.5
grammar::fa::dacceptor             0.1.1
grammar::fa::dexec                 0.2
grammar::fa::op                    0.4.1
grammar::me::cpu                   0.2
grammar::me::cpu::core             0.2
grammar::me::cpu::gasm             0.1
grammar::me::tcl                   0.1
grammar::me::util                  0.1
grammar::peg                       0.2
grammar::peg::interp               0.1.1
hook                               0.1
hook                               0.2
html                               1.5
htmlparse                          1.2.2
http::wget                         0.1
httpd                              4.3.4
huddle                             0.3
httpd                              4.3.5
huddle                             0.4
huddle::json                       0.1
ident                              0.42
imap4                              0.5.3
inifile                            0.3.1
inifile                            0.3.2
interp                             0.1.2
interp::delegate::method           0.2
interp::delegate::proc             0.2
ip                                 1.4
irc                                0.6.2
irc                                0.7.0
javascript                         1.0.2
jpeg                               0.5
json                               1.3.4
json::write                        1.0.3
json::write                        1.0.4
lambda                             1
lazyset                            1
ldap                               1.9.2
ldapx                              1.1
ldap                               1.10.1
ldapx                              1.2
log                                1.4
logger                             0.9.4
logger::appender                   1.3
logger::utils                      1.3.1
map::geocode::nominatim            0.1
map::slippy                        0.5
map::slippy::cache                 0.2
map::slippy::fetcher               0.4
mapproj                            1.0
math                               1.2.5
math::PCA                          1.0
math::bigfloat                     1.2.2
math::bigfloat                     2.0.2
math::bigfloat                     1.2.3
math::bigfloat                     2.0.3
math::bignum                       3.1.1
math::calculus                     0.8.2
math::calculus::symdiff            1.0.1
math::changepoint                  0.1
math::combinatorics                2.0
math::complexnumbers               1.0.2
math::constants                    1.0.2
math::decimal                      1.0.3
math::decimal                      1.0.4
math::exact                        1.0.1
math::figurate                     1.0
math::filters                      0.1
math::fourier                      1.0.2
math::fuzzy                        0.2.1
math::geometry                     1.3.1
math::geometry                     1.4.1
math::interpolate                  1.1.2
math::linearalgebra                1.1.6
math::machineparameters            0.1
math::numtheory                    1.1.1
math::numtheory                    1.1.3
math::optimize                     1.0.1
math::polynomials                  1.0.1
math::probopt                      1.0
math::quasirandom                  1.0
math::rationalfunctions            1.0.1
math::roman                        1.0
math::special                      0.4.0
math::special                      0.5.2
math::statistics                   1.5.0
math::trig                         1.0
md4                                1.0.7
md5                                1.4.4
md5                                2.0.7
md5                                1.4.5
md5                                2.0.8
md5crypt                           1.1.0
mime                               1.6.2
mime                               1.7.0
mkdoc                              0.7.0
multiplexer                        0.2
nameserv                           0.4.2
nameserv::auto                     0.3
nameserv::cluster                  0.2.5
nameserv::common                   0.1
nameserv::server                   0.3.2
namespacex                         0.2
namespacex                         0.3
ncgi                               1.4.4
nettool                            0.5.2
nettool::available_ports           0.1
nmea                               1.0.0
nntp                               0.2.1
oauth                              1.0.3
odie::processman                   0.5
odie::processman                   0.6
oo::dialect                        0.3.3
oo::meta                           0.7.1
oo::option                         0.3.1
oo::util                           1.2.2
otp                                1.0.0
page::analysis::peg::emodes        0.1
page::analysis::peg::minimize      0.1




︙


246
247
248
249
250
251
252
253
254


255
256
257

258
259
260
261
262
263


264
265
266
267
268
269
270

252
253
254
255
256
257
258


259
260
261
262

263
264
265
266
267


268
269
270
271
272
273
274
275
276








-
-
+
+


-
+




-
-
+
+








page::writer::mecpu                0.1.1
page::writer::null                 0.1
page::writer::peg                  0.1
page::writer::ser                  0.1
page::writer::tpc                  0.1
page::writer::tree                 0.1
paths                              1
picoirc                            0.5.2
pki                                0.10
picoirc                            0.13.0
pki                                0.20
pluginmgr                          0.3
png                                0.3
pop3                               1.9
pop3                               1.10
pop3d                              1.1.0
pop3d::dbox                        1.0.2
pop3d::udb                         1.1
practcl                            0.16.4
processman                         0.5
profiler                           0.4
processman                         0.6
profiler                           0.6
pt::ast                            1.1
pt::cparam::configuration::critcl  1.0.2
pt::cparam::configuration::tea     0.1
pt::parse::peg                     1.0.1
pt::pe                             1.0.2
pt::pe::op                         1.0.1
pt::peg                            1




︙


295
296
297
298
299
300
301
302

303
304
305
306
307

308
309
310
311

312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328


329
330
331
332
333
334
335

301
302
303
304
305
306
307

308
309
310
311
312
313
314
315
316
317

318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334

335
336
337
338
339
340
341
342
343








-
+





+



-
+
















-
+
+








pt::tclparam::configuration::snit  1.0.2
pt::tclparam::configuration::tcloo 1.0.4
pt::util                           1.1
rc4                                1.1.0
rcs                                0.1
report                             0.3.2
resolv                             1.0.3
rest                               1.3.1
rest                               1.5
ripemd128                          1.0.5
ripemd160                          1.0.5
sha1                               1.1.1
sha1                               2.0.4
sha256                             1.0.4
sha256c                            1.0.4
simulation::annealing              0.2
simulation::montecarlo             0.1
simulation::random                 0.4.0
smtp                               1.5
smtp                               1.5.1
smtpd                              1.5
snit                               1.4.2
snit                               2.3.2
soundex                            1.0
spf                                1.1.1
stooop                             4.4.1
string::token                      1
string::token::shell               1.2
stringprep                         1.0.1
stringprep::data                   1.0.1
struct                             1.4
struct                             2.1
struct::disjointset                1.1
struct::graph                      1.2.1
struct::graph                      2.4.3
struct::graph::op                  0.11.3
struct::list                       1.8.4
struct::list                       1.8.5
struct::list::test                 1.8.4
struct::map                        1
struct::matrix                     1.2.2
struct::matrix                     2.0.4
struct::pool                       1.2.3
struct::prioqueue                  1.4
struct::queue                      1.4.5
struct::record                     1.2.2




︙


343
344
345
346
347
348
349
350

351
352
353
354
355
356
357

351
352
353
354
355
356
357

358
359
360
361
362
363
364
365








-
+








tar                                0.11
tcl::chan::cat                     1.0.3
tcl::chan::core                    1
tcl::chan::events                  1
tcl::chan::facade                  1.0.1
tcl::chan::fifo                    1
tcl::chan::fifo2                   1
tcl::chan::halfpipe                1.0.1
tcl::chan::halfpipe                1.0.2
tcl::chan::memchan                 1.0.4
tcl::chan::null                    1
tcl::chan::nullzero                1
tcl::chan::random                  1
tcl::chan::std                     1.0.1
tcl::chan::string                  1.0.3
tcl::chan::textwindow              1




︙


374
375
376
377
378
379
380
381

382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408







409
410
411
412
413
414
415

382
383
384
385
386
387
388

389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409







410
411
412
413
414
415
416
417
418
419
420
421
422
423








-
+




















-
-
-
-
-
-
-
+
+
+
+
+
+
+








tclDES                             1.0.0
tclDESjr                           1.0.0
tepam                              0.5.2
tepam::doc_gen                     0.1.1
term                               0.1
term::ansi::code                   0.2
term::ansi::code::attr             0.1
term::ansi::code::ctrl             0.2
term::ansi::code::ctrl             0.3
term::ansi::code::macros           0.1
term::ansi::ctrl::unix             0.1.1
term::ansi::send                   0.2
term::interact::menu               0.1
term::interact::pager              0.1
term::receive                      0.1
term::receive::bind                0.1
term::send                         0.1
text::write                        1
textutil                           0.9
textutil::adjust                   0.7.3
textutil::expander                 1.3.1
textutil::patch                    0.1
textutil::repeat                   0.7
textutil::split                    0.8
textutil::string                   0.8
textutil::tabify                   0.7
textutil::trim                     0.7
textutil::wcswidth                 35.1
throw                              1
tie                                1.1
tie::std::array                    1.0
tie::std::dsource                  1.0
tie::std::file                     1.0.4
tie::std::growfile                 1.0
tie::std::log                      1.0
tie::std::rarray                   1.0.1
tie                                1.2
tie::std::array                    1.1
tie::std::dsource                  1.1
tie::std::file                     1.1
tie::std::growfile                 1.1
tie::std::log                      1.1
tie::std::rarray                   1.1
tiff                               0.2.1
time                               1.2.1
tool                               0.7
transfer::connect                  0.2
transfer::copy                     0.3
transfer::copy::queue              0.1
transfer::data::destination        0.2




︙


437
438
439
440
441
442
443
444

445
446
447
448
449
450

451
452

445
446
447
448
449
450
451

452
453
454
455
456
457

458
459
460








-
+





-
+



valtype::iban                      1.7
valtype::imei                      1
valtype::isbn                      1
valtype::luhn                      1
valtype::luhn5                     1
valtype::usnpi                     1
valtype::verhoeff                  1
websocket                          1.4.1
websocket                          1.4.2
wip                                1.2
wip                                2.2
xsxp                               1.0
yaml                               0.4.1
yencode                            1.1.3
zipfile::decode                    0.7.1
zipfile::decode                    0.9
zipfile::encode                    0.4
zipfile::mkzip                     1.2.1






Added support/releases/history/README-1.21.md.


















































































































































































































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

Overview
========

||||||
|---:|:---|:---|---:|:---|
|7|new packages|in|3|modules|
|53|changed packages|in|34|modules|
|78|internally changed packages|in|19|modules|
|307|unchanged packages|in|102|modules|
|453|packages, total|in|132|modules, total|

Legend
======

|Change|Details|Comments|
|:---|:---|:---|
|Major|API|__incompatible__ API changes|
|Minor|EF|Extended functionality, API|
||I|Major rewrite, but no API change|
|Patch|B|Bug fixes|
||EX|New examples|
||P|Performance enhancement|
|None|T|Testsuite changes|
||D|Documentation updates|

New in Tcllib 1.21
==================

|Module|Package|New Version|Comments|
|:---|:---|:---|:---|
|math|math::changepoint|0.1||
||math::combinatorics|2.0||
||math::figurate|1.0||
||math::filters|0.1||
||math::probopt|1.0||
|mkdoc|mkdoc|0.7.0||
|struct|struct::list::test|1.8.4||
|||||

Deprecations in Tcllib 1.21
===========================

Four packages are stage 2 deprecated in favor of two replacements.
All internal users of the deprecated packages have been rewritten to
use their replacements.

|Module|Package|Replacement|Deprecation stage|
|---|---|---|---|
|doctools|doctools::paths|fileutil::paths|(D2) Attempts to use throw errors|
|doctools|doctools::config|struct::map|(D2) Attempts to use throw errors|
|pt|paths|fileutil::paths|(D2) Attempts to use throw errors|
|pt|configuration|struct::map|(D2) Attempts to use throw errors|

Stage 1 (__D1__) means that:

  - The deprecated packages still exist.
  - Their implementations have changed and throw errors.

Future progress:

  - In the release after 1.21 the stage 2 deprecated packages will be
    moved to stage 3 (__D3__). In that stage the implementations will
    be removed from Tcllib, causing `package require` to fail.

Changes from Tcllib 1.20 to 1.21
================================

|Module|Package|From 1.20|To 1.21|Comments|
|:---|:---|:---|:---|:---|
|base64|base64|2.4.2|2.5|B D EF T|
|bibtex|bibtex|0.6|0.7|D EF T|
|cmdline|cmdline|1.5|1.5.2|B D T|
|comm|comm|4.6.3.1|4.7|B I T|
||||||
|coroutine|coroutine|1.2|1.3|B D I|
||coroutine::auto|1.1.3|1.2|D I|
||||||
|crc|crc16|1.1.3|1.1.4|B D|
||crc32|1.3.2|1.3.3|B D|
||||||
|dns|dns|1.4.1|1.5.0|D EF|
|fileutil|fileutil|1.16|1.16.1|B T|
||||||
|fumagic|fileutil::magic::cfront|1.2.0|1.3.0|B|
||fileutil::magic::cgen|1.2.0|1.3.0|B|
||fileutil::magic::filetype|2.0|2.0.1|B|
||fileutil::magic::rt|2.0||B|
||fileutil::magic::rt||3.0|B|
||||||
|generator|generator|0.1|0.2|B D|
|hook|hook|0.1|0.2|B D T|
|httpd|httpd|4.3.4|4.3.5|B T|
|inifile|inifile|0.3.1|0.3.2|B T|
||||||
|irc|irc|0.6.2|0.7.0|I|
||picoirc|0.5.2|0.13.0|B D EF I T|
||||||
|json|json::write|1.0.3|1.0.4|EF|
||||||
|ldap|ldap|1.9.2|1.10.1|B D|
||ldapx|1.1|1.2|EF|
||||||
|markdown|Markdown|1.1.1|1.2.2|B D EF T|
||||||
|math|math::bigfloat|1.2.2|1.2.3|B D T|
||math::bigfloat|2.0.2|2.0.3|B D T|
||math::decimal|1.0.3|1.0.4|B T|
||math::geometry|1.3.1|1.4.1|B D EF T|
||math::numtheory|1.1.1|1.1.3|B D EF T|
||math::special|0.4.0|0.5.2|D EF I T|
||||||
|md5|md5|1.4.4|1.4.5|D I P|
||md5|2.0.7|2.0.8|D I P|
||||||
|mime|mime|1.6.2|1.7.0|B D EF I T|
||smtp|1.5|1.5.1|B D T|
||||||
|namespacex|namespacex|0.2|0.3|B D T|
|pki|pki|0.10|0.20|B D EF I T|
|pop3|pop3|1.9|1.10|D EF T|
||||||
|processman|odie::processman|0.5|0.6|B D|
||processman|0.5|0.6|B D|
||||||
|profiler|profiler|0.4|0.6|B D T|
|pt|char|1.0.1|1.0.2|B T|
|rest|rest|1.3.1|1.5|D EF|
|struct|struct::list|1.8.4|1.8.5|B D T|
|term|term::ansi::code::ctrl|0.2|0.3|B D|
||||||
|tie|tie|1.1|1.2|D EF T|
||tie::std::array|1.0|1.1|D EF T|
||tie::std::dsource|1.0|1.1|D EF T|
||tie::std::file|1.0.4|1.1|D EF T|
||tie::std::growfile|1.0|1.1|D EF T|
||tie::std::log|1.0|1.1|D EF T|
||tie::std::rarray|1.0.1|1.1|D EF T|
|virtchannel_base|tcl::chan::halfpipe|1.0.1|1.0.2|EF|
|websocket|websocket|1.4.1|1.4.2|B|
|yaml|huddle|0.3|0.4|B D T|
|zip|zipfile::decode|0.7.1|0.9|B D EF|
||||||

Invisible changes (documentation, testsuites)
=============================================

|Module|Package|From 1.20|To 1.21|Comments|
|:---|:---|:---|:---|:---|
|amazon-s3|S3|1.0.3|1.0.3|T|
|asn|asn|0.8.4|0.8.4|T|
|base64|yencode|1.1.3|1.1.3|T|
|clay|clay|0.8.6|0.8.6|T|
||||||
|clock|clock::iso8601|0.1|0.1|D|
||clock::rfc2822|0.1|0.1|D I|
||||||
|doctools2base|doctools::tcl::parse|0.1|0.1|T|
||||||
|doctools2idx|doctools::idx::export|0.2.1|0.2.1|T|
||doctools::idx::export::docidx|0.1|0.1|T|
||doctools::idx::export::html|0.2|0.2|T|
||doctools::idx::export::json|0.1|0.1|T|
||doctools::idx::export::nroff|0.3|0.3|T|
||doctools::idx::export::text|0.2|0.2|T|
||doctools::idx::export::wiki|0.2|0.2|T|
||doctools::idx::import|0.2.1|0.2.1|T|
||doctools::idx::import::docidx|0.1|0.1|T|
||doctools::idx::import::json|0.1|0.1|T|
||doctools::idx::parse|0.1|0.1|T|
||doctools::idx::structure|0.1|0.1|T|
||||||
|doctools2toc|doctools::toc::export|0.2.1|0.2.1|T|
||doctools::toc::export::doctoc|0.1|0.1|T|
||doctools::toc::export::html|0.1|0.1|T|
||doctools::toc::export::json|0.1|0.1|T|
||doctools::toc::export::nroff|0.2|0.2|T|
||doctools::toc::export::text|0.1|0.1|T|
||doctools::toc::export::wiki|0.1|0.1|T|
||doctools::toc::import|0.2.1|0.2.1|T|
||doctools::toc::import::doctoc|0.1|0.1|T|
||doctools::toc::import::json|0.1|0.1|T|
||doctools::toc::parse|0.1|0.1|T|
||doctools::toc::structure|0.1|0.1|T|
||||||
|grammar_fa|grammar::fa|0.5|0.5|T|
|httpwget|http::wget|0.1|0.1|I|
|mapproj|mapproj|1.0|1.0|I|
||||||
|math|math::fourier|1.0.2|1.0.2|D|
||math::machineparameters|0.1|0.1|D|
||math::quasirandom|1.0|1.0|D|
||||||
|oometa|oo::meta|0.7.1|0.7.1|T|
||||||
|pt|pt::ast|1.1|1.1|T|
||pt::cparam::configuration::critcl|1.0.2|1.0.2|I T|
||pt::cparam::configuration::tea|0.1|0.1|T|
||pt::parse::peg|1.0.1|1.0.1|I T|
||pt::pe|1.0.2|1.0.2|T|
||pt::pe::op|1.0.1|1.0.1|T|
||pt::peg|1|1|T|
||pt::peg::container|1|1|T|
||pt::peg::export|1.0.1|1.0.1|T|
||pt::peg::export::container|1|1|T|
||pt::peg::export::json|1|1|T|
||pt::peg::export::peg|1|1|T|
||pt::peg::from::json|1|1|T|
||pt::peg::from::peg|1.0.3|1.0.3|T|
||pt::peg::import|1.0.1|1.0.1|T|
||pt::peg::import::json|1|1|T|
||pt::peg::import::peg|1|1|T|
||pt::peg::interp|1.0.1|1.0.1|T|
||pt::peg::op|1.1.0|1.1.0|T|
||pt::peg::to::container|1|1|T|
||pt::peg::to::cparam|1.1.3|1.1.3|T|
||pt::peg::to::json|1|1|T|
||pt::peg::to::param|1.0.1|1.0.1|T|
||pt::peg::to::peg|1.0.2|1.0.2|T|
||pt::peg::to::tclparam|1.0.3|1.0.3|T|
||pt::pgen|1.1|1.1|T|
||pt::rde|1.1|1.1|I T|
||pt::tclparam::configuration::nx|1.0.1|1.0.1|T|
||pt::tclparam::configuration::snit|1.0.2|1.0.2|T|
||pt::tclparam::configuration::tcloo|1.0.4|1.0.4|T|
||||||
|struct|struct::graph|1.2.1|1.2.1|I|
||struct::graph|2.4.3|2.4.3|I|
||struct::queue|1.4.5|1.4.5|I|
||struct::skiplist|1.3|1.3|T|
||struct::stack|1.5.3|1.5.3|I|
||struct::tree|1.2.2|1.2.2|I T|
||struct::tree|2.1.2|2.1.2|I T|
||||||
|tar|tar|0.11|0.11|D|
||||||
|textutil|textutil::adjust|0.7.3|0.7.3|T|
||textutil::patch|0.1|0.1|I T|
|tool|tool|0.7|0.7|I|
|yaml|yaml|0.4.1|0.4.1|I|
||||||

Unchanged
=========

    aes, ascii85, autoproxy, base32, base32::core, base32::hex, bee,
    bench, bench::in, bench::out::csv, bench::out::text, blowfish,
    cache::async, calendar, cksum, clay, configuration, control,
    counter, cron, csv, debug, debug::caller, debug::heartbeat,
    debug::timestamp, defer, des, dicttool, docstrip,
    docstrip::util, doctools, doctools::changelog, doctools::config,
    doctools::cvs, doctools::html, doctools::html::cssdefaults,
    doctools::idx, doctools::idx, doctools::msgcat,
    doctools::msgcat::idx::c, doctools::msgcat::idx::de,
    doctools::msgcat::idx::en, doctools::msgcat::idx::fr,
    doctools::msgcat::toc::c, doctools::msgcat::toc::de,
    doctools::msgcat::toc::en, doctools::msgcat::toc::fr,
    doctools::nroff::man_macros, doctools::paths, doctools::text,
    doctools::toc, doctools::toc, dtplite, exif, fileutil::decode,
    fileutil::multi, fileutil::multi::op, fileutil::paths,
    fileutil::traverse, ftp, ftp::geturl, ftpd, gpx,
    grammar::aycock, grammar::aycock::debug,
    grammar::aycock::runtime, grammar::fa::dacceptor,
    grammar::fa::dexec, grammar::fa::op, grammar::me::cpu,
    grammar::me::cpu::core, grammar::me::cpu::gasm,
    grammar::me::tcl, grammar::me::util, grammar::peg,
    grammar::peg::interp, html, htmlparse, huddle::json, ident,
    imap4, interp, interp::delegate::method, interp::delegate::proc,
    ip, javascript, jpeg, json, lambda, lazyset, log, logger,
    logger::appender, logger::utils, map::geocode::nominatim,
    map::slippy, map::slippy::cache, map::slippy::fetcher, math,
    math::bignum, math::calculus, math::calculus::symdiff,
    math::complexnumbers, math::constants, math::exact, math::fuzzy,
    math::interpolate, math::linearalgebra, math::optimize,
    math::PCA, math::polynomials, math::rationalfunctions,
    math::roman, math::statistics, math::trig, md4, md5crypt,
    multiplexer, nameserv, nameserv::auto, nameserv::common,
    nameserv::server, ncgi, nettool, nmea, nntp, oauth, oo::dialect,
    oo::option, oo::util, otp, page::analysis::peg::emodes,
    page::analysis::peg::minimize, page::analysis::peg::reachable,
    page::analysis::peg::realizable, page::compiler::peg::mecpu,
    page::config::peg, page::gen::peg::canon, page::gen::peg::cpkg,
    page::gen::peg::hb, page::gen::peg::me, page::gen::peg::mecpu,
    page::gen::peg::ser, page::gen::tree::text, page::parse::lemon,
    page::parse::peg, page::parse::peghb, page::parse::pegser,
    page::pluginmgr, page::reader::hb, page::reader::lemon,
    page::reader::peg, page::reader::ser, page::reader::treeser,
    page::transform::mecpu, page::transform::reachable,
    page::transform::realizable, page::util::flow,
    page::util::norm::lemon, page::util::norm::peg, page::util::peg,
    page::util::quote, page::writer::hb, page::writer::identity,
    page::writer::me, page::writer::mecpu, page::writer::null,
    page::writer::peg, page::writer::ser, page::writer::tpc,
    page::writer::tree, paths, pluginmgr, png, pop3d, pop3d::dbox,
    pop3d::udb, practcl, pt::peg::container::peg, pt::rde::nx,
    pt::rde::oo, pt::util, rc4, rcs, report, resolv, ripemd128,
    ripemd160, SASL, SASL::NTLM, SASL::SCRAM, SASL::XGoogleToken,
    sha1, sha256, simulation::annealing, simulation::montecarlo,
    simulation::random, smtpd, snit, soundex, spf, stooop,
    string::token, string::token::shell, stringprep,
    stringprep::data, struct, struct::disjointset,
    struct::graph::op, struct::map, struct::matrix, struct::pool,
    struct::prioqueue, struct::record, struct::set, sum, switched,
    tcl::chan::cat, tcl::chan::core, tcl::chan::events,
    tcl::chan::facade, tcl::chan::fifo, tcl::chan::fifo2,
    tcl::chan::memchan, tcl::chan::null, tcl::chan::nullzero,
    tcl::chan::random, tcl::chan::std, tcl::chan::string,
    tcl::chan::textwindow, tcl::chan::variable, tcl::chan::zero,
    tcl::randomseed, tcl::transform::adler32,
    tcl::transform::base64, tcl::transform::core,
    tcl::transform::counter, tcl::transform::crc32,
    tcl::transform::hex, tcl::transform::identity,
    tcl::transform::limitsize, tcl::transform::observe,
    tcl::transform::otp, tcl::transform::rot,
    tcl::transform::spacer, tcl::transform::zlib, tclDES, tclDESjr,
    tepam, tepam::doc_gen, term, term::ansi::code,
    term::ansi::code::attr, term::ansi::code::macros,
    term::ansi::ctrl::unix, term::ansi::send, term::interact::menu,
    term::interact::pager, term::receive, term::receive::bind,
    term::send, text::write, textutil, textutil::expander,
    textutil::repeat, textutil::split, textutil::string,
    textutil::tabify, textutil::trim, textutil::wcswidth, throw,
    tiff, time, transfer::connect, transfer::copy,
    transfer::copy::queue, transfer::data::destination,
    transfer::data::source, transfer::receiver,
    transfer::transmitter, treeql, try, udpcluster, uevent,
    uevent::onidle, unicode, unicode::data, units, uri, uri::urn,
    uuencode, uuid, valtype::common, valtype::creditcard::amex,
    valtype::creditcard::discover, valtype::creditcard::mastercard,
    valtype::creditcard::visa, valtype::gs1::ean13, valtype::iban,
    valtype::imei, valtype::isbn, valtype::luhn, valtype::luhn5,
    valtype::usnpi, valtype::verhoeff, wip, xsxp, zipfile::encode,
    zipfile::mkzip






Added support/releases/history/README-1.21.txt.





















































































































































































































































































































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

Overview
========

    7   new packages                in 3   modules
    53  changed packages            in 34  modules
    78  internally changed packages in 19  modules
    307 unchanged packages          in 102 modules
    453 packages, total             in 132 modules, total

Legend
======

    Change   Details   Comments
    -------- --------- ----------------------------------
    Major    API       __incompatible__ API changes
    Minor    EF        Extended functionality, API
             I         Major rewrite, but no API change
    Patch    B         Bug fixes
             EX        New examples
             P         Performance enhancement
    None     T         Testsuite changes
             D         Documentation updates
    -------- --------- ----------------------------------

New in Tcllib 1.21
==================

    Module   Package               New Version   Comments
    -------- --------------------- ------------- ----------
    math     math::changepoint     0.1
             math::combinatorics   2.0
             math::figurate        1.0
             math::filters         0.1
             math::probopt         1.0
    -------- --------------------- ------------- ----------
    mkdoc    mkdoc                 0.7.0
    struct   struct::list::test    1.8.4
    -------- --------------------- ------------- ----------

Deprecations in Tcllib 1.21
===========================

Four packages are stage 2 deprecated in favor of two replacements.
All internal users of the deprecated packages have been rewritten to
use their replacements.

    Module             Package           Replacement      Deprecation stage
    ------------------ ----------------- ---------------- --------------------------------
    doctools           doctools::paths   fileutil::paths  (D2) Attempts to use throw errors
    doctools           doctools::config  struct::map      (D2) Attempts to use throw errors
    pt                 paths             fileutil::paths  (D2) Attempts to use throw errors
    pt                 configuration     struct::map      (D2) Attempts to use throw errors
    ------------------ ----------------- ---------------- --------------------------------

Stage 2 (D2) means that:

  - The deprecated packages still exist.
  - Their implementations have changed and throw errors.

Future progress:

  - In the release after 1.21 the stage 2 deprecated packages will be
    moved to stage 3 (D3). In that stage the packages will be removed
    from Tcllib, causing `package require` to fail.

Changes from Tcllib 1.20 to 1.21
================================

    Module             Package                     From 1.20   To 1.21   Comments
    ------------------ --------------------------- ----------- --------- ------------
    base64             base64                      2.4.2       2.5       B D EF T
    bibtex             bibtex                      0.6         0.7       D EF T
    cmdline            cmdline                     1.5         1.5.2     B D T
    comm               comm                        4.6.3.1     4.7       B I T
    ------------------ --------------------------- ----------- --------- ------------
    coroutine          coroutine                   1.2         1.3       B D I
                       coroutine::auto             1.1.3       1.2       D I
    ------------------ --------------------------- ----------- --------- ------------
    crc                crc16                       1.1.3       1.1.4     B D
                       crc32                       1.3.2       1.3.3     B D
    ------------------ --------------------------- ----------- --------- ------------
    dns                dns                         1.4.1       1.5.0     D EF
    fileutil           fileutil                    1.16        1.16.1    B T
    ------------------ --------------------------- ----------- --------- ------------
    fumagic            fileutil::magic::cfront     1.2.0       1.3.0     B
                       fileutil::magic::cgen       1.2.0       1.3.0     B
                       fileutil::magic::filetype   2.0         2.0.1     B
                       fileutil::magic::rt         2.0                   B
                       fileutil::magic::rt                     3.0       B
    ------------------ --------------------------- ----------- --------- ------------
    generator          generator                   0.1         0.2       B D
    hook               hook                        0.1         0.2       B D T
    httpd              httpd                       4.3.4       4.3.5     B T
    inifile            inifile                     0.3.1       0.3.2     B T
    ------------------ --------------------------- ----------- --------- ------------
    irc                irc                         0.6.2       0.7.0     I
                       picoirc                     0.5.2       0.13.0    B D EF I T
    ------------------ --------------------------- ----------- --------- ------------
    json               json::write                 1.0.3       1.0.4     EF
    ------------------ --------------------------- ----------- --------- ------------
    ldap               ldap                        1.9.2       1.10.1    B D
                       ldapx                       1.1         1.2       EF
    ------------------ --------------------------- ----------- --------- ------------
    markdown           Markdown                    1.1.1       1.2.2     B D EF T
    ------------------ --------------------------- ----------- --------- ------------
    math               math::bigfloat              1.2.2       1.2.3     B D T
                       math::bigfloat              2.0.2       2.0.3     B D T
                       math::decimal               1.0.3       1.0.4     B T
                       math::geometry              1.3.1       1.4.1     B D EF T
                       math::numtheory             1.1.1       1.1.3     B D EF T
                       math::special               0.4.0       0.5.2     D EF I T
    ------------------ --------------------------- ----------- --------- ------------
    md5                md5                         1.4.4       1.4.5     D I P
                       md5                         2.0.7       2.0.8     D I P
    ------------------ --------------------------- ----------- --------- ------------
    mime               mime                        1.6.2       1.7.0     B D EF I T
                       smtp                        1.5         1.5.1     B D T
    ------------------ --------------------------- ----------- --------- ------------
    namespacex         namespacex                  0.2         0.3       B D T
    pki                pki                         0.10        0.20      B D EF I T
    pop3               pop3                        1.9         1.10      D EF T
    ------------------ --------------------------- ----------- --------- ------------
    processman         odie::processman            0.5         0.6       B D
                       processman                  0.5         0.6       B D
    ------------------ --------------------------- ----------- --------- ------------
    profiler           profiler                    0.4         0.6       B D T
    pt                 char                        1.0.1       1.0.2     B T
    rest               rest                        1.3.1       1.5       D EF
    struct             struct::list                1.8.4       1.8.5     B D T
    term               term::ansi::code::ctrl      0.2         0.3       B D
    ------------------ --------------------------- ----------- --------- ------------
    tie                tie                         1.1         1.2       D EF T
                       tie::std::array             1.0         1.1       D EF T
                       tie::std::dsource           1.0         1.1       D EF T
                       tie::std::file              1.0.4       1.1       D EF T
                       tie::std::growfile          1.0         1.1       D EF T
                       tie::std::log               1.0         1.1       D EF T
                       tie::std::rarray            1.0.1       1.1       D EF T
    ------------------ --------------------------- ----------- --------- ------------
    virtchannel_base   tcl::chan::halfpipe         1.0.1       1.0.2     EF
    websocket          websocket                   1.4.1       1.4.2     B
    yaml               huddle                      0.3         0.4       B D T
    zip                zipfile::decode             0.7.1       0.9       B D EF
    ------------------ --------------------------- ----------- --------- ------------

Invisible changes (documentation, testsuites)
=============================================

    Module          Package                              From 1.20   To 1.21   Comments
    --------------- ------------------------------------ ----------- --------- ----------
    amazon-s3       S3                                   1.0.3       1.0.3     T
    asn             asn                                  0.8.4       0.8.4     T
    base64          yencode                              1.1.3       1.1.3     T
    clay            clay                                 0.8.6       0.8.6     T
    --------------- ------------------------------------ ----------- --------- ----------
    clock           clock::iso8601                       0.1         0.1       D
                    clock::rfc2822                       0.1         0.1       D I
    --------------- ------------------------------------ ----------- --------- ----------
    doctools2base   doctools::tcl::parse                 0.1         0.1       T
    --------------- ------------------------------------ ----------- --------- ----------
    doctools2idx    doctools::idx::export                0.2.1       0.2.1     T
                    doctools::idx::export::docidx        0.1         0.1       T
                    doctools::idx::export::html          0.2         0.2       T
                    doctools::idx::export::json          0.1         0.1       T
                    doctools::idx::export::nroff         0.3         0.3       T
                    doctools::idx::export::text          0.2         0.2       T
                    doctools::idx::export::wiki          0.2         0.2       T
                    doctools::idx::import                0.2.1       0.2.1     T
                    doctools::idx::import::docidx        0.1         0.1       T
                    doctools::idx::import::json          0.1         0.1       T
                    doctools::idx::parse                 0.1         0.1       T
                    doctools::idx::structure             0.1         0.1       T
    --------------- ------------------------------------ ----------- --------- ----------
    doctools2toc    doctools::toc::export                0.2.1       0.2.1     T
                    doctools::toc::export::doctoc        0.1         0.1       T
                    doctools::toc::export::html          0.1         0.1       T
                    doctools::toc::export::json          0.1         0.1       T
                    doctools::toc::export::nroff         0.2         0.2       T
                    doctools::toc::export::text          0.1         0.1       T
                    doctools::toc::export::wiki          0.1         0.1       T
                    doctools::toc::import                0.2.1       0.2.1     T
                    doctools::toc::import::doctoc        0.1         0.1       T
                    doctools::toc::import::json          0.1         0.1       T
                    doctools::toc::parse                 0.1         0.1       T
                    doctools::toc::structure             0.1         0.1       T
    --------------- ------------------------------------ ----------- --------- ----------
    grammar_fa      grammar::fa                          0.5         0.5       T
    httpwget        http::wget                           0.1         0.1       I
    mapproj         mapproj                              1.0         1.0       I
    --------------- ------------------------------------ ----------- --------- ----------
    math            math::fourier                        1.0.2       1.0.2     D
                    math::machineparameters              0.1         0.1       D
                    math::quasirandom                    1.0         1.0       D
    --------------- ------------------------------------ ----------- --------- ----------
    oometa          oo::meta                             0.7.1       0.7.1     T
    --------------- ------------------------------------ ----------- --------- ----------
    pt              pt::ast                              1.1         1.1       T
                    pt::cparam::configuration::critcl    1.0.2       1.0.2     I T
                    pt::cparam::configuration::tea       0.1         0.1       T
                    pt::parse::peg                       1.0.1       1.0.1     I T
                    pt::pe                               1.0.2       1.0.2     T
                    pt::pe::op                           1.0.1       1.0.1     T
                    pt::peg                              1           1         T
                    pt::peg::container                   1           1         T
                    pt::peg::export                      1.0.1       1.0.1     T
                    pt::peg::export::container           1           1         T
                    pt::peg::export::json                1           1         T
                    pt::peg::export::peg                 1           1         T
                    pt::peg::from::json                  1           1         T
                    pt::peg::from::peg                   1.0.3       1.0.3     T
                    pt::peg::import                      1.0.1       1.0.1     T
                    pt::peg::import::json                1           1         T
                    pt::peg::import::peg                 1           1         T
                    pt::peg::interp                      1.0.1       1.0.1     T
                    pt::peg::op                          1.1.0       1.1.0     T
                    pt::peg::to::container               1           1         T
                    pt::peg::to::cparam                  1.1.3       1.1.3     T
                    pt::peg::to::json                    1           1         T
                    pt::peg::to::param                   1.0.1       1.0.1     T
                    pt::peg::to::peg                     1.0.2       1.0.2     T
                    pt::peg::to::tclparam                1.0.3       1.0.3     T
                    pt::pgen                             1.1         1.1       T
                    pt::rde                              1.1         1.1       I T
                    pt::tclparam::configuration::nx      1.0.1       1.0.1     T
                    pt::tclparam::configuration::snit    1.0.2       1.0.2     T
                    pt::tclparam::configuration::tcloo   1.0.4       1.0.4     T
    --------------- ------------------------------------ ----------- --------- ----------
    struct          struct::graph                        1.2.1       1.2.1     I
                    struct::graph                        2.4.3       2.4.3     I
                    struct::queue                        1.4.5       1.4.5     I
                    struct::skiplist                     1.3         1.3       T
                    struct::stack                        1.5.3       1.5.3     I
                    struct::tree                         1.2.2       1.2.2     I T
                    struct::tree                         2.1.2       2.1.2     I T
    --------------- ------------------------------------ ----------- --------- ----------
    tar             tar                                  0.11        0.11      D
    --------------- ------------------------------------ ----------- --------- ----------
    textutil        textutil::adjust                     0.7.3       0.7.3     T
                    textutil::patch                      0.1         0.1       I T
    --------------- ------------------------------------ ----------- --------- ----------
    tool            tool                                 0.7         0.7       I
    yaml            yaml                                 0.4.1       0.4.1     I
    --------------- ------------------------------------ ----------- --------- ----------

Unchanged
=========

    aes, ascii85, autoproxy, base32, base32::core, base32::hex, bee,
    bench, bench::in, bench::out::csv, bench::out::text, blowfish,
    cache::async, calendar, cksum, clay, configuration, control,
    counter, cron, csv, debug, debug::caller, debug::heartbeat,
    debug::timestamp, defer, des, dicttool, docstrip,
    docstrip::util, doctools, doctools::changelog, doctools::config,
    doctools::cvs, doctools::html, doctools::html::cssdefaults,
    doctools::idx, doctools::idx, doctools::msgcat,
    doctools::msgcat::idx::c, doctools::msgcat::idx::de,
    doctools::msgcat::idx::en, doctools::msgcat::idx::fr,
    doctools::msgcat::toc::c, doctools::msgcat::toc::de,
    doctools::msgcat::toc::en, doctools::msgcat::toc::fr,
    doctools::nroff::man_macros, doctools::paths, doctools::text,
    doctools::toc, doctools::toc, dtplite, exif, fileutil::decode,
    fileutil::multi, fileutil::multi::op, fileutil::paths,
    fileutil::traverse, ftp, ftp::geturl, ftpd, gpx,
    grammar::aycock, grammar::aycock::debug,
    grammar::aycock::runtime, grammar::fa::dacceptor,
    grammar::fa::dexec, grammar::fa::op, grammar::me::cpu,
    grammar::me::cpu::core, grammar::me::cpu::gasm,
    grammar::me::tcl, grammar::me::util, grammar::peg,
    grammar::peg::interp, html, htmlparse, huddle::json, ident,
    imap4, interp, interp::delegate::method, interp::delegate::proc,
    ip, javascript, jpeg, json, lambda, lazyset, log, logger,
    logger::appender, logger::utils, map::geocode::nominatim,
    map::slippy, map::slippy::cache, map::slippy::fetcher, math,
    math::bignum, math::calculus, math::calculus::symdiff,
    math::complexnumbers, math::constants, math::exact, math::fuzzy,
    math::interpolate, math::linearalgebra, math::optimize,
    math::PCA, math::polynomials, math::rationalfunctions,
    math::roman, math::statistics, math::trig, md4, md5crypt,
    multiplexer, nameserv, nameserv::auto, nameserv::common,
    nameserv::server, ncgi, nettool, nmea, nntp, oauth, oo::dialect,
    oo::option, oo::util, otp, page::analysis::peg::emodes,
    page::analysis::peg::minimize, page::analysis::peg::reachable,
    page::analysis::peg::realizable, page::compiler::peg::mecpu,
    page::config::peg, page::gen::peg::canon, page::gen::peg::cpkg,
    page::gen::peg::hb, page::gen::peg::me, page::gen::peg::mecpu,
    page::gen::peg::ser, page::gen::tree::text, page::parse::lemon,
    page::parse::peg, page::parse::peghb, page::parse::pegser,
    page::pluginmgr, page::reader::hb, page::reader::lemon,
    page::reader::peg, page::reader::ser, page::reader::treeser,
    page::transform::mecpu, page::transform::reachable,
    page::transform::realizable, page::util::flow,
    page::util::norm::lemon, page::util::norm::peg, page::util::peg,
    page::util::quote, page::writer::hb, page::writer::identity,
    page::writer::me, page::writer::mecpu, page::writer::null,
    page::writer::peg, page::writer::ser, page::writer::tpc,
    page::writer::tree, paths, pluginmgr, png, pop3d, pop3d::dbox,
    pop3d::udb, practcl, pt::peg::container::peg, pt::rde::nx,
    pt::rde::oo, pt::util, rc4, rcs, report, resolv, ripemd128,
    ripemd160, SASL, SASL::NTLM, SASL::SCRAM, SASL::XGoogleToken,
    sha1, sha256, simulation::annealing, simulation::montecarlo,
    simulation::random, smtpd, snit, soundex, spf, stooop,
    string::token, string::token::shell, stringprep,
    stringprep::data, struct, struct::disjointset,
    struct::graph::op, struct::map, struct::matrix, struct::pool,
    struct::prioqueue, struct::record, struct::set, sum, switched,
    tcl::chan::cat, tcl::chan::core, tcl::chan::events,
    tcl::chan::facade, tcl::chan::fifo, tcl::chan::fifo2,
    tcl::chan::memchan, tcl::chan::null, tcl::chan::nullzero,
    tcl::chan::random, tcl::chan::std, tcl::chan::string,
    tcl::chan::textwindow, tcl::chan::variable, tcl::chan::zero,
    tcl::randomseed, tcl::transform::adler32,
    tcl::transform::base64, tcl::transform::core,
    tcl::transform::counter, tcl::transform::crc32,
    tcl::transform::hex, tcl::transform::identity,
    tcl::transform::limitsize, tcl::transform::observe,
    tcl::transform::otp, tcl::transform::rot,
    tcl::transform::spacer, tcl::transform::zlib, tclDES, tclDESjr,
    tepam, tepam::doc_gen, term, term::ansi::code,
    term::ansi::code::attr, term::ansi::code::macros,
    term::ansi::ctrl::unix, term::ansi::send, term::interact::menu,
    term::interact::pager, term::receive, term::receive::bind,
    term::send, text::write, textutil, textutil::expander,
    textutil::repeat, textutil::split, textutil::string,
    textutil::tabify, textutil::trim, textutil::wcswidth, throw,
    tiff, time, transfer::connect, transfer::copy,
    transfer::copy::queue, transfer::data::destination,
    transfer::data::source, transfer::receiver,
    transfer::transmitter, treeql, try, udpcluster, uevent,
    uevent::onidle, unicode, unicode::data, units, uri, uri::urn,
    uuencode, uuid, valtype::common, valtype::creditcard::amex,
    valtype::creditcard::discover, valtype::creditcard::mastercard,
    valtype::creditcard::visa, valtype::gs1::ean13, valtype::iban,
    valtype::imei, valtype::isbn, valtype::luhn, valtype::luhn5,
    valtype::usnpi, valtype::verhoeff, wip, xsxp, zipfile::encode,
    zipfile::mkzip






Changes to tcllib.spec.





1
2
3

4
5
6
7
8
9
10

1
2

3
4
5
6
7
8
9
10



-
+








# $Id: package_rpm.txt,v 1.1 2006/07/01 03:16:57 andreas_kupries Exp $

%define version 1.20
%define version 1.21
%define directory /usr

Summary: The standard Tcl library
Name: tcllib
Version: %{version}
Release: 2
Copyright: BSD




︙





Changes to tcllib.tap.





1
2
3
4
5

6
7
8
9

10
11
12
13
14
15
16
17
18
19
20

21
22
23
24
25
26
27

1
2
3
4

5
6
7
8

9
10
11
12
13
14
15
16
17
18
19

20
21
22
23
24
25
26
27





-
+



-
+










-
+








format  {TclDevKit Project File}
fmtver  2.0
fmttool {TclDevKit TclApp PackageDefinition} 2.5

##  Saved at : Sun Dec 01 14:04:43 PST 2019
##  Saved at : Sat May 07 16:10:12 CEST 2022
##  By       : aku
##
##  Generated by "sak.tcl tap"
##  of tcllib 1.20
##  of tcllib 1.21

########
#####
###
##
#

# ###############
# Complete bundle

Package {tcllib 1.20}
Package {tcllib 1.21}
Base     @TAP_DIR@
Platform *
Desc     {Tcllib: Bundle of all packages}
Path     pkgIndex.tcl
Path     0compatibility
Path     aes
Path     amazon-s3




︙


63
64
65
66
67
68
69


70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89



90
91
92
93
94

95
96
97
98
99
100
101

63
64
65
66
67
68
69
70
71
72
73
74


75
76
77
78
79
80
81
82
83
84
85
86



87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102








+
+



-
-












-
-
-
+
+
+





+








Path     generator
Path     gpx
Path     grammar_aycock
Path     grammar_fa
Path     grammar_me
Path     grammar_peg
Path     hook
Path     html
Path     htmlparse
Path     http
Path     httpd
Path     httpwget
Path     html
Path     htmlparse
Path     ident
Path     imap4
Path     inifile
Path     interp
Path     irc
Path     javascript
Path     jpeg
Path     json
Path     lambda
Path     lazyset
Path     ldap
Path     log
Path     markdown
Path     map
Path     mapproj
Path     map
Path     mapproj
Path     markdown
Path     math
Path     md4
Path     md5
Path     md5crypt
Path     mime
Path     mkdoc
Path     multiplexer
Path     namespacex
Path     ncgi
Path     nettool
Path     nmea
Path     nns
Path     nntp




︙


153
154
155
156
157
158
159
160
161
162


163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188

154
155
156
157
158
159
160



161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176





177
178
179
180
181
182
183








-
-
-
+
+














-
-
-
-
-








Path     wip
Path     yaml
Path     zip

# #######################
# Module "0compatibility"
# [1]    | "configuration" (1)
# [2]    | "paths" (1)
# [3]    | "doctools::config" (0.1)
# [4]    | "doctools::paths" (0.1)
# [2]    | "doctools::config" (0.1)
# [3]    | "doctools::paths" (0.1)
# -------+

Package {__0compatibility 0.0}
Platform *
Desc     {Tcllib module}
Hidden
Base     @TAP_DIR@/0compatibility
Path     d_config.tcl
Path     d_paths.tcl
Path     p_config.tcl
Path     p_paths.tcl
Path     pkgIndex.tcl

Package {configuration 1}
See   __0compatibility
Platform *
Desc     {Tcllib package}

Package {paths 1}
See   __0compatibility
Platform *
Desc     {Tcllib package}

Package {doctools::config 0.1}
See   __0compatibility
Platform *




︙


292
293
294
295
296
297
298
299

300
301
302
303
304
305
306

287
288
289
290
291
292
293

294
295
296
297
298
299
300
301








-
+









#
# ###############

# ###############
# Module "base64"
# [1]    | "uuencode" (1.1.5)
# [2]    | "base64" (2.4.2)
# [2]    | "base64" (2.5)
# [3]    | "ascii85" (1.0)
# [4]    | "yencode" (1.1.3)
# -------+

Package {__base64 0.0}
Platform *
Desc     {Text encoding & decoding binary data}




︙


314
315
316
317
318
319
320
321

322
323
324
325
326
327
328

309
310
311
312
313
314
315

316
317
318
319
320
321
322
323








-
+








Path     yencode.tcl

Package {uuencode 1.1.5}
See   __base64
Platform *
Desc     {UU-encode/decode binary data}

Package {base64 2.4.2}
Package {base64 2.5}
See   __base64
Platform *
Desc     {base64-encode/decode binary data}

Package {ascii85 1.0}
See   __base64
Platform *




︙


349
350
351
352
353
354
355
356
357


358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373





374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399

400
401
402

403
404
405
406
407
408
409

344
345
346
347
348
349
350


351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378





379
380
381
382
383
384
385
386
387
388
389
390
391
392
393

394
395
396

397
398
399
400
401
402
403
404








-
-
+
+
















+
+
+
+
+





-
-
-
-
-















-
+


-
+








Path     pkgIndex.tcl

#
# ############

# ##############
# Module "bench"
# [1]    | "bench::out::csv" (0.1.2)
# [2]    | "bench" (0.4)
# [1]    | "bench" (0.4)
# [2]    | "bench::out::csv" (0.1.2)
# [3]    | "bench::out::text" (0.1.2)
# [4]    | "bench::in" (0.1)
# -------+

Package {__bench 0.0}
Platform *
Desc     {Benchmarking/Performance tools}
Hidden
Base     @TAP_DIR@/bench
Path     bench.tcl
Path     bench_read.tcl
Path     bench_wcsv.tcl
Path     bench_wtext.tcl
Path     libbench.tcl
Path     pkgIndex.tcl

Package {bench 0.4}
See   __bench
Platform *
Desc     {bench - Processing benchmark suites}

Package {bench::out::csv 0.1.2}
See   __bench
Platform *
Desc     {bench::out::csv - Formatting benchmark results as CSV}

Package {bench 0.4}
See   __bench
Platform *
Desc     {bench - Processing benchmark suites}

Package {bench::out::text 0.1.2}
See   __bench
Platform *
Desc     {bench::out::text - Formatting benchmark results as human readable text}

Package {bench::in 0.1}
See   __bench
Platform *
Desc     {bench::in - Reading benchmark results}

#
# ##############

# ###############
# Module "bibtex"
# [1]    | "bibtex" (0.6)
# [1]    | "bibtex" (0.7)
# -------+

Package {bibtex 0.6}
Package {bibtex 0.7}
Platform *
Desc     {Parse bibtex files}
Base     @TAP_DIR@/bibtex
Path     bibtex.tcl
Path     pkgIndex.tcl

#




︙


485
486
487
488
489
490
491
492

493
494
495
496
497
498
499
500
501
502
503
504

505
506
507

508
509
510
511
512
513
514
515
516
517
518
519

520
521
522

523
524

525
526
527
528
529
530
531

480
481
482
483
484
485
486

487
488
489
490
491
492
493
494
495
496
497
498

499
500
501

502
503
504
505
506
507
508
509
510
511
512
513

514
515
516

517
518

519
520
521
522
523
524
525
526








-
+











-
+


-
+











-
+


-
+

-
+








Path     iso8601.tcl
Path     pkgIndex.tcl
Path     rfc2822.tcl

Package {clock::rfc2822 0.1}
See   __clock
Platform *
Desc     {Parsing ISO 8601 dates/times}
Desc     {Parsing RFC 2822 dates/times}

Package {clock::iso8601 0.1}
See   __clock
Platform *
Desc     {Parsing ISO 8601 dates/times}

#
# ##############

# ################
# Module "cmdline"
# [1]    | "cmdline" (1.5)
# [1]    | "cmdline" (1.5.2)
# -------+

Package {cmdline 1.5}
Package {cmdline 1.5.2}
Platform *
Desc     {Procedures to process command lines and options.}
Base     @TAP_DIR@/cmdline
Path     cmdline.tcl
Path     pkgIndex.tcl

#
# ################

# #############
# Module "comm"
# [1]    | "comm" (4.6.3.1)
# [1]    | "comm" (4.7)
# -------+

Package {comm 4.6.3.1}
Package {comm 4.7}
Platform *
Desc     {The comm wire protocol}
Desc     {A remote communication facility for Tcl (8.5 and later)}
Base     @TAP_DIR@/comm
Path     comm.tcl
Path     pkgIndex.tcl

#
# #############





︙


547
548
549
550
551
552
553
554
555


556
557
558
559
560

561
562
563
564
565
566
567

568
569
570

571
572

573
574
575
576
577
578
579

542
543
544
545
546
547
548


549
550
551
552
553
554

555
556
557
558
559
560
561

562
563
564

565
566

567
568
569
570
571
572
573
574








-
-
+
+




-
+






-
+


-
+

-
+








Path     tclIndex

#
# ################

# ##################
# Module "coroutine"
# [1]    | "coroutine" (1.2)
# [2]    | "coroutine::auto" (1.1.3)
# [1]    | "coroutine" (1.3)
# [2]    | "coroutine::auto" (1.2)
# -------+

Package {__coroutine 0.0}
Platform *
Desc     {Coroutine utilities, Tcl Web Server}
Desc     {Coroutine utilities}
Hidden
Base     @TAP_DIR@/coroutine
Path     coro_auto.tcl
Path     coroutine.tcl
Path     pkgIndex.tcl

Package {coroutine 1.2}
Package {coroutine 1.3}
See   __coroutine
Platform *
Desc     {A TclOO and coroutine based web server}
Desc     {Coroutine based event and IO handling}

Package {coroutine::auto 1.1.3}
Package {coroutine::auto 1.2}
See   __coroutine
Platform *
Desc     {Automatic event and IO coroutine awareness}

#
# ##################





︙


590
591
592
593
594
595
596
597

598
599
600


601
602
603
604
605
606
607
608
609
610
611
612
613
614
615

616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634





635
636
637
638
639
640
641

585
586
587
588
589
590
591

592
593


594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609

610
611
612
613
614
615
616
617
618
619





620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636








-
+

-
-
+
+














-
+









-
-
-
-
-





+
+
+
+
+








Path     pkgIndex.tcl

#
# ################

# ############
# Module "crc"
# [1]    | "crc32" (1.3.2)
# [1]    | "crc32" (1.3.3)
# [2]    | "sum" (1.1.2)
# [3]    | "crc16" (1.1.3)
# [4]    | "cksum" (1.1.4)
# [3]    | "cksum" (1.1.4)
# [4]    | "crc16" (1.1.4)
# -------+

Package {__crc 0.0}
Platform *
Desc     {Cyclic Redundancy Checks}
Hidden
Base     @TAP_DIR@/crc
Path     cksum.tcl
Path     crc16.tcl
Path     crc32.tcl
Path     crcc.tcl
Path     pkgIndex.tcl
Path     sum.tcl

Package {crc32 1.3.2}
Package {crc32 1.3.3}
See   __crc
Platform *
Desc     {Perform a 32bit Cyclic Redundancy Check}

Package {sum 1.1.2}
See   __crc
Platform *
Desc     {Calculate a sum(1) compatible checksum}

Package {crc16 1.1.3}
See   __crc
Platform *
Desc     {Perform a 16bit Cyclic Redundancy Check}

Package {cksum 1.1.4}
See   __crc
Platform *
Desc     {Calculate a cksum(1) compatible checksum}

Package {crc16 1.1.4}
See   __crc
Platform *
Desc     {Perform a 16bit Cyclic Redundancy Check}

#
# ############

# #############
# Module "cron"
# [1]    | "cron" (2.1)
# -------+




︙


721
722
723
724
725
726
727
728
729


730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747

748
749
750
751
752

753
754
755
756
757
758
759
760
761
762
763
764
765
766
767

768
769
770
771
772
773
774
775
776
777
778


779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796





797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813

716
717
718
719
720
721
722


723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741

742
743
744
745
746

747
748
749
750
751
752
753
754
755
756
757
758
759
760
761

762
763
764
765
766
767
768
769
770
771


772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801





802
803
804
805
806
807
808








-
-
+
+

















-
+




-
+














-
+









-
-
+
+


















+
+
+
+
+





-
-
-
-
-









#
# ##############

# ############
# Module "des"
# [1]    | "des" (1.1.0)
# [2]    | "tclDES" (1.0.0)
# [3]    | "tclDESjr" (1.0.0)
# [2]    | "tclDESjr" (1.0.0)
# [3]    | "tclDES" (1.0.0)
# -------+

Package {__des 0.0}
Platform *
Desc     {Data Encryption Standard (DES)}
Hidden
Base     @TAP_DIR@/des
Path     des.tcl
Path     pkgIndex.tcl
Path     tcldes.tcl
Path     tcldesjr.tcl

Package {des 1.1.0}
See   __des
Platform *
Desc     {Implementation of the DES and triple-DES ciphers}

Package {tclDES 1.0.0}
Package {tclDESjr 1.0.0}
See   __des
Platform *
Desc     {Implementation of the DES and triple-DES ciphers}

Package {tclDESjr 1.0.0}
Package {tclDES 1.0.0}
See   __des
Platform *
Desc     {Implementation of the DES and triple-DES ciphers}

#
# ############

# #################
# Module "dicttool"
# [1]    | "dicttool" (1.1)
# -------+

Package {dicttool 1.1}
Platform *
Desc     {Dictionary Tools}
Desc     {TclOO Library (TOOL) Framework}
Base     @TAP_DIR@/dicttool
Path     dicttool.tcl
Path     pkgIndex.tcl

#
# #################

# ############
# Module "dns"
# [1]    | "spf" (1.1.1)
# [2]    | "dns" (1.4.1)
# [1]    | "dns" (1.5.0)
# [2]    | "spf" (1.1.1)
# [3]    | "ip" (1.4)
# [4]    | "resolv" (1.0.3)
# -------+

Package {__dns 0.0}
Platform *
Desc     {Domain Name Service}
Hidden
Base     @TAP_DIR@/dns
Path     dns.tcl
Path     ip.tcl
Path     ipMore.tcl
Path     ipMoreC.tcl
Path     msgs/en.msg
Path     pkgIndex.tcl
Path     resolv.tcl
Path     spf.tcl

Package {dns 1.5.0}
See   __dns
Platform *
Desc     {Tcl Domain Name Service Client}

Package {spf 1.1.1}
See   __dns
Platform *
Desc     {Tcllib package}

Package {dns 1.4.1}
See   __dns
Platform *
Desc     {Tcl Domain Name Service Client}

Package {ip 1.4}
See   __dns
Platform *
Desc     {IPv4 and IPv6 address manipulation}

Package {resolv 1.0.3}
See   __dns




︙


845
846
847
848
849
850
851
852
853
854



855
856
857
858
859
860
861

840
841
842
843
844
845
846



847
848
849
850
851
852
853
854
855
856








-
-
-
+
+
+








#
# #################

# #################
# Module "doctools"
# [1]    | "doctools::idx" (1.1)
# [2]    | "doctools::toc" (1.2)
# [3]    | "doctools::changelog" (1.1)
# [4]    | "doctools::cvs" (1)
# [5]    | "doctools" (1.5.6)
# [3]    | "doctools" (1.5.6)
# [4]    | "doctools::changelog" (1.1)
# [5]    | "doctools::cvs" (1)
# -------+

Package {__doctools 0.0}
Platform *
Desc     {Documentation tools}
Hidden
Base     @TAP_DIR@/doctools




︙


916
917
918
919
920
921
922
923

924
925
926
927
928
929





930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955




956
957
958
959
960
961
962

911
912
913
914
915
916
917

918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939





940
941
942
943
944
945
946




947
948
949
950
951
952
953
954
955
956
957








-
+






+
+
+
+
+










-
-
-
-
-







-
-
-
-
+
+
+
+








Path     mpformats/toc.tmml
Path     mpformats/toc.wiki
Path     pkgIndex.tcl

Package {doctools::idx 1.1}
See   __doctools
Platform *
Desc     {docidx - Processing indices}
Desc     {Holding keyword indices}

Package {doctools::toc 1.2}
See   __doctools
Platform *
Desc     {doctoc - Processing tables of contents}

Package {doctools 1.5.6}
See   __doctools
Platform *
Desc     {doctools - Processing documents}

Package {doctools::changelog 1.1}
See   __doctools
Platform *
Desc     {Processing text in Emacs ChangeLog format}

Package {doctools::cvs 1}
See   __doctools
Platform *
Desc     {Processing text in 'cvs log' format}

Package {doctools 1.5.6}
See   __doctools
Platform *
Desc     {doctools - Processing documents}

#
# #################

# ######################
# Module "doctools2base"
# [1]    | "doctools::text" (0.1)
# [2]    | "doctools::html" (0.1)
# [3]    | "doctools::html::cssdefaults" (0.1)
# [4]    | "doctools::tcl::parse" (0.1)
# [5]    | "doctools::msgcat" (0.1)
# [6]    | "doctools::nroff::man_macros" (0.1)
# [3]    | "doctools::tcl::parse" (0.1)
# [4]    | "doctools::html::cssdefaults" (0.1)
# [5]    | "doctools::nroff::man_macros" (0.1)
# [6]    | "doctools::msgcat" (0.1)
# -------+

Package {__doctools2base 0.0}
Platform *
Desc     {Documentation tools}
Hidden
Base     @TAP_DIR@/doctools2base




︙


974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991

992
993
994

995
996
997
998
999
1000





1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017







1018
1019
1020
1021
1022


1023
1024
1025
1026
1027
1028
1029

969
970
971
972
973
974
975





976
977
978
979
980

981
982
983

984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005







1006
1007
1008
1009
1010
1011
1012
1013
1014
1015


1016
1017
1018
1019
1020
1021
1022
1023
1024








-
-
-
-
-





-
+


-
+






+
+
+
+
+










-
-
-
-
-
-
-
+
+
+
+
+
+
+



-
-
+
+








Desc     {Tcllib package}

Package {doctools::html 0.1}
See   __doctools2base
Platform *
Desc     {Tcllib package}

Package {doctools::html::cssdefaults 0.1}
See   __doctools2base
Platform *
Desc     {Default CSS style for HTML export plugins}

Package {doctools::tcl::parse 0.1}
See   __doctools2base
Platform *
Desc     {Processing text in 'subst -novariables' format}

Package {doctools::msgcat 0.1}
Package {doctools::html::cssdefaults 0.1}
See   __doctools2base
Platform *
Desc     {Message catalog management for the various document parsers}
Desc     {Default CSS style for HTML export plugins}

Package {doctools::nroff::man_macros 0.1}
See   __doctools2base
Platform *
Desc     {Default CSS style for NROFF export plugins}

Package {doctools::msgcat 0.1}
See   __doctools2base
Platform *
Desc     {Message catalog management for the various document parsers}

#
# ######################

# #####################
# Module "doctools2idx"
# [1]    | "doctools::idx::import::json" (0.1)
# [2]    | "doctools::idx::structure" (0.1)
# [3]    | "doctools::idx::export::nroff" (0.3)
# [4]    | "doctools::idx::import::docidx" (0.1)
# [5]    | "doctools::idx::export" (0.2.1)
# [6]    | "doctools::idx::export::html" (0.2)
# [7]    | "doctools::msgcat::idx::fr" (0.1)
# [8]    | "doctools::idx::parse" (0.1)
# [9]    | "doctools::msgcat::idx::de" (0.1)
# [10]    | "doctools::idx" (2)
# [11]    | "doctools::msgcat::idx::c" (0.1)
# [12]    | "doctools::msgcat::idx::en" (0.1)
# [6]    | "doctools::idx::parse" (0.1)
# [7]    | "doctools::idx::export::html" (0.2)
# [8]    | "doctools::msgcat::idx::fr" (0.1)
# [9]    | "doctools::idx" (2)
# [10]    | "doctools::msgcat::idx::de" (0.1)
# [11]    | "doctools::msgcat::idx::en" (0.1)
# [12]    | "doctools::msgcat::idx::c" (0.1)
# [13]    | "doctools::idx::export::json" (0.1)
# [14]    | "doctools::idx::export::docidx" (0.1)
# [15]    | "doctools::idx::export::wiki" (0.2)
# [16]    | "doctools::idx::export::text" (0.2)
# [17]    | "doctools::idx::import" (0.2.1)
# [16]    | "doctools::idx::import" (0.2.1)
# [17]    | "doctools::idx::export::text" (0.2)
# -------+

Package {__doctools2idx 0.0}
Platform *
Desc     {Documentation tools}
Hidden
Base     @TAP_DIR@/doctools2idx




︙


1067
1068
1069
1070
1071
1072
1073





1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084

1085
1086
1087

1088
1089
1090
1091
1092
1093
1094

1095
1096
1097

1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122





1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142


1143
1144
1145
1146
1147
1148
1149
1150
1151




1152
1153
1154
1155
1156


1157
1158
1159
1160
1161
1162
1163

1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083

1084
1085
1086

1087
1088
1089
1090
1091
1092
1093

1094
1095
1096

1097
1098
1099
1100
1101
1102
1103





1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128





1129
1130
1131
1132
1133
1134
1135


1136
1137
1138
1139
1140
1141
1142




1143
1144
1145
1146
1147
1148
1149


1150
1151
1152
1153
1154
1155
1156
1157
1158








+
+
+
+
+










-
+


-
+






-
+


-
+






-
-
-
-
-














+
+
+
+
+






-
-
-
-
-







-
-
+
+





-
-
-
-
+
+
+
+



-
-
+
+








Desc     {docidx import plugin}

Package {doctools::idx::export 0.2.1}
See   __doctools2idx
Platform *
Desc     {Exporting keyword indices}

Package {doctools::idx::parse 0.1}
See   __doctools2idx
Platform *
Desc     {Parsing text in docidx format}

Package {doctools::idx::export::html 0.2}
See   __doctools2idx
Platform *
Desc     {HTML export plugin}

Package {doctools::msgcat::idx::fr 0.1}
See   __doctools2idx
Platform *
Desc     {Message catalog for the docidx parser (FR)}

Package {doctools::idx::parse 0.1}
Package {doctools::idx 2}
See   __doctools2idx
Platform *
Desc     {Parsing text in docidx format}
Desc     {Holding keyword indices}

Package {doctools::msgcat::idx::de 0.1}
See   __doctools2idx
Platform *
Desc     {Message catalog for the docidx parser (DE)}

Package {doctools::idx 2}
Package {doctools::msgcat::idx::en 0.1}
See   __doctools2idx
Platform *
Desc     {docidx - Processing indices}
Desc     {Message catalog for the docidx parser (EN)}

Package {doctools::msgcat::idx::c 0.1}
See   __doctools2idx
Platform *
Desc     {Message catalog for the docidx parser (C)}

Package {doctools::msgcat::idx::en 0.1}
See   __doctools2idx
Platform *
Desc     {Message catalog for the docidx parser (EN)}

Package {doctools::idx::export::json 0.1}
See   __doctools2idx
Platform *
Desc     {JSON export plugin}

Package {doctools::idx::export::docidx 0.1}
See   __doctools2idx
Platform *
Desc     {docidx export plugin}

Package {doctools::idx::export::wiki 0.2}
See   __doctools2idx
Platform *
Desc     {wiki export plugin}

Package {doctools::idx::import 0.2.1}
See   __doctools2idx
Platform *
Desc     {Importing keyword indices}

Package {doctools::idx::export::text 0.2}
See   __doctools2idx
Platform *
Desc     {plain text export plugin}

Package {doctools::idx::import 0.2.1}
See   __doctools2idx
Platform *
Desc     {Importing keyword indices}

#
# #####################

# #####################
# Module "doctools2toc"
# [1]    | "doctools::toc::export::html" (0.1)
# [2]    | "doctools::msgcat::toc::fr" (0.1)
# [3]    | "doctools::msgcat::toc::de" (0.1)
# [4]    | "doctools::toc" (2)
# [3]    | "doctools::toc" (2)
# [4]    | "doctools::msgcat::toc::de" (0.1)
# [5]    | "doctools::msgcat::toc::en" (0.1)
# [6]    | "doctools::toc::export::json" (0.1)
# [7]    | "doctools::toc::structure" (0.1)
# [8]    | "doctools::toc::export::nroff" (0.2)
# [9]    | "doctools::toc::export::wiki" (0.1)
# [10]    | "doctools::toc::import::doctoc" (0.1)
# [11]    | "doctools::toc::export::text" (0.1)
# [12]    | "doctools::toc::import" (0.2.1)
# [13]    | "doctools::toc::parse" (0.1)
# [10]    | "doctools::toc::import" (0.2.1)
# [11]    | "doctools::toc::parse" (0.1)
# [12]    | "doctools::toc::import::doctoc" (0.1)
# [13]    | "doctools::toc::export::text" (0.1)
# [14]    | "doctools::msgcat::toc::c" (0.1)
# [15]    | "dict" (1)
# [16]    | "doctools::toc::import::json" (0.1)
# [17]    | "doctools::toc::export" (0.2.1)
# [18]    | "doctools::toc::export::doctoc" (0.1)
# [17]    | "doctools::toc::export::doctoc" (0.1)
# [18]    | "doctools::toc::export" (0.2.1)
# -------+

Package {__doctools2toc 0.0}
Platform *
Desc     {Documentation tools}
Hidden
Base     @TAP_DIR@/doctools2toc




︙


1186
1187
1188
1189
1190
1191
1192





1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209

1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197





1198
1199
1200
1201
1202
1203
1204








+
+
+
+
+





-
-
-
-
-








Desc     {HTML export plugin}

Package {doctools::msgcat::toc::fr 0.1}
See   __doctools2toc
Platform *
Desc     {Message catalog for the doctoc parser (FR)}

Package {doctools::toc 2}
See   __doctools2toc
Platform *
Desc     {doctoc - Processing tables of contents}

Package {doctools::msgcat::toc::de 0.1}
See   __doctools2toc
Platform *
Desc     {Message catalog for the doctoc parser (DE)}

Package {doctools::toc 2}
See   __doctools2toc
Platform *
Desc     {doctoc - Processing tables of contents}

Package {doctools::msgcat::toc::en 0.1}
See   __doctools2toc
Platform *
Desc     {Message catalog for the doctoc parser (EN)}

Package {doctools::toc::export::json 0.1}
See   __doctools2toc




︙


1221
1222
1223
1224
1225
1226
1227










1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261





1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279

1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242










1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267





1268
1269
1270
1271
1272
1273
1274








+
+
+
+
+
+
+
+
+
+










-
-
-
-
-
-
-
-
-
-














+
+
+
+
+






-
-
-
-
-








Desc     {nroff export plugin}

Package {doctools::toc::export::wiki 0.1}
See   __doctools2toc
Platform *
Desc     {wiki export plugin}

Package {doctools::toc::import 0.2.1}
See   __doctools2toc
Platform *
Desc     {Importing keyword indices}

Package {doctools::toc::parse 0.1}
See   __doctools2toc
Platform *
Desc     {Parsing text in doctoc format}

Package {doctools::toc::import::doctoc 0.1}
See   __doctools2toc
Platform *
Desc     {doctoc import plugin}

Package {doctools::toc::export::text 0.1}
See   __doctools2toc
Platform *
Desc     {plain text export plugin}

Package {doctools::toc::import 0.2.1}
See   __doctools2toc
Platform *
Desc     {Importing keyword indices}

Package {doctools::toc::parse 0.1}
See   __doctools2toc
Platform *
Desc     {Parsing text in doctoc format}

Package {doctools::msgcat::toc::c 0.1}
See   __doctools2toc
Platform *
Desc     {Message catalog for the doctoc parser (C)}

Package {dict 1}
See   __doctools2toc
Platform *
Desc     {Tcllib package}

Package {doctools::toc::import::json 0.1}
See   __doctools2toc
Platform *
Desc     {JSON import plugin}

Package {doctools::toc::export::doctoc 0.1}
See   __doctools2toc
Platform *
Desc     {doctoc export plugin}

Package {doctools::toc::export 0.2.1}
See   __doctools2toc
Platform *
Desc     {Exporting tables of contents}

Package {doctools::toc::export::doctoc 0.1}
See   __doctools2toc
Platform *
Desc     {doctoc export plugin}

#
# #####################

# ################
# Module "dtplite"
# [1]    | "dtplite" (1.3.1)
# -------+




︙


1304
1305
1306
1307
1308
1309
1310
1311
1312
1313



1314
1315
1316
1317
1318

1319
1320
1321
1322
1323
1324
1325

1299
1300
1301
1302
1303
1304
1305



1306
1307
1308
1309
1310
1311
1312

1313
1314
1315
1316
1317
1318
1319
1320








-
-
-
+
+
+




-
+








# #############

# #################
# Module "fileutil"
# [1]    | "fileutil::multi::op" (0.5.3)
# [2]    | "fileutil::multi" (0.1)
# [3]    | "fileutil::paths" (1)
# [4]    | "fileutil::decode" (0.2.1)
# [5]    | "fileutil" (1.16)
# [6]    | "fileutil::traverse" (0.6)
# [4]    | "fileutil" (1.16.1)
# [5]    | "fileutil::traverse" (0.6)
# [6]    | "fileutil::decode" (0.2.1)
# -------+

Package {__fileutil 0.0}
Platform *
Desc     {file utilities, Parser generator tools}
Desc     {file utilities}
Hidden
Base     @TAP_DIR@/fileutil
Path     decode.tcl
Path     fileutil.tcl
Path     multi.tcl
Path     multiop.tcl
Path     paths.tcl




︙


1337
1338
1339
1340
1341
1342
1343
1344

1345
1346
1347
1348

1349
1350
1351
1352
1353
1354
1355
1356
1357





1358
1359
1360
1361
1362
1363
1364

1332
1333
1334
1335
1336
1337
1338

1339
1340
1341


1342




1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359








-
+


-
-
+
-
-
-
-





+
+
+
+
+








Desc     {Multi-file operation, scatter/gather, standard object}

Package {fileutil::paths 1}
See   __fileutil
Platform *
Desc     {Manage search path pools}

Package {fileutil::decode 0.2.1}
Package {fileutil 1.16.1}
See   __fileutil
Platform *
Desc     {Tcllib package}

Desc     {Procedures implementing some file utilities}
Package {fileutil 1.16}
See   __fileutil
Platform *
Desc     {page plugin manager}

Package {fileutil::traverse 0.6}
See   __fileutil
Platform *
Desc     {Iterative directory traversal}

Package {fileutil::decode 0.2.1}
See   __fileutil
Platform *
Desc     {Tcllib package}

#
# #################

# ############
# Module "ftp"
# [1]    | "ftp::geturl" (0.2.2)




︙


1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410




1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424

1425
1426
1427
1428
1429






1430
1431
1432
1433
1434

1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449

1450
1451
1452

1453
1454
1455
1456
1457
1458
1459

1395
1396
1397
1398
1399
1400
1401




1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418

1419
1420
1421
1422
1423

1424
1425
1426
1427
1428
1429
1430
1431
1432
1433

1434





1435
1436
1437
1438
1439
1440
1441
1442
1443

1444
1445
1446

1447
1448
1449
1450
1451
1452
1453
1454








-
-
-
-
+
+
+
+













-
+




-
+
+
+
+
+
+




-
+
-
-
-
-
-









-
+


-
+








Path     pkgIndex.tcl

#
# #############

# ################
# Module "fumagic"
# [1]    | "fileutil::magic::cgen" (1.2.0)
# [2]    | "fileutil::magic::rt" (2.0)
# [3]    | "fileutil::magic::filetype" (2.0)
# [4]    | "fileutil::magic::cfront" (1.2.0)
# [1]    | "fileutil::magic::cgen" (1.3.0)
# [2]    | "fileutil::magic::filetype" (2.0.1)
# [3]    | "fileutil::magic::rt" (3.0)
# [4]    | "fileutil::magic::cfront" (1.3.0)
# -------+

Package {__fumagic 0.0}
Platform *
Desc     {Tcl Web Server, file utilities}
Hidden
Base     @TAP_DIR@/fumagic
Path     cfront.tcl
Path     cgen.tcl
Path     filetypes.tcl
Path     pkgIndex.tcl
Path     rtcore.tcl

Package {fileutil::magic::cgen 1.2.0}
Package {fileutil::magic::cgen 1.3.0}
See   __fumagic
Platform *
Desc     {Generator core for compiler of magic(5) files}

Package {fileutil::magic::rt 2.0}
Package {fileutil::magic::filetype 2.0.1}
See   __fumagic
Platform *
Desc     {A TclOO and coroutine based web server}

Package {fileutil::magic::rt 3.0}
See   __fumagic
Platform *
Desc     {Runtime core for file type recognition engines written in pure Tcl}

Package {fileutil::magic::filetype 2.0}
Package {fileutil::magic::cfront 1.3.0}
See   __fumagic
Platform *
Desc     {A TclOO and coroutine based web server}

Package {fileutil::magic::cfront 1.2.0}
See   __fumagic
Platform *
Desc     {Generator core for compiler of magic(5) files}

#
# ################

# ##################
# Module "generator"
# [1]    | "generator" (0.1)
# [1]    | "generator" (0.2)
# -------+

Package {generator 0.1}
Package {generator 0.2}
Platform *
Desc     {Procedures for creating and using generators.}
Base     @TAP_DIR@/generator
Path     generator.tcl
Path     pkgIndex.tcl

#




︙


1473
1474
1475
1476
1477
1478
1479
1480
1481


1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497





1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515

1468
1469
1470
1471
1472
1473
1474


1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503





1504
1505
1506
1507
1508
1509
1510








-
-
+
+
















+
+
+
+
+






-
-
-
-
-









#
# ############

# #######################
# Module "grammar_aycock"
# [1]    | "grammar::aycock::debug" (1.0)
# [2]    | "grammar::aycock" (1.0)
# [3]    | "grammar::aycock::runtime" (1.0)
# [2]    | "grammar::aycock::runtime" (1.0)
# [3]    | "grammar::aycock" (1.0)
# -------+

Package {__grammar_aycock 0.0}
Platform *
Desc     {Aycock-Horspool-Earley parser generator for Tcl}
Hidden
Base     @TAP_DIR@/grammar_aycock
Path     aycock-build.tcl
Path     aycock-debug.tcl
Path     aycock-runtime.tcl
Path     pkgIndex.tcl

Package {grammar::aycock::debug 1.0}
See   __grammar_aycock
Platform *
Desc     {Tcllib package}

Package {grammar::aycock::runtime 1.0}
See   __grammar_aycock
Platform *
Desc     {Tcllib package}

Package {grammar::aycock 1.0}
See   __grammar_aycock
Platform *
Desc     {Aycock-Horspool-Earley parser generator for Tcl}

Package {grammar::aycock::runtime 1.0}
See   __grammar_aycock
Platform *
Desc     {Tcllib package}

#
# #######################

# ###################
# Module "grammar_fa"
# [1]    | "grammar::fa::op" (0.4.1)
# [2]    | "grammar::fa" (0.5)




︙


1626
1627
1628
1629
1630
1631
1632
1633

1634
1635
1636

1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697

1621
1622
1623
1624
1625
1626
1627

1628
1629
1630

1631
1632
1633
1634
1635
1636
1637
1638
1639
1640













































1641
1642
1643
1644
1645
1646
1647








-
+


-
+









-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-








Desc     {Create and manipulate parsing expression grammars}

#
# ####################

# #############
# Module "hook"
# [1]    | "hook" (0.1)
# [1]    | "hook" (0.2)
# -------+

Package {hook 0.1}
Package {hook 0.2}
Platform *
Desc     {Hooks}
Base     @TAP_DIR@/hook
Path     hook.tcl
Path     pkgIndex.tcl

#
# #############

# #############
# Module "http"
# [1]    | "autoproxy" (1.7)
# -------+

Package {autoproxy 1.7}
Platform *
Desc     {Automatic HTTP proxy usage and authentication}
Base     @TAP_DIR@/http
Path     autoproxy.tcl
Path     pkgIndex.tcl

#
# #############

# ##############
# Module "httpd"
# [1]    | "httpd" (4.3.4)
# -------+

Package {httpd 4.3.4}
Platform *
Desc     {Tcllib package}
Base     @TAP_DIR@/httpd
Path     httpd.tcl
Path     pkgIndex.tcl

#
# ##############

# #################
# Module "httpwget"
# [1]    | "http::wget" (0.1)
# -------+

Package {http::wget 0.1}
Platform *
Desc     {Tcllib package}
Base     @TAP_DIR@/httpwget
Path     pkgIndex.tcl
Path     wget.tcl

#
# #################

# #############
# Module "html"
# [1]    | "html" (1.5)
# -------+

Package {html 1.5}
Platform *




︙


1714
1715
1716
1717
1718
1719
1720













































1721
1722
1723
1724
1725
1726
1727

1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722








+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+








Base     @TAP_DIR@/htmlparse
Path     htmlparse.tcl
Path     pkgIndex.tcl

#
# ##################

# #############
# Module "http"
# [1]    | "autoproxy" (1.7)
# -------+

Package {autoproxy 1.7}
Platform *
Desc     {Automatic HTTP proxy usage and authentication}
Base     @TAP_DIR@/http
Path     autoproxy.tcl
Path     pkgIndex.tcl

#
# #############

# ##############
# Module "httpd"
# [1]    | "httpd" (4.3.5)
# -------+

Package {httpd 4.3.5}
Platform *
Desc     {Tcllib package}
Base     @TAP_DIR@/httpd
Path     httpd.tcl
Path     pkgIndex.tcl

#
# ##############

# #################
# Module "httpwget"
# [1]    | "http::wget" (0.1)
# -------+

Package {http::wget 0.1}
Platform *
Desc     {Tcllib package}
Base     @TAP_DIR@/httpwget
Path     pkgIndex.tcl
Path     wget.tcl

#
# #################

# ##############
# Module "ident"
# [1]    | "ident" (0.42)
# -------+

Package {ident 0.42}
Platform *




︙


1746
1747
1748
1749
1750
1751
1752
1753

1754
1755
1756

1757
1758
1759
1760
1761
1762
1763

1741
1742
1743
1744
1745
1746
1747

1748
1749
1750

1751
1752
1753
1754
1755
1756
1757
1758








-
+


-
+








Path     pkgIndex.tcl

#
# ##############

# ################
# Module "inifile"
# [1]    | "inifile" (0.3.1)
# [1]    | "inifile" (0.3.2)
# -------+

Package {inifile 0.3.1}
Package {inifile 0.3.2}
Platform *
Desc     {Parsing of Windows INI files}
Base     @TAP_DIR@/inifile
Path     ini.tcl
Path     pkgIndex.tcl

#




︙


1796
1797
1798
1799
1800
1801
1802
1803
1804


1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816

1817
1818
1819
1820
1821

1822
1823
1824
1825
1826
1827
1828

1791
1792
1793
1794
1795
1796
1797


1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810

1811
1812
1813
1814
1815

1816
1817
1818
1819
1820
1821
1822
1823








-
-
+
+











-
+




-
+








Desc     {Interp creation and aliasing}

#
# ###############

# ############
# Module "irc"
# [1]    | "picoirc" (0.5.2)
# [2]    | "irc" (0.6.2)
# [1]    | "picoirc" (0.13.0)
# [2]    | "irc" (0.7.0)
# -------+

Package {__irc 0.0}
Platform *
Desc     {Low Level Tcl IRC Interface, Simple embeddable IRC interface}
Hidden
Base     @TAP_DIR@/irc
Path     irc.tcl
Path     picoirc.tcl
Path     pkgIndex.tcl

Package {picoirc 0.5.2}
Package {picoirc 0.13.0}
See   __irc
Platform *
Desc     {Small and simple embeddable IRC client.}

Package {irc 0.6.2}
Package {irc 0.7.0}
See   __irc
Platform *
Desc     {Create IRC connection and interface.}

#
# ############





︙


1854
1855
1856
1857
1858
1859
1860
1861

1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876

1877
1878
1879
1880
1881
1882
1883

1849
1850
1851
1852
1853
1854
1855

1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870

1871
1872
1873
1874
1875
1876
1877
1878








-
+














-
+








Path     pkgIndex.tcl

#
# #############

# #############
# Module "json"
# [1]    | "json::write" (1.0.3)
# [1]    | "json::write" (1.0.4)
# [2]    | "json" (1.3.4)
# -------+

Package {__json 0.0}
Platform *
Desc     {JSON}
Hidden
Base     @TAP_DIR@/json
Path     json.tcl
Path     json_tcl.tcl
Path     json_write.tcl
Path     jsonc.tcl
Path     pkgIndex.tcl

Package {json::write 1.0.3}
Package {json::write 1.0.4}
See   __json
Platform *
Desc     {JSON generation}

Package {json 1.3.4}
See   __json
Platform *




︙


1914
1915
1916
1917
1918
1919
1920
1921
1922


1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934

1935
1936
1937
1938
1939

1940
1941
1942
1943
1944
1945
1946

1909
1910
1911
1912
1913
1914
1915


1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928

1929
1930
1931
1932
1933

1934
1935
1936
1937
1938
1939
1940
1941








-
-
+
+











-
+




-
+








Path     pkgIndex.tcl

#
# ################

# #############
# Module "ldap"
# [1]    | "ldapx" (1.1)
# [2]    | "ldap" (1.9.2)
# [1]    | "ldapx" (1.2)
# [2]    | "ldap" (1.10.1)
# -------+

Package {__ldap 0.0}
Platform *
Desc     {LDAP client, LDAP extended object interface}
Hidden
Base     @TAP_DIR@/ldap
Path     ldap.tcl
Path     ldapx.tcl
Path     pkgIndex.tcl

Package {ldapx 1.1}
Package {ldapx 1.2}
See   __ldap
Platform *
Desc     {LDAP extended object interface}

Package {ldap 1.9.2}
Package {ldap 1.10.1}
See   __ldap
Platform *
Desc     {LDAP client}

#
# #############





︙


1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010


2011
2012
2013
2014
2015
2016
2017

1978
1979
1980
1981
1982
1983
1984















1985
1986
1987
1988


1989
1990
1991
1992
1993
1994
1995
1996
1997








-
-
-
-
-
-
-
-
-
-
-
-
-
-
-




-
-
+
+








See   __log
Platform *
Desc     {Collection of predefined appenders for logger}

#
# ############

# #################
# Module "markdown"
# [1]    | "Markdown" (1.1.1)
# -------+

Package {Markdown 1.1.1}
Platform *
Desc     {A TclOO and coroutine based web server}
Base     @TAP_DIR@/markdown
Path     markdown.tcl
Path     pkgIndex.tcl

#
# #################

# ############
# Module "map"
# [1]    | "map::geocode::nominatim" (0.1)
# [2]    | "map::slippy::fetcher" (0.4)
# [3]    | "map::slippy" (0.5)
# [4]    | "map::slippy::cache" (0.2)
# [3]    | "map::slippy::cache" (0.2)
# [4]    | "map::slippy" (0.5)
# -------+

Package {__map 0.0}
Platform *
Desc     {Mapping utilities}
Hidden
Base     @TAP_DIR@/map




︙


2027
2028
2029
2030
2031
2032
2033





2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061















2062
2063

2064
2065


2066
2067
2068
2069
2070
2071





2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089





















2090
2091
2092
2093
2094

2095
2096
2097
2098
2099
2100
2101

2102
2103

2104
2105
2106
2107
2108


2109
2110
2111
2112

2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128





2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142





2143

2144
2145
2146
2147
2148
2149
2150
2151
2152
2153

2154
2155
2156

2157
2158
2159
2160
2161
2162
2163

2164
2165
2166

2167
2168
2169
2170
2171
2172
2173

2174
2175
2176
2177

2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192





2193
2194
2195
2196
2197
2198
2199
2200
2201
2202










2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217










2218

2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233

2234
2235
2236

2237
2238

2239
2240
2241
2242





2243
2244
2245
2246
2247










2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258

2259
2260
2261
2262
2263

2264
2265
2266
2267
2268
2269
2270

2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023





2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059


2060
2061






2062
2063
2064
2065
2066
2067
2068
















2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093

2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157

2158
2159
2160
2161
2162
2163
2164
2165
2166
2167

2168
2169
2170

2171
2172
2173
2174
2175
2176
2177

2178
2179
2180

2181
2182
2183
2184
2185
2186
2187

2188
2189
2190


2191




2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232





2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247

2248
2249
2250
2251
2252





2253
2254
2255
2256
2257

2258
2259
2260

2261
2262

2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292






2293
2294
2295
2296
2297

2298
2299
2300
2301
2302
2303
2304
2305








+
+
+
+
+





-
-
-
-
-


















+
+
+
+
+
+
+
+
+
+
+
+
+
+
+


+
-
-
+
+
-
-
-
-
-
-
+
+
+
+
+


-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+




-
+







+


+





+
+




+
















+
+
+
+
+














+
+
+
+
+
-
+









-
+


-
+






-
+


-
+






-
+


-
-
+
-
-
-
-











+
+
+
+
+










+
+
+
+
+
+
+
+
+
+





-
-
-
-
-





+
+
+
+
+
+
+
+
+
+
-
+




-
-
-
-
-





-
+


-
+

-
+




+
+
+
+
+





+
+
+
+
+
+
+
+
+
+





-
-
-
-
-
-
+




-
+








Desc     {Resolving geographical names with a Nominatim service}

Package {map::slippy::fetcher 0.4}
See   __map
Platform *
Desc     {Accessing a server providing tiles for slippy-based maps}

Package {map::slippy::cache 0.2}
See   __map
Platform *
Desc     {Management of a tile cache in the local filesystem}

Package {map::slippy 0.5}
See   __map
Platform *
Desc     {Common code for slippy based map packages}

Package {map::slippy::cache 0.2}
See   __map
Platform *
Desc     {Management of a tile cache in the local filesystem}

#
# ############

# ################
# Module "mapproj"
# [1]    | "mapproj" (1.0)
# -------+

Package {mapproj 1.0}
Platform *
Desc     {Map projection routines}
Base     @TAP_DIR@/mapproj
Path     mapproj.tcl
Path     pkgIndex.tcl

#
# ################

# #################
# Module "markdown"
# [1]    | "Markdown" (1.2.2)
# -------+

Package {Markdown 1.2.2}
Platform *
Desc     {A TclOO and coroutine based web server}
Base     @TAP_DIR@/markdown
Path     markdown.tcl
Path     pkgIndex.tcl

#
# #################

# #############
# Module "math"
# [1]    | "math::rationalfunctions" (1.0.1)
# [1]    | "math::numtheory" (1.1.1)
# [2]    | "math::statistics" (1.5.0)
# [2]    | "math::numtheory" (1.1.3)
# [3]    | "math::statistics" (1.5.0)
# [3]    | "math::rationalfunctions" (1.0.1)
# [4]    | "math::quasirandom" (1.0)
# [5]    | "math::fourier" (1.0.2)
# [6]    | "math::PCA" (1.0)
# [7]    | "math" (1.2.5)
# [8]    | "math::complexnumbers" (1.0.2)
# [4]    | "math::complexnumbers" (1.0.2)
# [5]    | "math::quasirandom" (1.0)
# [6]    | "math" (1.2.5)
# [7]    | "math::PCA" (1.0)
# [8]    | "math::fourier" (1.0.2)
# [9]    | "math::roman" (1.0)
# [10]    | "math::exact" (1.0.1)
# [11]    | "math::trig" (1.0)
# [12]    | "math::interpolate" (1.1.2)
# [13]    | "math::fuzzy" (0.2.1)
# [14]    | "math::linearalgebra" (1.1.6)
# [15]    | "math::optimize" (1.0.1)
# [16]    | "math::special" (0.4.0)
# [17]    | "math::calculus::symdiff" (1.0.1)
# [18]    | "math::bignum" (3.1.1)
# [19]    | "math::calculus" (0.8.2)
# [20]    | "math::geometry" (1.3.1)
# [21]    | "math::constants" (1.0.2)
# [22]    | "math::polynomials" (1.0.1)
# [23]    | "math::decimal" (1.0.3)
# [24]    | "math::bigfloat" (1.2.2)
# [25]    | "math::bigfloat" (2.0.2)
# [26]    | "math::machineparameters" (0.1)
# [11]    | "math::combinatorics" (2.0)
# [12]    | "math::trig" (1.0)
# [13]    | "math::interpolate" (1.1.2)
# [14]    | "math::figurate" (1.0)
# [15]    | "math::changepoint" (0.1)
# [16]    | "math::fuzzy" (0.2.1)
# [17]    | "math::optimize" (1.0.1)
# [18]    | "math::filters" (0.1)
# [19]    | "math::linearalgebra" (1.1.6)
# [20]    | "math::special" (0.5.2)
# [21]    | "math::bignum" (3.1.1)
# [22]    | "math::calculus::symdiff" (1.0.1)
# [23]    | "math::geometry" (1.4.1)
# [24]    | "math::calculus" (0.8.2)
# [25]    | "math::constants" (1.0.2)
# [26]    | "math::probopt" (1.0)
# [27]    | "math::decimal" (1.0.4)
# [28]    | "math::polynomials" (1.0.1)
# [29]    | "math::bigfloat" (1.2.3)
# [30]    | "math::bigfloat" (2.0.3)
# [31]    | "math::machineparameters" (0.1)
# -------+

Package {__math 0.0}
Platform *
Desc     {Principal Components Analysis, Tcl Decimal Arithmetic Library, tclrep, Math, Tcl Math Library, Symbolic differentiation for Tcl}
Desc     {Principal Components Analysis, Tcl Decimal Arithmetic Library, tclrep, Tcl Math Library, Math, Symbolic differentiation for Tcl}
Hidden
Base     @TAP_DIR@/math
Path     bessel.tcl
Path     bigfloat.tcl
Path     bigfloat2.tcl
Path     bignum.tcl
Path     calculus.tcl
Path     changepoint.tcl
Path     classic_polyns.tcl
Path     combinatorics.tcl
Path     combinatoricsExt.tcl
Path     constants.tcl
Path     decimal.tcl
Path     elliptic.tcl
Path     exact.tcl
Path     exponential.tcl
Path     figurate.tcl
Path     filtergen.tcl
Path     fourier.tcl
Path     fuzzy.tcl
Path     geometry.tcl
Path     geometry_circle.tcl
Path     geometry_ext.tcl
Path     interpolate.tcl
Path     kruskal.tcl
Path     linalg.tcl
Path     liststat.tcl
Path     machineparameters.tcl
Path     math.tcl
Path     misc.tcl
Path     mvlinreg.tcl
Path     numtheory.tcl
Path     optimize.tcl
Path     pca.tcl
Path     pdf_stat.tcl
Path     pkgIndex.tcl
Path     plotstat.tcl
Path     polynomials.tcl
Path     primes.tcl
Path     probopt.tcl
Path     probopt_diffev.tcl
Path     probopt_lipo.tcl
Path     probopt_pso.tcl
Path     probopt_sce.tcl
Path     qcomplex.tcl
Path     quasirandom.tcl
Path     rational_funcs.tcl
Path     romannumerals.tcl
Path     special.tcl
Path     stat_kernel.tcl
Path     stat_logit.tcl
Path     stat_wasserstein.tcl
Path     statistics.tcl
Path     symdiff.tcl
Path     tclIndex
Path     trig.tcl
Path     wilcoxon.tcl

Package {math::rationalfunctions 1.0.1}
See   __math
Platform *
Desc     {Polynomial functions}

Package {math::numtheory 1.1.1}
Package {math::numtheory 1.1.3}
See   __math
Platform *
Desc     {Number Theory}

Package {math::statistics 1.5.0}
See   __math
Platform *
Desc     {Basic statistical functions and procedures}

Package {math::rationalfunctions 1.0.1}
Package {math::complexnumbers 1.0.2}
See   __math
Platform *
Desc     {Polynomial functions}
Desc     {Straightforward complex number package}

Package {math::quasirandom 1.0}
See   __math
Platform *
Desc     {Quasi-random points for integration and Monte Carlo type methods}

Package {math::fourier 1.0.2}
Package {math 1.2.5}
See   __math
Platform *
Desc     {Discrete and fast fourier transforms}
Desc     {Tcl Math Library}

Package {math::PCA 1.0}
See   __math
Platform *
Desc     {Tcllib package}

Package {math 1.2.5}
Package {math::fourier 1.0.2}
See   __math
Platform *
Desc     {Combinatorial functions in the Tcl Math Library}

Desc     {Discrete and fast fourier transforms}
Package {math::complexnumbers 1.0.2}
See   __math
Platform *
Desc     {Straightforward complex number package}

Package {math::roman 1.0}
See   __math
Platform *
Desc     {Tools for creating and manipulating roman numerals}

Package {math::exact 1.0.1}
See   __math
Platform *
Desc     {Exact Real Arithmetic}

Package {math::combinatorics 2.0}
See   __math
Platform *
Desc     {Combinatorial functions in the Tcl Math Library}

Package {math::trig 1.0}
See   __math
Platform *
Desc     {Trigonometric anf hyperbolic functions}

Package {math::interpolate 1.1.2}
See   __math
Platform *
Desc     {Interpolation routines}

Package {math::figurate 1.0}
See   __math
Platform *
Desc     {Evaluate figurate numbers}

Package {math::changepoint 0.1}
See   __math
Platform *
Desc     {Change point detection methods}

Package {math::fuzzy 0.2.1}
See   __math
Platform *
Desc     {Fuzzy comparison of floating-point numbers}

Package {math::linearalgebra 1.1.6}
See   __math
Platform *
Desc     {Package for Principal Component Analysis}

Package {math::optimize 1.0.1}
See   __math
Platform *
Desc     {Optimisation routines}

Package {math::filters 0.1}
See   __math
Platform *
Desc     {Digital filters}

Package {math::linearalgebra 1.1.6}
See   __math
Platform *
Desc     {Package for Principal Component Analysis}

Package {math::special 0.4.0}
Package {math::special 0.5.2}
See   __math
Platform *
Desc     {Special mathematical functions}

Package {math::calculus::symdiff 1.0.1}
See   __math
Platform *
Desc     {Symbolic differentiation for Tcl}

Package {math::bignum 3.1.1}
See   __math
Platform *
Desc     {Arbitrary precision integer numbers}

Package {math::calculus 0.8.2}
Package {math::calculus::symdiff 1.0.1}
See   __math
Platform *
Desc     {Romberg integration}
Desc     {Symbolic differentiation for Tcl}

Package {math::geometry 1.3.1}
Package {math::geometry 1.4.1}
See   __math
Platform *
Desc     {Geometrical computations}

Package {math::calculus 0.8.2}
See   __math
Platform *
Desc     {Integration and ordinary differential equations}

Package {math::constants 1.0.2}
See   __math
Platform *
Desc     {Mathematical and numerical constants}

Package {math::probopt 1.0}
See   __math
Platform *
Desc     {Probabilistic optimisation methods}

Package {math::decimal 1.0.4}
See   __math
Platform *
Desc     {General decimal arithmetic}

Package {math::polynomials 1.0.1}
See   __math
Platform *
Desc     {Polynomial functions}

Package {math::decimal 1.0.3}
See   __math
Platform *
Desc     {General decimal arithmetic}

Package {math::bigfloat 1.2.2}
Package {math::bigfloat 1.2.3}
See   __math
Platform *
Desc     {Arbitrary precision floating-point numbers}

Package {math::bigfloat 2.0.2}
Package {math::bigfloat 2.0.3}
See   __math
Platform *
Desc     {Arbitrary precision floating-point numbers}

Package {math::machineparameters 0.1}
See   __math
Platform *




︙


2287
2288
2289
2290
2291
2292
2293
2294
2295


2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308

2309
2310
2311
2312
2313

2314
2315
2316
2317
2318
2319
2320

2322
2323
2324
2325
2326
2327
2328


2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342

2343
2344
2345
2346
2347

2348
2349
2350
2351
2352
2353
2354
2355








-
-
+
+












-
+




-
+








Path     pkgIndex.tcl

#
# ############

# ############
# Module "md5"
# [1]    | "md5" (1.4.4)
# [2]    | "md5" (2.0.7)
# [1]    | "md5" (1.4.5)
# [2]    | "md5" (2.0.8)
# -------+

Package {__md5 0.0}
Platform *
Desc     {MD5 Message-Digest Algorithm}
Hidden
Base     @TAP_DIR@/md5
Path     md5.tcl
Path     md5c.tcl
Path     md5x.tcl
Path     pkgIndex.tcl

Package {md5 1.4.4}
Package {md5 1.4.5}
See   __md5
Platform *
Desc     {MD5 Message-Digest Algorithm}

Package {md5 2.0.7}
Package {md5 2.0.8}
See   __md5
Platform *
Desc     {MD5 Message-Digest Algorithm}

#
# ############





︙


2332
2333
2334
2335
2336
2337
2338
2339
2340


2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357

2358
2359
2360
2361




2362


2363















2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382

2383
2384
2385

2386
2387
2388
2389
2390
2391
2392

2367
2368
2369
2370
2371
2372
2373


2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386






2387
2388
2389
2390
2391
2392
2393
2394
2395

2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431

2432
2433
2434

2435
2436
2437
2438
2439
2440
2441
2442








-
-
+
+











-
-
-
-
-
-
+




+
+
+
+
-
+
+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+


















-
+


-
+








Path     pkgIndex.tcl

#
# #################

# #############
# Module "mime"
# [1]    | "smtp" (1.5)
# [2]    | "mime" (1.6.2)
# [1]    | "mime" (1.7.0)
# [2]    | "smtp" (1.5.1)
# -------+

Package {__mime 0.0}
Platform *
Desc     {Tcl Web Server, smtp client}
Hidden
Base     @TAP_DIR@/mime
Path     mime.tcl
Path     pkgIndex.tcl
Path     smtp.tcl

Package {smtp 1.5}
See   __mime
Platform *
Desc     {Client-side tcl implementation of the smtp protocol}

Package {mime 1.6.2}
Package {mime 1.7.0}
See   __mime
Platform *
Desc     {A TclOO and coroutine based web server}

Package {smtp 1.5.1}
See   __mime
Platform *
Desc     {Client-side tcl implementation of the smtp protocol}
#

#
# #############

# ##############
# Module "mkdoc"
# [1]    | "mkdoc" (0.7.0)
# -------+

Package {mkdoc 0.7.0}
Platform *
Desc     {Extracts and optionally converts Markdown comments in source code to HTML}
Base     @TAP_DIR@/mkdoc
Path     mkdoc.tcl
Path     pkgIndex.tcl

#
# ##############

# ####################
# Module "multiplexer"
# [1]    | "multiplexer" (0.2)
# -------+

Package {multiplexer 0.2}
Platform *
Desc     {One-to-many communication with sockets.}
Base     @TAP_DIR@/multiplexer
Path     multiplexer.tcl
Path     pkgIndex.tcl

#
# ####################

# ###################
# Module "namespacex"
# [1]    | "namespacex" (0.2)
# [1]    | "namespacex" (0.3)
# -------+

Package {namespacex 0.2}
Package {namespacex 0.3}
Platform *
Desc     {Namespace utility commands}
Base     @TAP_DIR@/namespacex
Path     namespacex.tcl
Path     pkgIndex.tcl

#




︙


2595
2596
2597
2598
2599
2600
2601
2602

2603
2604
2605

2606
2607


2608
2609
2610
2611
2612
2613
2614
2615







2616
2617
2618


2619
2620
2621
2622


2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633






2634
2635
2636
2637



2638
2639
2640


2641
2642
2643
2644
2645
2646
2647

2645
2646
2647
2648
2649
2650
2651

2652
2653
2654

2655


2656
2657
2658







2659
2660
2661
2662
2663
2664
2665
2666


2667
2668
2669
2670


2671
2672
2673
2674
2675
2676
2677






2678
2679
2680
2681
2682
2683
2684



2685
2686
2687
2688


2689
2690
2691
2692
2693
2694
2695
2696
2697








-
+


-
+
-
-
+
+

-
-
-
-
-
-
-
+
+
+
+
+
+
+

-
-
+
+


-
-
+
+





-
-
-
-
-
-
+
+
+
+
+
+

-
-
-
+
+
+

-
-
+
+








Path     pkgIndex.tcl

#
# ############

# #############
# Module "page"
# [1]    | "page::gen::peg::hb" (0.1)
# [1]    | "page::gen::peg::mecpu" (0.1)
# [2]    | "page::gen::peg::ser" (0.1)
# [3]    | "page::gen::peg::me" (0.1)
# [4]    | "page::gen::peg::mecpu" (0.1)
# [4]    | "page::gen::peg::hb" (0.1)
# [5]    | "page::reader::ser" (0.1)
# [6]    | "page::compiler::peg::mecpu" (0.1.1)
# [5]    | "page::compiler::peg::mecpu" (0.1.1)
# [6]    | "page::reader::ser" (0.1)
# [7]    | "page::analysis::peg::minimize" (0.1)
# [8]    | "page::writer::mecpu" (0.1.1)
# [9]    | "page::transform::realizable" (0.1)
# [10]    | "page::writer::ser" (0.1)
# [11]    | "page::reader::peg" (0.1)
# [12]    | "page::parse::peg" (0.1)
# [13]    | "page::analysis::peg::realizable" (0.1)
# [14]    | "page::parse::pegser" (0.1)
# [8]    | "page::analysis::peg::realizable" (0.1)
# [9]    | "page::reader::peg" (0.1)
# [10]    | "page::transform::realizable" (0.1)
# [11]    | "page::writer::ser" (0.1)
# [12]    | "page::writer::mecpu" (0.1.1)
# [13]    | "page::parse::peg" (0.1)
# [14]    | "page::writer::peg" (0.1)
# [15]    | "page::pluginmgr" (0.2)
# [16]    | "page::analysis::peg::emodes" (0.1)
# [17]    | "page::writer::peg" (0.1)
# [16]    | "page::parse::pegser" (0.1)
# [17]    | "page::analysis::peg::emodes" (0.1)
# [18]    | "page::util::peg" (0.1)
# [19]    | "page::util::norm::peg" (0.1)
# [20]    | "page::transform::reachable" (0.1)
# [21]    | "page::analysis::peg::reachable" (0.1)
# [20]    | "page::analysis::peg::reachable" (0.1)
# [21]    | "page::transform::reachable" (0.1)
# [22]    | "page::gen::tree::text" (0.1)
# [23]    | "page::util::quote" (0.1)
# [24]    | "page::writer::tpc" (0.1)
# [25]    | "@PKG@" (0.1)
# [26]    | "page::writer::tree" (0.1)
# [27]    | "page::reader::treeser" (0.1)
# [28]    | "page::reader::hb" (0.1)
# [29]    | "page::parse::lemon" (0.1)
# [30]    | "page::reader::lemon" (0.1)
# [31]    | "page::transform::mecpu" (0.1)
# [32]    | "page::util::flow" (0.1)
# [27]    | "page::reader::hb" (0.1)
# [28]    | "page::reader::treeser" (0.1)
# [29]    | "page::util::flow" (0.1)
# [30]    | "page::transform::mecpu" (0.1)
# [31]    | "page::reader::lemon" (0.1)
# [32]    | "page::parse::lemon" (0.1)
# [33]    | "page::gen::peg::cpkg" (0.1)
# [34]    | "page::writer::me" (0.1)
# [35]    | "page::writer::identity" (0.1)
# [36]    | "page::writer::hb" (0.1)
# [34]    | "page::writer::identity" (0.1)
# [35]    | "page::writer::hb" (0.1)
# [36]    | "page::writer::me" (0.1)
# [37]    | "page::writer::null" (0.1)
# [38]    | "page::gen::peg::canon" (0.1)
# [39]    | "page::util::norm::lemon" (0.1)
# [38]    | "page::util::norm::lemon" (0.1)
# [39]    | "page::gen::peg::canon" (0.1)
# [40]    | "page::parse::peghb" (0.1)
# [41]    | "page::config::peg" (0.1)
# -------+

Package {__page 0.0}
Platform *
Desc     {Parser generator tools}




︙


2689
2690
2691
2692
2693
2694
2695
2696

2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711

2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724





2725
2726
2727
2728
2729
2730





2731

2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746

2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761

2762
2763
2764
2765
2766
2767
2768
2769
2770
2771

2772
2773
2774
2775
2776

2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791

2792
2793
2794
2795
2796

2797
2798
2799
2800
2801
2802
2803
2804

2739
2740
2741
2742
2743
2744
2745

2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760

2761





2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785

2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800

2801
2802
2803
2804
2805
2806
2807
2808
2809
2810






2811
2812
2813
2814
2815
2816
2817
2818
2819
2820

2821
2822
2823
2824
2825

2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840

2841
2842
2843
2844
2845

2846
2847
2848
2849
2850
2851
2852
2853
2854








-
+














-
+
-
-
-
-
-








+
+
+
+
+






+
+
+
+
+
-
+














-
+









-
-
-
-
-
-
+









-
+




-
+














-
+




-
+









Path     plugins/writer_tree.tcl
Path     util_flow.tcl
Path     util_norm_lemon.tcl
Path     util_norm_peg.tcl
Path     util_peg.tcl
Path     util_quote.tcl

Package {page::gen::peg::hb 0.1}
Package {page::gen::peg::mecpu 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::gen::peg::ser 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::gen::peg::me 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::gen::peg::mecpu 0.1}
Package {page::gen::peg::hb 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::reader::ser 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::compiler::peg::mecpu 0.1.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::reader::ser 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::analysis::peg::minimize 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::analysis::peg::realizable 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::writer::mecpu 0.1.1}
Package {page::reader::peg 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::transform::realizable 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::writer::ser 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::reader::peg 0.1}
Package {page::writer::mecpu 0.1.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::parse::peg 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::analysis::peg::realizable 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::parse::pegser 0.1}
Package {page::writer::peg 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::pluginmgr 0.2}
See   __page
Platform *
Desc     {page plugin manager}

Package {page::analysis::peg::emodes 0.1}
Package {page::parse::pegser 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::writer::peg 0.1}
Package {page::analysis::peg::emodes 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::util::peg 0.1}
See   __page
Platform *
Desc     {page PEG transformation utilities}

Package {page::util::norm::peg 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::transform::reachable 0.1}
Package {page::analysis::peg::reachable 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::analysis::peg::reachable 0.1}
Package {page::transform::reachable 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::gen::tree::text 0.1}
See   __page
Platform *
Desc     {Tcllib package}




︙


2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835





2836






2837
2838
2839
2840
2841
2842
2843
2844
2845
2846

2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876

2877
2878
2879
2880
2881

2882
2883
2884
2885
2886
2887





2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906

2907
2908
2909

2910
2911
2912
2913
2914
2915
2916

2869
2870
2871
2872
2873
2874
2875





2876
2877
2878
2879
2880
2881
2882
2883
2884
2885

2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900

2901
2902
2903
2904
2905





2906
2907
2908





2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920

2921
2922
2923
2924
2925

2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955

2956
2957
2958

2959
2960
2961
2962
2963
2964
2965
2966








-
-
-
-
-





+
+
+
+
+
-
+
+
+
+
+
+









-
+




-
-
-
-
-



-
-
-
-
-












-
+




-
+






+
+
+
+
+


















-
+


-
+








Desc     {Tcllib package}

Package {page::writer::tree 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::reader::treeser 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::reader::hb 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::reader::treeser 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::parse::lemon 0.1}
Package {page::util::flow 0.1}
See   __page
Platform *
Desc     {page dataflow/treewalker utility}

Package {page::transform::mecpu 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::reader::lemon 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::transform::mecpu 0.1}
Package {page::parse::lemon 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::util::flow 0.1}
See   __page
Platform *
Desc     {page dataflow/treewalker utility}

Package {page::gen::peg::cpkg 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::writer::me 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::writer::identity 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::writer::hb 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::writer::null 0.1}
Package {page::writer::me 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::gen::peg::canon 0.1}
Package {page::writer::null 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::util::norm::lemon 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::gen::peg::canon 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::parse::peghb 0.1}
See   __page
Platform *
Desc     {Tcllib package}

Package {page::config::peg 0.1}
See   __page
Platform *
Desc     {Tcllib package}

#
# #############

# ############
# Module "pki"
# [1]    | "pki" (0.10)
# [1]    | "pki" (0.20)
# -------+

Package {pki 0.10}
Package {pki 0.20}
Platform *
Desc     {Implementation of the public key cipher}
Base     @TAP_DIR@/pki
Path     pkgIndex.tcl
Path     pki.tcl

#




︙


2944
2945
2946
2947
2948
2949
2950
2951

2952
2953
2954

2955
2956
2957
2958
2959
2960
2961

2994
2995
2996
2997
2998
2999
3000

3001
3002
3003

3004
3005
3006
3007
3008
3009
3010
3011








-
+


-
+








Path     png.tcl

#
# ############

# #############
# Module "pop3"
# [1]    | "pop3" (1.9)
# [1]    | "pop3" (1.10)
# -------+

Package {pop3 1.9}
Package {pop3 1.10}
Platform *
Desc     {Tcl client for POP3 email protocol}
Base     @TAP_DIR@/pop3
Path     pkgIndex.tcl
Path     pop3.tcl

#




︙


3021
3022
3023
3024
3025
3026
3027
3028
3029


3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040

3041
3042
3043
3044
3045

3046
3047
3048
3049
3050
3051
3052
3053
3054
3055

3056
3057
3058

3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
3071
3072
3073




3074
3075

3076
3077
3078
3079
3080
3081





3082

3083
3084


3085
3086
3087
3088
3089
3090
3091




3092
3093
3094


3095
3096
3097
3098
3099
3100
3101
3102







3103
3104
3105
3106
3107


3108
3109
3110
3111
3112
3113
3114

3071
3072
3073
3074
3075
3076
3077


3078
3079
3080
3081
3082
3083
3084
3085
3086
3087
3088
3089

3090
3091
3092
3093
3094

3095
3096
3097
3098
3099
3100
3101
3102
3103
3104

3105
3106
3107

3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119




3120
3121
3122
3123
3124

3125
3126





3127
3128
3129
3130
3131
3132
3133


3134
3135

3136
3137




3138
3139
3140
3141
3142


3143
3144
3145







3146
3147
3148
3149
3150
3151
3152
3153
3154
3155


3156
3157
3158
3159
3160
3161
3162
3163
3164








-
-
+
+










-
+




-
+









-
+


-
+











-
-
-
-
+
+
+
+

-
+

-
-
-
-
-
+
+
+
+
+

+
-
-
+
+
-


-
-
-
-
+
+
+
+

-
-
+
+

-
-
-
-
-
-
-
+
+
+
+
+
+
+



-
-
+
+








Desc     {Tcllib package}

#
# ################

# ###################
# Module "processman"
# [1]    | "odie::processman" (0.5)
# [2]    | "processman" (0.5)
# [1]    | "odie::processman" (0.6)
# [2]    | "processman" (0.6)
# -------+

Package {__processman 0.0}
Platform *
Desc     {processman}
Hidden
Base     @TAP_DIR@/processman
Path     pkgIndex.tcl
Path     processman.tcl

Package {odie::processman 0.5}
Package {odie::processman 0.6}
See   __processman
Platform *
Desc     {Tcllib package}

Package {processman 0.5}
Package {processman 0.6}
See   __processman
Platform *
Desc     {Tool for automating the period callback of commands}

#
# ###################

# #################
# Module "profiler"
# [1]    | "profiler" (0.5)
# [1]    | "profiler" (0.6)
# -------+

Package {profiler 0.5}
Package {profiler 0.6}
Platform *
Desc     {Tcl source code profiler}
Base     @TAP_DIR@/profiler
Path     pkgIndex.tcl
Path     profiler.tcl

#
# #################

# ###########
# Module "pt"
# [1]    | "pt::rde::critcl" (1.3.4)
# [2]    | "pt::peg::to::param" (1.0.1)
# [3]    | "pt::peg::export::json" (1)
# [4]    | "pt::tclparam::configuration::snit" (1.0.2)
# [1]    | "pt::peg::to::param" (1.0.1)
# [2]    | "pt::peg::export::json" (1)
# [3]    | "pt::rde::critcl" (1.3.4)
# [4]    | "pt::peg::export::peg" (1)
# [5]    | "pt::peg::from::json" (1)
# [6]    | "pt::peg::export::peg" (1)
# [6]    | "pt::tclparam::configuration::snit" (1.0.2)
# [7]    | "pt::peg::to::cparam" (1.1.3)
# [8]    | "pt::peg::import" (1.0.1)
# [9]    | "pt::peg::to::peg" (1.0.2)
# [10]    | "pt::parse::peg" (1.0.1)
# [11]    | "pt::peg::import::peg" (1)
# [12]    | "pt::rde" (1.1)
# [8]    | "pt::peg::import::peg" (1)
# [9]    | "pt::rde" (1.1)
# [10]    | "pt::peg::import" (1.0.1)
# [11]    | "pt::parse::peg" (1.0.1)
# [12]    | "pt::peg::to::peg" (1.0.2)
# [13]    | "pt::peg::from::peg" (1.0.3)
# [14]    | "pt::parse::peg_tcl" (1.0.1)
# [14]    | "pt::cparam::configuration::critcl" (1.0.2)
# [15]    | "pt::tclparam::configuration::tcloo" (1.0.4)
# [15]    | "pt::cparam::configuration::critcl" (1.0.2)
# [16]    | "pt::tclparam::configuration::tcloo" (1.0.4)
# [16]    | "pt::parse::peg_tcl" (1.0.1)
# [17]    | "pt::util" (1.1)
# [18]    | "pt::peg::op" (1.1.0)
# [19]    | "pt::ast" (1.1)
# [20]    | "pt::pe::op" (1.0.1)
# [21]    | "pt::peg::import::json" (1)
# [22]    | "pt::peg::to::json" (1)
# [19]    | "pt::pe::op" (1.0.1)
# [20]    | "pt::ast" (1.1)
# [21]    | "pt::peg::to::json" (1)
# [22]    | "pt::peg::import::json" (1)
# [23]    | "pt::peg::export::container" (1)
# [24]    | "pt::peg::export" (1.0.1)
# [25]    | "pt::peg::to::container" (1)
# [24]    | "pt::tclparam::configuration::nx" (1.0.1)
# [25]    | "pt::peg::interp" (1.0.1)
# [26]    | "pt::pgen" (1.1)
# [27]    | "pt::tclparam::configuration::nx" (1.0.1)
# [28]    | "pt::peg::interp" (1.0.1)
# [29]    | "pt::peg::container" (1)
# [30]    | "pt::peg::container::peg" (1)
# [31]    | "pt::peg::to::tclparam" (1.0.3)
# [32]    | "text::write" (1)
# [33]    | "pt::peg" (1)
# [27]    | "pt::peg::export" (1.0.1)
# [28]    | "pt::peg::to::container" (1)
# [29]    | "pt::peg::to::tclparam" (1.0.3)
# [30]    | "pt::peg::container" (1)
# [31]    | "pt::peg::container::peg" (1)
# [32]    | "pt::peg" (1)
# [33]    | "text::write" (1)
# [34]    | "pt::rde::nx" (.1.1)
# [35]    | "pt::rde::oo" (1.1)
# [36]    | "pt::pe" (1.0.2)
# [37]    | "char" (1.0.1)
# [38]    | "pt::cparam::configuration::tea" (0.1)
# [37]    | "pt::cparam::configuration::tea" (0.1)
# [38]    | "char" (1.0.2)
# -------+

Package {__pt 0.0}
Platform *
Desc     {Parser Tools}
Hidden
Base     @TAP_DIR@/pt




︙


3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189

3190
3191
3192

3193
3194
3195
3196
3197
3198
3199
3200
3201
3202
3203










3204
3205
3206
3207
3208
3209
3210
3211
3212
3213
3214
3215
3216
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3233















3234
3235
3236
3237





3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
3251
3252
3253
3254
3255
3256
3257
3258
3259
3260
3261
3262
3263
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274

3275
3276
3277

3278
3279
3280
3281
3282
3283





3284
3285
3286
3287
3288
3289
3290
3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
3309
3310
3311
3312
3313




















3314
3315
3316
3317
3318
3319
3320
3321
3322
3323
3324

3325
3326
3327

3328
3329
3330
3331
3332
3333
3334
3335
3336
3337
3338
3339
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
3357
3358
3359
3360
3361
3362
3363





3364
3365
3366
3367
3368
3369
3370

3217
3218
3219
3220
3221
3222
3223





3224
3225
3226
3227
3228
3229
3230
3231
3232
3233

3234
3235
3236

3237





3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
3251
3252
3253
3254
3255
3256
3257
3258















3259
3260
3261
3262
3263
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3290
3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303





3304
3305
3306
3307
3308
3309
3310
3311
3312
3313





3314
3315
3316
3317
3318

3319
3320
3321

3322
3323
3324
3325
3326
3327
3328
3329
3330
3331
3332
3333
3334
3335
3336
3337
3338















3339
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
3357
3358
3359
3360
3361
3362
3363
3364
3365
3366
3367
3368
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378

3379
3380
3381

3382
3383
3384
3385
3386
3387
3388





3389
3390
3391
3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
3403





3404
3405
3406
3407
3408
3409
3410
3411
3412
3413
3414
3415
3416
3417
3418
3419
3420








-
-
-
-
-










-
+


-
+
-
-
-
-
-






+
+
+
+
+
+
+
+
+
+





-
-
-
-
-
-
-
-
-
-
-
-
-
-
-










+
+
+
+
+
+
+
+
+
+
+
+
+
+
+




+
+
+
+
+











-
-
-
-
-










-
-
-
-
-





-
+


-
+






+
+
+
+
+





-
-
-
-
-
-
-
-
-
-
-
-
-
-
-










+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+










-
+


-
+






-
-
-
-
-















-
-
-
-
-





+
+
+
+
+








Path     rde_critcl/stack.h
Path     rde_critcl/tc.c
Path     rde_critcl/tc.h
Path     rde_critcl/util.c
Path     rde_critcl/util.h
Path     text_write.tcl

Package {pt::rde::critcl 1.3.4}
See   __pt
Platform *
Desc     {Tcllib package}

Package {pt::peg::to::param 1.0.1}
See   __pt
Platform *
Desc     {PEG Conversion. Write PARAM format}

Package {pt::peg::export::json 1}
See   __pt
Platform *
Desc     {PEG Export Plugin. Write JSON format}

Package {pt::tclparam::configuration::snit 1.0.2}
Package {pt::rde::critcl 1.3.4}
See   __pt
Platform *
Desc     {Tcl/PARAM, Canned configuration, Snit}
Desc     {Tcllib package}

Package {pt::peg::from::json 1}
See   __pt
Platform *
Desc     {PEG Conversion. Read JSON format}

Package {pt::peg::export::peg 1}
See   __pt
Platform *
Desc     {PEG Export Plugin. Write PEG format}

Package {pt::peg::from::json 1}
See   __pt
Platform *
Desc     {PEG Conversion. Read JSON format}

Package {pt::tclparam::configuration::snit 1.0.2}
See   __pt
Platform *
Desc     {Tcl/PARAM, Canned configuration, Snit}

Package {pt::peg::to::cparam 1.1.3}
See   __pt
Platform *
Desc     {PEG Conversion. Write CPARAM format}

Package {pt::peg::import 1.0.1}
See   __pt
Platform *
Desc     {PEG Import}

Package {pt::peg::to::peg 1.0.2}
See   __pt
Platform *
Desc     {PEG Conversion. Write PEG format}

Package {pt::parse::peg 1.0.1}
See   __pt
Platform *
Desc     {Parser Tools PEG Parser}

Package {pt::peg::import::peg 1}
See   __pt
Platform *
Desc     {PEG Import Plugin. Read PEG format}

Package {pt::rde 1.1}
See   __pt
Platform *
Desc     {Parsing Runtime Support, PARAM based}

Package {pt::peg::import 1.0.1}
See   __pt
Platform *
Desc     {PEG Import}

Package {pt::parse::peg 1.0.1}
See   __pt
Platform *
Desc     {Parser Tools PEG Parser}

Package {pt::peg::to::peg 1.0.2}
See   __pt
Platform *
Desc     {PEG Conversion. Write PEG format}

Package {pt::peg::from::peg 1.0.3}
See   __pt
Platform *
Desc     {PEG Conversion. Read PEG format}

Package {pt::parse::peg_tcl 1.0.1}
See   __pt
Platform *
Desc     {Tcllib package}

Package {pt::cparam::configuration::critcl 1.0.2}
See   __pt
Platform *
Desc     {C/PARAM, Canned configuration, Critcl}

Package {pt::tclparam::configuration::tcloo 1.0.4}
See   __pt
Platform *
Desc     {Tcl/PARAM, Canned configuration, Tcloo}

Package {pt::parse::peg_tcl 1.0.1}
See   __pt
Platform *
Desc     {Tcllib package}

Package {pt::util 1.1}
See   __pt
Platform *
Desc     {Tcllib package}

Package {pt::peg::op 1.1.0}
See   __pt
Platform *
Desc     {Parser Tools PE Grammar Utility Operations}

Package {pt::ast 1.1}
See   __pt
Platform *
Desc     {General utilities}

Package {pt::pe::op 1.0.1}
See   __pt
Platform *
Desc     {Parsing Expression Utilities}

Package {pt::peg::import::json 1}
Package {pt::ast 1.1}
See   __pt
Platform *
Desc     {PEG Import Plugin. Read JSON format}
Desc     {General utilities}

Package {pt::peg::to::json 1}
See   __pt
Platform *
Desc     {PEG Conversion. Write JSON format}

Package {pt::peg::import::json 1}
See   __pt
Platform *
Desc     {PEG Import Plugin. Read JSON format}

Package {pt::peg::export::container 1}
See   __pt
Platform *
Desc     {PEG Export Plugin. Write CONTAINER format}

Package {pt::peg::export 1.0.1}
See   __pt
Platform *
Desc     {PEG Export}

Package {pt::peg::to::container 1}
See   __pt
Platform *
Desc     {PEG Conversion. Write CONTAINER format}

Package {pt::pgen 1.1}
See   __pt
Platform *
Desc     {Parser Generator}

Package {pt::tclparam::configuration::nx 1.0.1}
See   __pt
Platform *
Desc     {Tcl/PARAM, Canned configuration, NX}

Package {pt::peg::interp 1.0.1}
See   __pt
Platform *
Desc     {Interpreter for parsing expression grammars}

Package {pt::pgen 1.1}
See   __pt
Platform *
Desc     {Parser Generator}

Package {pt::peg::export 1.0.1}
See   __pt
Platform *
Desc     {PEG Export}

Package {pt::peg::to::container 1}
See   __pt
Platform *
Desc     {PEG Conversion. Write CONTAINER format}

Package {pt::peg::to::tclparam 1.0.3}
See   __pt
Platform *
Desc     {PEG Conversion. Write TCLPARAM format}

Package {pt::peg::container 1}
See   __pt
Platform *
Desc     {PEG Storage}

Package {pt::peg::container::peg 1}
See   __pt
Platform *
Desc     {PEG Storage. Canned PEG grammar specification}

Package {pt::peg::to::tclparam 1.0.3}
Package {pt::peg 1}
See   __pt
Platform *
Desc     {PEG Conversion. Write TCLPARAM format}
Desc     {Parsing Expression Grammar Serialization}

Package {text::write 1}
See   __pt
Platform *
Desc     {Tcllib package}

Package {pt::peg 1}
See   __pt
Platform *
Desc     {Parsing Expression Grammar Serialization}

Package {pt::rde::nx .1.1}
See   __pt
Platform *
Desc     {Tcllib package}

Package {pt::rde::oo 1.1}
See   __pt
Platform *
Desc     {Tcllib package}

Package {pt::pe 1.0.2}
See   __pt
Platform *
Desc     {Parsing Expression Serialization}

Package {char 1.0.1}
See   __pt
Platform *
Desc     {Tcllib package}

Package {pt::cparam::configuration::tea 0.1}
See   __pt
Platform *
Desc     {C/PARAM, Canned configuration, TEA}

Package {char 1.0.2}
See   __pt
Platform *
Desc     {Tcllib package}

#
# ###########

# ############
# Module "rc4"
# [1]    | "rc4" (1.1.0)
# -------+




︙


3408
3409
3410
3411
3412
3413
3414
3415

3416
3417
3418

3419
3420
3421
3422
3423
3424
3425
3426
3427
3428
3429
3430
3431


3432
3433
3434
3435
3436
3437
3438
3439
3440
3441
3442





3443
3444
3445
3446
3447
3448
3449
3450
3451
3452
3453
3454
3455
3456
3457
3458
3459


3460
3461
3462
3463
3464
3465
3466
3467
3468
3469
3470
3471
3472
3473
3474





3475
3476
3477
3478
3479
3480
3481
3482
3483
3484
3485
3486
3487
3488
3489
3490
3491

3458
3459
3460
3461
3462
3463
3464

3465
3466
3467

3468
3469
3470
3471
3472
3473
3474
3475
3476
3477
3478
3479


3480
3481
3482
3483
3484
3485
3486
3487
3488
3489
3490
3491
3492
3493
3494
3495
3496
3497
3498
3499
3500
3501
3502





3503
3504
3505
3506
3507


3508
3509
3510
3511
3512
3513
3514
3515
3516
3517
3518
3519
3520
3521
3522
3523
3524
3525
3526
3527
3528
3529
3530
3531
3532
3533
3534





3535
3536
3537
3538
3539
3540
3541








-
+


-
+











-
-
+
+











+
+
+
+
+





-
-
-
-
-





-
-
+
+















+
+
+
+
+





-
-
-
-
-








Path     report.tcl

#
# ###############

# #############
# Module "rest"
# [1]    | "rest" (1.3.1)
# [1]    | "rest" (1.5)
# -------+

Package {rest 1.3.1}
Package {rest 1.5}
Platform *
Desc     {define REST web APIs and call them inline or asychronously}
Base     @TAP_DIR@/rest
Path     pkgIndex.tcl
Path     rest.tcl

#
# #############

# ###############
# Module "ripemd"
# [1]    | "ripemd128" (1.0.5)
# [2]    | "ripemd160" (1.0.5)
# [1]    | "ripemd160" (1.0.5)
# [2]    | "ripemd128" (1.0.5)
# -------+

Package {__ripemd 0.0}
Platform *
Desc     {RIPEMD Message-Digest Algorithm}
Hidden
Base     @TAP_DIR@/ripemd
Path     pkgIndex.tcl
Path     ripemd128.tcl
Path     ripemd160.tcl

Package {ripemd160 1.0.5}
See   __ripemd
Platform *
Desc     {RIPEMD-160 Message-Digest Algorithm}

Package {ripemd128 1.0.5}
See   __ripemd
Platform *
Desc     {RIPEMD-128 Message-Digest Algorithm}

Package {ripemd160 1.0.5}
See   __ripemd
Platform *
Desc     {RIPEMD-160 Message-Digest Algorithm}

#
# ###############

# #############
# Module "sasl"
# [1]    | "SASL::XGoogleToken" (1.0.1)
# [2]    | "SASL::SCRAM" (0.1)
# [1]    | "SASL::SCRAM" (0.1)
# [2]    | "SASL::XGoogleToken" (1.0.1)
# [3]    | "SASL::NTLM" (1.1.2)
# [4]    | "SASL" (1.3.3)
# -------+

Package {__sasl 0.0}
Platform *
Desc     {Simple Authentication and Security Layer (SASL)}
Hidden
Base     @TAP_DIR@/sasl
Path     gtoken.tcl
Path     ntlm.tcl
Path     pkgIndex.tcl
Path     sasl.tcl
Path     scram.tcl

Package {SASL::SCRAM 0.1}
See   __sasl
Platform *
Desc     {Implementation of SASL SCRAM mechanism for Tcl}

Package {SASL::XGoogleToken 1.0.1}
See   __sasl
Platform *
Desc     {Implementation of SASL NTLM mechanism for Tcl}

Package {SASL::SCRAM 0.1}
See   __sasl
Platform *
Desc     {Implementation of SASL SCRAM mechanism for Tcl}

Package {SASL::NTLM 1.1.2}
See   __sasl
Platform *
Desc     {Implementation of SASL NTLM mechanism for Tcl}

Package {SASL 1.3.3}
See   __sasl




︙


3500
3501
3502
3503
3504
3505
3506
3507

3508
3509
3510


3511
3512
3513


3514
3515
3516
3517
3518
3519
3520

3521
3522
3523
3524
3525

3526
3527
3528
3529
3530
3531
3532
3533
3534
3535
3536
3537
3538
3539


3540
3541
3542
3543
3544
3545
3546
3547
3548
3549
3550
3551
3552
3553
3554
3555
3556





3557
3558
3559
3560
3561
3562
3563
3564
3565
3566
3567
3568
3569
3570
3571
3572
3573

3550
3551
3552
3553
3554
3555
3556

3557
3558
3559
3560
3561
3562
3563
3564
3565
3566
3567
3568
3569
3570
3571
3572
3573

3574
3575
3576
3577
3578

3579
3580
3581
3582
3583
3584
3585
3586
3587
3588
3589
3590
3591


3592
3593
3594
3595
3596
3597
3598
3599
3600
3601
3602
3603
3604
3605
3606
3607
3608
3609
3610
3611
3612
3613
3614
3615
3616
3617
3618
3619
3620





3621
3622
3623
3624
3625
3626
3627








-
+



+
+



+
+






-
+




-
+












-
-
+
+

















+
+
+
+
+





-
-
-
-
-








# [1]    | "sha1" (1.1.1)
# [2]    | "sha1" (2.0.4)
# [3]    | "sha256" (1.0.4)
# -------+

Package {__sha1 0.0}
Platform *
Desc     {SHA-x Message-Digest Algorithm}
Desc     {SHA-x Message-Digest Algorithm, Standardized OO Framework for development}
Hidden
Base     @TAP_DIR@/sha1
Path     pkgIndex.tcl
Path     sha1.c
Path     sha1.h
Path     sha1.tcl
Path     sha1c.tcl
Path     sha1v1.tcl
Path     sha256.c
Path     sha256.h
Path     sha256.tcl
Path     sha256c.tcl

Package {sha1 1.1.1}
See   __sha1
Platform *
Desc     {SHA1 Message-Digest Algorithm}
Desc     {TclOO Library (TOOL) Framework}

Package {sha1 2.0.4}
See   __sha1
Platform *
Desc     {SHA1 Message-Digest Algorithm}
Desc     {TclOO Library (TOOL) Framework}

Package {sha256 1.0.4}
See   __sha1
Platform *
Desc     {SHA256 Message-Digest Algorithm}

#
# #############

# ###################
# Module "simulation"
# [1]    | "simulation::montecarlo" (0.1)
# [2]    | "simulation::annealing" (0.2)
# [3]    | "simulation::random" (0.4.0)
# [2]    | "simulation::random" (0.4.0)
# [3]    | "simulation::annealing" (0.2)
# -------+

Package {__simulation 0.0}
Platform *
Desc     {Tcl Simulation Tools}
Hidden
Base     @TAP_DIR@/simulation
Path     annealing.tcl
Path     montecarlo.tcl
Path     pkgIndex.tcl
Path     random.tcl

Package {simulation::montecarlo 0.1}
See   __simulation
Platform *
Desc     {Monte Carlo simulations}

Package {simulation::random 0.4.0}
See   __simulation
Platform *
Desc     {Pseudo-random number generators}

Package {simulation::annealing 0.2}
See   __simulation
Platform *
Desc     {Simulated annealing}

Package {simulation::random 0.4.0}
See   __simulation
Platform *
Desc     {Pseudo-random number generators}

#
# ###################

# ##############
# Module "smtpd"
# [1]    | "smtpd" (1.5)
# -------+




︙


3586
3587
3588
3589
3590
3591
3592
3593

3594
3595
3596
3597
3598
3599
3600
3601
3602
3603
3604
3605
3606
3607
3608

3609
3610
3611
3612
3613

3614
3615
3616
3617
3618
3619
3620

3640
3641
3642
3643
3644
3645
3646

3647
3648
3649
3650
3651
3652
3653
3654
3655
3656
3657
3658
3659
3660
3661

3662
3663
3664
3665
3666

3667
3668
3669
3670
3671
3672
3673
3674








-
+














-
+




-
+








# Module "snit"
# [1]    | "snit" (1.4.2)
# [2]    | "snit" (2.3.2)
# -------+

Package {__snit 0.0}
Platform *
Desc     {Parser generator tools}
Desc     {Snit's Not Incr Tcl, OO system}
Hidden
Base     @TAP_DIR@/snit
Path     main1.tcl
Path     main1_83.tcl
Path     main2.tcl
Path     pkgIndex.tcl
Path     snit.tcl
Path     snit2.tcl
Path     snit_tcl83_utils.tcl
Path     validate.tcl

Package {snit 1.4.2}
See   __snit
Platform *
Desc     {page character quoting utilities}
Desc     {Snit's Not Incr Tcl}

Package {snit 2.3.2}
See   __snit
Platform *
Desc     {page character quoting utilities}
Desc     {Snit's Not Incr Tcl}

#
# #############

# ################
# Module "soundex"
# [1]    | "soundex" (1.0)




︙


3658
3659
3660
3661
3662
3663
3664
3665
3666


3667
3668
3669
3670
3671
3672
3673
3674
3675
3676
3677





3678
3679
3680
3681
3682
3683
3684
3685
3686
3687
3688
3689
3690
3691
3692
3693
3694

3712
3713
3714
3715
3716
3717
3718


3719
3720
3721
3722
3723
3724
3725
3726
3727
3728
3729
3730
3731
3732
3733
3734
3735
3736
3737
3738
3739
3740
3741





3742
3743
3744
3745
3746
3747
3748








-
-
+
+











+
+
+
+
+





-
-
-
-
-








Desc     {switch/option management.}

#
# ###############

# ###############
# Module "string"
# [1]    | "string::token" (1)
# [2]    | "string::token::shell" (1.2)
# [1]    | "string::token::shell" (1.2)
# [2]    | "string::token" (1)
# -------+

Package {__string 0.0}
Platform *
Desc     {Text and string utilities}
Hidden
Base     @TAP_DIR@/string
Path     pkgIndex.tcl
Path     token.tcl
Path     token_shell.tcl

Package {string::token::shell 1.2}
See   __string
Platform *
Desc     {Parsing of shell command line}

Package {string::token 1}
See   __string
Platform *
Desc     {Regex based iterative lexing}

Package {string::token::shell 1.2}
See   __string
Platform *
Desc     {Parsing of shell command line}

#
# ###############

# ###################
# Module "stringprep"
# [1]    | "stringprep::data" (1.0.1)
# [2]    | "unicode::data" (1.0.0)




︙


3740
3741
3742
3743
3744
3745
3746
3747
3748
3749
3750
3751
3752
3753








3754
3755
3756
3757
3758
3759
3760
3761
3762
3763
3764
3765
3766
3767

3768
3769
3770
3771
3772
3773
3774

3794
3795
3796
3797
3798
3799
3800







3801
3802
3803
3804
3805
3806
3807
3808
3809
3810
3811
3812
3813
3814
3815
3816
3817
3818
3819
3820
3821
3822
3823
3824
3825
3826
3827
3828
3829
3830








-
-
-
-
-
-
-
+
+
+
+
+
+
+
+














+








# [6]    | "struct::skiplist" (1.3)
# [7]    | "struct" (1.4)
# [8]    | "struct" (2.1)
# [9]    | "struct::set" (2.2.3)
# [10]    | "struct::queue" (1.4.5)
# [11]    | "struct::map" (1)
# [12]    | "struct::prioqueue" (1.4)
# [13]    | "struct::disjointset" (1.1)
# [14]    | "struct::pool" (1.2.3)
# [15]    | "struct::list" (1.8.4)
# [16]    | "struct::graph::op" (0.11.3)
# [17]    | "struct::matrix" (1.2.2)
# [18]    | "struct::matrix" (2.0.4)
# [19]    | "struct::stack" (1.5.3)
# [13]    | "struct::list::test" (1.8.4)
# [14]    | "struct::disjointset" (1.1)
# [15]    | "struct::pool" (1.2.3)
# [16]    | "struct::list" (1.8.5)
# [17]    | "struct::graph::op" (0.11.3)
# [18]    | "struct::matrix" (1.2.2)
# [19]    | "struct::matrix" (2.0.4)
# [20]    | "struct::stack" (1.5.3)
# -------+

Package {__struct 0.0}
Platform *
Desc     {Tcl Data Structures}
Hidden
Base     @TAP_DIR@/struct
Path     disjointset.tcl
Path     graph.tcl
Path     graph1.tcl
Path     graph_c.tcl
Path     graph_tcl.tcl
Path     graphops.tcl
Path     list.tcl
Path     list.test.tcl
Path     map.tcl
Path     matrix.tcl
Path     matrix1.tcl
Path     pkgIndex.tcl
Path     pool.tcl
Path     prioqueue.tcl
Path     queue.tcl




︙


3846
3847
3848
3849
3850
3851
3852





3853
3854
3855
3856
3857
3858
3859
3860
3861
3862
3863
3864

3865
3866
3867
3868
3869
3870
3871

3902
3903
3904
3905
3906
3907
3908
3909
3910
3911
3912
3913
3914
3915
3916
3917
3918
3919
3920
3921
3922
3923
3924

3925
3926
3927
3928
3929
3930
3931
3932








+
+
+
+
+











-
+








Platform *
Desc     {Manage key/value maps}

Package {struct::prioqueue 1.4}
See   __struct
Platform *
Desc     {Create and manipulate prioqueue objects}

Package {struct::list::test 1.8.4}
See   __struct
Platform *
Desc     {Tcllib package}

Package {struct::disjointset 1.1}
See   __struct
Platform *
Desc     {Disjoint set data structure}

Package {struct::pool 1.2.3}
See   __struct
Platform *
Desc     {Create and manipulate pool objects (of discrete items)}

Package {struct::list 1.8.4}
Package {struct::list 1.8.5}
See   __struct
Platform *
Desc     {Procedures for manipulating lists}

Package {struct::graph::op 0.11.3}
See   __struct
Platform *




︙


3930
3931
3932
3933
3934
3935
3936

3937

3938
3939
3940
3941
3942
3943
3944
3945
3946
3947
3948





3949
3950
3951
3952
3953
3954
3955

3991
3992
3993
3994
3995
3996
3997
3998

3999

4000
4001
4002
4003
4004





4005
4006
4007
4008
4009
4010
4011
4012
4013
4014
4015
4016








+
-
+
-





-
-
-
-
-
+
+
+
+
+








Desc     {TEPAM procedure, reference manual}

#
# ##############

# #############
# Module "term"
# [1]    | "term::receive::bind" (0.1)
# [1]    | "term::ansi::ctrl::unix" (0.1.1)
# [2]    | "term::ansi::ctrl::unix" (0.1.1)
# [2]    | "term::receive::bind" (0.1)
# [3]    | "term::ansi::code::attr" (0.1)
# [4]    | "term::interact::menu" (0.1)
# [5]    | "term" (0.1)
# [6]    | "term::interact::pager" (0.1)
# [7]    | "term::ansi::send" (0.2)
# [8]    | "term::ansi::code" (0.2)
# [9]    | "term::send" (0.1)
# [10]    | "term::ansi::code::macros" (0.1)
# [11]    | "term::ansi::code::ctrl" (0.2)
# [12]    | "term::receive" (0.1)
# [8]    | "term::send" (0.1)
# [9]    | "term::ansi::code" (0.2)
# [10]    | "term::receive" (0.1)
# [11]    | "term::ansi::code::macros" (0.1)
# [12]    | "term::ansi::code::ctrl" (0.3)
# -------+

Package {__term 0.0}
Platform *
Desc     {Terminal control}
Hidden
Base     @TAP_DIR@/term




︙


3963
3964
3965
3966
3967
3968
3969





3970
3971
3972
3973
3974
3975
3976
3977
3978
3979
3980
3981
3982
3983
3984
3985
3986

4024
4025
4026
4027
4028
4029
4030
4031
4032
4033
4034
4035
4036
4037
4038
4039
4040





4041
4042
4043
4044
4045
4046
4047








+
+
+
+
+





-
-
-
-
-








Path     imenu.tcl
Path     ipager.tcl
Path     pkgIndex.tcl
Path     receive.tcl
Path     send.tcl
Path     term.tcl

Package {term::receive::bind 0.1}
See   __term
Platform *
Desc     {Keyboard dispatch from terminals}

Package {term::ansi::ctrl::unix 0.1.1}
See   __term
Platform *
Desc     {Control operations and queries}

Package {term::receive::bind 0.1}
See   __term
Platform *
Desc     {Keyboard dispatch from terminals}

Package {term::ansi::code::attr 0.1}
See   __term
Platform *
Desc     {ANSI attribute sequences}

Package {term::interact::menu 0.1}
See   __term




︙


3998
3999
4000
4001
4002
4003
4004





4005
4006
4007
4008
4009
4010

4011
4012
4013

4014
4015
4016
4017
4018
4019
4020

4021
4022
4023
4024
4025
4026
4027
4028
4029
4030
4031
4032
4033
4034
4035
4036
4037
4038
4039


4040
4041
4042
4043
4044




4045
4046
4047
4048
4049
4050
4051

4059
4060
4061
4062
4063
4064
4065
4066
4067
4068
4069
4070
4071
4072
4073
4074
4075

4076
4077
4078

4079
4080
4081
4082
4083
4084
4085

4086
4087
4088
4089
4090





4091
4092
4093
4094
4095
4096
4097
4098


4099
4100
4101




4102
4103
4104
4105
4106
4107
4108
4109
4110
4111
4112








+
+
+
+
+





-
+


-
+






-
+




-
-
-
-
-








-
-
+
+

-
-
-
-
+
+
+
+








Desc     {Terminal widget, paging}

Package {term::ansi::send 0.2}
See   __term
Platform *
Desc     {Output of ANSI control sequences to terminals}

Package {term::send 0.1}
See   __term
Platform *
Desc     {General output to terminals}

Package {term::ansi::code 0.2}
See   __term
Platform *
Desc     {Helper for control sequences}

Package {term::send 0.1}
Package {term::receive 0.1}
See   __term
Platform *
Desc     {General output to terminals}
Desc     {General input from terminals}

Package {term::ansi::code::macros 0.1}
See   __term
Platform *
Desc     {Macro sequences}

Package {term::ansi::code::ctrl 0.2}
Package {term::ansi::code::ctrl 0.3}
See   __term
Platform *
Desc     {ANSI control sequences}

Package {term::receive 0.1}
See   __term
Platform *
Desc     {General input from terminals}

#
# #############

# #################
# Module "textutil"
# [1]    | "textutil::repeat" (0.7)
# [2]    | "textutil::wcswidth" (35.1)
# [3]    | "textutil::expander" (1.3.1)
# [4]    | "textutil::tabify" (0.7)
# [5]    | "textutil::string" (0.8)
# [4]    | "textutil::string" (0.8)
# [5]    | "textutil::tabify" (0.7)
# [6]    | "textutil::adjust" (0.7.3)
# [7]    | "textutil::trim" (0.7)
# [8]    | "textutil" (0.9)
# [9]    | "textutil::split" (0.8)
# [10]    | "textutil::patch" (0.1)
# [7]    | "textutil" (0.9)
# [8]    | "textutil::trim" (0.7)
# [9]    | "textutil::patch" (0.1)
# [10]    | "textutil::split" (0.8)
# -------+

Package {__textutil 0.0}
Platform *
Desc     {Text and string utilities, macro processing, Text and string utilities, Markdown to HTML Converter}
Hidden
Base     @TAP_DIR@/textutil




︙


4075
4076
4077
4078
4079
4080
4081





4082
4083
4084
4085
4086
4087
4088
4089
4090
4091
4092
4093
4094
4095
4096
4097
4098
4099
4100
4101
4102
4103
4104
4105
4106
4107

4108
4109
4110

4111
4112
4113
4114
4115
4116





4117
4118
4119
4120
4121
4122
4123
4124
4125
4126
4127
4128







4129
4130
4131
4132
4133
4134
4135
4136
4137
4138
4139
4140
4141
4142
4143
4144
4145

4146
4147
4148
4149
4150

4151
4152
4153
4154
4155

4156
4157
4158
4159
4160

4161
4162
4163

4164
4165

4166
4167
4168
4169
4170

4171
4172
4173

4174
4175

4176
4177
4178
4179
4180
4181
4182

4136
4137
4138
4139
4140
4141
4142
4143
4144
4145
4146
4147
4148
4149
4150
4151
4152





4153
4154
4155
4156
4157





4158
4159
4160
4161
4162

4163
4164
4165

4166
4167
4168
4169
4170
4171
4172
4173
4174
4175
4176
4177
4178
4179
4180
4181
4182







4183
4184
4185
4186
4187
4188
4189
4190
4191
4192
4193
4194
4195
4196
4197
4198
4199
4200
4201
4202
4203
4204
4205

4206
4207
4208
4209
4210

4211
4212
4213
4214
4215

4216
4217
4218
4219
4220

4221
4222
4223

4224
4225

4226
4227
4228
4229
4230

4231
4232
4233

4234
4235

4236
4237
4238
4239
4240
4241
4242
4243








+
+
+
+
+





-
-
-
-
-





-
-
-
-
-





-
+


-
+






+
+
+
+
+





-
-
-
-
-
-
-
+
+
+
+
+
+
+
















-
+




-
+




-
+




-
+


-
+

-
+




-
+


-
+

-
+








Desc     {Tcllib package}

Package {textutil::expander 1.3.1}
See   __textutil
Platform *
Desc     {Procedures to process templates and expand text.}

Package {textutil::string 0.8}
See   __textutil
Platform *
Desc     {Procedures to manipulate texts and strings.}

Package {textutil::tabify 0.7}
See   __textutil
Platform *
Desc     {Procedures to (un)tabify strings}

Package {textutil::string 0.8}
See   __textutil
Platform *
Desc     {Procedures to manipulate texts and strings.}

Package {textutil::adjust 0.7.3}
See   __textutil
Platform *
Desc     {Procedures to adjust, indent, and undent paragraphs}

Package {textutil::trim 0.7}
See   __textutil
Platform *
Desc     {Procedures to trim strings}

Package {textutil 0.9}
See   __textutil
Platform *
Desc     {Converts Markdown text to HTML}

Package {textutil::split 0.8}
Package {textutil::trim 0.7}
See   __textutil
Platform *
Desc     {Procedures to split texts}
Desc     {Procedures to trim strings}

Package {textutil::patch 0.1}
See   __textutil
Platform *
Desc     {Application of uni-diff patches to directory trees}

Package {textutil::split 0.8}
See   __textutil
Platform *
Desc     {Procedures to split texts}

#
# #################

# ############
# Module "tie"
# [1]    | "tie::std::growfile" (1.0)
# [2]    | "tie::std::array" (1.0)
# [3]    | "tie::std::file" (1.0.4)
# [4]    | "tie::std::dsource" (1.0)
# [5]    | "tie::std::rarray" (1.0.1)
# [6]    | "tie" (1.1)
# [7]    | "tie::std::log" (1.0)
# [1]    | "tie::std::growfile" (1.1)
# [2]    | "tie::std::array" (1.1)
# [3]    | "tie::std::file" (1.1)
# [4]    | "tie" (1.2)
# [5]    | "tie::std::dsource" (1.1)
# [6]    | "tie::std::rarray" (1.1)
# [7]    | "tie::std::log" (1.1)
# -------+

Package {__tie 0.0}
Platform *
Desc     {Tcl Data Structures}
Hidden
Base     @TAP_DIR@/tie
Path     pkgIndex.tcl
Path     tie.tcl
Path     tie_array.tcl
Path     tie_dsource.tcl
Path     tie_file.tcl
Path     tie_growfile.tcl
Path     tie_log.tcl
Path     tie_rarray.tcl

Package {tie::std::growfile 1.0}
Package {tie::std::growfile 1.1}
See   __tie
Platform *
Desc     {Array persistence, standard data sources}

Package {tie::std::array 1.0}
Package {tie::std::array 1.1}
See   __tie
Platform *
Desc     {Array persistence, standard data sources}

Package {tie::std::file 1.0.4}
Package {tie::std::file 1.1}
See   __tie
Platform *
Desc     {Array persistence, standard data sources}

Package {tie::std::dsource 1.0}
Package {tie 1.2}
See   __tie
Platform *
Desc     {Array persistence, standard data sources}
Desc     {Array persistence}

Package {tie::std::rarray 1.0.1}
Package {tie::std::dsource 1.1}
See   __tie
Platform *
Desc     {Array persistence, standard data sources}

Package {tie 1.1}
Package {tie::std::rarray 1.1}
See   __tie
Platform *
Desc     {Array persistence}
Desc     {Array persistence, standard data sources}

Package {tie::std::log 1.0}
Package {tie::std::log 1.1}
See   __tie
Platform *
Desc     {Array persistence, standard data sources}

#
# ############





︙


4398
4399
4400
4401
4402
4403
4404
4405

4406
4407
4408
4409
4410
4411
4412
4413
4414
4415

4416
4417
4418
4419
4420
4421
4422

4459
4460
4461
4462
4463
4464
4465

4466
4467
4468
4469
4470
4471
4472
4473
4474
4475

4476
4477
4478
4479
4480
4481
4482
4483








-
+









-
+








# Module "uri"
# [1]    | "uri" (1.2.7)
# [2]    | "uri::urn" (1.0.3)
# -------+

Package {__uri 0.0}
Platform *
Desc     {Tcl Web Server, Tcl Uniform Resource Identifier Management}
Desc     {Tcl Uniform Resource Identifier Management}
Hidden
Base     @TAP_DIR@/uri
Path     pkgIndex.tcl
Path     uri.tcl
Path     urn-scheme.tcl

Package {uri 1.2.7}
See   __uri
Platform *
Desc     {A TclOO and coroutine based web server}
Desc     {URI utilities}

Package {uri::urn 1.0.3}
See   __uri
Platform *
Desc     {URI utilities, URN scheme}

#




︙


4435
4436
4437
4438
4439
4440
4441
4442
4443


4444
4445
4446

4447
4448

4449
4450
4451
4452
4453
4454
4455

4496
4497
4498
4499
4500
4501
4502


4503
4504
4505
4506

4507
4508

4509
4510
4511
4512
4513
4514
4515
4516








-
-
+
+


-
+

-
+








Path     uuid.tcl

#
# #############

# ################
# Module "valtype"
# [1]    | "valtype::creditcard::mastercard" (1)
# [2]    | "valtype::usnpi" (1)
# [1]    | "valtype::usnpi" (1)
# [2]    | "valtype::creditcard::mastercard" (1)
# [3]    | "valtype::creditcard::discover" (1)
# [4]    | "valtype::common" (1)
# [5]    | "valtype::imei" (1)
# [5]    | "valtype::creditcard::visa" (1)
# [6]    | "valtype::isbn" (1)
# [7]    | "valtype::creditcard::visa" (1)
# [7]    | "valtype::imei" (1)
# [8]    | "valtype::creditcard::amex" (1)
# [9]    | "valtype::luhn" (1)
# [10]    | "valtype::gs1::ean13" (1)
# [11]    | "valtype::iban" (1.7)
# [12]    | "valtype::luhn5" (1)
# [13]    | "valtype::verhoeff" (1)
# -------+




︙


4470
4471
4472
4473
4474
4475
4476





4477
4478
4479
4480
4481
4482
4483
4484
4485
4486
4487
4488
4489
4490
4491
4492
4493
4494
4495
4496
4497

4498
4499
4500

4501
4502
4503
4504
4505
4506
4507

4508
4509
4510

4511
4512
4513
4514
4515
4516
4517

4531
4532
4533
4534
4535
4536
4537
4538
4539
4540
4541
4542
4543
4544
4545
4546
4547





4548
4549
4550
4551
4552
4553
4554
4555
4556
4557

4558
4559
4560

4561
4562
4563
4564
4565
4566
4567

4568
4569
4570

4571
4572
4573
4574
4575
4576
4577
4578








+
+
+
+
+





-
-
-
-
-










-
+


-
+






-
+


-
+








Path     luhn.tcl
Path     luhn5.tcl
Path     pkgIndex.tcl
Path     usnpi.tcl
Path     valtype.tcl
Path     verhoeff.tcl

Package {valtype::usnpi 1}
See   __valtype
Platform *
Desc     {Validation for USNPI}

Package {valtype::creditcard::mastercard 1}
See   __valtype
Platform *
Desc     {Validation for Mastercard creditcard number}

Package {valtype::usnpi 1}
See   __valtype
Platform *
Desc     {Validation for USNPI}

Package {valtype::creditcard::discover 1}
See   __valtype
Platform *
Desc     {Validation for Discover creditcard number}

Package {valtype::common 1}
See   __valtype
Platform *
Desc     {Validation, common code}

Package {valtype::imei 1}
Package {valtype::creditcard::visa 1}
See   __valtype
Platform *
Desc     {Validation for IMEI}
Desc     {Validation for VISA creditcard number}

Package {valtype::isbn 1}
See   __valtype
Platform *
Desc     {Validation for ISBN}

Package {valtype::creditcard::visa 1}
Package {valtype::imei 1}
See   __valtype
Platform *
Desc     {Validation for VISA creditcard number}
Desc     {Validation for IMEI}

Package {valtype::creditcard::amex 1}
See   __valtype
Platform *
Desc     {Validation for AMEX creditcard number}

Package {valtype::luhn 1}




︙


4543
4544
4545
4546
4547
4548
4549
4550
4551
4552
4553
4554





4555
4556
4557
4558
4559


4560
4561
4562
4563
4564
4565
4566

4604
4605
4606
4607
4608
4609
4610





4611
4612
4613
4614
4615
4616
4617
4618


4619
4620
4621
4622
4623
4624
4625
4626
4627








-
-
-
-
-
+
+
+
+
+



-
-
+
+








# ################

# #########################
# Module "virtchannel_base"
# [1]    | "tcl::chan::std" (1.0.1)
# [2]    | "tcl::chan::fifo" (1)
# [3]    | "tcl::chan::cat" (1.0.3)
# [4]    | "tcl::chan::halfpipe" (1.0.1)
# [5]    | "tcl::chan::random" (1)
# [6]    | "tcl::chan::memchan" (1.0.4)
# [7]    | "tcl::chan::null" (1)
# [8]    | "tcl::chan::nullzero" (1)
# [4]    | "tcl::chan::halfpipe" (1.0.2)
# [5]    | "tcl::chan::memchan" (1.0.4)
# [6]    | "tcl::chan::random" (1)
# [7]    | "tcl::chan::nullzero" (1)
# [8]    | "tcl::chan::null" (1)
# [9]    | "tcl::chan::facade" (1.0.1)
# [10]    | "tcl::randomseed" (1)
# [11]    | "tcl::chan::textwindow" (1)
# [12]    | "tcl::chan::fifo2" (1)
# [13]    | "tcl::chan::variable" (1.0.4)
# [12]    | "tcl::chan::variable" (1.0.4)
# [13]    | "tcl::chan::fifo2" (1)
# [14]    | "tcl::chan::string" (1.0.3)
# [15]    | "tcl::chan::zero" (1)
# -------+

Package {__virtchannel_base 0.0}
Platform *
Desc     {Reflected/virtual channel support}




︙


4594
4595
4596
4597
4598
4599
4600
4601

4602
4603
4604
4605
4606
4607
4608
4609
4610
4611
4612
4613
4614
4615
4616

4617
4618
4619

4620
4621
4622
4623
4624





4625
4626
4627
4628
4629
4630
4631
4632
4633
4634
4635
4636
4637
4638
4639
4640





4641
4642
4643
4644
4645
4646
4647
4648
4649
4650
4651
4652
4653
4654
4655
4656
4657

4655
4656
4657
4658
4659
4660
4661

4662
4663
4664
4665
4666





4667
4668
4669
4670
4671

4672
4673
4674

4675
4676
4677
4678
4679
4680
4681
4682
4683
4684
4685
4686
4687
4688
4689
4690
4691
4692
4693
4694
4695
4696
4697
4698
4699
4700
4701
4702
4703
4704
4705
4706
4707
4708
4709
4710
4711





4712
4713
4714
4715
4716
4717
4718








-
+




-
-
-
-
-





-
+


-
+





+
+
+
+
+
















+
+
+
+
+





-
-
-
-
-








Desc     {In-memory fifo channel}

Package {tcl::chan::cat 1.0.3}
See   __virtchannel_base
Platform *
Desc     {Concatenation channel}

Package {tcl::chan::halfpipe 1.0.1}
Package {tcl::chan::halfpipe 1.0.2}
See   __virtchannel_base
Platform *
Desc     {In-memory channel, half of a fifo2}

Package {tcl::chan::random 1}
See   __virtchannel_base
Platform *
Desc     {Random channel}

Package {tcl::chan::memchan 1.0.4}
See   __virtchannel_base
Platform *
Desc     {In-memory channel}

Package {tcl::chan::null 1}
Package {tcl::chan::random 1}
See   __virtchannel_base
Platform *
Desc     {Null channel}
Desc     {Random channel}

Package {tcl::chan::nullzero 1}
See   __virtchannel_base
Platform *
Desc     {Null/Zero channel combination}

Package {tcl::chan::null 1}
See   __virtchannel_base
Platform *
Desc     {Null channel}

Package {tcl::chan::facade 1.0.1}
See   __virtchannel_base
Platform *
Desc     {Facade channel}

Package {tcl::randomseed 1}
See   __virtchannel_base
Platform *
Desc     {Utilities for random channels}

Package {tcl::chan::textwindow 1}
See   __virtchannel_base
Platform *
Desc     {Textwindow channel}

Package {tcl::chan::variable 1.0.4}
See   __virtchannel_base
Platform *
Desc     {In-memory channel using variable for storage}

Package {tcl::chan::fifo2 1}
See   __virtchannel_base
Platform *
Desc     {In-memory interconnected fifo channels}

Package {tcl::chan::variable 1.0.4}
See   __virtchannel_base
Platform *
Desc     {In-memory channel using variable for storage}

Package {tcl::chan::string 1.0.3}
See   __virtchannel_base
Platform *
Desc     {Read-only in-memory channel}

Package {tcl::chan::zero 1}
See   __virtchannel_base




︙


4695
4696
4697
4698
4699
4700
4701
4702
4703


4704
4705
4706
4707
4708
4709


4710
4711
4712
4713
4714
4715
4716

4756
4757
4758
4759
4760
4761
4762


4763
4764
4765
4766
4767
4768


4769
4770
4771
4772
4773
4774
4775
4776
4777








-
-
+
+




-
-
+
+









#
# #########################

# ##############################
# Module "virtchannel_transform"
# [1]    | "tcl::transform::zlib" (1.0.1)
# [2]    | "tcl::transform::limitsize" (1)
# [3]    | "tcl::transform::identity" (1)
# [2]    | "tcl::transform::identity" (1)
# [3]    | "tcl::transform::limitsize" (1)
# [4]    | "tcl::transform::otp" (1)
# [5]    | "tcl::transform::base64" (1)
# [6]    | "tcl::transform::crc32" (1)
# [7]    | "tcl::transform::rot" (1)
# [8]    | "tcl::transform::adler32" (1)
# [9]    | "tcl::transform::hex" (1)
# [8]    | "tcl::transform::hex" (1)
# [9]    | "tcl::transform::adler32" (1)
# [10]    | "tcl::transform::spacer" (1)
# [11]    | "tcl::transform::observe" (1)
# [12]    | "tcl::transform::counter" (1)
# -------+

Package {__virtchannel_transform 0.0}
Platform *




︙


4731
4732
4733
4734
4735
4736
4737





4738
4739
4740
4741
4742
4743
4744
4745
4746
4747
4748
4749
4750
4751
4752
4753
4754
4755
4756
4757
4758
4759
4760
4761
4762
4763
4764
4765
4766
4767
4768





4769
4770
4771
4772
4773
4774
4775
4776
4777
4778
4779
4780
4781
4782
4783
4784
4785
4786
4787
4788
4789
4790
4791
4792
4793
4794
4795
4796
4797
4798
4799

4800
4801
4802

4803
4804

4805
4806
4807
4808
4809
4810
4811

4792
4793
4794
4795
4796
4797
4798
4799
4800
4801
4802
4803
4804
4805
4806
4807
4808
4809





4810
4811
4812
4813
4814
4815
4816
4817
4818
4819
4820
4821
4822
4823
4824
4825
4826
4827
4828
4829
4830
4831
4832
4833
4834
4835
4836
4837
4838
4839





4840
4841
4842
4843
4844
4845
4846
4847
4848
4849
4850
4851
4852
4853
4854
4855
4856
4857
4858
4859

4860
4861
4862

4863
4864

4865
4866
4867
4868
4869
4870
4871
4872








+
+
+
+
+






-
-
-
-
-




















+
+
+
+
+





-
-
-
-
-




















-
+


-
+

-
+








Path     spacer.tcl
Path     zlib.tcl

Package {tcl::transform::zlib 1.0.1}
See   __virtchannel_transform
Platform *
Desc     {zlib (de)compression}

Package {tcl::transform::identity 1}
See   __virtchannel_transform
Platform *
Desc     {Identity transformation}

Package {tcl::transform::limitsize 1}
See   __virtchannel_transform
Platform *
Desc     {limiting input}

Package {tcl::transform::identity 1}
See   __virtchannel_transform
Platform *
Desc     {Identity transformation}

Package {tcl::transform::otp 1}
See   __virtchannel_transform
Platform *
Desc     {Encryption via one-time pad}

Package {tcl::transform::base64 1}
See   __virtchannel_transform
Platform *
Desc     {Base64 encoding transformation}

Package {tcl::transform::crc32 1}
See   __virtchannel_transform
Platform *
Desc     {Crc32 transformation}

Package {tcl::transform::rot 1}
See   __virtchannel_transform
Platform *
Desc     {rot-encryption}

Package {tcl::transform::hex 1}
See   __virtchannel_transform
Platform *
Desc     {Hexadecimal encoding transformation}

Package {tcl::transform::adler32 1}
See   __virtchannel_transform
Platform *
Desc     {Adler32 transformation}

Package {tcl::transform::hex 1}
See   __virtchannel_transform
Platform *
Desc     {Hexadecimal encoding transformation}

Package {tcl::transform::spacer 1}
See   __virtchannel_transform
Platform *
Desc     {Space insertation and removal}

Package {tcl::transform::observe 1}
See   __virtchannel_transform
Platform *
Desc     {Observer transformation, stream copy}

Package {tcl::transform::counter 1}
See   __virtchannel_transform
Platform *
Desc     {Counter transformation}

#
# ##############################

# ##################
# Module "websocket"
# [1]    | "websocket" (1.4.1)
# [1]    | "websocket" (1.4.2)
# -------+

Package {websocket 1.4.1}
Package {websocket 1.4.2}
Platform *
Desc     {A TclOO and coroutine based web server}
Desc     {Tcl implementation of the websocket protocol}
Base     @TAP_DIR@/websocket
Path     pkgIndex.tcl
Path     websocket.tcl

#
# ##################





︙


4836
4837
4838
4839
4840
4841
4842
4843

4844
4845
4846
4847
4848
4849
4850
4851
4852
4853
4854
4855
4856
4857
4858
4859
4860
4861
4862
4863

4864
4865
4866
4867
4868
4869
4870
4871
4872
4873
4874
4875
4876
4877
4878
4879
4880

4881
4882
4883
4884
4885
4886
4887

4897
4898
4899
4900
4901
4902
4903

4904
4905
4906
4907
4908
4909
4910
4911
4912
4913
4914
4915
4916
4917
4918
4919
4920
4921
4922
4923

4924
4925
4926
4927
4928
4929
4930
4931
4932
4933
4934
4935
4936
4937
4938
4939
4940

4941
4942
4943
4944
4945
4946
4947
4948








-
+



















-
+
















-
+









#
# ############

# #############
# Module "yaml"
# [1]    | "huddle::json" (0.1)
# [2]    | "huddle" (0.3)
# [2]    | "huddle" (0.4)
# [3]    | "yaml" (0.4.1)
# -------+

Package {__yaml 0.0}
Platform *
Desc     {YAML processing, HUDDLE}
Hidden
Base     @TAP_DIR@/yaml
Path     huddle.tcl
Path     huddle_types.tcl
Path     json2huddle.tcl
Path     pkgIndex.tcl
Path     yaml.tcl

Package {huddle::json 0.1}
See   __yaml
Platform *
Desc     {Tcllib package}

Package {huddle 0.3}
Package {huddle 0.4}
See   __yaml
Platform *
Desc     {Create and manipulate huddle object}

Package {yaml 0.4.1}
See   __yaml
Platform *
Desc     {YAML Format Encoder/Decoder}

#
# #############

# ############
# Module "zip"
# [1]    | "zipfile::encode" (0.4)
# [2]    | "zipfile::mkzip" (1.2.1)
# [3]    | "zipfile::decode" (0.7.1)
# [3]    | "zipfile::decode" (0.9)
# -------+

Package {__zip 0.0}
Platform *
Desc     {Zip archive creation, Zip archive handling}
Hidden
Base     @TAP_DIR@/zip




︙


4896
4897
4898
4899
4900
4901
4902
4903

4904
4905
4906
4907
4908
4909
4910
4911
4912
4913
4914
4915

4957
4958
4959
4960
4961
4962
4963

4964
4965
4966
4967
4968
4969
4970
4971
4972
4973
4974
4975
4976








-
+













Desc     {Generation of zip archives}

Package {zipfile::mkzip 1.2.1}
See   __zip
Platform *
Desc     {Build a zip archive}

Package {zipfile::decode 0.7.1}
Package {zipfile::decode 0.9}
See   __zip
Platform *
Desc     {Access to zip archives}

#
# ############

#
##
###
#####
########






Changes to tcllib.yml.





1
2

3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20


1

2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

20


-
+

















-
+

dist_id: tcllib
version: 1.20
version: 1.21
language: tcl
description: |
   This package is intended to be a collection of Tcl packages that provide
   utility functions useful to a large collection of Tcl programmers.

   The home web site for this code is http://core.tcl.tk/tcllib/.
   At this web site, you will find mailing lists, web forums, databases
   for bug reports and feature requests, the CVS repository (browsable
   on the web, or read-only accessible via CVS ), and more.

categories: 
  - Library/Utility
  - Library/Mail
  - Library/Cryptography
  - Library/Math
license: BSD
owner_id: AndreasKupries
wrapped_content: tcllib-1.20/
wrapped_content: tcllib-1.21/









This page was generated in about
0.258s by
Fossil 2.27 [a6d506ecc4] 2025-07-09 13:52:53