modules/html/html.man | 146 +++++++++++++++++-------------
modules/html/html.tcl | 55 +++++++++---
modules/html/html.test | 224 +++++++++++++++++++++++++++++++++++-----------
modules/html/pkgIndex.tcl | 2 +-
4 files changed, 297 insertions(+), 130 deletions(-)
diff --git a/modules/html/html.man b/modules/html/html.man
index efb41fc..f18cf4b 100644
--- a/modules/html/html.man
+++ b/modules/html/html.man
@@ -1,10 +1,19 @@
[comment {-*- tcl -*- doctools manpage}]
-[manpage_begin html n 1.4]
+[vset HTML_VERSION 1.4.4]
+[manpage_begin html n [vset HTML_VERSION]]
+[see_also htmlparse]
+[see_also ncgi]
+[keywords checkbox]
+[keywords checkbutton]
+[keywords form]
+[keywords html]
+[keywords radiobutton]
+[keywords table]
[moddesc {HTML Generation}]
[titledesc {Procedures to generate HTML structures}]
[category {CGI programming}]
[require Tcl 8.2]
-[require html [opt 1.4]]
+[require html [opt [vset HTML_VERSION]]]
[description]
[para]
@@ -26,13 +35,11 @@ for HTML tag parameters.
define an author for the page. The author is noted in a comment in
the HEAD section.
-
[call [cmd ::html::bodyTag] [arg args]]
Generate a [term body] tag. The tag parameters are taken from [arg args] or
from the body.* attributes define with [cmd ::html::init].
-
[call [cmd ::html::cell] [arg {param value}] [opt [arg tag]]]
Generate a [term td] (or [term th]) tag, a value, and a closing
@@ -41,13 +48,11 @@ tag parameters come from [arg param] or TD.* attributes defined with
[cmd ::html::init]. This uses [cmd ::html::font] to insert a standard
[term font] tag into the table cell. The [arg tag] argument defaults to "td".
-
[call [cmd ::html::checkbox] [arg {name value}]]
Generate a [term checkbox] form element with the specified name and value.
This uses [cmd ::html::checkValue].
-
[call [cmd ::html::checkSet] [arg {key sep list}]]
Generate a set of [term checkbox] form elements and associated labels. The
@@ -56,21 +61,18 @@ This uses [cmd ::html::checkbox]. All the [term checkbox] buttons share the
same [arg key] for their name. The [arg sep] is text used to separate
the elements.
-
[call [cmd ::html::checkValue] [arg name] [opt [arg value]]]
-Generate the "name=[arg name] value=[arg value] for a [term checkbox] form
+Generate the "name=[arg name] value=[arg value]" for a [term checkbox] form
element. If the CGI variable [arg name] has the value [arg value],
then SELECTED is added to the return value. [arg value] defaults to
"1".
-
[call [cmd ::html::closeTag]]
Pop a tag off the stack created by [cmd ::html::openTag] and generate
the corresponding close tag (e.g.,