1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
#! /bin/sh
# -*- tcl -*- \
exec tclsh "$0" ${1+"$@"}
lappend auto_path [file dirname [file dirname [info script]]]
package require doctools
# ---------------------------------------------------------------------
# 1. Handle command line options, input and output
# 2. Initialize a doctools object.
# 3. Run the input through the object.
# 4. Write output.
# ---------------------------------------------------------------------
proc usage {{exitstate 1}} {
global argv0
puts "Usage: $argv0\
?-h|--help|-help|-??\
?-help-fmt|--help-fmt?\
?-module module?\
?-deprecated?\
?-copyright text?\
format in|- ?out|-?"
exit $exitstate
}
# ---------------------------------------------------------------------
proc fmthelp {} {
# Tcllib FR #527029: short reference of formatting commands.
global argv0
puts "$argv0 [doctools::help]"
exit 0
}
# ---------------------------------------------------------------------
# 1. Handle command line options, input and output
proc cmdline {} {
global argv0 argv format in out extmodule deprecated copyright
set copyright ""
set extmodule ""
set deprecated 0
while {[string match -* [set opt [lindex $argv 0]]]} {
switch -exact -- $opt {
-module {
set extmodule [lindex $argv 1]
set argv [lrange $argv 2 end]
continue
}
-copyright {
set copyright [lindex $argv 1]
set argv [lrange $argv 2 end]
continue
}
-deprecated {
set deprecated 1
set argv [lrange $argv 1 end]
}
-help - -h - --help - -? {
# Tcllib FR #527029
usage 0
}
-help-fmt - --help-fmt {
# Tcllib FR #527029
fmthelp
}
default {
# Unknown option
usage
}
}
}
if {[llength $argv] < 3} {
usage
}
foreach {format in out} $argv break
if {$format == {} || $in == {}} {
usage
}
if {$out == {}} {set out -}
return $format
}
# ---------------------------------------------------------------------
# 3. Read input. Also providing the namespace with file information.
proc get_input {} {
global in
if {[string equal $in -]} {
return [read stdin]
} else {
set if [open $in r]
set text [read $if]
close $if
return $text
}
}
# ---------------------------------------------------------------------
# 4. Write output.
proc write_out {text} {
global out
if {[string equal $out -]} {
puts -nonewline stdout $text
} else {
set of [open $out w]
puts -nonewline $of $text
close $of
}
}
# ---------------------------------------------------------------------
# Get it all together
proc main {} {
global format deprecated extmodule in copyright
#if {[catch {}
cmdline
::doctools::new dt -format $format -deprecated $deprecated -file $in
if {$extmodule != {}} {
dt configure -module $extmodule
}
if {$copyright != {}} {
dt configure -copyright $copyright
}
write_out [dt format [get_input]]
set warnings [dt warnings]
if {[llength $warnings] > 0} {
puts stderr [join $warnings \n]
}
#{} msg]} {}
#puts stderr "Execution error: $msg"
#{}
return
}
# ---------------------------------------------------------------------
main
exit
|
