Tcl Library Source Code

Check-in [945be77637]
Login

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

Overview
Comment:Merge latest work done on markdown generator (tocs, xrefs).
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | doc-fixup-and-markdown-localdoc
Files: files | file ages | folders
SHA3-256: 945be7763782d503522609a5c00362e5733ffa42856b7c22a8a4c2411c3b2a14
User & Date: aku 2019-03-20 23:39:19.477
Context
2019-03-21
01:48
Fixed forgotten reset of md comment counter between documents. Fixed missing md extension declaration in the localdoc implementation. check-in: 945b80356c user: aku tags: doc-fixup-and-markdown-localdoc
2019-03-20
23:39
Merge latest work done on markdown generator (tocs, xrefs). check-in: 945be77637 user: aku tags: doc-fixup-and-markdown-localdoc
22:57
Markdown: Implemented document cross references, and added refs to the per-page synopses. check-in: a8b930a4d3 user: aku tags: doc-fixup-and-markdown
2019-03-19
18:40
Switch embedded docs over to markdown. Drop lots of superfluous trailing whitespace. check-in: 56ca2fa4d9 user: andreask tags: doc-fixup-and-markdown-localdoc
Changes
Unified Diff Ignore Whitespace Patch
Changes to modules/doctools/mpformats/_common.tcl.
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

######################################################################
# Cross-reference tracking (for a single file).
#
global SectionNames	;# array mapping 'section name' to 'reference id'
global SectionList      ;# List of sections, their ids, and levels, in
set    SectionList {}   ;# order of definition.











# sectionId --
#	Format section name as an XML ID.
#
proc c_sectionId {name} {
    # Identical to '__sid' in checker.tcl
    regsub -all {[ 	]+} [string tolower [string trim $name]] _ id
    regsub -all {"} $id _ id ; # "
    return $id
}

# possibleReference text gi --
#	Check if $text is a potential cross-reference;
#	if so, format as a reference;
#	otherwise format as a $gi element.
#
proc c_possibleReference {text gi {label {}}} {
    global SectionNames







>
>
>
>
>
>
>
>
>
>










|







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

######################################################################
# Cross-reference tracking (for a single file).
#
global SectionNames	;# array mapping 'section name' to 'reference id'
global SectionList      ;# List of sections, their ids, and levels, in
set    SectionList {}   ;# order of definition.

proc c_sections {} {
    global SectionList
    set    SectionList
}

proc c_sectionKnown {id} {
    global SectionNames
    info exists SectionNames($id)
}

# sectionId --
#	Format section name as an XML ID.
#
proc c_sectionId {name} {
    # Identical to '__sid' in checker.tcl
    regsub -all {[ 	]+} [string tolower [string trim $name]] _ id
    regsub -all {"} $id _ id ; # "
    return $id
}
    
# possibleReference text gi --
#	Check if $text is a potential cross-reference;
#	if so, format as a reference;
#	otherwise format as a $gi element.
#
proc c_possibleReference {text gi {label {}}} {
    global SectionNames
Changes to modules/doctools/mpformats/_html.tcl.
109
110
111
112
113
114
115

116
117
118
119
120
121
122
proc use_bg {} {
    set c [bgcolor]
    #puts stderr "using $c"
    if {$c == {}} {return ""}
    return bgcolor=$c
}



proc nbsp   {}         {return [markup " "]}
proc p      {}         {return [markup <p>]}
proc ptop   {}         {return [markup "<p valign=top>"]}
proc td     {}         {return [markup "<td [use_bg]>"]}
proc trtop  {}         {return [markup "<tr valign=top [use_bg]>"]}
proc tr     {}         {return [markup "<tr            [use_bg]>"]}







>







109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
proc use_bg {} {
    set c [bgcolor]
    #puts stderr "using $c"
    if {$c == {}} {return ""}
    return bgcolor=$c
}

proc MakeLink {l t} { link $l $t }

proc nbsp   {}         {return [markup "&nbsp;"]}
proc p      {}         {return [markup <p>]}
proc ptop   {}         {return [markup "<p valign=top>"]}
proc td     {}         {return [markup "<td [use_bg]>"]}
proc trtop  {}         {return [markup "<tr valign=top [use_bg]>"]}
proc tr     {}         {return [markup "<tr            [use_bg]>"]}
Changes to modules/doctools/mpformats/_markdown.tcl.
39
40
41
42
43
44
45




46
47
48
49
50
51
52
53
54
55
56
57



























58
59
60
61
    upvar 1 $lb lines
    lappend lines "#### $title"
    return
}

proc Strong {text} { return __${text}__ }
proc Em     {text} { return *${text}* }





set __comments 0

proc MDComment {text} {
    global __comments
    Text "\n\[//[format %09d [incr __comments]]\]: # ($text)"
}

proc MDCDone {} {
    TextTrimLeadingSpace
    CloseParagraph [Verbatim]
}




























##
# # ## ### ##### ########
return







>
>
>
>












>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>




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
    upvar 1 $lb lines
    lappend lines "#### $title"
    return
}

proc Strong {text} { return __${text}__ }
proc Em     {text} { return *${text}* }

##
# # ## ### ##### ########
##

set __comments 0

proc MDComment {text} {
    global __comments
    Text "\n\[//[format %09d [incr __comments]]\]: # ($text)"
}

proc MDCDone {} {
    TextTrimLeadingSpace
    CloseParagraph [Verbatim]
}

##
# # ## ### ##### ########
##

proc MakeLink {l t} { ALink $t $l } ;# - xref - todo: consolidate

proc ALink {dst label} { return "\[$label]($dst)" }

proc SetAnchor {text {name {}}} {
    if {$name == {}} { set name [Anchor $text] }
    return "<a name='$name'></a>$text"
}

proc Anchor {text} {
    global kwid
    if {[info exists kwid($text)]} {
	return "$kwid($text)"
    }
    return [A $text]
}

proc A {text} {
    set anchor [regsub -all {[^a-zA-Z0-9]} [string tolower $text] {_}]
    set anchor [regsub -all {__+} $anchor _]
    return $anchor
}

##
# # ## ### ##### ########
return
Changes to modules/doctools/mpformats/_text_ccore.tcl.
47
48
49
50
51
52
53


54
55
56
57
58
59
60

    #puts_stderr "--Set ($id) ([CAttrName $id])"

    # Ensure that array is clean before setting hte new block of
    # information.
    unset     currentContext
    array set currentContext $contextData($currentHandle)


    return
}

proc ContextExists {id} {
    global contextData
    info exists contextData($id)
}







>
>







47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

    #puts_stderr "--Set ($id) ([CAttrName $id])"

    # Ensure that array is clean before setting hte new block of
    # information.
    unset     currentContext
    array set currentContext $contextData($currentHandle)

    #puts_stderr "--Set $contextData($currentHandle)"
    return
}

proc ContextExists {id} {
    global contextData
    info exists contextData($id)
}
Changes to modules/doctools/mpformats/_text_dlist.tcl.
103
104
105
106
107
108
109

110
111
112
113
114
115
116
proc ListNone     {} { CAttrSet listtype {} }
proc MarginIn     {} { CAttrIncr lmargin [LMI] }
proc MarginReset  {} { CAttrSet lmargin 0 }
proc PrefixReset  {} { CAttrSet prefix {} }
proc WPrefixReset {} { CAttrSet wspfx {} }

proc Prefix!   {p} { CAttrSet prefix $p }

proc WPrefix!  {p} { CAttrSet wspfx  $p }

proc Bullet?   {} { CAttrGet bullet }
proc ListType? {} { CAttrGet listtype }
proc Margin?   {} { CAttrGet lmargin }
proc Prefix?   {} { CAttrGet prefix }
proc WPrefix?  {} { CAttrGet wspfx }







>







103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
proc ListNone     {} { CAttrSet listtype {} }
proc MarginIn     {} { CAttrIncr lmargin [LMI] }
proc MarginReset  {} { CAttrSet lmargin 0 }
proc PrefixReset  {} { CAttrSet prefix {} }
proc WPrefixReset {} { CAttrSet wspfx {} }

proc Prefix!   {p} { CAttrSet prefix $p }
proc Prefix+   {p} { CAttrAppend prefix $p }
proc WPrefix!  {p} { CAttrSet wspfx  $p }

proc Bullet?   {} { CAttrGet bullet }
proc ListType? {} { CAttrGet listtype }
proc Margin?   {} { CAttrGet lmargin }
proc Prefix?   {} { CAttrGet prefix }
proc WPrefix?  {} { CAttrGet wspfx }
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
    # Note. As the display list is processed at the very end we can
    # reuse the current context and accessors to hold and query the
    # context of each paragraph.
    
    foreach {env text} $arguments break
    ContextSet $env

    #puts_stderr "PARA $env"
    #parray_stderr ::currentEnv
    #puts_stderr "    (($text))"
    #puts_stderr ""

    # Use the information in the referenced context to format the
    # paragraph.








|







182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
    # Note. As the display list is processed at the very end we can
    # reuse the current context and accessors to hold and query the
    # context of each paragraph.
    
    foreach {env text} $arguments break
    ContextSet $env

    #puts_stderr "PARA $env [CAttrName $env]"
    #parray_stderr ::currentEnv
    #puts_stderr "    (($text))"
    #puts_stderr ""

    # Use the information in the referenced context to format the
    # paragraph.

Changes to modules/doctools/mpformats/_text_para.tcl.
9
10
11
12
13
14
15



16


17
18
19
20
21
22
23
24
25
## State: Text buffer for paragraphs.

global __currentp

# # ## ### ##### ########
## API




proc Text      {text} { global __currentp ; append __currentp $text ; return }


proc Text?     {}     { global __currentp ; return $__currentp }
proc TextClear {}     { global __currentp ; set __currentp "" }

proc TextTrimLeadingSpace {} {
    global __currentp
    regsub {^([ \t\v\f]*\n)*} $__currentp {} __currentp
    return
}








>
>
>
|
>
>
|
|







9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
## State: Text buffer for paragraphs.

global __currentp

# # ## ### ##### ########
## API

proc Text {text} {
    #puts_stderr "T++ (($text))"
    global __currentp
    append __currentp $text
    return
}
proc Text?     {} { global __currentp ; return $__currentp }
proc TextClear {} { global __currentp ; set __currentp "" }

proc TextTrimLeadingSpace {} {
    global __currentp
    regsub {^([ \t\v\f]*\n)*} $__currentp {} __currentp
    return
}

44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

    if {[string length [string trim $text]] == 0} return

    Text $text
    return
}

#return
# # ## ### ##### ########
## Debugging

proc Text {text} {
    #puts_stderr "T++ (($text))"
    global __currentp
    append __currentp $text
    return
}







|

<
<
<
<
<
<
|
<
49
50
51
52
53
54
55
56
57






58


    if {[string length [string trim $text]] == 0} return

    Text $text
    return
}

##
# # ## ### ##### ########






return

Added modules/doctools/mpformats/_xref.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
# -*- tcl -*-
##
# Shared code for the management of cross-references between
# documents. Origin in HTML. Other user: Markdown.
#
# Copyright (c) 2001,2019 Andreas Kupries <[email protected]>

# Hook:
# - MakeLink {label target} - Format specific
# - GetXref                 - Engine parameter access

# # ## ### ##### ######## ############# #####################
## API

proc XrefInit {} {
    global xref
    foreach item [GetXref] {
	foreach {pattern fname fragment} $item break
	set fname_ref [dt_fmap $fname]
	if {$fragment != {}} {append fname_ref #$fragment}
	set xref($pattern) $fname_ref
    }
    proc XrefInit {} {}
    return
}

proc XrefMatch {word args} {
    global xref

    foreach ext $args {
	if {$ext != {}} {
	    if {[info exists xref($ext,$word)]} {
		return [XrefLink $xref($ext,$word) $word]
	    }
	}
    }
    if {[info exists xref($word)]} {
	return [XrefLink $xref($word) $word]
    }

    # Convert the word to all-lower case and then try again.

    set lword [string tolower $word]

    foreach ext $args {
	if {$ext != {}} {
	    if {[info exists xref($ext,$lword)]} {
		return [XrefLink $xref($ext,$lword) $word]
	    }
	}
    }
    if {[info exists xref($lword)]} {
	return [XrefLink $xref($lword) $word]
    }

    return $word
}

proc XrefList {list {ext {}}} {
    set res [list]
    foreach w $list {lappend res [XrefMatch $w $ext]}
    return $res
}

proc XrefLink {dest label} {
    # Ensure that the link is properly done relative to this file!

    set here [LinkHere]
    set dest [LinkTo $dest $here]

    if {[string equal $dest [lindex [file split $here] end]]} {
	# Suppress self-referential links, i.e. links made from the
	# current file to itself. Note that links to specific parts of
	# the current file are not suppressed, only exact links.
	return $label
    }
    return [MakeLink $label $dest]
}

# # ## ### ##### ######## ############# #####################
## Internals

proc LinkHere {} {
    return [dt_fmap [dt_mainfile]]
}

proc LinkTo {dest here} {
    # Ensure that the link is properly done relative to this file!

    set save $dest

    #puts_stderr "XrefLink $dest $label"

    set here [file split $here]
    set dest [file split $dest]

    #puts_stderr "XrefLink < $here"
    #puts_stderr "XrefLink > $dest"

    while {[string equal [lindex $dest 0] [lindex $here 0]]} {
	set dest [lrange $dest 1 end]
	set here [lrange $here 1 end]
	if {[llength $dest] == 0} {break}
    }
    set ul [llength $dest]
    set hl [llength $here]

    if {$ul == 0} {
	set dest [lindex [file split $save] end]
    } else {
	while {$hl > 1} {
	    set dest [linsert $dest 0 ..]
	    incr hl -1
	}
	set dest [eval file join $dest]
    }

    #puts_stderr "XrefLink --> $dest"
    return $dest
}

# # ## ### ##### ######## ############# #####################
## State

global xref ; array set xref {}

##
# # ## ### ##### ######## ############# #####################
return
Changes to modules/doctools/mpformats/fmt.html.
8
9
10
11
12
13
14

15
16
17
18
19
20
21
# a manpage based upon HTML markup.
#
################################################################
################################################################

dt_source _common.tcl   ; # Shared code
dt_source _html.tcl     ; # HTML basic formatting


proc c_copyrightsymbol {} {return "[markup "&"]copy;"}

proc bgcolor {} {return ""}
proc border  {} {return 0}
proc Year    {} {clock format [clock seconds] -format %Y}








>







8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# a manpage based upon HTML markup.
#
################################################################
################################################################

dt_source _common.tcl   ; # Shared code
dt_source _html.tcl     ; # HTML basic formatting
dt_source _xref.tcl     ; # xref management

proc c_copyrightsymbol {} {return "[markup "&"]copy;"}

proc bgcolor {} {return ""}
proc border  {} {return 0}
proc Year    {} {clock format [clock seconds] -format %Y}

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
    c_newSection {Table Of Contents} 1 0 toc

    if {[llength [c_xref_seealso]]  > 0} {c_newSection {See Also} 1 end see-also}
    if {[llength [c_xref_keywords]] > 0} {c_newSection Keywords   1 end keywords}
    if {[c_xref_category]         ne ""} {c_newSection Category   1 end category}
    if {[c_get_copyright]         != {}} {c_newSection Copyright  1 end copyright}

    set sections $::SectionList

    # Pass 2: Generate the markup for the TOC, indenting the
    #         links according to the level of each section.

    append result [fmt_section {Table Of Contents} toc] [para_close] \n
    append result [taga ul {class doctools_toc}] \n

    set lastlevel 1
    set close 0
    foreach {name id level} $sections {
	# level in {1,2}, 1 = sectio n, 2 = subsection
	if {$level == $lastlevel} {
	    # Close previous item.
	    if {$close} { append result [tag/ li] \n }
	} elseif {$level > $lastlevel} {
	    # Start list of subsections
	    append result \n [tag ul] \n
	} else { # level < lastlevel







|










|







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
    c_newSection {Table Of Contents} 1 0 toc

    if {[llength [c_xref_seealso]]  > 0} {c_newSection {See Also} 1 end see-also}
    if {[llength [c_xref_keywords]] > 0} {c_newSection Keywords   1 end keywords}
    if {[c_xref_category]         ne ""} {c_newSection Category   1 end category}
    if {[c_get_copyright]         != {}} {c_newSection Copyright  1 end copyright}

    set sections [c_sections]

    # Pass 2: Generate the markup for the TOC, indenting the
    #         links according to the level of each section.

    append result [fmt_section {Table Of Contents} toc] [para_close] \n
    append result [taga ul {class doctools_toc}] \n

    set lastlevel 1
    set close 0
    foreach {name id level} $sections {
	# level in {1,2}, 1 = section, 2 = subsection
	if {$level == $lastlevel} {
	    # Close previous item.
	    if {$close} { append result [tag/ li] \n }
	} elseif {$level > $lastlevel} {
	    # Start list of subsections
	    append result \n [tag ul] \n
	} else { # level < lastlevel
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
proc fmt_arg  {text} { italic $text                arg }
proc fmt_cmd  {text} { bold   [XrefMatch $text sa] cmd }
proc fmt_emph {text} { em     $text }
proc fmt_opt  {text} { span   "?$text?" opt }

proc fmt_comment {text} {ht_comment $text}
proc fmt_sectref {title {id {}}} {
    global SectionNames
    if {$id == {}} {
	set id [c_sectionId $title]
    }
    if {[info exists SectionNames($id)]} {
    	return [span [link $title "#$id"] sectref]
    } else {
	return [bold $title sectref]
    }
}

proc fmt_syscmd  {text} {bold [XrefMatch $text sa] syscmd}







<
|
<
|
|







366
367
368
369
370
371
372

373

374
375
376
377
378
379
380
381
382
proc fmt_arg  {text} { italic $text                arg }
proc fmt_cmd  {text} { bold   [XrefMatch $text sa] cmd }
proc fmt_emph {text} { em     $text }
proc fmt_opt  {text} { span   "?$text?" opt }

proc fmt_comment {text} {ht_comment $text}
proc fmt_sectref {title {id {}}} {

    if {$id == {}} { set id [c_sectionId $title] }


    if {[c_sectionKnown $id]} {
    	return [span [link $title "#$id"] sectref]
    } else {
	return [bold $title sectref]
    }
}

proc fmt_syscmd  {text} {bold [XrefMatch $text sa] syscmd}
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
    if {!$para_is_open} {return ""}
    set para_is_open 0
    return [tag/ p]
}

################################################################

global xref ; array set xref {}

global    __var
array set __var {
    meta   {}
    header {}
    footer {}
    xref   {}







|







503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
    if {!$para_is_open} {return ""}
    set para_is_open 0
    return [tag/ p]
}

################################################################

proc GetXref {} { Get xref } ;# xref access to engine parameters

global    __var
array set __var {
    meta   {}
    header {}
    footer {}
    xref   {}
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
    UL.doctools_requirements {
	margin-bottom: 	1em;
	border-bottom:	1px solid black;
    }
}

################################################################

proc XrefInit {} {
    global xref __var
    foreach item $__var(xref) {
	foreach {pattern fname fragment} $item break
	set fname_ref [dt_fmap $fname]
	if {$fragment != {}} {append fname_ref #$fragment}
	set xref($pattern) $fname_ref
    }
    proc XrefInit {} {}
    return
}

proc XrefMatch {word args} {
    global xref

    foreach ext $args {
	if {$ext != {}} {
	    if {[info exists xref($ext,$word)]} {
		return [XrefLink $xref($ext,$word) $word]
	    }
	}
    }
    if {[info exists xref($word)]} {
	return [XrefLink $xref($word) $word]
    }

    # Convert the word to all-lower case and then try again.

    set lword [string tolower $word]

    foreach ext $args {
	if {$ext != {}} {
	    if {[info exists xref($ext,$lword)]} {
		return [XrefLink $xref($ext,$lword) $word]
	    }
	}
    }
    if {[info exists xref($lword)]} {
	return [XrefLink $xref($lword) $word]
    }

    return $word
}

proc XrefList {list {ext {}}} {
    set res [list]
    foreach w $list {lappend res [XrefMatch $w $ext]}
    return $res
}

proc LinkHere {} {
    return [dt_fmap [dt_mainfile]]
}

proc LinkTo {dest here} {
    # Ensure that the link is properly done relative to this file!

    set save $dest

    #puts_stderr "XrefLink $dest $label"

    set here [file split $here]
    set dest [file split $dest]

    #puts_stderr "XrefLink < $here"
    #puts_stderr "XrefLink > $dest"

    while {[string equal [lindex $dest 0] [lindex $here 0]]} {
	set dest [lrange $dest 1 end]
	set here [lrange $here 1 end]
	if {[llength $dest] == 0} {break}
    }
    set ul [llength $dest]
    set hl [llength $here]

    if {$ul == 0} {
	set dest [lindex [file split $save] end]
    } else {
	while {$hl > 1} {
	    set dest [linsert $dest 0 ..]
	    incr hl -1
	}
	set dest [eval file join $dest]
    }

    #puts_stderr "XrefLink --> $dest"
    return $dest
}

proc XrefLink {dest label} {
    # Ensure that the link is properly done relative to this file!

    set here [LinkHere]
    set dest [LinkTo $dest $here]

    if {[string equal $dest [lindex [file split $here] end]]} {
	# Suppress self-referential links, i.e. links made from the
	# current file to itself. Note that links to specific parts of
	# the current file are not suppressed, only exact links.
	return $label
    }
    return [link $label $dest]
}







<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
627
628
629
630
631
632
633








































































































    UL.doctools_requirements {
	margin-bottom: 	1em;
	border-bottom:	1px solid black;
    }
}

################################################################








































































































Changes to modules/doctools/mpformats/fmt.markdown.
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
# -*- tcl -*-
# Convert a doctools document into markdown formatted text
#
# Copyright (c) 2019 Andreas Kupries <[email protected]>

# Note: While markdown is a text format its intended target is HTML,
# making its formatting nearer to that with the ability to set anchors
# and refer to them, linkage in general.

# TODO: Table of contents, section linkage
# TODO: Synopsis command linkage
# TODO: package - xref
# TODO: syscmd - xref
# TODO: cmd - xref
# TODO: term -xref
# TODO: see also, keywords - xref

# # ## ### ##### ######## #############
## Load shared code and modify it to our needs.

dt_source _common.tcl
dt_source _text.tcl
dt_source fmt.text
dt_source _markdown.tcl


rename PostProcess PostProcessT
proc PostProcess {text} {
    string map [list [LB] "  \n"] [PostProcessT $text]
}

proc LB  {} { return "\1\n" }
proc LB. {} { return "\1" }

# # ## ### ##### ########
## Override crucial parts of the regular text formatter











proc NewExample {} {
    return [ContextNew Example {
	VerbatimOn ; Example! ; Prefix! "    "
    }] ; # {}
}

proc NewUnorderedList {} {
    # Itemized list - unordered list - bullet
    # 1. Base context provides indentation.
    # 2. First paragraph in a list item.
    # 3. All other paragraphs.
    ContextPush




    set base [ContextNew Itemized {
	set bullet "[WPrefix?]  [IBullet]"


    }] ; # {}




    set first [ContextNew First {
	List! bullet $bullet [set ws "[BlankM $bullet] "]
    }] ; ContextSet $base ; # {}

    set next [ContextNew Next {
	WPrefix! $ws
	Prefix!  $ws
    }] ; ContextSet $base ; # {}










<
<
<
<
<
<
<
<







>











>
>
>
>
>
>
>
>
>
>



|









>
>
>
>

|
>
>


>
>
>

|







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
# -*- tcl -*-
# Convert a doctools document into markdown formatted text
#
# Copyright (c) 2019 Andreas Kupries <[email protected]>

# Note: While markdown is a text format its intended target is HTML,
# making its formatting nearer to that with the ability to set anchors
# and refer to them, linkage in general.









# # ## ### ##### ######## #############
## Load shared code and modify it to our needs.

dt_source _common.tcl
dt_source _text.tcl
dt_source fmt.text
dt_source _markdown.tcl
dt_source _xref.tcl

rename PostProcess PostProcessT
proc PostProcess {text} {
    string map [list [LB] "  \n"] [PostProcessT $text]
}

proc LB  {} { return "\1\n" }
proc LB. {} { return "\1" }

# # ## ### ##### ########
## Override crucial parts of the regular text formatter

proc In? {} {
    if {![CAttrHas mdindent]} {
	CAttrSet mdindent ""
    }
    CAttrGet mdindent
}
proc In! {ws} {
    CAttrSet mdindent $ws
}

proc NewExample {} {
    return [ContextNew Example {
	VerbatimOn ; Example! ; Prefix+ "    "
    }] ; # {}
}

proc NewUnorderedList {} {
    # Itemized list - unordered list - bullet
    # 1. Base context provides indentation.
    # 2. First paragraph in a list item.
    # 3. All other paragraphs.
    ContextPush

    #puts_stderr "UL [CAttrName]"
    #puts_stderr "UL |[string map {{ } _} [In?]]|outer"

    set base [ContextNew Itemized {
	set bullet "[In?]  [IBullet]"
	set ws     "[BlankM $bullet] "
	In! $ws
    }] ; # {}

    #puts_stderr "UL |[string map {{ } _} $bullet]|[string length $bullet]"
    #puts_stderr "UL |[string map {{ } _} $ws]|[string length $ws]"

    set first [ContextNew First {
	List! bullet $bullet $ws
    }] ; ContextSet $base ; # {}

    set next [ContextNew Next {
	WPrefix! $ws
	Prefix!  $ws
    }] ; ContextSet $base ; # {}

69
70
71
72
73
74
75
76



77
78


79
80



81
82
83
84
85
86
87
88
89

proc NewOrderedList {} {
    # Ordered list - enumeration - enum
    # 1. Base context provides indentation.
    # 2. First paragraph in a list item.
    # 3. All other paragraphs.
    ContextPush
    



    set base [ContextNew Enumerated {
	set bullet "[WPrefix?]  [EBullet]"


    }] ; # {}




    set first [ContextNew First {
	List! bullet $bullet [set ws "[BlankM $bullet] "]
    }] ; ContextSet $base ; # {}

    set next [ContextNew Next {
	WPrefix! $ws
	Prefix!  $ws
    }] ; ContextSet $base ; # {}








|
>
>
>

|
>
>


>
>
>

|







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

proc NewOrderedList {} {
    # Ordered list - enumeration - enum
    # 1. Base context provides indentation.
    # 2. First paragraph in a list item.
    # 3. All other paragraphs.
    ContextPush

    #puts_stderr "OL [CAttrName]"
    #puts_stderr "OL |[string map {{ } _} [In?]]|outer"

    set base [ContextNew Enumerated {
	set bullet "[In?]  [EBullet]"
	set ws     "[BlankM $bullet] "
	In! $ws
    }] ; # {}

    #puts_stderr "OL |[string map {{ } _} $bullet]|[string length $bullet]"
    #puts_stderr "OL |[string map {{ } _} $ws]|[string length $ws]"

    set first [ContextNew First {
	List! bullet $bullet $ws
    }] ; ContextSet $base ; # {}

    set next [ContextNew Next {
	WPrefix! $ws
	Prefix!  $ws
    }] ; ContextSet $base ; # {}

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

























    # 2. Term context
    # 3. Definition context
    ContextPush

    # Markdown has no native definition lists. We translate them into
    # itemized lists, rendering the term part as the first paragraph
    # of each entry, and the definition as all following.
    



    set base [ContextNew Definitions {
	set bullet "[WPrefix?]  [IBullet]"


    }] ; # {}




    set term [ContextNew Term {
	List! bullet $bullet [set ws "[BlankM $bullet] "]
	VerbatimOn
    }] ; ContextSet $base ; # {}

    set def [ContextNew Def {
	WPrefix! $ws
	Prefix!  $ws
    }] ; ContextSet $base ; # {}

    TD $term $def
    ContextCommit
    
    ContextPop
    ContextSet $base
    return
}




























c_pass 1 fmt_usage {cmd args} {c_hold synopsis "[join [linsert $args 0 $cmd] " "][LB.]"}




c_pass 1 fmt_call  {cmd args} {c_hold synopsis "[join [linsert $args 0 $cmd] " "][LB.]"}









c_pass 1 fmt_require {pkg {version {}}} {
    set result "package require $pkg"
    if {$version != {}} {append result " $version"}
    c_hold require "$result  "
    return
}

c_pass 2 fmt_tkoption_def {name dbname dbclass} {
    set    text ""
    append text "Command-Line Switch:\t[fmt_option $name][LB]"
    append text "Database Name:\t[Strong $dbname][LB]"
    append text "Database Class:\t[Strong $dbclass]\n"
    fmt_lst_item $text
}





proc fmt_arg     {text} { Em     $text }
proc fmt_cmd     {text} { Strong $text }
proc fmt_method  {text} { Strong $text }
proc fmt_option  {text} { Strong $text }

proc fmt_uri {text {label {}}} {
    if {$label == {}} { set label $text }
    return "\[$label\]($text)"
}

proc fmt_image {text {label {}}} {
    # text = symbolic name of the image.

    # formatting based on the available data ...

    set img [dt_imgdst $text {png gif jpg}]
    if {$img != {}} {
	if {$label != {}} {
	    return "!\[\]($img \"$label\")"
	} else {
	    return "!\[\]($img)"
	}
    }
    
    set img [dt_imgdata $text {txt}]
    if {$img != {}} {
	# Show ASCII image like an example (code block => fixed font, no reflow)
	# A label is shown as a pseudo-caption (paragraph after image).
	fmt_example $img
	if {$label != {}} {
	    Text [String "IMAGE: $label"]
	    CloseCurrent
	}
    }

    return $img
}

c_pass 1 fmt_manpage_begin {title section version} NOP
c_pass 2 fmt_manpage_begin {title section version} {
    Off



    set module      [dt_module]
    set shortdesc   [c_get_module]
    set description [c_get_title]

    MDComment  "$title - $shortdesc"
    MDComment  [c_provenance]
    MDComment  "[string trimleft $title :]($section) $version $module \"$shortdesc\""
    MDCDone

    Section NAME
    Text "$title - $description"
    CloseParagraph
    return
}





























































proc c_get_copyright {} {
    return [join [c_get_copyright_r] [LB]]
}

##
# # ## ### ##### ########



























return
































|
>
>
>

|
>
>


>
>
>

|










|





>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
>
>
>
>
|
>
>
>
>
>
>
>
>
>















>
>
>
>

|





|















|














|


>
>
>















>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>






>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
    # 2. Term context
    # 3. Definition context
    ContextPush

    # Markdown has no native definition lists. We translate them into
    # itemized lists, rendering the term part as the first paragraph
    # of each entry, and the definition as all following.

    #puts_stderr "DL [CAttrName]"
    #puts_stderr "DL |[string map {{ } _} [In?]]|outer"

    set base [ContextNew Definitions {
	set bullet "[In?]  [IBullet]"
	set ws "[BlankM $bullet] "
	In! $ws
    }] ; # {}

    #puts_stderr "DL |[string map {{ } _} $bullet]|[string length $bullet]"
    #puts_stderr "DL |[string map {{ } _} $ws]|[string length $ws]"

    set term [ContextNew Term {
	List! bullet $bullet $ws
	VerbatimOn
    }] ; ContextSet $base ; # {}

    set def [ContextNew Def {
	WPrefix! $ws
	Prefix!  $ws
    }] ; ContextSet $base ; # {}

    TD $term $def
    ContextCommit

    ContextPop
    ContextSet $base
    return
}

##
# # ## ### ##### ########
##

c_pass 1 fmt_section {name id} { c_newSection $name 1 end $id }
c_pass 2 fmt_section {name id} {
    CloseParagraph
    Section [SetAnchor $name $id]
    return
}

c_pass 1 fmt_subsection {name id} { c_newSection $name 2 end $id }
c_pass 2 fmt_subsection {name id} {
    CloseParagraph
    Subsection [SetAnchor $name $id]
    return
}

proc fmt_sectref {title {id {}}} {
    if {$id == {}} { set id [c_sectionId $title] }
    if {[c_sectionKnown $id]} {
    	return [ALink "#$id" $title]
    } else {
	return [Strong $title]
    }
}

c_pass 1 fmt_usage {cmd args} {
    set text [join [linsert $args 0 $cmd] " "]
    c_hold synopsis "$text[LB.]"
}

c_pass 1 fmt_call  {cmd args} {
    set text [join [linsert $args 0 $cmd] " "]
    set dest "#[c_cnext]"
    c_hold synopsis "[MakeLink $text $dest][LB.]"
}
c_pass 2 fmt_call {cmd args} {
    set text [join [linsert $args 0 $cmd] " "]
    return [fmt_lst_item [SetAnchor $text [c_cnext]]]
}

c_pass 1 fmt_require {pkg {version {}}} {
    set result "package require $pkg"
    if {$version != {}} {append result " $version"}
    c_hold require "$result  "
    return
}

c_pass 2 fmt_tkoption_def {name dbname dbclass} {
    set    text ""
    append text "Command-Line Switch:\t[fmt_option $name][LB]"
    append text "Database Name:\t[Strong $dbname][LB]"
    append text "Database Class:\t[Strong $dbclass]\n"
    fmt_lst_item $text
}

proc fmt_syscmd  {text} { Strong [XrefMatch $text sa] }
proc fmt_package {text} { Strong [XrefMatch $text sa kw] }
proc fmt_term    {text} { Em     [XrefMatch $text kw sa] }

proc fmt_arg     {text} { Em     $text }
proc fmt_cmd     {text} { Strong [XrefMatch $text sa] }
proc fmt_method  {text} { Strong $text }
proc fmt_option  {text} { Strong $text }

proc fmt_uri {text {label {}}} {
    if {$label == {}} { set label $text }
    ALink $text $label
}

proc fmt_image {text {label {}}} {
    # text = symbolic name of the image.

    # formatting based on the available data ...

    set img [dt_imgdst $text {png gif jpg}]
    if {$img != {}} {
	if {$label != {}} {
	    return "!\[\]($img \"$label\")"
	} else {
	    return "!\[\]($img)"
	}
    }

    set img [dt_imgdata $text {txt}]
    if {$img != {}} {
	# Show ASCII image like an example (code block => fixed font, no reflow)
	# A label is shown as a pseudo-caption (paragraph after image).
	fmt_example $img
	if {$label != {}} {
	    Text [String "IMAGE: $label"]
	    CloseCurrent
	}
    }

    return $img
}

c_pass 1 fmt_manpage_begin {title section version} {c_cinit ; c_clrSections ; return}
c_pass 2 fmt_manpage_begin {title section version} {
    Off
    XrefInit
    c_cinit

    set module      [dt_module]
    set shortdesc   [c_get_module]
    set description [c_get_title]

    MDComment  "$title - $shortdesc"
    MDComment  [c_provenance]
    MDComment  "[string trimleft $title :]($section) $version $module \"$shortdesc\""
    MDCDone

    Section NAME
    Text "$title - $description"
    CloseParagraph
    return
}

c_pass 2 fmt_description {id} {
    On
    set syn [c_held synopsis]
    set req [c_held require]

    # Create the TOC.

    # Pass 1: We have a number of special sections which were not
    #         listed explicitly in the document sources. Add them
    #         now. Note the inverse order for the sections added
    #         at the beginning.

    c_newSection Description 1 0 $id
    if {$syn != {} || $req != {}} {c_newSection Synopsis 1 0 synopsis}
    c_newSection {Table Of Contents} 1 0 toc

    if {[llength [c_xref_seealso]]  > 0} {c_newSection {See Also} 1 end see-also}
    if {[llength [c_xref_keywords]] > 0} {c_newSection Keywords   1 end keywords}
    if {[c_xref_category]         ne ""} {c_newSection Category   1 end category}
    if {[c_get_copyright]         != {}} {c_newSection Copyright  1 end copyright}

    # Pass 2: Generate the markup for the TOC, indenting the
    #         links according to the level of each section.

    TOC

    # Implicit sections coming after the TOC (Synopsis, then the
    # description which starts the actual document). The other
    # implicit sections are added at the end of the document and are
    # generated by 'fmt_manpage_end' in the second pass.
    
    if {$syn != {} || $req != {}} {
	Section [SetAnchor SYNOPSIS synopsis]
	if {($req != {}) && ($syn != {})} {
	    Text $req\n\n$syn
	} else {
	    if {$req != {}} {Text $req}
	    if {$syn != {}} {Text $syn}
	}
	CloseParagraph [Verbatim]
    }

    Section [SetAnchor DESCRIPTION description]
    return
}

c_pass 2 fmt_manpage_end {} {
    set sa [c_xref_seealso]
    set kw [c_xref_keywords]
    set ca [c_xref_category]
    set ct [c_get_copyright]

    CloseParagraph
    if {[llength $sa]} { Special {SEE ALSO} see-also  [join [XrefList [lsort $sa] sa] ", "] }
    if {[llength $kw]} { Special KEYWORDS   keywords  [join [XrefList [lsort $kw] kw] ", "] }
    if {$ca ne ""}     { Special CATEGORY   category  $ca                     }
    if {$ct != {}}     { Special COPYRIGHT  copyright $ct [Verbatim]          }
    return
}

proc c_get_copyright {} {
    return [join [c_get_copyright_r] [LB]]
}

##
# # ## ### ##### ########
##

proc Special {title id text {p {}}} {
    Section [SetAnchor $title $id]
    Text $text
    CloseParagraph $p
}

proc TOC {} {
    # While we could go through (fmt_list_begin itemized, item ...,
    # fmt_list_end) it looks to be easier to directly emit paragraphs
    # into the display list. No need to track anything. Just map entry
    # level directly to the proper context.
    Section [SetAnchor {Table Of Contents} toc]

    ContextPush
    lappend toc _bogus_
    lappend toc [ContextNew TOC/Section { List! bullet "  - "     "     "     }]
    lappend toc [ContextNew TOC/SubSect { List! bullet "      - " "         " }]
    ContextPop

    foreach {name id level} [c_sections] {
	# level in {1,2}, 1 = section, 2 = subsection
	Text [ALink "#$id" $name]
	CloseParagraph [lindex $toc $level]
    }

    return
}

# # ## ### ##### ########
## Engine Parameters

proc GetXref {} { Get xref } ;# xref access to engine parameters

global    __var
array set __var {
    xref   {}
}
proc Get               {varname}      {global __var ; return $__var($varname)}
proc fmt_listvariables {}             {global __var ; return [array names __var]}
proc fmt_varset        {varname text} {
    global __var
    if {![info exists __var($varname)]} {
	return -code error "Unknown engine variable \"$varname\""
    }
    set __var($varname) $text
    return
}

##
# # ## ### ##### ########
return
Changes to modules/doctools/mpformats/fmt.text.
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# # ## ### ##### ########
## Special manpage contexts

# example     = if present, context is for an example
# exenv       = if present, reference to example variant of current context

proc Example!     {} { CAttrSet example . }
proc Example?  {} { CAttrHas example }

proc NewExample {} {
    return [ContextNew Example { VerbatimOn ; Example! ; Prefix! "| " }] ; # {}
}

proc Example {} {







|







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

# # ## ### ##### ########
## Special manpage contexts

# example     = if present, context is for an example
# exenv       = if present, reference to example variant of current context

proc Example!  {} { CAttrSet example . }
proc Example?  {} { CAttrHas example }

proc NewExample {} {
    return [ContextNew Example { VerbatimOn ; Example! ; Prefix! "| " }] ; # {}
}

proc Example {} {
53
54
55
56
57
58
59

60
61
62
63
64
65
66

proc NewUnorderedList {} {
    # Itemized list - unordered list - bullet
    # 1. Base context provides indentation.
    # 2. First paragraph in a list item.
    # 3. All other paragraphs.
    ContextPush

    set base [ContextNew Itemized {
	MarginIn
	set bullet [IBullet]
    }] ; # {}

    set first [ContextNew First {
	List! bullet $bullet [BlankMargin]







>







53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

proc NewUnorderedList {} {
    # Itemized list - unordered list - bullet
    # 1. Base context provides indentation.
    # 2. First paragraph in a list item.
    # 3. All other paragraphs.
    ContextPush

    set base [ContextNew Itemized {
	MarginIn
	set bullet [IBullet]
    }] ; # {}

    set first [ContextNew First {
	List! bullet $bullet [BlankMargin]
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

# # ## ### ##### ########
##

proc OUL {f n} {
    CAttrSet _first $f
    CAttrSet _next  $n
    CAttrSet pcount 0
}

proc TD {t d} {
    CAttrSet _term       $t
    CAttrSet _definition $d
}

proc IsPara   {} { CAttrHas pcount }
proc Paras    {} { CAttrGet pcount }
proc PAdvance {} { CAttrIncr pcount 1 }



proc PReset   {} { CAttrSet pcount 0 }




















proc First    {} { CAttrGet _first }
proc Other    {} { CAttrGet _next }
proc Term     {} { CAttrGet _term }
proc Def      {} { CAttrGet _definition }
proc IsDef    {} { CAttrHas _definition }

# # ## ### ##### ########
##

proc CloseCurrent {{op PAdvance}} {
    if {[IsDef]} {

	# Currently in a definition list.
	CloseParagraph [Def]
    } elseif {[IsPara]} {

	# Currently in an (un)ordered list.

	if {![Paras]} {
	    # No paragraphs yet, this is first in the item
	    if {[CloseParagraph [First]]} $op
	} else {
	    # More paragraphs in the item
	    if {[CloseParagraph [Other]]} $op
	}
    } else {

	# Currently in a regular paragraph
	CloseParagraph
    }
}

proc GetCurrent {{op PAdvance}} {
    if {[IsDef]} {

	# Currently in a definition list.
	return [Def]
    } elseif {[IsPara]} {

	# Currently in an (un)ordered list.

	if {![Paras]} {
	    set res [First]
	} else {
	    set res [Other]
	}
	$op

	return $res
    } else {

	# Currently in a regular paragraph
	return {}
    }
}

# # ## ### ##### ########
##







<







|
|
|
>
>
>
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>









|

>



>

>


|


|


>





|

>



>

>





<
>


>







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

# # ## ### ##### ########
##

proc OUL {f n} {
    CAttrSet _first $f
    CAttrSet _next  $n

}

proc TD {t d} {
    CAttrSet _term       $t
    CAttrSet _definition $d
}

proc IsPara   {} { CAttrHas _next }
proc Paras    {} { global __pcount ; set  __pcount }
proc PAdvance {} {
    global __pcount ; incr __pcount 1
    #puts_stderr "    ZZZ/ItemParas/Advance:$__pcount"
}
proc PReset   {} {
    #puts_stderr "    ZZZ/ItemParas/Reset"
    global __pcount ; set  __pcount 0 }

global __pcount  ; set __pcount  0
global __pcstack ; set __pcstack {}

proc PSave {} {
    global __pcount __pcstack
    lappend __pcstack $__pcount
    PReset
}

proc PRestore {} {
    global __pcount __pcstack
    set __pcount  [lindex $__pcstack end]
    set __pcstack [lrange $__pcstack 0 end-1]
    #puts_stderr "    ZZZ/ItemParas/Restore:$__pcount"
    return
}

proc First    {} { CAttrGet _first }
proc Other    {} { CAttrGet _next }
proc Term     {} { CAttrGet _term }
proc Def      {} { CAttrGet _definition }
proc IsDef    {} { CAttrHas _definition }

# # ## ### ##### ########
##

proc CloseCurrent {} {
    if {[IsDef]} {
	#puts_stderr "    ZZZ/CloseCurrent/Definitions"
	# Currently in a definition list.
	CloseParagraph [Def]
    } elseif {[IsPara]} {
	#puts_stderr "    ZZZ/CloseCurrent/UOL"
	# Currently in an (un)ordered list.
	#puts_stderr "    ZZZ/ItemParas/[Paras]"
	if {![Paras]} {
	    # No paragraphs yet, this is first in the item
	    if {[CloseParagraph [First]]} PAdvance
	} else {
	    # More paragraphs in the item
	    if {[CloseParagraph [Other]]} PAdvance
	}
    } else {
	#puts_stderr "    ZZZ/CloseCurrent/Plain"
	# Currently in a regular paragraph
	CloseParagraph
    }
}

proc GetCurrent {} {
    if {[IsDef]} {
	#puts_stderr "    ZZZ/GetCurrent/Definitions"
	# Currently in a definition list.
	return [Def]
    } elseif {[IsPara]} {
	#puts_stderr "    ZZZ/GetCurrent/UOL"
	# Currently in an (un)ordered list.
	#puts_stderr "    ZZZ/ItemParas/[Paras]"
	if {![Paras]} {
	    set res [First]
	} else {
	    set res [Other]
	}

	PAdvance
	return $res
    } else {
	#puts_stderr "    ZZZ/GetCurrent/Plain"
	# Currently in a regular paragraph
	return {}
    }
}

# # ## ### ##### ########
##
262
263
264
265
266
267
268
269




270
271
272
273
274
275
276
c_pass 1 fmt_section     {name {id {}}} NOP
c_pass 2 fmt_section     {name {id {}}} {CloseParagraph ; Section $name ; return}

c_pass 1 fmt_subsection  {name {id {}}} NOP
c_pass 2 fmt_subsection  {name {id {}}} {CloseParagraph ; Subsection $name ; return}

c_pass 1 fmt_para {} NOP
c_pass 2 fmt_para {} {CloseCurrent ; return}





# NL is an alias of PARA
# See also fmt_example_begin
c_pass 1 fmt_nl {} NOP
c_pass 2 fmt_nl {} {CloseCurrent ; return }

c_pass 2 fmt_require {pkg {version {}}} NOP







|
>
>
>
>







293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
c_pass 1 fmt_section     {name {id {}}} NOP
c_pass 2 fmt_section     {name {id {}}} {CloseParagraph ; Section $name ; return}

c_pass 1 fmt_subsection  {name {id {}}} NOP
c_pass 2 fmt_subsection  {name {id {}}} {CloseParagraph ; Subsection $name ; return}

c_pass 1 fmt_para {} NOP
c_pass 2 fmt_para {} {
    CloseCurrent
    #puts_stderr "AAA/fmt_para/START"
    return
}

# NL is an alias of PARA
# See also fmt_example_begin
c_pass 1 fmt_nl {} NOP
c_pass 2 fmt_nl {} {CloseCurrent ; return }

c_pass 2 fmt_require {pkg {version {}}} NOP
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
}

# # ## ### ##### ########
##

c_pass 1 fmt_list_begin {what {hint {}}} NOP
c_pass 2 fmt_list_begin {what {hint {}}} {
    #puts_stderr "<<fmt_list_begin $what>>"


    CloseCurrent
    ContextPush
    NewList $what
    Off


    #puts_stderr "<<fmt_list_begin _____>>"
    return
}

c_pass 1 fmt_list_end {} NOP
c_pass 2 fmt_list_end {} {
    #puts_stderr "<<fmt_list_end>>"


    CloseCurrent
    ContextPop


    #puts_stderr "<<fmt_list_end ____>>"
    return
}

c_pass 1 fmt_lst_item {text} NOP
c_pass 2 fmt_lst_item {text} {
    #puts_stderr "<<fmt_lst_item \{$text\}>>"


    if {[IsOff]} { On } else { CloseParagraph [Def] }
    Text $text
    CloseParagraph [Term]

    #puts_stderr "<<fmt_lst_item _____>>"
    return
}

c_pass 1 fmt_bullet {} NOP
c_pass 2 fmt_bullet {} {
    if {[IsOff]} {On ; return}


    CloseCurrent PReset
    return
}

c_pass 1 fmt_enum {} NOP
c_pass 2 fmt_enum {} {
    if {[IsOff]} {On ; return}


    CloseCurrent PReset
    return
}

c_pass 1 fmt_cmd_def  {command} NOP
c_pass 2 fmt_cmd_def  {command} {fmt_lst_item [fmt_cmd $command]}

c_pass 1 fmt_arg_def {type name {mode {}}} NOP







|

>
|
|
|

>

|





|

>
|
|
>

|





|

>
|



|





|
>
>
|





|
>
>
|







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
}

# # ## ### ##### ########
##

c_pass 1 fmt_list_begin {what {hint {}}} NOP
c_pass 2 fmt_list_begin {what {hint {}}} {
    CloseCurrent

    #puts_stderr "AAA/fmt_list_begin/Setup $what"

    ContextPush ;# push outer
    NewList $what ;# base/controller of current/new/inner
    Off
    PSave

    #puts_stderr "AAA/fmt_list_begin/Enter"
    return
}

c_pass 1 fmt_list_end {} NOP
c_pass 2 fmt_list_end {} {
    CloseCurrent

    #puts_stderr "AAA/fmt_list_end/Exit"

    ContextPop ;# return to outer
    PRestore

    #puts_stderr "AAA/fmt_list_end/Done"
    return
}

c_pass 1 fmt_lst_item {text} NOP
c_pass 2 fmt_lst_item {text} {
    if {[IsOff]} { On } else { CloseParagraph [Def] }

    #puts_stderr "AAA/fmt_lst_item/(($text))"

    Text $text
    CloseParagraph [Term]

    #puts_stderr "AAA/fmt_lst_item/Done"
    return
}

c_pass 1 fmt_bullet {} NOP
c_pass 2 fmt_bullet {} {
    if {[IsOff]} { On } else { CloseCurrent }

    #puts_stderr "AAA/fmt_bullet/START"
    PReset
    return
}

c_pass 1 fmt_enum {} NOP
c_pass 2 fmt_enum {} {
    if {[IsOff]} { On } else { CloseCurrent }

    #puts_stderr "AAA/fmt_enum/START"
    PReset
    return
}

c_pass 1 fmt_cmd_def  {command} NOP
c_pass 2 fmt_cmd_def  {command} {fmt_lst_item [fmt_cmd $command]}

c_pass 1 fmt_arg_def {type name {mode {}}} NOP
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
    fmt_lst_item $text
}

# # ## ### ##### ########
##

c_pass 1 fmt_example_begin {} NOP
c_pass 2 fmt_example_begin {} { CloseCurrent ; return }








c_pass 1 fmt_example_end {} NOP
c_pass 2 fmt_example_end {} {

    TextTrimLeadingSpace
    
    set penv [GetCurrent]
    if {$penv != {}} {
	# In a list we save the current list context, activate the
	# proper paragraph context and create its example
	# variant. After closing the paragraph using the example we
	# restore and reactivate the list context.
	ContextPush
	ContextSet $penv

	CloseParagraph [Example]
	ContextPop
    } else {
	# In a regular paragraph we simple close the example

	CloseParagraph [Example]
    }


    return
}

c_pass 1 fmt_example {code} NOP
c_pass 2 fmt_example {code} {
    fmt_example_begin
    fmt_plain_text $code







|
>
>
>
>
>
>
>



>










>




>


>
>







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
    fmt_lst_item $text
}

# # ## ### ##### ########
##

c_pass 1 fmt_example_begin {} NOP
c_pass 2 fmt_example_begin {} {
    #puts_stderr "AAA/fmt_example_begin"

    CloseCurrent

    #puts_stderr "AAA/fmt_example_begin/Done"
    return
}

c_pass 1 fmt_example_end {} NOP
c_pass 2 fmt_example_end {} {
    #puts_stderr "AAA/fmt_example_end"
    TextTrimLeadingSpace
    
    set penv [GetCurrent]
    if {$penv != {}} {
	# In a list we save the current list context, activate the
	# proper paragraph context and create its example
	# variant. After closing the paragraph using the example we
	# restore and reactivate the list context.
	ContextPush
	ContextSet $penv
	#if {[CloseParagraph [Example]]} PAdvance
	CloseParagraph [Example]
	ContextPop
    } else {
	# In a regular paragraph we simple close the example
	#if {[CloseParagraph [Example]]} PAdvance
	CloseParagraph [Example]
    }

    #puts_stderr "AAA/fmt_example_end/Done"
    return
}

c_pass 1 fmt_example {code} NOP
c_pass 2 fmt_example {code} {
    fmt_example_begin
    fmt_plain_text $code
Changes to modules/doctools/mpformats/idx.markdown.
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
}

proc Separator {} {
    Text ----
    CloseParagraph [Verbatim]
}

proc ALink {dst label} { return "\[$label]($dst)" }

proc SetAnchor {text {name {}}} {
    if {$name == {}} { set name [Anchor $text] }
    return "<a name='$name'></a>$text"
}

proc Anchor {text} {
    global kwid
    if {[info exists kwid($text)]} {
	return "$kwid($text)"
    }
    return [A $text]
}

proc A {text} {
    set anchor [regsub -all {[^a-zA-Z0-9]} [string tolower $text] {_}]
    set anchor [regsub -all {__+} $anchor _]
    return $anchor
}

# ### ### ### ######### ######### #########
## Engine state

proc LoadKwid {} {
    global kwid
    # Engine parameter - load predefined keyword anchors.
    set             ki [Get kwid]







<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<







154
155
156
157
158
159
160





















161
162
163
164
165
166
167
}

proc Separator {} {
    Text ----
    CloseParagraph [Verbatim]
}






















# ### ### ### ######### ######### #########
## Engine state

proc LoadKwid {} {
    global kwid
    # Engine parameter - load predefined keyword anchors.
    set             ki [Get kwid]
Added modules/doctools/tests/fmt/desc/16.
Added modules/doctools/tests/fmt/desc/17.
Added modules/doctools/tests/fmt/desc/18.
Added modules/doctools/tests/fmt/html/16.






























































































































































































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
<!DOCTYPE html><html><head>
<title>test-itemized-nested - </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 '.FILE.' by tcllib/doctools with format 'html'
   -->
<!-- Copyright &amp;copy; .COPYRIGHT.
   -->
<!-- test-itemized-nested.1
   -->
<body><div class="doctools">
<h1 class="doctools_title">test-itemized-nested(1) n .MODULE. &quot;&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>test-itemized-nested -</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="#section1">Description</a></li>
<li class="doctools_section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>lorem ipsum dolores</p>
<ul class="doctools_itemized">
<li><p>lorem ipsum dolores</p>
<ul class="doctools_itemized">
<li><p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
</ul>
</li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p>
<ul class="doctools_itemized">
<li><p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
</ul>
<p>lorem ipsum dolores</p></li>
</ul>
</div>
<div id="copyright" class="doctools_section"><h2><a name="copyright">Copyright</a></h2>
<p>Copyright &copy; .COPYRIGHT.</p>
</div>
</div></body></html>
Added modules/doctools/tests/fmt/html/17.






























































































































































































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
<!DOCTYPE html><html><head>
<title>test-enumerated-nested - </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 '.FILE.' by tcllib/doctools with format 'html'
   -->
<!-- Copyright &amp;copy; .COPYRIGHT.
   -->
<!-- test-enumerated-nested.1
   -->
<body><div class="doctools">
<h1 class="doctools_title">test-enumerated-nested(1) n .MODULE. &quot;&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>test-enumerated-nested -</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="#section1">Description</a></li>
<li class="doctools_section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>lorem ipsum dolores</p>
<ol class="doctools_enumerated">
<li><p>lorem ipsum dolores</p>
<ol class="doctools_enumerated">
<li><p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
</ol>
</li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p>
<ol class="doctools_enumerated">
<li><p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
<li><p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></li>
</ol>
<p>lorem ipsum dolores</p></li>
</ol>
</div>
<div id="copyright" class="doctools_section"><h2><a name="copyright">Copyright</a></h2>
<p>Copyright &copy; .COPYRIGHT.</p>
</div>
</div></body></html>
Added modules/doctools/tests/fmt/html/18.














































































































































































































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
<!DOCTYPE html><html><head>
<title>test-definitions-nested - </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 '.FILE.' by tcllib/doctools with format 'html'
   -->
<!-- Copyright &amp;copy; .COPYRIGHT.
   -->
<!-- test-definitions-nested.1
   -->
<body><div class="doctools">
<h1 class="doctools_title">test-definitions-nested(1) n .MODULE. &quot;&quot;</h1>
<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
<p>test-definitions-nested -</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="#section1">Description</a></li>
<li class="doctools_section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
<p>lorem ipsum dolores</p>
<dl class="doctools_definitions">
<dt>lorem</dt>
<dd><p>ipsum dolores</p>
<dl class="doctools_definitions">
<dt>lorem</dt>
<dd><p>ipsum dolores</p></dd>
<dt>lorem</dt>
<dd><p>ipsum dolores</p>
<p>lorem ipsum dolores</p></dd>
<dt>lorem</dt>
<dd><p>ipsum dolores</p>
<p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></dd>
</dl></dd>
<dt>lorem</dt>
<dd><p>ipsum dolores</p>
<p>lorem ipsum dolores</p></dd>
<dt>lorem</dt>
<dd><p>ipsum dolores</p>
<p>lorem ipsum dolores</p>
<dl class="doctools_definitions">
<dt>lorem</dt>
<dd><p>ipsum dolores</p></dd>
<dt>lorem</dt>
<dd><p>ipsum dolores</p>
<p>lorem ipsum dolores</p></dd>
<dt>lorem</dt>
<dd><p>ipsum dolores</p>
<p>lorem ipsum dolores</p>
<p>lorem ipsum dolores</p></dd>
</dl>
<p>lorem ipsum dolores</p></dd>
</dl>
</div>
<div id="copyright" class="doctools_section"><h2><a name="copyright">Copyright</a></h2>
<p>Copyright &copy; .COPYRIGHT.</p>
</div>
</div></body></html>
Changes to modules/doctools/tests/fmt/latex/09.
1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% TEST.z
\documentclass{article}
\begin{document}
\author{aku}
\title{.MODULE. / TEST --  : }
\maketitle
\section{Description}\label{section1}
lorem
\begin{verbatim}
1 lorem ipsum dolores
\end{verbatim}





|







1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% TEST.z
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / TEST --  : }
\maketitle
\section{Description}\label{section1}
lorem
\begin{verbatim}
1 lorem ipsum dolores
\end{verbatim}
Changes to modules/doctools/tests/fmt/latex/10.
1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-itemized.1
\documentclass{article}
\begin{document}
\author{aku}
\title{.MODULE. / test-itemized --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item





|







1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-itemized.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-itemized --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item
Changes to modules/doctools/tests/fmt/latex/11.
1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-enumerated.1
\documentclass{article}
\begin{document}
\author{aku}
\title{.MODULE. / test-enumerated --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{enumerate}
%
\item





|







1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-enumerated.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-enumerated --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{enumerate}
%
\item
Changes to modules/doctools/tests/fmt/latex/12.
1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-definitions.1
\documentclass{article}
\begin{document}
\author{aku}
\title{.MODULE. / test-definitions --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item[] lorem





|







1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-definitions.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-definitions --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item[] lorem
Changes to modules/doctools/tests/fmt/latex/13.
1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-itemized-examples.1
\documentclass{article}
\begin{document}
\author{aku}
\title{.MODULE. / test-itemized-examples --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item





|







1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-itemized-examples.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-itemized-examples --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item
Changes to modules/doctools/tests/fmt/latex/14.
1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-enumerated-examples.1
\documentclass{article}
\begin{document}
\author{aku}
\title{.MODULE. / test-enumerated-examples --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{enumerate}
%
\item





|







1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-enumerated-examples.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-enumerated-examples --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{enumerate}
%
\item
Changes to modules/doctools/tests/fmt/latex/15.
1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-definition-examples.1
\documentclass{article}
\begin{document}
\author{aku}
\title{.MODULE. / test-definition-examples --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item[] lorem





|







1
2
3
4
5
6
7
8
9
10
11
12
13
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-definition-examples.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-definition-examples --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item[] lorem
Added modules/doctools/tests/fmt/latex/16.






















































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-itemized-nested.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-itemized-nested --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item
%
 lorem ipsum dolores
\begin{itemize}
%
\item
%
 lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores

lorem ipsum dolores
\end{itemize}
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores
\begin{itemize}
%
\item
%
 lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores

lorem ipsum dolores
\end{itemize}

lorem ipsum dolores
\end{itemize}
\section{Copyright}\label{copyright}
\begin{flushleft}
Copyright (c) .COPYRIGHT.\linebreak
\end{flushleft}
\end{document}
Added modules/doctools/tests/fmt/latex/17.






















































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-enumerated-nested.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-enumerated-nested --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{enumerate}
%
\item
%
 lorem ipsum dolores
\begin{enumerate}
%
\item
%
 lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores

lorem ipsum dolores
\end{enumerate}
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores
\begin{enumerate}
%
\item
%
 lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores
%
\item
%
 lorem ipsum dolores

lorem ipsum dolores

lorem ipsum dolores
\end{enumerate}

lorem ipsum dolores
\end{enumerate}
\section{Copyright}\label{copyright}
\begin{flushleft}
Copyright (c) .COPYRIGHT.\linebreak
\end{flushleft}
\end{document}
Added modules/doctools/tests/fmt/latex/18.






















































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) .COPYRIGHT.
% test-definitions-nested.1
\documentclass{article}
\begin{document}
\author{@USR@}
\title{.MODULE. / test-definitions-nested --  : }
\maketitle
\section{Description}\label{section1}
lorem ipsum dolores
\begin{itemize}
%
\item[] lorem
%
 ipsum dolores
\begin{itemize}
%
\item[] lorem
%
 ipsum dolores
%
\item[] lorem
%
 ipsum dolores

lorem ipsum dolores
%
\item[] lorem
%
 ipsum dolores

lorem ipsum dolores

lorem ipsum dolores
\end{itemize}
%
\item[] lorem
%
 ipsum dolores

lorem ipsum dolores
%
\item[] lorem
%
 ipsum dolores

lorem ipsum dolores
\begin{itemize}
%
\item[] lorem
%
 ipsum dolores
%
\item[] lorem
%
 ipsum dolores

lorem ipsum dolores
%
\item[] lorem
%
 ipsum dolores

lorem ipsum dolores

lorem ipsum dolores
\end{itemize}

lorem ipsum dolores
\end{itemize}
\section{Copyright}\label{copyright}
\begin{flushleft}
Copyright (c) .COPYRIGHT.\linebreak
\end{flushleft}
\end{document}
Added modules/doctools/tests/fmt/list/16.


>
1
manpage {seealso {} keywords {} file .FILE. section 1 category {} module .MODULE. version n title test-itemized-nested shortdesc {} desc {} fid .FILE}
Added modules/doctools/tests/fmt/list/17.


>
1
manpage {seealso {} keywords {} file .FILE. section 1 category {} module .MODULE. version n title test-enumerated-nested shortdesc {} desc {} fid .FILE}
Added modules/doctools/tests/fmt/list/18.


>
1
manpage {seealso {} keywords {} file .FILE. section 1 category {} module .MODULE. version n title test-definitions-nested shortdesc {} desc {} fid .FILE}
Added modules/doctools/tests/fmt/man/16.


























































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
[comment { -- List 9 - itemized nested }]
[manpage_begin test-itemized-nested 1 n]
[description]
lorem ipsum dolores
[list_begin itemized]
[item] lorem ipsum dolores
[list_begin itemized]
[item] lorem ipsum dolores
[item] lorem ipsum dolores
[para] lorem ipsum dolores
[item] lorem ipsum dolores
[para] lorem ipsum dolores
[para] lorem ipsum dolores
[list_end]
[item] lorem ipsum dolores
[para] lorem ipsum dolores
[item] lorem ipsum dolores
[para] lorem ipsum dolores
[list_begin itemized]
[item] lorem ipsum dolores
[item] lorem ipsum dolores
[para] lorem ipsum dolores
[item] lorem ipsum dolores
[para] lorem ipsum dolores
[para] lorem ipsum dolores
[list_end]
[para] lorem ipsum dolores
[list_end]
[manpage_end]
Added modules/doctools/tests/fmt/man/17.


























































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
[comment { -- List 10 - enumerated nested }]
[manpage_begin test-enumerated-nested 1 n]
[description]
lorem ipsum dolores
[list_begin enumerated]
[enum] lorem ipsum dolores
[list_begin enumerated]
[enum] lorem ipsum dolores
[enum] lorem ipsum dolores
[para] lorem ipsum dolores
[enum] lorem ipsum dolores
[para] lorem ipsum dolores
[para] lorem ipsum dolores
[list_end]
[enum] lorem ipsum dolores
[para] lorem ipsum dolores
[enum] lorem ipsum dolores
[para] lorem ipsum dolores
[list_begin enumerated]
[enum] lorem ipsum dolores
[enum] lorem ipsum dolores
[para] lorem ipsum dolores
[enum] lorem ipsum dolores
[para] lorem ipsum dolores
[para] lorem ipsum dolores
[list_end]
[para] lorem ipsum dolores
[list_end]
[manpage_end]
Added modules/doctools/tests/fmt/man/18.


























































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
[comment { -- List 11 - definitions nested }]
[manpage_begin test-definitions-nested 1 n]
[description]
lorem ipsum dolores
[list_begin definitions]
[def lorem] ipsum dolores
[list_begin definitions]
[def lorem] ipsum dolores
[def lorem] ipsum dolores
[para] lorem ipsum dolores
[def lorem] ipsum dolores
[para] lorem ipsum dolores
[para] lorem ipsum dolores
[list_end]
[def lorem] ipsum dolores
[para] lorem ipsum dolores
[def lorem] ipsum dolores
[para] lorem ipsum dolores
[list_begin definitions]
[def lorem] ipsum dolores
[def lorem] ipsum dolores
[para] lorem ipsum dolores
[def lorem] ipsum dolores
[para] lorem ipsum dolores
[para] lorem ipsum dolores
[list_end]
[para] lorem ipsum dolores
[list_end]
[manpage_end]
Changes to modules/doctools/tests/fmt/markdown/00.
1
2
3
4
5
6
7
8
9








10
11
12
13
14

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -









# DESCRIPTION

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|

|


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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/01.
1
2
3
4
5
6
7
8
9








10
11
12
13
14
15
16
17
18
19
20
21

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -









# DESCRIPTION

Argument ::*Argument*:: Class ::__Class__:: Command ::__Command__:: Comment ::::
Const ::__Constant__:: Emphasis ::*Emphasis*:: File ::"File/Path":: Function
::__Function__:: Method ::__Method__:: Namespace ::__Namespace__:: Option
::__Option__:: Optional ::?Optional?:: Package ::__Package__:: Syscmd
::__SystemCommand__:: Term ::*Term*:: Type ::__Type__:: Uri ::[Uri](Uri)::
Variable ::__Variable__:: Widget ::__Widget__::

# COPYRIGHT

Copyright &copy; **Copyright**









>
>
>
>
>
>
>
>
|








|


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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

Argument ::*Argument*:: Class ::__Class__:: Command ::__Command__:: Comment ::::
Const ::__Constant__:: Emphasis ::*Emphasis*:: File ::"File/Path":: Function
::__Function__:: Method ::__Method__:: Namespace ::__Namespace__:: Option
::__Option__:: Optional ::?Optional?:: Package ::__Package__:: Syscmd
::__SystemCommand__:: Term ::*Term*:: Type ::__Type__:: Uri ::[Uri](Uri)::
Variable ::__Variable__:: Widget ::__Widget__::

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

Copyright &copy; **Copyright**
Changes to modules/doctools/tests/fmt/markdown/02.
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

[//000000001]: # (TEST - ..THE_MODULE..)
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "..THE_MODULE..")

# NAME

TEST - ..THE_TITLE..















# SYNOPSIS

package require AAA  
package require BBB VVV  

# DESCRIPTION

# SEE ALSO

ELSE, OTHER

# KEYWORDS

KEYA, KEYZ

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
>
>
>
>
>
>
|




|

|



|



|


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

[//000000001]: # (TEST - ..THE_MODULE..)
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "..THE_MODULE..")

# NAME

TEST - ..THE_TITLE..

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

  -  [Table Of Contents](#toc)

  -  [Synopsis](#synopsis)

  -  [Description](#section1)

  -  [See Also](#see-also)

  -  [Keywords](#keywords)

  -  [Copyright](#copyright)

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

package require AAA  
package require BBB VVV  

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

# <a name='see-also'></a>SEE ALSO

ELSE, OTHER

# <a name='keywords'></a>KEYWORDS

KEYA, KEYZ

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/03.
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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -


# DESCRIPTION



# AaA
















1

# BbB

22

## BbB.cCc

333

## BbB.dDd

4444

# EeE

5555

At -> AaA.

At -> __undefined__.

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
|
>

>
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>



|



|



|



|



|

|

|


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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [AaA](#section2)

  -  [BbB](#section3)

      -  [BbB.cCc](#subsection1)

      -  [BbB.dDd](#subsection2)

  -  [EeE](#section4)

  -  [Copyright](#copyright)

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

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

1

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

22

## <a name='subsection1'></a>BbB.cCc

333

## <a name='subsection2'></a>BbB.dDd

4444

# <a name='section4'></a>EeE

5555

At [AaA](#section2).

At ____undefined____.

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/04.
1
2
3
4
5
6
7
8
9








10
11
12
13
14
15
16
17
18
19
20
21
22
23

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -









# DESCRIPTION

BEGINNE HIER

    Example Block  More Lines

    Inlined Example \
    Next Line

FERTIG

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|










|


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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

BEGINNE HIER

    Example Block  More Lines

    Inlined Example \
    Next Line

FERTIG

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/05.
1
2
3
4
5
6
7
8
9










10
11
12
13
14
15
16
17
18
19
20
21

[//000000001]: # (BASIC - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (BASIC(a) 5 .MODULE. "")

# NAME

BASIC -











# SYNOPSIS

a-command  

# DESCRIPTION

OK

  - integer *argument-1*

    verification










>
>
>
>
>
>
>
>
>
>
|

|

|







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

[//000000001]: # (BASIC - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (BASIC(a) 5 .MODULE. "")

# NAME

BASIC -

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

  -  [Table Of Contents](#toc)

  -  [Synopsis](#synopsis)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

[a-command](#1)  

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

OK

  - integer *argument-1*

    verification

31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

    elucidation

  - term

    definition

  - a-command

    semantic

  1. A

  1. B








|







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

    elucidation

  - term

    definition

  - <a name='1'></a>a-command

    semantic

  1. A

  1. B

73
74
75
76
77
78
79
80
81
82
    Database Name:	__Foreground__  
    Database Class:	__Color__

    caramel

KO

# COPYRIGHT

Copyright &copy; .COPYRIGHT.







|


83
84
85
86
87
88
89
90
91
92
    Database Name:	__Foreground__  
    Database Class:	__Color__

    caramel

KO

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/06.
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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -









# DESCRIPTION

  - 1

    2

    3

  1. a

     b

     c

  * foo

    snafu

  * bar

    barf

  * roo

    gork

  1. a

     b

     c

  - 4

    5

    6

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|







|

|

|

|

|

|

|

|

|

|

|

|







|


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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

  - 1

    2

    3

      1. a

         b

         c

           * foo

             snafu

           * bar

             barf

           * roo

             gork

      1. a

         b

         c

  - 4

    5

    6

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/07.
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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -









# DESCRIPTION

  - 1

  - 2

  1. a

  1. b

  * foo

    snafu

  * bar

    barf

  * roo

    gork

  1. bb

  1. a

  - 22

  - 3

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|





|

|

|

|

|

|

|

|

|

|

|



|


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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

  - 1

  - 2

      1. a

      1. b

           * foo

             snafu

           * bar

             barf

           * roo

             gork

         bb

      1. a

    22

  - 3

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/08.
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

[//000000001]: # (ALL - ..THE_MODULE..)
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (ALL(a) 5 .MODULE. "..THE_MODULE..")

# NAME

ALL - ..THE_TITLE..



















# SYNOPSIS

package require AAA  
package require BBB VVV  
package require CCC ?VVV?  

CMDNAME ...  
CMDNAME ...  
CMDNAME ...  

# DESCRIPTION

  - __NAME__

    DESCRIPTION ::__Command__::

  - __NAME__

    DESCRIPTION ::::

  - __NAME__

    DESCRIPTION ::__Constant__::

# API

  - TERM

    DESCRIPTION ::*Emphasis*::

  - TERM

    DESCRIPTION ::"File/Path"::

  * Command-Line Switch:	__NAME__  
    Database Name:	__DBNAME__  
    Database Class:	__CLASS__

    DESCRIPTION -> NARGLE

  * Command-Line Switch:	__NAME__  
    Database Name:	__DBNAME__  
    Database Class:	__CLASS__

    DESCRIPTION ::__Function__::

  * Command-Line Switch:	__NAME__  
    Database Name:	__DBNAME__  
    Database Class:	__CLASS__

    DESCRIPTION ::__Method__::

  - TERM

    DESCRIPTION

  - CMDNAME ...

    DESCRIPTION ::__Namespace__::

  * TYPE *NAME*

    DESCRIPTION ::*Argument*::

  * TYPE *NAME*

    DESCRIPTION ::__Option__::

  * TYPE *NAME* (MODE)

    DESCRIPTION ::?Optional?::

    THE ARGUMENT IS USED IN THIS
    AND/OR THAT MANNER

  - CMDNAME ...

    DESCRIPTION ::__Package__::

  - CMDNAME ...

    DESCRIPTION ::__SystemCommand__::

  * __NAME__

    DESCRIPTION ::*Term*::

  * __NAME__

    DESCRIPTION ::__Type__::

  * __NAME__ ARGUMENT

    DESCRIPTION ::[Uri](Uri)::

## NARGLE

  1. PARAGRAPH ::[UriLabel](Uri)::

  1. PARAGRAPH ::__Variable__::

  1. PARAGRAPH ::__Widget__::

  - PARAGRAPH ::__Class__::

  - PARAGRAPH

  - PARAGRAPH

# SEE ALSO

ELSE, OTHER

# KEYWORDS

KEYA, KEYZ

# COPYRIGHT

Copyright &copy; **Copyright**









>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|





|
|
|

|













|









|
|
|

|

|
|
|

|

|
|
|

|





|



|

|

|

|

|

|

|
|

|



|



|

|

|

|

|

|

|







|

|

|

|



|



|


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

[//000000001]: # (ALL - ..THE_MODULE..)
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (ALL(a) 5 .MODULE. "..THE_MODULE..")

# NAME

ALL - ..THE_TITLE..

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

  -  [Table Of Contents](#toc)

  -  [Synopsis](#synopsis)

  -  [Description](#section1)

  -  [API](#section2)

      -  [NARGLE](#subsection1)

  -  [See Also](#see-also)

  -  [Keywords](#keywords)

  -  [Copyright](#copyright)

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

package require AAA  
package require BBB VVV  
package require CCC ?VVV?  

[CMDNAME ...](#1)  
[CMDNAME ...](#2)  
[CMDNAME ...](#3)  

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

  - __NAME__

    DESCRIPTION ::__Command__::

  - __NAME__

    DESCRIPTION ::::

  - __NAME__

    DESCRIPTION ::__Constant__::

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

  - TERM

    DESCRIPTION ::*Emphasis*::

  - TERM

    DESCRIPTION ::"File/Path"::

      * Command-Line Switch:	__NAME__  
        Database Name:	__DBNAME__  
        Database Class:	__CLASS__

        DESCRIPTION [NARGLE](#subsection1)

      * Command-Line Switch:	__NAME__  
        Database Name:	__DBNAME__  
        Database Class:	__CLASS__

        DESCRIPTION ::__Function__::

      * Command-Line Switch:	__NAME__  
        Database Name:	__DBNAME__  
        Database Class:	__CLASS__

        DESCRIPTION ::__Method__::

  - TERM

    DESCRIPTION

  - <a name='1'></a>CMDNAME ...

    DESCRIPTION ::__Namespace__::

      * TYPE *NAME*

        DESCRIPTION ::*Argument*::

      * TYPE *NAME*

        DESCRIPTION ::__Option__::

      * TYPE *NAME* (MODE)

        DESCRIPTION ::?Optional?::

            THE ARGUMENT IS USED IN THIS
            AND/OR THAT MANNER

  - <a name='2'></a>CMDNAME ...

    DESCRIPTION ::__Package__::

  - <a name='3'></a>CMDNAME ...

    DESCRIPTION ::__SystemCommand__::

      * __NAME__

        DESCRIPTION ::*Term*::

      * __NAME__

        DESCRIPTION ::__Type__::

      * __NAME__ ARGUMENT

        DESCRIPTION ::[Uri](Uri)::

## <a name='subsection1'></a>NARGLE

  1. PARAGRAPH ::[UriLabel](Uri)::

  1. PARAGRAPH ::__Variable__::

  1. PARAGRAPH ::__Widget__::

       - PARAGRAPH ::__Class__::

       - PARAGRAPH

       - PARAGRAPH

# <a name='see-also'></a>SEE ALSO

ELSE, OTHER

# <a name='keywords'></a>KEYWORDS

KEYA, KEYZ

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

Copyright &copy; **Copyright**
Changes to modules/doctools/tests/fmt/markdown/09.
1
2
3
4
5
6
7
8
9








10
11
12
13
14
15
16
17

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -









# DESCRIPTION

lorem

    1 lorem ipsum dolores

ipsum










>
>
>
>
>
>
>
>
|







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

[//000000001]: # (TEST - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (TEST(z) 3.14.15.926 .MODULE. "")

# NAME

TEST -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem

    1 lorem ipsum dolores

ipsum

27
28
29
30
31
32
33
34
35
36

ipsum

    5 lorem ipsum dolores

dolores

# COPYRIGHT

Copyright &copy; .COPYRIGHT.







|


35
36
37
38
39
40
41
42
43
44

ipsum

    5 lorem ipsum dolores

dolores

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/10.
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

[//000000001]: # (test-itemized - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-itemized(1) n .MODULE. "")

# NAME

test-itemized -









# DESCRIPTION

lorem ipsum dolores

  - lorem ipsum dolores

  - lorem ipsum dolores

    lorem ipsum dolores

  - lorem ipsum dolores

    lorem ipsum dolores

    lorem ipsum dolores

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|















|


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

[//000000001]: # (test-itemized - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-itemized(1) n .MODULE. "")

# NAME

test-itemized -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  - lorem ipsum dolores

  - lorem ipsum dolores

    lorem ipsum dolores

  - lorem ipsum dolores

    lorem ipsum dolores

    lorem ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/11.
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

[//000000001]: # (test-enumerated - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-enumerated(1) n .MODULE. "")

# NAME

test-enumerated -









# DESCRIPTION

lorem ipsum dolores

  1. lorem ipsum dolores

  1. lorem ipsum dolores

     lorem ipsum dolores

  1. lorem ipsum dolores

     lorem ipsum dolores

     lorem ipsum dolores

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|















|


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

[//000000001]: # (test-enumerated - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-enumerated(1) n .MODULE. "")

# NAME

test-enumerated -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  1. lorem ipsum dolores

  1. lorem ipsum dolores

     lorem ipsum dolores

  1. lorem ipsum dolores

     lorem ipsum dolores

     lorem ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/12.
1
2
3
4
5
6
7
8
9








10
11
12
13
14
15
16
17

[//000000001]: # (test-definitions - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-definitions(1) n .MODULE. "")

# NAME

test-definitions -









# DESCRIPTION

lorem ipsum dolores

  - lorem

    ipsum dolores










>
>
>
>
>
>
>
>
|







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

[//000000001]: # (test-definitions - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-definitions(1) n .MODULE. "")

# NAME

test-definitions -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  - lorem

    ipsum dolores

25
26
27
28
29
30
31
32
33
34

    ipsum dolores

    lorem ipsum dolores

    lorem ipsum dolores

# COPYRIGHT

Copyright &copy; .COPYRIGHT.







|


33
34
35
36
37
38
39
40
41
42

    ipsum dolores

    lorem ipsum dolores

    lorem ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/13.
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

[//000000001]: # (test-itemized-examples - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-itemized-examples(1) n .MODULE. "")

# NAME

test-itemized-examples -









# DESCRIPTION

lorem ipsum dolores

  -     A lorem ipsum dolores

  - lorem ipsum dolores

    B lorem ipsum dolores

  - lorem ipsum dolores

  - lorem ipsum dolores

    C lorem ipsum dolores

  - lorem ipsum dolores

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|







|

|



|



|


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

[//000000001]: # (test-itemized-examples - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-itemized-examples(1) n .MODULE. "")

# NAME

test-itemized-examples -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  -     A lorem ipsum dolores

  - lorem ipsum dolores

        B lorem ipsum dolores

    lorem ipsum dolores

  - lorem ipsum dolores

        C lorem ipsum dolores

  - lorem ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/14.
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

[//000000001]: # (test-enumerated-examples - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-enumerated-examples(1) n .MODULE. "")

# NAME

test-enumerated-examples -









# DESCRIPTION

lorem ipsum dolores

  1.     A1 lorem ipsum dolores

  1. lorem ipsum dolores

    B2 lorem ipsum dolores

  1. lorem ipsum dolores

  1. lorem ipsum dolores

    C3 lorem ipsum dolores

  1. lorem ipsum dolores

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|







|

|



|



|


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

[//000000001]: # (test-enumerated-examples - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-enumerated-examples(1) n .MODULE. "")

# NAME

test-enumerated-examples -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  1.     A1 lorem ipsum dolores

  1. lorem ipsum dolores

         B2 lorem ipsum dolores

     lorem ipsum dolores

  1. lorem ipsum dolores

         C3 lorem ipsum dolores

  1. lorem ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/15.
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

[//000000001]: # (test-definition-examples - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-definition-examples(1) n .MODULE. "")

# NAME

test-definition-examples -









# DESCRIPTION

lorem ipsum dolores

  - lorem

    A1 lorem ipsum dolores

  - lorem

    ipsum dolores

    B2 lorem ipsum dolores

    lorem ipsum dolores

  - lorem

    ipsum dolores

    C3 lorem ipsum dolores

  - lorem

    ipsum dolores

# COPYRIGHT

Copyright &copy; .COPYRIGHT.









>
>
>
>
>
>
>
>
|





|





|







|





|


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

[//000000001]: # (test-definition-examples - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-definition-examples(1) n .MODULE. "")

# NAME

test-definition-examples -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  - lorem

        A1 lorem ipsum dolores

  - lorem

    ipsum dolores

        B2 lorem ipsum dolores

    lorem ipsum dolores

  - lorem

    ipsum dolores

        C3 lorem ipsum dolores

  - lorem

    ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Added modules/doctools/tests/fmt/markdown/16.
























































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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

[//000000001]: # (test-itemized-nested - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-itemized-nested(1) n .MODULE. "")

# NAME

test-itemized-nested -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  - lorem ipsum dolores

      * lorem ipsum dolores

      * lorem ipsum dolores

        lorem ipsum dolores

      * lorem ipsum dolores

        lorem ipsum dolores

        lorem ipsum dolores

  - lorem ipsum dolores

    lorem ipsum dolores

  - lorem ipsum dolores

    lorem ipsum dolores

      * lorem ipsum dolores

      * lorem ipsum dolores

        lorem ipsum dolores

      * lorem ipsum dolores

        lorem ipsum dolores

        lorem ipsum dolores

    lorem ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Added modules/doctools/tests/fmt/markdown/17.
























































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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

[//000000001]: # (test-enumerated-nested - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-enumerated-nested(1) n .MODULE. "")

# NAME

test-enumerated-nested -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  1. lorem ipsum dolores

       1) lorem ipsum dolores

       1) lorem ipsum dolores

          lorem ipsum dolores

       1) lorem ipsum dolores

          lorem ipsum dolores

          lorem ipsum dolores

  1. lorem ipsum dolores

     lorem ipsum dolores

  1. lorem ipsum dolores

     lorem ipsum dolores

       1) lorem ipsum dolores

       1) lorem ipsum dolores

          lorem ipsum dolores

       1) lorem ipsum dolores

          lorem ipsum dolores

          lorem ipsum dolores

     lorem ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Added modules/doctools/tests/fmt/markdown/18.




























































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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]: # (test-definitions-nested - )
[//000000002]: # (Generated from file '.FILE.' by tcllib/doctools with format 'markdown')
[//000000003]: # (test-definitions-nested(1) n .MODULE. "")

# NAME

test-definitions-nested -

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

  -  [Table Of Contents](#toc)

  -  [Description](#section1)

  -  [Copyright](#copyright)

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

lorem ipsum dolores

  - lorem

    ipsum dolores

      * lorem

        ipsum dolores

      * lorem

        ipsum dolores

        lorem ipsum dolores

      * lorem

        ipsum dolores

        lorem ipsum dolores

        lorem ipsum dolores

  - lorem

    ipsum dolores

    lorem ipsum dolores

  - lorem

    ipsum dolores

    lorem ipsum dolores

      * lorem

        ipsum dolores

      * lorem

        ipsum dolores

        lorem ipsum dolores

      * lorem

        ipsum dolores

        lorem ipsum dolores

        lorem ipsum dolores

    lorem ipsum dolores

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

Copyright &copy; .COPYRIGHT.
Changes to modules/doctools/tests/fmt/markdown/index.
11
12
13
14
15
16
17



  * [09.md](09.md)
  * [10.md](10.md)
  * [11.md](11.md)
  * [12.md](12.md)
  * [13.md](13.md)
  * [14.md](14.md)
  * [15.md](15.md)










>
>
>
11
12
13
14
15
16
17
18
19
20
  * [09.md](09.md)
  * [10.md](10.md)
  * [11.md](11.md)
  * [12.md](12.md)
  * [13.md](13.md)
  * [14.md](14.md)
  * [15.md](15.md)
  * [16.md](16.md)
  * [17.md](17.md)
  * [18.md](18.md)
Added modules/doctools/tests/fmt/nroff/16.


















































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
'\"
'\" Generated from file '\&.FILE\&.' by tcllib/doctools with format 'nroff'
'\" Copyright (c) \&.COPYRIGHT\&.
'\"
.TH "test-itemized-nested" 1 n \&.MODULE\&. ""
.so man.macros
.BS
.SH NAME
test-itemized-nested \-
.SH DESCRIPTION
lorem ipsum dolores
.IP \(bu
lorem ipsum dolores
.RS
.IP \(bu
lorem ipsum dolores
.IP \(bu
lorem ipsum dolores
.sp
lorem ipsum dolores
.IP \(bu
lorem ipsum dolores
.sp
lorem ipsum dolores
.sp
lorem ipsum dolores
.RE
.IP \(bu
lorem ipsum dolores
.sp
lorem ipsum dolores
.IP \(bu
lorem ipsum dolores
.sp
lorem ipsum dolores
.RS
.IP \(bu
lorem ipsum dolores
.IP \(bu
lorem ipsum dolores
.sp
lorem ipsum dolores
.IP \(bu
lorem ipsum dolores
.sp
lorem ipsum dolores
.sp
lorem ipsum dolores
.RE
.sp
lorem ipsum dolores
.PP
.SH COPYRIGHT
.nf
Copyright (c) \&.COPYRIGHT\&.

.fi
Added modules/doctools/tests/fmt/nroff/17.


















































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
'\"
'\" Generated from file '\&.FILE\&.' by tcllib/doctools with format 'nroff'
'\" Copyright (c) \&.COPYRIGHT\&.
'\"
.TH "test-enumerated-nested" 1 n \&.MODULE\&. ""
.so man.macros
.BS
.SH NAME
test-enumerated-nested \-
.SH DESCRIPTION
lorem ipsum dolores
.IP [1]
lorem ipsum dolores
.RS
.IP [1]
lorem ipsum dolores
.IP [2]
lorem ipsum dolores
.sp
lorem ipsum dolores
.IP [3]
lorem ipsum dolores
.sp
lorem ipsum dolores
.sp
lorem ipsum dolores
.RE
.IP [2]
lorem ipsum dolores
.sp
lorem ipsum dolores
.IP [3]
lorem ipsum dolores
.sp
lorem ipsum dolores
.RS
.IP [1]
lorem ipsum dolores
.IP [2]
lorem ipsum dolores
.sp
lorem ipsum dolores
.IP [3]
lorem ipsum dolores
.sp
lorem ipsum dolores
.sp
lorem ipsum dolores
.RE
.sp
lorem ipsum dolores
.PP
.SH COPYRIGHT
.nf
Copyright (c) \&.COPYRIGHT\&.

.fi
Added modules/doctools/tests/fmt/nroff/18.




































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
'\"
'\" Generated from file '\&.FILE\&.' by tcllib/doctools with format 'nroff'
'\" Copyright (c) \&.COPYRIGHT\&.
'\"
.TH "test-definitions-nested" 1 n \&.MODULE\&. ""
.so man.macros
.BS
.SH NAME
test-definitions-nested \-
.SH DESCRIPTION
lorem ipsum dolores
.TP
lorem
ipsum dolores
.RS
.TP
lorem
ipsum dolores
.TP
lorem
ipsum dolores
.sp
lorem ipsum dolores
.TP
lorem
ipsum dolores
.sp
lorem ipsum dolores
.sp
lorem ipsum dolores
.RE
.TP
lorem
ipsum dolores
.sp
lorem ipsum dolores
.TP
lorem
ipsum dolores
.sp
lorem ipsum dolores
.RS
.TP
lorem
ipsum dolores
.TP
lorem
ipsum dolores
.sp
lorem ipsum dolores
.TP
lorem
ipsum dolores
.sp
lorem ipsum dolores
.sp
lorem ipsum dolores
.RE
.sp
lorem ipsum dolores
.PP
.SH COPYRIGHT
.nf
Copyright (c) \&.COPYRIGHT\&.

.fi
Added modules/doctools/tests/fmt/null/16.
Added modules/doctools/tests/fmt/null/17.
Added modules/doctools/tests/fmt/null/18.
Changes to modules/doctools/tests/fmt/text/07.
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

                barf

            roo

                gork

        [3] bb

        [4] a

    *   22

    *   3

COPYRIGHT
=========

Copyright (c) .COPYRIGHT.







|

|

|







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

                barf

            roo

                gork

            bb

        [3] a

        22

    *   3

COPYRIGHT
=========

Copyright (c) .COPYRIGHT.
Changes to modules/doctools/tests/fmt/text/13.
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

    *   | A lorem ipsum dolores

    *   lorem ipsum dolores

        | B lorem ipsum dolores

    *   lorem ipsum dolores

    *   lorem ipsum dolores

        | C lorem ipsum dolores

    *   lorem ipsum dolores








|







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

    *   | A lorem ipsum dolores

    *   lorem ipsum dolores

        | B lorem ipsum dolores

        lorem ipsum dolores

    *   lorem ipsum dolores

        | C lorem ipsum dolores

    *   lorem ipsum dolores

Changes to modules/doctools/tests/fmt/text/14.
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

    [1] | A1 lorem ipsum dolores

    [2] lorem ipsum dolores

        | B2 lorem ipsum dolores

    [3] lorem ipsum dolores

    [4] lorem ipsum dolores

        | C3 lorem ipsum dolores

    [5] lorem ipsum dolores

COPYRIGHT
=========

Copyright (c) .COPYRIGHT.







|

|



|





15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

    [1] | A1 lorem ipsum dolores

    [2] lorem ipsum dolores

        | B2 lorem ipsum dolores

        lorem ipsum dolores

    [3] lorem ipsum dolores

        | C3 lorem ipsum dolores

    [4] lorem ipsum dolores

COPYRIGHT
=========

Copyright (c) .COPYRIGHT.
Added modules/doctools/tests/fmt/text/16.














































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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

test-itemized-nested - 
Generated from file '.FILE.' by tcllib/doctools with format 'text'
test-itemized-nested(1) n .MODULE. ""

NAME
====

test-itemized-nested -

DESCRIPTION
===========

lorem ipsum dolores

    *   lorem ipsum dolores

        -   lorem ipsum dolores

        -   lorem ipsum dolores

            lorem ipsum dolores

        -   lorem ipsum dolores

            lorem ipsum dolores

            lorem ipsum dolores

    *   lorem ipsum dolores

        lorem ipsum dolores

    *   lorem ipsum dolores

        lorem ipsum dolores

        -   lorem ipsum dolores

        -   lorem ipsum dolores

            lorem ipsum dolores

        -   lorem ipsum dolores

            lorem ipsum dolores

            lorem ipsum dolores

        lorem ipsum dolores

COPYRIGHT
=========

Copyright (c) .COPYRIGHT.
Added modules/doctools/tests/fmt/text/17.














































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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

test-enumerated-nested - 
Generated from file '.FILE.' by tcllib/doctools with format 'text'
test-enumerated-nested(1) n .MODULE. ""

NAME
====

test-enumerated-nested -

DESCRIPTION
===========

lorem ipsum dolores

    [1] lorem ipsum dolores

        (1) lorem ipsum dolores

        (2) lorem ipsum dolores

            lorem ipsum dolores

        (3) lorem ipsum dolores

            lorem ipsum dolores

            lorem ipsum dolores

    [2] lorem ipsum dolores

        lorem ipsum dolores

    [3] lorem ipsum dolores

        lorem ipsum dolores

        (1) lorem ipsum dolores

        (2) lorem ipsum dolores

            lorem ipsum dolores

        (3) lorem ipsum dolores

            lorem ipsum dolores

            lorem ipsum dolores

        lorem ipsum dolores

COPYRIGHT
=========

Copyright (c) .COPYRIGHT.
Added modules/doctools/tests/fmt/text/18.


















































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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

test-definitions-nested - 
Generated from file '.FILE.' by tcllib/doctools with format 'text'
test-definitions-nested(1) n .MODULE. ""

NAME
====

test-definitions-nested -

DESCRIPTION
===========

lorem ipsum dolores

    lorem

        ipsum dolores

        lorem

            ipsum dolores

        lorem

            ipsum dolores

            lorem ipsum dolores

        lorem

            ipsum dolores

            lorem ipsum dolores

            lorem ipsum dolores

    lorem

        ipsum dolores

        lorem ipsum dolores

    lorem

        ipsum dolores

        lorem ipsum dolores

        lorem

            ipsum dolores

        lorem

            ipsum dolores

            lorem ipsum dolores

        lorem

            ipsum dolores

            lorem ipsum dolores

            lorem ipsum dolores

        lorem ipsum dolores

COPYRIGHT
=========

Copyright (c) .COPYRIGHT.
Added modules/doctools/tests/fmt/tmml/16.




























































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
<!-- Generated from file '.FILE.' by tcllib/doctools with format 'tmml' -->
<manpage id='.FILE' cat='cmd' title='test-itemized-nested' version='n' package='.MODULE.'>
<head>
<info key='copyright' value='Copyright (c) .COPYRIGHT.'/>
</head>
<namesection>
<name>test-itemized-nested</name>
<desc></desc>

</namesection>


<section id='section1'>
<title>DESCRIPTION</title>
lorem ipsum dolores

<ul>

<li> lorem ipsum dolores

<ul>

<li> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>

</ul>
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores

<ul>

<li> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>

</ul>
<br/> lorem ipsum dolores
</li>

</ul>
</section>



</manpage>
Added modules/doctools/tests/fmt/tmml/17.




























































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
<!-- Generated from file '.FILE.' by tcllib/doctools with format 'tmml' -->
<manpage id='.FILE' cat='cmd' title='test-enumerated-nested' version='n' package='.MODULE.'>
<head>
<info key='copyright' value='Copyright (c) .COPYRIGHT.'/>
</head>
<namesection>
<name>test-enumerated-nested</name>
<desc></desc>

</namesection>


<section id='section1'>
<title>DESCRIPTION</title>
lorem ipsum dolores

<ol>

<li> lorem ipsum dolores

<ol>

<li> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>

</ol>
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores

<ol>

<li> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>
<li> lorem ipsum dolores
<br/> lorem ipsum dolores
<br/> lorem ipsum dolores
</li>

</ol>
<br/> lorem ipsum dolores
</li>

</ol>
</section>



</manpage>
Added modules/doctools/tests/fmt/tmml/18.


















































































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
<!-- Generated from file '.FILE.' by tcllib/doctools with format 'tmml' -->
<manpage id='.FILE' cat='cmd' title='test-definitions-nested' version='n' package='.MODULE.'>
<head>
<info key='copyright' value='Copyright (c) .COPYRIGHT.'/>
</head>
<namesection>
<name>test-definitions-nested</name>
<desc></desc>

</namesection>


<section id='section1'>
<title>DESCRIPTION</title>
lorem ipsum dolores

<dl>

<dle>
<dt>lorem</dt>
<dd> ipsum dolores

<dl>

<dle>
<dt>lorem</dt>
<dd> ipsum dolores
</dd>
</dle>
<dle>
<dt>lorem</dt>
<dd> ipsum dolores
<br/> lorem ipsum dolores
</dd>
</dle>
<dle>
<dt>lorem</dt>
<dd> ipsum dolores
<br/> lorem ipsum dolores
<br/> lorem ipsum dolores
</dd>
</dle>

</dl>
</dd>
</dle>
<dle>
<dt>lorem</dt>
<dd> ipsum dolores
<br/> lorem ipsum dolores
</dd>
</dle>
<dle>
<dt>lorem</dt>
<dd> ipsum dolores
<br/> lorem ipsum dolores

<dl>

<dle>
<dt>lorem</dt>
<dd> ipsum dolores
</dd>
</dle>
<dle>
<dt>lorem</dt>
<dd> ipsum dolores
<br/> lorem ipsum dolores
</dd>
</dle>
<dle>
<dt>lorem</dt>
<dd> ipsum dolores
<br/> lorem ipsum dolores
<br/> lorem ipsum dolores
</dd>
</dle>

</dl>
<br/> lorem ipsum dolores
</dd>
</dle>

</dl>
</section>



</manpage>
Added modules/doctools/tests/fmt/wiki/16.














































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
'''test-itemized-nested n''' '''.MODULE.'''




**DESCRIPTION**

lorem ipsum dolores

   *  lorem ipsum dolores

   *  lorem ipsum dolores

   *  lorem ipsum dolores
lorem ipsum dolores

   *  lorem ipsum dolores
lorem ipsum dolores
lorem ipsum dolores

   *  lorem ipsum dolores
lorem ipsum dolores

   *  lorem ipsum dolores
lorem ipsum dolores

   *  lorem ipsum dolores

   *  lorem ipsum dolores
lorem ipsum dolores

   *  lorem ipsum dolores
lorem ipsum dolores
lorem ipsum dolores
lorem ipsum dolores

**COPYRIGHT**

 Copyright (c) .COPYRIGHT.
Added modules/doctools/tests/fmt/wiki/17.














































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
'''test-enumerated-nested n''' '''.MODULE.'''




**DESCRIPTION**

lorem ipsum dolores

   1.  lorem ipsum dolores

   1.  lorem ipsum dolores

   1.  lorem ipsum dolores
lorem ipsum dolores

   1.  lorem ipsum dolores
lorem ipsum dolores
lorem ipsum dolores

   1.  lorem ipsum dolores
lorem ipsum dolores

   1.  lorem ipsum dolores
lorem ipsum dolores

   1.  lorem ipsum dolores

   1.  lorem ipsum dolores
lorem ipsum dolores

   1.  lorem ipsum dolores
lorem ipsum dolores
lorem ipsum dolores
lorem ipsum dolores

**COPYRIGHT**

 Copyright (c) .COPYRIGHT.
Added modules/doctools/tests/fmt/wiki/18.














































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
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
'''test-definitions-nested n''' '''.MODULE.'''




**DESCRIPTION**

lorem ipsum dolores

   lorem:    ipsum dolores  

   lorem:    ipsum dolores 

   lorem:    ipsum dolores 
lorem ipsum dolores

   lorem:    ipsum dolores 
lorem ipsum dolores
lorem ipsum dolores

   lorem:    ipsum dolores 
lorem ipsum dolores

   lorem:    ipsum dolores 
lorem ipsum dolores

   lorem:    ipsum dolores 

   lorem:    ipsum dolores 
lorem ipsum dolores

   lorem:    ipsum dolores 
lorem ipsum dolores
lorem ipsum dolores
lorem ipsum dolores

**COPYRIGHT**

 Copyright (c) .COPYRIGHT.