You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-cvs@tcl.apache.org by mx...@apache.org on 2025/01/27 09:48:30 UTC
(tcl-site) branch master updated (f4ee7cd -> f378212)
This is an automated email from the ASF dual-hosted git repository.
mxmanghi pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/tcl-site.git
from f4ee7cd Update after release of 3.2.6 (long forgotten site update)
new c90f6c1 Update Rivet manual
new f378212 switch back to tcl-size as published branch
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.asf.yaml | 8 +-
rivet/manual3.2/abort_code.html | 2 +-
rivet/manual3.2/abort_page.html | 2 +-
rivet/manual3.2/apache_log_error.html | 2 +-
rivet/manual3.2/apache_table.html | 2 +-
rivet/manual3.2/asciiglyphs.html | 4 +-
rivet/manual3.2/calendar.html | 4 +-
rivet/manual3.2/calendar_package.html | 2 +-
rivet/manual3.2/catch.html | 2 +-
rivet/manual3.2/clock_to_rfc.html | 2 +-
rivet/manual3.2/cmake.html | 2 +-
rivet/manual3.2/cookie.html | 2 +-
rivet/manual3.2/debug.html | 2 +-
rivet/manual3.2/decode.html | 2 +-
rivet/manual3.2/dio_package.html | 20 ++-
rivet/manual3.2/diodisplay_package.html | 12 +-
rivet/manual3.2/directives.html | 4 +-
rivet/manual3.2/encode.html | 2 +-
rivet/manual3.2/entities.html | 2 +-
rivet/manual3.2/env.html | 2 +-
rivet/manual3.2/escape_sgml_chars.html | 2 +-
rivet/manual3.2/escape_shell_command.html | 2 +-
rivet/manual3.2/escape_string.html | 2 +-
rivet/manual3.2/examples.html | 2 +-
rivet/manual3.2/exit.html | 2 +-
rivet/manual3.2/fb.html | 8 +-
rivet/manual3.2/form.html | 2 +-
rivet/manual3.2/form_package.html | 68 ++++-----
rivet/manual3.2/formbroker.html | 2 +-
rivet/manual3.2/headers.html | 2 +-
rivet/manual3.2/help.html | 10 +-
rivet/manual3.2/html.html | 2 +-
rivet/manual3.2/html_calendar.html | 4 +-
rivet/manual3.2/http_accept.html | 2 +-
rivet/manual3.2/import_keyvalue_pairs.html | 2 +-
rivet/manual3.2/include.html | 2 +-
rivet/manual3.2/index.html | 20 +--
rivet/manual3.2/inspect.html | 2 +-
rivet/manual3.2/installation.html | 4 +-
rivet/manual3.2/internals.html | 16 +--
rivet/manual3.2/lassign_array.html | 2 +-
rivet/manual3.2/lazybridge.html | 221 ++++++++++++++---------------
rivet/manual3.2/lempty.html | 2 +-
rivet/manual3.2/lmatch.html | 2 +-
rivet/manual3.2/load_cookies.html | 2 +-
rivet/manual3.2/load_env.html | 2 +-
rivet/manual3.2/load_headers.html | 2 +-
rivet/manual3.2/load_response.html | 2 +-
rivet/manual3.2/lremove.html | 2 +-
rivet/manual3.2/makeurl.html | 2 +-
rivet/manual3.2/no_body.html | 2 +-
rivet/manual3.2/parray.html | 2 +-
rivet/manual3.2/parse.html | 2 +-
rivet/manual3.2/processing.html | 4 +-
rivet/manual3.2/raw_post.html | 2 +-
rivet/manual3.2/read_file.html | 2 +-
rivet/manual3.2/redirect.html | 2 +-
rivet/manual3.2/request.html | 14 +-
rivet/manual3.2/session_package.html | 14 +-
rivet/manual3.2/shorthand.html | 2 +-
rivet/manual3.2/thread_id.html | 2 +-
rivet/manual3.2/toglyphs.html | 2 +-
rivet/manual3.2/try.html | 2 +-
rivet/manual3.2/unescape_string.html | 2 +-
rivet/manual3.2/upload.html | 2 +-
rivet/manual3.2/url_script.html | 2 +-
rivet/manual3.2/var.html | 2 +-
rivet/manual3.2/wrap.html | 2 +-
rivet/manual3.2/wrapline.html | 2 +-
rivet/manual3.2/xml.html | 2 +-
rivet/manual3.2/xml_calendar.html | 6 +-
71 files changed, 276 insertions(+), 271 deletions(-)
---------------------------------------------------------------------
To unsubscribe, e-mail: site-cvs-unsubscribe@tcl.apache.org
For additional commands, e-mail: site-cvs-help@tcl.apache.org
(tcl-site) 02/02: switch back to tcl-size as published branch
Posted by mx...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mxmanghi pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tcl-site.git
commit f378212ad71014d63302f2dfddd2c4319f09cc16
Author: Massimo Manghi <mx...@apache.org>
AuthorDate: Mon Jan 27 10:37:03 2025 +0100
switch back to tcl-size as published branch
---
.asf.yaml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/.asf.yaml b/.asf.yaml
index e2f0d1d..eab81c5 100644
--- a/.asf.yaml
+++ b/.asf.yaml
@@ -3,8 +3,8 @@ staging:
profile: ~
whoami: master
-publish:
- whoami: rivet3.2.5
-
#publish:
-# whoami: asf-site
+# whoami: rivet3.2.5
+
+publish:
+ whoami: asf-site
---------------------------------------------------------------------
To unsubscribe, e-mail: site-cvs-unsubscribe@tcl.apache.org
For additional commands, e-mail: site-cvs-help@tcl.apache.org
(tcl-site) 01/02: Update Rivet manual
Posted by mx...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mxmanghi pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tcl-site.git
commit c90f6c124c8e1cab38ba2be1646d2c89a5dce91b
Author: Massimo Manghi <mx...@apache.org>
AuthorDate: Mon Jan 27 10:35:52 2025 +0100
Update Rivet manual
---
rivet/manual3.2/abort_code.html | 2 +-
rivet/manual3.2/abort_page.html | 2 +-
rivet/manual3.2/apache_log_error.html | 2 +-
rivet/manual3.2/apache_table.html | 2 +-
rivet/manual3.2/asciiglyphs.html | 4 +-
rivet/manual3.2/calendar.html | 4 +-
rivet/manual3.2/calendar_package.html | 2 +-
rivet/manual3.2/catch.html | 2 +-
rivet/manual3.2/clock_to_rfc.html | 2 +-
rivet/manual3.2/cmake.html | 2 +-
rivet/manual3.2/cookie.html | 2 +-
rivet/manual3.2/debug.html | 2 +-
rivet/manual3.2/decode.html | 2 +-
rivet/manual3.2/dio_package.html | 20 ++-
rivet/manual3.2/diodisplay_package.html | 12 +-
rivet/manual3.2/directives.html | 4 +-
rivet/manual3.2/encode.html | 2 +-
rivet/manual3.2/entities.html | 2 +-
rivet/manual3.2/env.html | 2 +-
rivet/manual3.2/escape_sgml_chars.html | 2 +-
rivet/manual3.2/escape_shell_command.html | 2 +-
rivet/manual3.2/escape_string.html | 2 +-
rivet/manual3.2/examples.html | 2 +-
rivet/manual3.2/exit.html | 2 +-
rivet/manual3.2/fb.html | 8 +-
rivet/manual3.2/form.html | 2 +-
rivet/manual3.2/form_package.html | 68 ++++-----
rivet/manual3.2/formbroker.html | 2 +-
rivet/manual3.2/headers.html | 2 +-
rivet/manual3.2/help.html | 10 +-
rivet/manual3.2/html.html | 2 +-
rivet/manual3.2/html_calendar.html | 4 +-
rivet/manual3.2/http_accept.html | 2 +-
rivet/manual3.2/import_keyvalue_pairs.html | 2 +-
rivet/manual3.2/include.html | 2 +-
rivet/manual3.2/index.html | 20 +--
rivet/manual3.2/inspect.html | 2 +-
rivet/manual3.2/installation.html | 4 +-
rivet/manual3.2/internals.html | 16 +--
rivet/manual3.2/lassign_array.html | 2 +-
rivet/manual3.2/lazybridge.html | 221 ++++++++++++++---------------
rivet/manual3.2/lempty.html | 2 +-
rivet/manual3.2/lmatch.html | 2 +-
rivet/manual3.2/load_cookies.html | 2 +-
rivet/manual3.2/load_env.html | 2 +-
rivet/manual3.2/load_headers.html | 2 +-
rivet/manual3.2/load_response.html | 2 +-
rivet/manual3.2/lremove.html | 2 +-
rivet/manual3.2/makeurl.html | 2 +-
rivet/manual3.2/no_body.html | 2 +-
rivet/manual3.2/parray.html | 2 +-
rivet/manual3.2/parse.html | 2 +-
rivet/manual3.2/processing.html | 4 +-
rivet/manual3.2/raw_post.html | 2 +-
rivet/manual3.2/read_file.html | 2 +-
rivet/manual3.2/redirect.html | 2 +-
rivet/manual3.2/request.html | 14 +-
rivet/manual3.2/session_package.html | 14 +-
rivet/manual3.2/shorthand.html | 2 +-
rivet/manual3.2/thread_id.html | 2 +-
rivet/manual3.2/toglyphs.html | 2 +-
rivet/manual3.2/try.html | 2 +-
rivet/manual3.2/unescape_string.html | 2 +-
rivet/manual3.2/upload.html | 2 +-
rivet/manual3.2/url_script.html | 2 +-
rivet/manual3.2/var.html | 2 +-
rivet/manual3.2/wrap.html | 2 +-
rivet/manual3.2/wrapline.html | 2 +-
rivet/manual3.2/xml.html | 2 +-
rivet/manual3.2/xml_calendar.html | 6 +-
70 files changed, 272 insertions(+), 267 deletions(-)
diff --git a/rivet/manual3.2/abort_code.html b/rivet/manual3.2/abort_code.html
index 85a7abe..f1dcf3f 100644
--- a/rivet/manual3.2/abort_code.html
+++ b/rivet/manual3.2/abort_code.html
@@ -1,7 +1,7 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>abort_code</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="shorthand.html" title="<?= ... ?>"><link rel="next" href="abort_page.html" title="abort_page"></hea [...]
Returns the code passed to <span style="font-family:monospace"><span class="command"><strong>abort_page</strong></span></span>
earlier during the request processing
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::abort_code</span> </div></div></div><div class="refsect1"><a name="idm794"></a><h2>Description</h2><p style="width:90%">
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::abort_code</span> </div></div></div><div class="refsect1"><a name="id2161"></a><h2>Description</h2><p style="width:90%">
Usage of this command is meaningful only in a script set as
AbortScript or AfterEveryScript.
<span style="font-family:monospace"><span class="command"><strong>abort_code</strong></span></span> returns the value of the optional
diff --git a/rivet/manual3.2/abort_page.html b/rivet/manual3.2/abort_page.html
index 81070e6..0223488 100644
--- a/rivet/manual3.2/abort_page.html
+++ b/rivet/manual3.2/abort_page.html
@@ -1,7 +1,7 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>abort_page</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="abort_code.html" title="abort_code"><link rel="next" href="apache_log_error.html" title="apache_log_error [...]
Stops outputting data to web page, similar in
purpose to PHP's <span style="font-family:monospace"><span class="command"><strong>die</strong></span></span> command.
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::abort_page</span> (<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>abort code</code></em></span> | <span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::abort_page</span> (<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>abort code</code></em></span> | <span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code [...]
This command flushes the output buffer and stops the Tcl
script from sending any more data to the client.
A normal Tcl script might use the
diff --git a/rivet/manual3.2/apache_log_error.html b/rivet/manual3.2/apache_log_error.html
index f2a7f40..8068292 100644
--- a/rivet/manual3.2/apache_log_error.html
+++ b/rivet/manual3.2/apache_log_error.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>apache_log_error</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="abort_page.html" title="abort_page"><link rel="next" href="apache_table.html" title="apache_table"> [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>apache_log_error</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="abort_page.html" title="abort_page"><link rel="next" href="apache_table.html" title="apache_table"> [...]
The apache_log_error command logs a message to the
Apache error log, whose name and location have been
set by the ErrorLog directive.
diff --git a/rivet/manual3.2/apache_table.html b/rivet/manual3.2/apache_table.html
index d579fe2..3f49c55 100644
--- a/rivet/manual3.2/apache_table.html
+++ b/rivet/manual3.2/apache_table.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>apache_table</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="apache_log_error.html" title="apache_log_error"><link rel="next" href="catch.html" title="catch"></head [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>apache_table</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="apache_log_error.html" title="apache_log_error"><link rel="next" href="catch.html" title="catch"></head [...]
The apache_table command is for accessing and manipulating
Apache tables in the request structure.
</p><p style="width:90%">
diff --git a/rivet/manual3.2/asciiglyphs.html b/rivet/manual3.2/asciiglyphs.html
index a88a73c..9fb242a 100644
--- a/rivet/manual3.2/asciiglyphs.html
+++ b/rivet/manual3.2/asciiglyphs.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>AsciiGlyphs</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="decode.html" title="decode"><link rel="next" href="toglyphs.html" title="toGlyphs"></head><body bgcolor="white" text="black [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>AsciiGlyphs</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="decode.html" title="decode"><link rel="next" href="toglyphs.html" title="toGlyphs"></head><body bgcolor="white" text="black [...]
The <span style="font-family:monospace"><span class="command"><strong>AsciiGlyphs</strong></span></span> package provides a command
to print large ASCII glyphs in an HTML fragment based on
a <pre>...</pre:> element. The shape of the glyphs was
@@ -7,7 +7,7 @@
support the whole English alphabet and some punctuation characters.
The string to be represented has to be made of pure 7-bit ASCII characters.
The package also runs standalone outside of mod_rivet
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4247"></a>Example</h3></div></div></div><pre class="programlisting">package require AsciiGlyphs
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1356"></a>Example</h3></div></div></div><pre class="programlisting">package require AsciiGlyphs
::AsciiGlyphs toGlyphs "Date: 07-12-2015"
_____ _____ ______ ___ ______ __ ___ ___ ___ __ _____
| __ \ /\ |_ _| | ____| _ / _ \ |____ | /_ ||__ \ |__ \ / _ \ /_ || ____|
diff --git a/rivet/manual3.2/calendar.html b/rivet/manual3.2/calendar.html
index 8933a38..8b548d1 100644
--- a/rivet/manual3.2/calendar.html
+++ b/rivet/manual3.2/calendar.html
@@ -1,7 +1,7 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Calendar</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="calendar_package.html" title="Calendar Package"><link rel="prev" href="calendar_package.html" title="Calendar Package"><link rel="next" href="xml_calendar.html" title="XmlCalendar"></hea [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Calendar</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="calendar_package.html" title="Calendar Package"><link rel="prev" href="calendar_package.html" title="Calendar Package"><link rel="next" href="xml_calendar.html" title="XmlCalendar"></hea [...]
The main public command for a calendar object is
<span style="font-family:monospace"><span class="command"><strong>emit</strong></span></span> that returns a calendar table
- </p></div><div class="refsect1"><a name="idm4009"></a><div class="variablelist"><p style="width:90%">
+ </p></div><div class="refsect1"><a name="id5390"></a><div class="variablelist"><p style="width:90%">
The method <span style="font-family:monospace"><span class="command"><strong>emit</strong></span></span> when invoked with a single argument
takes it as an year number and prints the whole calendar of
that year. When invoked with 2 arguments takes the first as a month, either
diff --git a/rivet/manual3.2/calendar_package.html b/rivet/manual3.2/calendar_package.html
index e971dfd..32f1b55 100644
--- a/rivet/manual3.2/calendar_package.html
+++ b/rivet/manual3.2/calendar_package.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Calendar Package</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="form_package.html" title="form"><link rel="next" href="calendar.html" title="Calendar"></head><body bgcolor="white" te [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Calendar Package</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="form_package.html" title="form"><link rel="next" href="calendar.html" title="Calendar"></head><body bgcolor="white" te [...]
The package is based on the Calendar class, a class capable
of printing an ascii calendar table that closely resembles the output
of the typical Unix <span style="font-family:monospace"><span class="command"><strong>cal</strong></span></span> command. The internal
diff --git a/rivet/manual3.2/catch.html b/rivet/manual3.2/catch.html
index c5b4d88..a02ff60 100644
--- a/rivet/manual3.2/catch.html
+++ b/rivet/manual3.2/catch.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>catch</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="apache_table.html" title="apache_table"><link rel="next" href="clock_to_rfc.html" title="clock_to_rfc850_gmt"> [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>catch</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="apache_table.html" title="apache_table"><link rel="next" href="clock_to_rfc.html" title="clock_to_rfc850_gmt"> [...]
<span style="font-family:monospace"><span class="command"><strong>::rivet::catch</strong></span></span> wraps the core language <span style="font-family:monospace"><span class="command"><strong>catch</strong></span></span>
command adding some extra error handling needed by mod_rivet design.
The rationale for Rivet to have its own <span style="font-family:monospace"><span class="command"><strong>::rivet::catch</strong></span></span> reads
diff --git a/rivet/manual3.2/clock_to_rfc.html b/rivet/manual3.2/clock_to_rfc.html
index 2a12386..dd7eb48 100644
--- a/rivet/manual3.2/clock_to_rfc.html
+++ b/rivet/manual3.2/clock_to_rfc.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>clock_to_rfc850_gmt</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="catch.html" title="catch"><link rel="next" href="cookie.html" title="cookie"></head><body bgcolo [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>clock_to_rfc850_gmt</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="catch.html" title="catch"><link rel="next" href="cookie.html" title="cookie"></head><body bgcolo [...]
Convert an integer-seconds-since-1970 click value to
RFC850 format, with the additional requirement that it be
GMT only.
diff --git a/rivet/manual3.2/cmake.html b/rivet/manual3.2/cmake.html
index d042a4d..77007fa 100644
--- a/rivet/manual3.2/cmake.html
+++ b/rivet/manual3.2/cmake.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Building Rivet 3.2 with CMake</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="installation.html" title="Apache Rivet 3.2 Installation"><link rel="next" href="directives.html" title="A [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Building Rivet 3.2 with CMake</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="installation.html" title="Apache Rivet 3.2 Installation"><link rel="next" href="directives.html" title="A [...]
Starting with 3.2 Rivet has adopted <a class="ulink" href="" target="_top">CMake</a>
as an alternate build system. The choice of introducing CMake was motivated by the
need of an easy to use and reliable build system for Windows installations. Nonetheless
diff --git a/rivet/manual3.2/cookie.html b/rivet/manual3.2/cookie.html
index 91d01a9..50926a0 100644
--- a/rivet/manual3.2/cookie.html
+++ b/rivet/manual3.2/cookie.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>cookie</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="clock_to_rfc.html" title="clock_to_rfc850_gmt"><link rel="next" href="debug.html" title="debug"></head><body [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>cookie</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="clock_to_rfc.html" title="clock_to_rfc850_gmt"><link rel="next" href="debug.html" title="debug"></head><body [...]
<span style="font-family:monospace"><span class="command"><strong>cookie</strong></span></span> gets, sets, unsets or deletes a cookie. When you
get a cookie, the command returns the value of the cookie,
or an empty string if no cookie exists.
diff --git a/rivet/manual3.2/debug.html b/rivet/manual3.2/debug.html
index 5dacd3c..fcd8c70 100644
--- a/rivet/manual3.2/debug.html
+++ b/rivet/manual3.2/debug.html
@@ -1,7 +1,7 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>debug</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="cookie.html" title="cookie"><link rel="next" href="env.html" title="env"></head><body bgcolor="white" text="bl [...]
A command to print strings, arrays
and the values of variables as specified by the arguments.
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::debug</span> <span style="font-family:monospace; font-weight: bold;">-subst</span> ?<span style="font-family:monospace; font-weight: bold;"><on|off></span>? <span style="font-family:monospace; font-weight: bold;" [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::debug</span> <span style="font-family:monospace; font-weight: bold;">-subst</span> ?<span style="font-family:monospace; font-weight: bold;"><on|off></span>? <span style="font-family:monospace; font-weight: bold;" [...]
A command to make debugging more convenient print strings, arrays
and the values of variables as specified by the arguments.
</p><p style="width:90%">
diff --git a/rivet/manual3.2/decode.html b/rivet/manual3.2/decode.html
index 474a049..d933cb6 100644
--- a/rivet/manual3.2/decode.html
+++ b/rivet/manual3.2/decode.html
@@ -1,7 +1,7 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>decode</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="entities.html" title="RivetEntities"><link rel="prev" href="encode.html" title="encode"><link rel="next" href="asciiglyphs.html" title="AsciiGlyphs"></head><body bgcolor="white" text="blac [...]
decode an SGML encoded string replacing every entity with the
corresponding character
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::decode</span> <span style="font-family:monospace; font-weight: bold;">string</span> ?<span style="font-family:monospace; font-weight: bold;">-encoding <em class="replaceable"><code><encoding></code></em>< [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::decode</span> <span style="font-family:monospace; font-weight: bold;">string</span> ?<span style="font-family:monospace; font-weight: bold;">-encoding <em class="replaceable"><code><encoding></code></em>< [...]
<span style="font-family:monospace"><span class="command"><strong>::rivet::decode</strong></span></span> implements the inverse function of
<span style="font-family:monospace"><span class="command"><strong>::rivet::encode</strong></span></span>. The input string is scanned searching
and replacing every SGML entity with its corresponding character.
diff --git a/rivet/manual3.2/dio_package.html b/rivet/manual3.2/dio_package.html
index 6d14e52..89184b5 100644
--- a/rivet/manual3.2/dio_package.html
+++ b/rivet/manual3.2/dio_package.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>DIO</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="dio.html" title="DIO - Database Interface Objects"><link rel="prev" href="dio.html" title="DIO - Database Interface Objects"><link rel="next" href="diodisplay.html" title="DIODisplay - Databa [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>DIO</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="dio.html" title="DIO - Database Interface Objects"><link rel="prev" href="dio.html" title="DIO - Database Interface Objects"><link rel="next" href="diodisplay.html" title="DIODisplay - Databa [...]
<span style="font-family:monospace"><span class="command"><strong>DIO</strong></span></span> is designed to be a generic,
object-oriented interface to SQL databases. Its main goal
is to be as generic as possible, but since not all SQL
@@ -8,14 +8,22 @@
interface generic.
</p><p style="width:90%">
interface - The name of the database
- interface. Currently supported interfaces are
- Postgresql and Mysql.
+ interface. Currently supported direct interfaces are
+ Postgresql, Mysql,
+ Oracle and Sqlite.
+ Start with version 1.2 DIO supports also the <a class="ulink" href="https://https://core.tcl-lang.org/tdbc" target="_top">TDBC</a>
+ interface through the Tdbc interfaces.
+ In this form the command requires a further argument for one of the
+ TDBC supported DBMS driver mysql. TDBC drivers are:
+ mysql (supports also MariaDB),
+ odbc (provides also support for Oracle),
+ postgresql and sqlite
</p><p style="width:90%">
If <em class="replaceable"><code>objectName</code></em> is
- specified, DIO creates an object of that name. If there is
+ specified, DIO creates an object of that name. If there is
no <em class="replaceable"><code>objectName</code></em>
given, DIO will automatically generate a unique object ID
- </p></div><div class="refsect1"><a name="idm2119"></a><h2>Options</h2><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-host</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="re [...]
+ </p></div><div class="refsect1"><a name="id3509"></a><h2>Options</h2><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-host</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="rep [...]
The hostname of the computer to connect to. If none
is given, DIO assumes the local host.
</div></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-port</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>portNumber</code></em></span>?</div></div><div style="margin-bottom:1.5ex ; paddi [...]
@@ -35,7 +43,7 @@
field specified as AUTO.</div></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-sequence</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>sequenceName</code></em></span>?</div></div><div style=" [...]
If DIO is automatically generating keys, it will use
this sequence as a means to gain a unique number for
- the stored key.</div></div></dd></dl></div></div><div class="refsect1"><a name="idm2189"></a><h2>DIO Object Commands</h2><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code> [...]
+ the stored key.</div></div></dd></dl></div></div><div class="refsect1"><a name="id3579"></a><h2>DIO Object Commands</h2><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>o [...]
Execute request as a SQL query and
create an array from the first record found. The
array is set with the fields of the table and the
diff --git a/rivet/manual3.2/diodisplay_package.html b/rivet/manual3.2/diodisplay_package.html
index d3a6893..22101dc 100644
--- a/rivet/manual3.2/diodisplay_package.html
+++ b/rivet/manual3.2/diodisplay_package.html
@@ -1,8 +1,8 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>DIODisplay</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="diodisplay.html" title="DIODisplay - Database Interface Objects Display Class"><link rel="prev" href="diodisplay.html" title="DIODisplay - Database Interface Objects Display Class"><li [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>DIODisplay</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="diodisplay.html" title="DIODisplay - Database Interface Objects Display Class"><link rel="prev" href="diodisplay.html" title="DIODisplay - Database Interface Objects Display Class"><li [...]
DIODisplay is an HTML display class that uses a DIO object
to do the database work and a form object to do the
displaying.
- </p></div><div class="refsect1"><a name="idm2737"></a><h2>Options</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">
+ </p></div><div class="refsect1"><a name="id4127"></a><h2>Options</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-DIO</span> <span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>dioObject</code></em></span> </div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
The DIO object to be used in conjunction with this
@@ -82,7 +82,7 @@
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
The title of the display object. This will be output
as the title of the HTML document.
- </div></div></dd></dl></div><div class="refsect2"><a name="idm2840"></a><h3>DIO Display Object Commands</h3><div class="variablelist"><dl class="variablelist"><dt><span class="term">
+ </div></div></dd></dl></div><div class="refsect2"><a name="id4230"></a><h3>DIO Display Object Commands</h3><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace"><em class="replaceable"><code>objectName</code></em></span> <span style="font-family:monospace; font-weight: bold;">cleanup</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>value</code></em></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Return the current cleanup value. If
@@ -288,7 +288,7 @@
Return the current value value. If
<em class="replaceable"><code>value</code></em> is
specified, it sets a new value for value.
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3153"></a><h3>DIO Display Functions</h3><p style="width:90%">
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id4543"></a><h3>DIO Display Functions</h3><p style="width:90%">
These functions are called from the
<span style="font-family:monospace"><span class="command"><strong>show</strong></span></span> method when a form response
variable called <code class="varname">mode</code> is set. If no
@@ -369,7 +369,7 @@
<code class="varname">query</code>. Once any number of records
are found, <span style="font-family:monospace"><span class="command"><strong>Search</strong></span></span> displays the
results in rows.
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3234"></a><h3>DIO Display Fields</h3><p style="width:90%">
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id4624"></a><h3>DIO Display Fields</h3><p style="width:90%">
Display fields are created with the
<span style="font-family:monospace"><span class="command"><strong>field</strong></span></span> command of the DIODisplay object.
Each field is created as a new DIODisplayField object or
@@ -422,7 +422,7 @@
Or, if type were textarea, you could define
-rows and -cols to
specify its row and column count.
- </p></div><div class="refsect2"><a name="idm3292"></a><h3>DIO Display Field Types</h3><p style="width:90%">
+ </p></div><div class="refsect2"><a name="id4682"></a><h3>DIO Display Field Types</h3><p style="width:90%">
The following is a list of recognized field types by
DIODisplay. Some are standard HTML form fields, and
others are DIODisplay fields which execute special actions
diff --git a/rivet/manual3.2/directives.html b/rivet/manual3.2/directives.html
index fa97ead..103f256 100644
--- a/rivet/manual3.2/directives.html
+++ b/rivet/manual3.2/directives.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Apache Rivet 3.2 Configuration</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="cmake.html" title="Building Rivet 3.2 with CMake"><link rel="next" href="processing.html" title="Apache [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Apache Rivet 3.2 Configuration</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="cmake.html" title="Building Rivet 3.2 with CMake"><link rel="next" href="processing.html" title="Apache [...]
Rivet directives are used within the Apache httpd server
configuration to set up the environment where Rivet script
will be run.
@@ -34,7 +34,7 @@
<Directory /var/www/myrivetapp>
RivetDirConf BeforeScript "source /var/www/myrivetapp/before_script.tcl"
-</Directory></pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm216"></a>Configuration Directives</h3></div></div></div><div class="table"><table align="center" title="Configuration Directives application scopes" class="directives"><thead><td>Configuration Directives</td><td>DirConf</td><td>UserConf</td><td>ServerConf</td><td>Virtual Host</td><td>Notes</td></thead><tbody><tr><td>AbortScript</td><td>X</td><td>X</td><td>X</td><td>X</td>
+</Directory></pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1341"></a>Configuration Directives</h3></div></div></div><div class="table"><table align="center" title="Configuration Directives application scopes" class="directives"><thead><td>Configuration Directives</td><td>DirConf</td><td>UserConf</td><td>ServerConf</td><td>Virtual Host</td><td>Notes</td></thead><tbody><tr><td>AbortScript</td><td>X</td><td>X</td><td>X</td><td>X</td>
<td>This directive is meaningful with the default request handler. In order
to have this triggered by calling ::rivet::abort_page or ::rivet::exit
any special request handler should explicitly read this script from the configuration
diff --git a/rivet/manual3.2/encode.html b/rivet/manual3.2/encode.html
index 4615525..3ccfb07 100644
--- a/rivet/manual3.2/encode.html
+++ b/rivet/manual3.2/encode.html
@@ -1,7 +1,7 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>encode</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="entities.html" title="RivetEntities"><link rel="prev" href="entities.html" title="RivetEntities"><link rel="next" href="decode.html" title="decode"></head><body bgcolor="white" text="black [...]
encode a string replacing every occurrence of characters for
which an SGML entity exists
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::encode</span> <span style="font-family:monospace; font-weight: bold;">string</span> ?<span style="font-family:monospace; font-weight: bold;">-encoding <em class="replaceable"><code><encoding></code></em>< [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::encode</span> <span style="font-family:monospace; font-weight: bold;">string</span> ?<span style="font-family:monospace; font-weight: bold;">-encoding <em class="replaceable"><code><encoding></code></em>< [...]
<span style="font-family:monospace"><span class="command"><strong>::rivet::encode</strong></span></span> returns a copy of the input string
after replacing every occurence of characters for which an SGML entity
exists. By default the command assumes the string is encoded in UTF-8,
diff --git a/rivet/manual3.2/entities.html b/rivet/manual3.2/entities.html
index 1863b62..06754fc 100644
--- a/rivet/manual3.2/entities.html
+++ b/rivet/manual3.2/entities.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>RivetEntities</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="html_calendar.html" title="HtmlCalendar"><link rel="next" href="encode.html" title="encode"></head><body bgcolor="white" [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>RivetEntities</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="html_calendar.html" title="HtmlCalendar"><link rel="next" href="encode.html" title="encode"></head><body bgcolor="white" [...]
The <span style="font-family:monospace"><span class="command"><strong>RivetEntities</strong></span></span> package was kindly provided by Harald Oehlmann and
is largely taken from a simple yet clever encoder/decoder of HTML entities
starting from a utf-8 character string. The original code writted by Andy Goth is
diff --git a/rivet/manual3.2/env.html b/rivet/manual3.2/env.html
index 9a33ddc..39b8dad 100644
--- a/rivet/manual3.2/env.html
+++ b/rivet/manual3.2/env.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>env</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="debug.html" title="debug"><link rel="next" href="escape_sgml_chars.html" title="escape_sgml_chars"></head><body [...]
Returns the value a single "environmental variable".
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::env</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>environment_variable_name</code></em></span>?</div></div></div><div class="refsect1"><a name="idm1100"></a><h2>Description< [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::env</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>environment_variable_name</code></em></span>?</div></div></div><div class="refsect1"><a name="id2467"></a><h2>Description</ [...]
<span style="font-family:monospace"><span class="command"><strong>::rivet::env</strong></span></span> resolves a single environment
variable and returns its value or an empty string if the environment
variable name in the argument is not defined.
diff --git a/rivet/manual3.2/escape_sgml_chars.html b/rivet/manual3.2/escape_sgml_chars.html
index b850ebf..bb33425 100644
--- a/rivet/manual3.2/escape_sgml_chars.html
+++ b/rivet/manual3.2/escape_sgml_chars.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>escape_sgml_chars</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="env.html" title="env"><link rel="next" href="escape_shell_command.html" title="escape_shell_comman [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>escape_sgml_chars</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="env.html" title="env"><link rel="next" href="escape_shell_command.html" title="escape_shell_comman [...]
Scans through each character in the specified string looking
for any special (with respect to SGML, and hence HTML) characters
from the specified string, and returns the result.
diff --git a/rivet/manual3.2/escape_shell_command.html b/rivet/manual3.2/escape_shell_command.html
index d0caa26..4d697cd 100644
--- a/rivet/manual3.2/escape_shell_command.html
+++ b/rivet/manual3.2/escape_shell_command.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>escape_shell_command</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="escape_sgml_chars.html" title="escape_sgml_chars"><link rel="next" href="escape_string.html" ti [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>escape_shell_command</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="escape_sgml_chars.html" title="escape_sgml_chars"><link rel="next" href="escape_string.html" ti [...]
Scans through each character in the specified string looking
for any shell metacharacters, such as asterisk, less than and
greater than, parens, square brackets, curly brackets, angle
diff --git a/rivet/manual3.2/escape_string.html b/rivet/manual3.2/escape_string.html
index 9ac7edf..6320db7 100644
--- a/rivet/manual3.2/escape_string.html
+++ b/rivet/manual3.2/escape_string.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>escape_string</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="escape_shell_command.html" title="escape_shell_command"><link rel="next" href="exit.html" title="exit" [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>escape_string</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="escape_shell_command.html" title="escape_shell_command"><link rel="next" href="exit.html" title="exit" [...]
Scans through each character in the specified string looking
for special characters, escaping them as needed, mapping
special characters to a quoted hexadecimal equivalent,
diff --git a/rivet/manual3.2/examples.html b/rivet/manual3.2/examples.html
index 847b30f..6200f9c 100644
--- a/rivet/manual3.2/examples.html
+++ b/rivet/manual3.2/examples.html
@@ -29,7 +29,7 @@ puts "Hello World"
</pre><p style="width:90%">
which is translated into
</p><pre class="programlisting">puts -nonewline "Hello World"</pre><p style="width:90%">
- </p></div></div><br class="example-break"><div class="example"><a name="idm1980"></a><p class="title"><b>Example 2. Generate a Colorful Table</b></p><div class="example-contents"><p style="width:90%">
+ </p></div></div><br class="example-break"><div class="example"><a name="id1375"></a><p class="title"><b>Example 2. Generate a Colorful Table</b></p><div class="example-contents"><p style="width:90%">
In another simple example, we dynamically generate a table selecting
a different background color for each cell. The font color is determined
through a simple CSS rule embedded in a HTML <style> element. Create
diff --git a/rivet/manual3.2/exit.html b/rivet/manual3.2/exit.html
index d963a26..8ff0ecf 100644
--- a/rivet/manual3.2/exit.html
+++ b/rivet/manual3.2/exit.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>exit</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="escape_string.html" title="escape_string"><link rel="next" href="headers.html" title="headers"></head><body bgc [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>exit</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="escape_string.html" title="escape_string"><link rel="next" href="headers.html" title="headers"></head><body bgc [...]
Replaces Tcl's <span style="font-family:monospace"><span class="command"><strong>exit</strong></span></span> core command. <span style="font-family:monospace"><span class="command"><strong>::rivet::exit</strong></span></span>
interrupts execution of the current script and passes execution to AbortScript if
such script is set. After AbortScript has finished and request processing completed
diff --git a/rivet/manual3.2/fb.html b/rivet/manual3.2/fb.html
index 8eacf2a..17a586a 100644
--- a/rivet/manual3.2/fb.html
+++ b/rivet/manual3.2/fb.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>FormBroker</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="formbroker.html" title="The Form Broker"><link rel="prev" href="formbroker.html" title="The Form Broker"><link rel="next" href="help.html" title="Resources - How to Get Help"></head><b [...]
Form broker object creator
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::FormBroker</span> <span style="font-family:monospace; font-weight: bold;">create</span> ?<span style="font-family:monospace; font-weight: bold;">-quoting quoting_procedure</span>? ?<span style="font-family:monospace; [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::FormBroker</span> <span style="font-family:monospace; font-weight: bold;">create</span> ?<span style="font-family:monospace; font-weight: bold;">-quoting quoting_procedure</span>? ?<span style="font-family:monospace; [...]
The command returns a reference to a form broker object by creating
a representation of the form data using the list of variable
descriptors passed to method <span style="font-family:monospace"><span class="command"><strong>create</strong></span></span>. Each descriptor
@@ -36,7 +36,7 @@
</li></ul></div><p style="width:90%">
An example of a form accepting four variable, one for each native type of a form broker object
</p><pre class="programlisting"> % set fbroker [::FormBroker create {var1 integer} {var2 unsigned} {var3 string} {var4 integer bounds {-10 100}}]
-::FormBroker::form0</pre></div><div class="refsect1"><a name="idm4304"></a><h2>Form broker object methods</h2><p style="width:90%">
+::FormBroker::form0</pre></div><div class="refsect1"><a name="id5681"></a><h2>Form broker object methods</h2><p style="width:90%">
The central method of a form broker object is <span style="font-family:monospace"><span class="command"><strong>validate</strong></span></span>
</p><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>formBroker_object</code></em></span> <span style="font-family:monospace; font-weight: bold;">validate</span [...]
The method <span style="font-family:monospace"><span class="command"><strong>validate</strong></span></span> takes as argument the name of an array of variables
@@ -198,7 +198,7 @@ a(var1) = 0
a(var2) = 1
a(var4) = 0</pre></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>formBroker_object</code></em></span> <span style="font-family:monospace; font-weight: bold;">reset</span> </div></div><div style="margin-bottom:1. [...]
The method resets the object to its initial defaults
- </div></div></dd></dl></div></div><div class="refsect1"><a name="idm4369"></a><h2>Validator Error codes</h2><p style="width:90%">
+ </div></div></dd></dl></div></div><div class="refsect1"><a name="id5746"></a><h2>Validator Error codes</h2><p style="width:90%">
Variable type validators returned specific code
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><span class="emphasis"><em>string</em></span>:
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><span class="emphasis"><em>FB_EMPTY_STRING</em></span> if
@@ -218,7 +218,7 @@ a(var4) = 0</pre></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ;
which forces its value to be the closest boundary value</li></ul></div></li><li class="listitem"><span class="emphasis"><em>email</em></span>:
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><span class="emphasis"><em>FB_INVALID_EMAIL</em></span> the variable is
an invalid email address representation</li></ul></div></li></ul></div><p style="width:90%">
- </p></div><div class="refsect1"><a name="idm4397"></a><h2>Writing a custom variable validator</h2><p style="width:90%">
+ </p></div><div class="refsect1"><a name="id5774"></a><h2>Writing a custom variable validator</h2><p style="width:90%">
The form broker is by no means restricted to work only with its native
data types: you may define your own form variable types and have
them validated with their own variable validator.
diff --git a/rivet/manual3.2/form.html b/rivet/manual3.2/form.html
index 98eb7a4..45bb941 100644
--- a/rivet/manual3.2/form.html
+++ b/rivet/manual3.2/form.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Form: An HTML Form Fields Generation Utility</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="session_package.html" title="Session Package"><link rel="next" href="form_package.html" ti [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Form: An HTML Form Fields Generation Utility</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="session_package.html" title="Session Package"><link rel="next" href="form_package.html" ti [...]
The <span style="font-family:monospace"><span class="command"><strong>form</strong></span></span> package is a utility for generating html forms. A <span style="font-family:monospace"><span class="command"><strong>form</strong></span></span>
object command saves the programmer from typing the cumbersome html code of input elements,
working out a solution for better standardization and readability of the code.
diff --git a/rivet/manual3.2/form_package.html b/rivet/manual3.2/form_package.html
index f79a88e..6066d2d 100644
--- a/rivet/manual3.2/form_package.html
+++ b/rivet/manual3.2/form_package.html
@@ -1,6 +1,6 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>form</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="form.html" title="Form: An HTML Form Fields Generation Utility"><link rel="prev" href="form.html" title="Form: An HTML Form Fields Generation Utility"><link rel="next" href="calendar_package [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>form</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="form.html" title="Form: An HTML Form Fields Generation Utility"><link rel="prev" href="form.html" title="Form: An HTML Form Fields Generation Utility"><link rel="next" href="calendar_package [...]
creates and returns a new Tcl command named <em class="replaceable"><code>form_name</code></em>.
- </p><div class="refsect2"><a name="idm3542"></a><h3>Options</h3><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-method</span> ?<span style="font-family:monospace; font-weight: bold;">post|get</span> [...]
+ </p><div class="refsect2"><a name="id4924"></a><h3>Options</h3><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-method</span> ?<span style="font-family:monospace; font-weight: bold;">post|get</span>? [...]
The http method for sending the form data back to the server.
Possible values are get or post
</div></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-name</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>form_name</code></em></span>?</div></div><div style="margin-bottom:1.5ex ; pa [...]
@@ -21,7 +21,7 @@
</div></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-action</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>URL</code></em></span>?</div></div><div style="margin-bottom:1.5ex ; padding .5ex">
The URL the data are being sent to. If no ?<span style="font-family:monospace; font-weight: bold;">-action</span>? switch is specified
the data are sent to the form's URL.
- </div></div></dd></dl></div></div></div><div class="refsect1"><a name="idm3581"></a><h2>Form Object Commands</h2><p style="width:90%">
+ </div></div></dd></dl></div></div></div><div class="refsect1"><a name="id4963"></a><h2>Form Object Commands</h2><p style="width:90%">
Form object commands follow the usual syntax of Tcl commands with a ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>subcommand</code></em></span>? argument playing the
role of a switch among various functionalities of the command. Form objects also need the ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>name</code></em></span>? parameter
which is to become the value of the 'name' attribute in an input field. This argument is the key that has to be
@@ -36,7 +36,7 @@
<span style="font-family:monospace"><span class="command"><strong>field</strong></span></span> is an abstract input field creation method and requires an additional
parameter specifiyng the type of field to create. Every concrete input field generation command
uses this subcommand internally to print the final html.
- </p></div><div class="refsect1"><a name="idm3604"></a><h2>Subcommands</h2><div class="refsect2"><a name="idm3606"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">start</span> ?<span style="font-fam [...]
+ </p></div><div class="refsect1"><a name="id4986"></a><h2>Subcommands</h2><div class="refsect2"><a name="id4988"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">start</span> ?<span style="font-famil [...]
Print the <form> tag with all its attributes.
This command must be called as first in the form generation
process. The following is a sample of code creating a form named 'formname' whose data will
@@ -52,7 +52,7 @@ myform end</pre><div style="margin-bottom:1.5ex ; padding .5ex">
The code prints a form that sends a text entry content and the option value
associated with a radiobutton. The URL of the server script is the same that
created the form. Use the ?<span style="font-family:monospace; font-weight: bold;">-url</span>? option to specify a different url.
- </div></div></dd></dl></div><div class="refsect3"><a name="idm3627"></a><div style="padding:4 ; margin-top:3 ; margin-left: 5%;">Options</div><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-we [...]
+ </div></div></dd></dl></div><div class="refsect3"><a name="id5009"></a><div style="padding:4 ; margin-top:3 ; margin-left: 5%;">Options</div><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-wei [...]
The method to be used to encode the form data.
Possible values are get or post
</div></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-name</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>form_name</code></em></span>?</div></div><div style=" [...]
@@ -69,22 +69,22 @@ myform end</pre><div style="margin-bottom:1.5ex ; padding .5ex">
</div></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-action</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>URL</code></em></span>?</div></div><div style="margin-botto [...]
The URL the data will be sent to. If no ?<span style="font-family:monospace; font-weight: bold;">-action</span>? switch is specified
the data are sent to the form's URL.
- </div></div></dd></dl></div></div></div><div class="refsect2"><a name="idm3659"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">end</span> </div></div><div style="margin-bottom:1.5ex ; padding .5ex">
+ </div></div></dd></dl></div></div></div><div class="refsect2"><a name="id5041"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">end</span> </div></div><div style="margin-bottom:1.5ex ; padding .5ex">
Print the </form> closing tag. This command must
be called last in the form generation process
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3666"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">field</span> ?<span style="font-family:monospace; font-weight: bold;">n [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5048"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">field</span> ?<span style="font-family:monospace; font-weight: bold;">na [...]
Print a field of the given ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>type</code></em></span>? and ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>name</code></em></span>?,
including any default key-value pairs defined for this field
type and optional key-value pairs included with the statement
- </div></div></dd></dl></div><div class="refsect3"><a name="idm3680"></a><div style="padding:4 ; margin-top:3 ; margin-left: 5%;">Options</div><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-we [...]
+ </div></div></dd></dl></div><div class="refsect3"><a name="id5062"></a><div style="padding:4 ; margin-top:3 ; margin-left: 5%;">Options</div><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-wei [...]
Option description
- </div></div></dd></dl></div></div></div><div class="refsect2"><a name="idm3689"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">radiobuttons</span> ?<span style="font-family:monospace; f [...]
+ </div></div></dd></dl></div></div></div><div class="refsect2"><a name="id5071"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">radiobuttons</span> ?<span style="font-family:monospace; fo [...]
the <span style="font-family:monospace"><span class="command"><strong>radiobutton</strong></span></span> creates a whole radiobutton group
with the values and labels specified in the argument list.
If no ?<span style="font-family:monospace; font-weight: bold;">-labels</span>? switch is
passed to the subcommand the values are printed as labels of
the radiobutton.
- </div><div class="refsect3"><a name="idm3704"></a><div style="padding:4 ; margin-top:3 ; margin-left: 5%;">Options</div><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-values</ [...]
+ </div><div class="refsect3"><a name="id5086"></a><div style="padding:4 ; margin-top:3 ; margin-left: 5%;">Options</div><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-values</s [...]
List of values associated with the radiobuttons to be displayed
</div></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-labels</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>labels_list</code></em></span>?</div></div><div style="m [...]
List of labels to be printed with every radiobutton. There must
@@ -110,7 +110,7 @@ myform end</pre><div style="margin-bottom:1.5ex ; padding .5ex">
radiobutton field is automatically checked. The options ?<span style="font-family:monospace; font-weight: bold;">values</span>? and ?<span style="font-family:monospace; font-weight: bold;">labels</span>?
are used internally and don't get into the tag attributes. If a ?<span style="font-family:monospace; font-weight: bold;">labels</span>?
option is not given, labels are assigned using the ?<span style="font-family:monospace; font-weight: bold;">values</span>? list.
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3731"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">checkbox</span> ?<span style="font-family:monospace; font-weight: bol [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5113"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">checkbox</span> ?<span style="font-family:monospace; font-weight: bold [...]
The <span style="font-family:monospace; font-weight: bold;">checkbox</span> subcommand emits a checkbox
type input field with the name, label and value attributes set
according to the parameters passed to the subcommand.
@@ -133,13 +133,13 @@ myform destroy</pre><div style="margin-bottom:1.5ex ; padding .5ex">
<input type="checkbox" name="options" id="autogen_3" label="Option 3" value="sopt3" /><label for="autogen_3">Option 3</label>
<input type="checkbox" name="options" id="autogen_4" label="Option 4" value="sopt4" /><label for="autogen_4">Option 4</label>
<input type="submit" name="submit" value="Send" />
-</form></pre></div></dd></dl></div></div><div class="refsect2"><a name="idm3749"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">checkboxes</span> ?<span style="font-family:monospace; font-wei [...]
+</form></pre></div></dd></dl></div></div><div class="refsect2"><a name="id5131"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">checkboxes</span> ?<span style="font-family:monospace; font-weig [...]
The <span style="font-family:monospace; font-weight: bold;">checkboxes</span> is an extended form
of the <span style="font-family:monospace; font-weight: bold;">checkbox</span> subcommand.
<span style="font-family:monospace; font-weight: bold;">checkboxes</span>
prints as many checkboxes as the number of elements in the
?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>labels_list</code></em></span>? argument
- </div><div class="refsect3"><a name="idm3767"></a><div style="padding:4 ; margin-top:3 ; margin-left: 5%;">Options</div><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-values</ [...]
+ </div><div class="refsect3"><a name="id5149"></a><div style="padding:4 ; margin-top:3 ; margin-left: 5%;">Options</div><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-values</s [...]
List of values associated with the checkboxes to be displayed
</div></div></dd><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-left: 5%; margin-bottom:3 ; width:70%;"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">-labels</span> ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>labels_list</code></em></span>?</div></div><div style="m [...]
List of labels to be printed with every checkbox. There must
@@ -159,12 +159,12 @@ myform destroy</pre><div style="margin-bottom:1.5ex ; padding .5ex">
<input type="checkbox" name="options" id="autogen_3" label="Option 3" value="opt3" /><label for="autogen_3">Option 3</label>
<input type="checkbox" name="options" id="autogen_4" label="Option 4" value="opt4" /><label for="autogen_4">Option 4</label>
<input type="submit" name="save_tps" value="Send Options" />
-</form></pre></div></dd></dl></div></div><div class="refsect2"><a name="idm3788"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">password</span> ?<span style="font-family:monospace; font-weigh [...]
+</form></pre></div></dd></dl></div></div><div class="refsect2"><a name="id5170"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">password</span> ?<span style="font-family:monospace; font-weight [...]
Same as text, but the input is obfuscated so as not to reveal the text being typed
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3797"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">hidden</span> ?<span style="font-family:monospace; font-weight: bold; [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5179"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">hidden</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
hidden input element: typicall embedded in a form in order to
pass status variables.
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3806"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">submit</span> ?<span style="font-family:monospace; font-weight: bold; [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5188"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">submit</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
emits the code for a classical HTML submit button. Example: the following
code
</div><div style="margin-bottom:1.5ex ; padding .5ex">
@@ -177,41 +177,41 @@ myform destroy</pre><div style="margin-bottom:1.5ex ; padding .5ex">
</div><pre class="programlisting">
<form...>
<input type="submit" name="submit" value="Search" />
- </form></pre></div></dd></dl></div></div><div class="refsect2"><a name="idm3819"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">button</span> ?<span style="font-family:monospace; font-weight [...]
+ </form></pre></div></dd></dl></div></div><div class="refsect2"><a name="id5201"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">button</span> ?<span style="font-family:monospace; font-weight: [...]
emits the code for a button field having ?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>name</code></em></span>? as name
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3830"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">reset</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5212"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">reset</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
Classical HTML reset button that resets the input fields
back to their initial values
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3839"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">image</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5221"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">image</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
Emits an image input field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3848"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">radio</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5230"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">radio</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
Emits a radiobutton input field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3857"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">color</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5239"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">color</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
Emits an HTML 5 "color" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3866"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">date</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5248"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">date</span> ?<span style="font-family:monospace; font-weight: bold;">n [...]
Emits an HTML 5 "date" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3875"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">datetime</span> ?<span style="font-family:monospace; font-weight: bol [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5257"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">datetime</span> ?<span style="font-family:monospace; font-weight: bold [...]
Emits an HTML 5 "datetime" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3884"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">datetime_local</span> ?<span style="font-family:monospace; font-weigh [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5266"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">datetime_local</span> ?<span style="font-family:monospace; font-weight [...]
Emits an HTML 5 "datetime_local" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3893"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">email</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5275"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">email</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
Emits an HTML 5 "email" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3902"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">file</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5284"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">file</span> ?<span style="font-family:monospace; font-weight: bold;">n [...]
Emits an HTML 5 "file" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3911"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">month</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5293"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">month</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
Emits an HTML 5 "month" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3920"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">number</span> ?<span style="font-family:monospace; font-weight: bold; [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5302"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">number</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
Emits an HTML 5 "number" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3929"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">range</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5311"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">range</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
Emits an HTML 5 "range" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3938"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">search</span> ?<span style="font-family:monospace; font-weight: bold; [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5320"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">search</span> ?<span style="font-family:monospace; font-weight: bold;" [...]
Emits an HTML 5 "search" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3947"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">tel</span> ?<span style="font-family:monospace; font-weight: bold;">n [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5329"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">tel</span> ?<span style="font-family:monospace; font-weight: bold;">na [...]
Emits an HTML 5 "tel" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3956"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">time</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5338"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">time</span> ?<span style="font-family:monospace; font-weight: bold;">n [...]
Emits an HTML 5 "time" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3965"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">url</span> ?<span style="font-family:monospace; font-weight: bold;">n [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5347"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">url</span> ?<span style="font-family:monospace; font-weight: bold;">na [...]
Emits an HTML 5 "url" form field
- </div></div></dd></dl></div></div><div class="refsect2"><a name="idm3974"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">week</span> ?<span style="font-family:monospace; font-weight: bold;"> [...]
+ </div></div></dd></dl></div></div><div class="refsect2"><a name="id5356"></a><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "> <span style="font-family:monospace; font-weight: bold;">week</span> ?<span style="font-family:monospace; font-weight: bold;">n [...]
Emits an HTML 5 "week" form field
</div></div></dd></dl></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="form.html"><img src="images/prev.png" alt="Prev"></a> </td><td width="20%" align="center"><a accesskey="u" href="form.html"><img src="images/up.png" alt="Up"></a></td><td width="40%" align="right"> <a accesskey="n" href="calendar_package.html"><img src="images/next.png" alt="Next"></a></td></tr><tr><td widt [...]
diff --git a/rivet/manual3.2/formbroker.html b/rivet/manual3.2/formbroker.html
index 49329ba..aca2541 100644
--- a/rivet/manual3.2/formbroker.html
+++ b/rivet/manual3.2/formbroker.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>The Form Broker</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="toglyphs.html" title="toGlyphs"><link rel="next" href="fb.html" title="FormBroker"></head><body bgcolor="white" text="b [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>The Form Broker</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="toglyphs.html" title="toGlyphs"><link rel="next" href="fb.html" title="FormBroker"></head><body bgcolor="white" text="b [...]
The <span style="font-family:monospace"><span class="command"><strong>FormBroker</strong></span></span> package creates instances of
form data description objects. These objects instances have
a simple set of methods to validate and control data
diff --git a/rivet/manual3.2/headers.html b/rivet/manual3.2/headers.html
index 1f02c7e..7e48dfb 100644
--- a/rivet/manual3.2/headers.html
+++ b/rivet/manual3.2/headers.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>headers</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="exit.html" title="exit"><link rel="next" href="html.html" title="html"></head><body bgcolor="white" text="bl [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>headers</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="exit.html" title="exit"><link rel="next" href="html.html" title="html"></head><body bgcolor="white" text="bl [...]
The <span style="font-family:monospace"><span class="command"><strong>headers</strong></span></span> command is for setting and
parsing HTTP headers.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
diff --git a/rivet/manual3.2/help.html b/rivet/manual3.2/help.html
index 1014af7..72a93a1 100644
--- a/rivet/manual3.2/help.html
+++ b/rivet/manual3.2/help.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Resources - How to Get Help</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="fb.html" title="FormBroker"><link rel="next" href="internals.html" title="Rivet Internals"></head><body bgc [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Resources - How to Get Help</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="fb.html" title="FormBroker"><link rel="next" href="internals.html" title="Rivet Internals"></head><body bgc [...]
The Rivet mailing list is the first place you should turn for
help. If you haven't found the solution to your problem in the documentation
or you have a question, idea, or comment about the Rivet code itself send email to
@@ -6,7 +6,7 @@
<code class="email"><<a class="email" href="mailto:rivet-dev-subscribe@tcl.apache.org">rivet-dev-subscribe@tcl.apache.org</a>></code>.
</p><p style="width:90%">
The mailing list archives are available at <a class="ulink" href="http://mail-archives.apache.org/mod_mbox/tcl-rivet-dev/" target="_top">http://mail-archives.apache.org/mod_mbox/tcl-rivet-dev/</a>
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4417"></a>Newsgroup</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1359"></a>Newsgroup</h3></div></div></div><p style="width:90%">
The <a class="ulink" href="news:comp.lang.tcl" target="_top">news:comp.lang.tcl</a> newsgroup is a good
place to ask about Tcl questions in general. Rivet developers
also follow the newsgroup, but it's best to ask Rivet-specific
@@ -28,14 +28,14 @@
</div></li><li class="listitem"><div style="margin-bottom:1.5ex ; padding .5ex">
<a class="ulink" href="http://wiki.tcl.tk" target="_top">http://wiki.tcl.tk</a> is the Tcl'ers Wiki, a
free-form place to search for answers and ask for help.
- </div></li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4437"></a>Bug Tracking System</h3></div></div></div><p style="width:90%">
+ </div></li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1360"></a>Bug Tracking System</h3></div></div></div><p style="width:90%">
Apache Rivet uses the Apache Bug Tracking system at <a class="ulink" href="http://issues.apache.org/bugzilla/" target="_top">http://issues.apache.org/bugzilla/</a>. Here,
you can report problems, or check and see if existing issues
are already known and being dealt with.
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4441"></a>IRC</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1361"></a>IRC</h3></div></div></div><p style="width:90%">
Occasionally, someone from the Rivet team is on IRC at
irc.freenode.net, channel #tcl.
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4444"></a>Editing Rivet Template Files</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1362"></a>Editing Rivet Template Files</h3></div></div></div><p style="width:90%">
Rivet makes available code for two popular editors,
<span class="application">emacs</span> and
<span class="application">vim</span> to facilitate the editing of
diff --git a/rivet/manual3.2/html.html b/rivet/manual3.2/html.html
index f8827cd..259697e 100644
--- a/rivet/manual3.2/html.html
+++ b/rivet/manual3.2/html.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>html</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="headers.html" title="headers"><link rel="next" href="http_accept.html" title="http_accept"></head><body bgcolor [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>html</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="headers.html" title="headers"><link rel="next" href="http_accept.html" title="http_accept"></head><body bgcolor [...]
Print text with the added ability to pass HTML tags
following the string. Example:
</p><pre class="programlisting">::rivet::html "Test" b i</pre><p style="width:90%">
diff --git a/rivet/manual3.2/html_calendar.html b/rivet/manual3.2/html_calendar.html
index 6285041..94024f5 100644
--- a/rivet/manual3.2/html_calendar.html
+++ b/rivet/manual3.2/html_calendar.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>HtmlCalendar</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="calendar_package.html" title="Calendar Package"><link rel="prev" href="xml_calendar.html" title="XmlCalendar"><link rel="next" href="entities.html" title="RivetEntities"></head><body [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>HtmlCalendar</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="calendar_package.html" title="Calendar Package"><link rel="prev" href="xml_calendar.html" title="XmlCalendar"><link rel="next" href="entities.html" title="RivetEntities"></head><body [...]
Concrete XmlCalendar class for printing html calendar tables. The markup of the class
is xhtml compliant and prints a code fragment for inclusion in a webpage.
The following is the class definition.
@@ -18,7 +18,7 @@
-days_row tr \
-days_cell td
}
-}</pre></div><div class="refsect1"><a name="idm4185"></a><p style="width:90%">
+}</pre></div><div class="refsect1"><a name="id5566"></a><p style="width:90%">
A sample output from HtmlCalendar (with some styling)
</p><p style="width:90%">
</p><div><img src="images/calendar.png"></div><p style="width:90%">
diff --git a/rivet/manual3.2/http_accept.html b/rivet/manual3.2/http_accept.html
index 5099712..fc48bcf 100644
--- a/rivet/manual3.2/http_accept.html
+++ b/rivet/manual3.2/http_accept.html
@@ -2,7 +2,7 @@
?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>-zeroweight</code></em></span>?
?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>-default</code></em></span>?
?<span style="font-family:monospace; font-weight: bold;"><em class="replaceable"><code>-list</code></em></span>?
- http_accept_line</span> </div></div></div><div class="refsect1"><a name="idm1289"></a><h2>Description</h2><p style="width:90%">
+ http_accept_line</span> </div></div></div><div class="refsect1"><a name="id2656"></a><h2>Description</h2><p style="width:90%">
Command for parsing HTTP Accept header lines that tell the
server about preferences and/or capabilities of the browser
(e.g. content language,media type, etc.). The following
diff --git a/rivet/manual3.2/import_keyvalue_pairs.html b/rivet/manual3.2/import_keyvalue_pairs.html
index d26bd4d..eee69a5 100644
--- a/rivet/manual3.2/import_keyvalue_pairs.html
+++ b/rivet/manual3.2/import_keyvalue_pairs.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>import_keyvalue_pairs</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="http_accept.html" title="http_accept"><link rel="next" href="include.html" title="include"></h [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>import_keyvalue_pairs</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="http_accept.html" title="http_accept"><link rel="next" href="include.html" title="include"></h [...]
key-value pairs, like "-foo bar" are stored in the array ?<span style="font-family:monospace; font-weight: bold;">arrayName</span>?.
In that case, the value "bar" would be stored in the element "foo"
</p><p style="width:90%">
diff --git a/rivet/manual3.2/include.html b/rivet/manual3.2/include.html
index 42d2f43..8046ae0 100644
--- a/rivet/manual3.2/include.html
+++ b/rivet/manual3.2/include.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>include</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="import_keyvalue_pairs.html" title="import_keyvalue_pairs"><link rel="next" href="inspect.html" title="inspec [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>include</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="import_keyvalue_pairs.html" title="import_keyvalue_pairs"><link rel="next" href="inspect.html" title="inspec [...]
Include a file without parsing it for processing tags <?
and ?>. This is the best way to include an HTML file or
any other static content.
diff --git a/rivet/manual3.2/index.html b/rivet/manual3.2/index.html
index a78c05c..1662074 100644
--- a/rivet/manual3.2/index.html
+++ b/rivet/manual3.2/index.html
@@ -1,6 +1,6 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Apache Rivet 3.2</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="next" href="installation.html" title="Apache Rivet 3.2 Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Apache Rivet 3.2</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="next" href="installation.html" title="Apache Rivet 3.2 Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table [...]
<code class="email"><<a class="email" href="mailto:rivet-dev@tcl.apache.org">rivet-dev@tcl.apache.org</a>></code><br>
- </p></div></div></div></div><div><p class="copyright">Copyright © 2002-2024 Apache Software Foundation</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="index.html#introduction">Introduction to Apache Rivet version 3.2</a></span></dt><dt><span class="section"><a href="installation.html">Apache Rivet 3.2 Installation</a></span></dt><dt><span class="section"><a href="cmake.html">Building Rivet 3.2 with CMake [...]
+ </p></div></div></div></div><div><p class="copyright">Copyright © 2002-2025 Apache Software Foundation</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="index.html#introduction">Introduction to Apache Rivet version 3.2</a></span></dt><dt><span class="section"><a href="installation.html">Apache Rivet 3.2 Installation</a></span></dt><dt><span class="section"><a href="cmake.html">Building Rivet 3.2 with CMake [...]
Shorthand construct for single strings output
</span></dt><dt><span class="refentrytitle"><a href="abort_code.html">abort_code</a></span><span class="refpurpose"> —
Returns the code passed to <span style="font-family:monospace"><span class="command"><strong>abort_page</strong></span></span>
@@ -28,18 +28,18 @@
Split the line into multiple lines by splitting on space characters
</span></dt><dt><span class="refentrytitle"><a href="xml.html">xml</a></span><span class="refpurpose"> —
XML Fragments creation
- </span></dt></dl></dd><dt><span class="section"><a href="examples.html">Examples and Usage</a></span></dt><dt><span class="section"><a href="tcl_packages.html">Rivet Tcl Packages</a></span></dt><dt><span class="section"><a href="dio.html">DIO - Database Interface Objects</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="dio_package.html">DIO</a></span><span class="refpurpose"> — Database Interface Objects</span></dt></dl></dd><dt><span class="section"><a href="d [...]
+ </span></dt></dl></dd><dt><span class="section"><a href="examples.html">Examples and Usage</a></span></dt><dt><span class="section"><a href="tcl_packages.html">Rivet Tcl Packages</a></span></dt><dt><span class="section"><a href="dio.html">DIO - Database Interface Objects</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="dio_package.html">DIO</a></span><span class="refpurpose"> — Database Interface Objects</span></dt></dl></dd><dt><span class="section"><a href="d [...]
encode a string replacing every occurrence of characters for
which an SGML entity exists
</span></dt><dt><span class="refentrytitle"><a href="decode.html">decode</a></span><span class="refpurpose"> —
decode an SGML encoded string replacing every entity with the
corresponding character
- </span></dt></dl></dd><dt><span class="section"><a href="asciiglyphs.html">AsciiGlyphs</a></span></dt><dd><dl><dt><span class="section"><a href="asciiglyphs.html#idm4231">Introduction</a></span></dt><dt><span class="refentrytitle"><a href="toglyphs.html">toGlyphs</a></span><span class="refpurpose"> —
+ </span></dt></dl></dd><dt><span class="section"><a href="asciiglyphs.html">AsciiGlyphs</a></span></dt><dd><dl><dt><span class="section"><a href="asciiglyphs.html#id1355">Introduction</a></span></dt><dt><span class="refentrytitle"><a href="toglyphs.html">toGlyphs</a></span><span class="refpurpose"> —
print large ASCII glyphs
- </span></dt><dt><span class="section"><a href="asciiglyphs.html#idm4247">Example</a></span></dt></dl></dd><dt><span class="section"><a href="formbroker.html">The Form Broker</a></span></dt><dd><dl><dt><span class="section"><a href="formbroker.html#idm4252">Introduction</a></span></dt><dt><span class="refentrytitle"><a href="fb.html">FormBroker</a></span><span class="refpurpose"> —
+ </span></dt><dt><span class="section"><a href="asciiglyphs.html#id1356">Example</a></span></dt></dl></dd><dt><span class="section"><a href="formbroker.html">The Form Broker</a></span></dt><dd><dl><dt><span class="section"><a href="formbroker.html#id1357">Introduction</a></span></dt><dt><span class="refentrytitle"><a href="fb.html">FormBroker</a></span><span class="refpurpose"> —
Form broker object creator
- </span></dt></dl></dd><dt><span class="section"><a href="help.html">Resources - How to Get Help</a></span></dt><dd><dl><dt><span class="section"><a href="help.html#idm4410">Mailing Lists</a></span></dt><dt><span class="section"><a href="help.html#idm4417">Newsgroup</a></span></dt><dt><span class="section"><a href="help.html#websites">Web Sites</a></span></dt><dt><span class="section"><a href="help.html#idm4437">Bug Tracking System</a></span></dt><dt><span class="section"><a h [...]
- This manual is released as part of Apache/Rivet 3.2.5 (Sunday 2024-05-19 17:45:03+02:00).
+ </span></dt></dl></dd><dt><span class="section"><a href="help.html">Resources - How to Get Help</a></span></dt><dd><dl><dt><span class="section"><a href="help.html#id1358">Mailing Lists</a></span></dt><dt><span class="section"><a href="help.html#id1359">Newsgroup</a></span></dt><dt><span class="section"><a href="help.html#websites">Web Sites</a></span></dt><dt><span class="section"><a href="help.html#id1360">Bug Tracking System</a></span></dt><dt><span class="section"><a href [...]
+ This manual is released as part of Apache/Rivet 3.2.6 (Monday 2025-01-27 10:28:55+01:00).
</p><div class="section"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="introduction"></a>Introduction to Apache Rivet version 3.2</h2></div></div></div><p style="width:90%">
Apache Rivet is a system for creating dynamic web content by
integrating the
@@ -62,7 +62,7 @@
something that needs improving, and have ideas or suggestions,
don't hesitate to let us know. If you want to contribute
directly, better yet!
- </p><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm21"></a>Apache MPM and Rivet Bridge Modules</h3></div></div></div><p style="width:90%">
+ </p><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="id1376"></a>Apache MPM and Rivet Bridge Modules</h3></div></div></div><p style="width:90%">
Rivet 3.2 is a successor to Rivet 3.0, a major rewriting of mod_rivet,
the Apache HTTP Websever module at the core of Rivet. Unlike in 2.x of
mod_rivet, which only supported the
@@ -84,7 +84,7 @@
further reading. MPM bridges are loaded accordingly to a heuristics of rules based
on the Apache introspection calls but they can be determined in the configuration.
Only a bridge can be loaded at a time.
- </p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm29"></a>Request Processing</h3></div></div></div><p style="width:90%">
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="id1402"></a>Request Processing</h3></div></div></div><p style="width:90%">
Request processing was performed in mod_rivet version 2.x by chaining together 3 scripts
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">BeforeScript, if defined in the configuration</li><li class="listitem">The URI referenced Tcl script or rvt template dermined with
respect to the <a class="ulink" href="https://httpd.apache.org/docs/2.4/mod/core.html#documentroot" target="_top">DocumentRoot</a> and following
@@ -101,6 +101,6 @@
version 2.x scheme to handle a request but this can be entirely overridden by
the developer replacing the central request handling procedure. See the
<a class="link" href="request.html" title="Apache Child Processes Lifecycle and Request Processing">request processing</a> page.
- </p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm44"></a>Acknowledgements</h3></div></div></div><p style="width:90%">This version of Rivet received substantial contributions from George Petasis who solved
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="id1417"></a>Acknowledgements</h3></div></div></div><p style="width:90%">This version of Rivet received substantial contributions from George Petasis who solved
several problems with the threaded code, improved the code in several ways and made the CMake
based build scripts</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="installation.html"><img src="images/next.png" alt="Next"></a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Apache Rivet 3.2 Installation</td></t [...]
diff --git a/rivet/manual3.2/inspect.html b/rivet/manual3.2/inspect.html
index 9ec8f6e..08869b9 100644
--- a/rivet/manual3.2/inspect.html
+++ b/rivet/manual3.2/inspect.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>inspect</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="include.html" title="include"><link rel="next" href="lassign_array.html" title="lassign_array"></head><body [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>inspect</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="include.html" title="include"><link rel="next" href="lassign_array.html" title="lassign_array"></head><body [...]
<span style="font-family:monospace"><span class="command"><strong>::rivet::inspect</strong></span></span> provides introspection into the running
configuration of Rivet. Rivet's debug command uses it in order to gain insight
into the configuration, but it can be used in any script.
diff --git a/rivet/manual3.2/installation.html b/rivet/manual3.2/installation.html
index 7f85260..61e2fc1 100644
--- a/rivet/manual3.2/installation.html
+++ b/rivet/manual3.2/installation.html
@@ -67,8 +67,8 @@
We will assume that you have Apache installed at this point.
You must uncompress the Rivet sources in the directory where you
wish to compile them.
- </p><pre class="programlisting">gunzip rivet-3.2.5.tar.gz
-tar -xvf rivet-3.2.5.tar.gz</pre><p style="width:90%">
+ </p><pre class="programlisting">gunzip rivet-3.2.6.tar.gz
+tar -xvf rivet-3.2.6.tar.gz</pre><p style="width:90%">
</p></li><li class="step"><p class="title"><b>Building Rivet</b></p><ol type="a" class="substeps"><li class="step"><p style="width:90%">
Rivet uses the standard <span style="font-family:monospace"><span class="command"><strong>./configure ; make ; make install</strong></span></span>
sequence which installs to their target directories the Apache module, the binary libraries and the
diff --git a/rivet/manual3.2/internals.html b/rivet/manual3.2/internals.html
index 707e1a7..a4bafbf 100644
--- a/rivet/manual3.2/internals.html
+++ b/rivet/manual3.2/internals.html
@@ -5,7 +5,7 @@
themselves, the Subversion revision control system
(<span style="font-family:monospace"><span class="command"><strong>svn</strong></span></span>) can provide you with information about
what has been happening with the code.
- </p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4456"></a>Rivet approach to Apache Multiprocessing Models</h3></div></div></div><p style="width:90%">
+ </p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1363"></a>Rivet approach to Apache Multiprocessing Models</h3></div></div></div><p style="width:90%">
The Apache HTTP web server has an extremely modular architecture
that made it very popular among web developers. Most of the server
features can be implemented in external modules, including some of
@@ -39,7 +39,7 @@
at start up, only when requests come in Tcl execution threads are created.
This bridge is explained in detail in the <a class="xref" href="lazybridge.html" title="Example: the “Lazy” bridge">the section called “Example: the <span class="quote">“<span class="quote">Lazy</span>”</span> bridge”</a>.
Since the resource demand at startup is minimal this bridge should suit
- development machines that go through frequent web server restarts.</li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4469"></a>mod_rivet MPM Bridge callbacks</h3></div></div></div><p style="width:90%">
+ development machines that go through frequent web server restarts.</li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1364"></a>mod_rivet MPM Bridge callbacks</h3></div></div></div><p style="width:90%">
A bridge is a loadable library implementing different ways to handle
specific features needed to mod_rivet. It was originally meant as a way
to handle the prefork/worker/event MPM specificities, at the same time
@@ -119,8 +119,8 @@
status. So this macro (and associated function) should hide from the module core function
the specific approach followed in a particular bridge
</li></ul></div><p style="width:90%">
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4503"></a>Server Initialization and MPM Bridge</h3></div></div></div><p style="width:90%">
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4506"></a>RivetChan</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1365"></a>Server Initialization and MPM Bridge</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1366"></a>RivetChan</h3></div></div></div><p style="width:90%">
The <span class="structname">RivetChan</span> system was created in
order to have an actual Tcl channel that we could redirect
standard output to. This enables us use, for instance, the
@@ -130,7 +130,7 @@
Tcl's regular standard output is replaced with an instance of
this channel type, so that, by default, output will go to the
web page.
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4511"></a>The <span style="font-family:monospace"><span class="command"><strong>global</strong></span></span> Command</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1367"></a>The <span style="font-family:monospace"><span class="command"><strong>global</strong></span></span> Command</h3></div></div></div><p style="width:90%">
Rivet aims to run standard Tcl code with as few surprises as
possible. At times this involves some compromises - in this
case regarding the <span style="font-family:monospace"><span class="command"><strong>global</strong></span></span> command. The
@@ -145,7 +145,7 @@
you really need a true global variable, use either
<span style="font-family:monospace"><span class="command"><strong>::global</strong></span></span> or add the :: namespace qualifier
to variables you wish to make global.
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4519"></a>Page Parsing, Execution and Caching</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1368"></a>Page Parsing, Execution and Caching</h3></div></div></div><p style="width:90%">
When a Rivet page is requested, it is transformed into an
ordinary Tcl script by parsing the file for the <? ?>
processing instruction tags. Everything outside these tags
@@ -171,7 +171,7 @@
without having to reload it (and re-parse it) from the disk.
The number of scripts stored in memory is configurable. This
feature can significantly improve performance.
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4527"></a>Extending Rivet by developing C code procedures</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1369"></a>Extending Rivet by developing C code procedures</h3></div></div></div><p style="width:90%">
Rivet endows the Tcl interpreter with new commands
serving as interface between the application layer and the
Apache web server. Many of these commands
@@ -246,7 +246,7 @@ check_fail my_cmd <arg1> <arg2>
mycmd->1</pre>
The value associated to the test must be 0 in case the
command doesn't need to test the <span style="font-family:monospace"><span class="command"><strong>private->r</strong></span></span> pointer.
- </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4551"></a>Debugging Rivet and Apache</h3></div></div></div><p style="width:90%">
+ </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1370"></a>Debugging Rivet and Apache</h3></div></div></div><p style="width:90%">
If you are interested in hacking on Rivet, you're welcome to
contribute! Invariably, when working with code, things go
wrong, and it's necessary to do some debugging. In a server
diff --git a/rivet/manual3.2/lassign_array.html b/rivet/manual3.2/lassign_array.html
index af61847..5d08799 100644
--- a/rivet/manual3.2/lassign_array.html
+++ b/rivet/manual3.2/lassign_array.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>lassign_array</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="inspect.html" title="inspect"><link rel="next" href="lempty.html" title="lempty"></head><body bgcolor= [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>lassign_array</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="inspect.html" title="inspect"><link rel="next" href="lempty.html" title="lempty"></head><body bgcolor= [...]
<span style="font-family:monospace"><span class="command"><strong>lassign_array</strong></span></span> is an utility command inspired by the same Tclx command and
with a close resemblance with Tcl's <span style="font-family:monospace"><span class="command"><strong>lassign</strong></span></span> for assigning list elements to variables.
<span style="font-family:monospace"><span class="command"><strong>lassign_array</strong></span></span> first argument is a list of values to be assigned to an array that must be
diff --git a/rivet/manual3.2/lazybridge.html b/rivet/manual3.2/lazybridge.html
index 44c2bdc..bb9302a 100644
--- a/rivet/manual3.2/lazybridge.html
+++ b/rivet/manual3.2/lazybridge.html
@@ -1,13 +1,13 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Example: the “Lazy” bridge</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="internals.html" title="Rivet Internals"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840 [...]
- The 'bridge' concept was introduced to cope with the ability of
- the Apache HTTP web server to adopt different multiprocessing
- models by loading one of the available MPMs (Multi Processing Modules).
- A bridge's task is to let mod_rivet fit the selected multiprocessing
- model in the first place. Still separating mod_rivet core
- functions from the MPM machinery provided also a solution for
- implementing a flexible and extensible design that enables
- a programmer to develop alternative approaches to workload and
- resource management.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Example: the “Lazy” bridge</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="internals.html" title="Rivet Internals"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840 [...]
+ The 'bridge' concept was introduced to cope with the ability of
+ the Apache HTTP web server to adopt different multiprocessing
+ models by loading one of the available MPMs (Multi Processing Modules).
+ A bridge's task is to let mod_rivet fit the selected multiprocessing
+ model in the first place. Still separating mod_rivet core
+ functions from the MPM machinery provided also a solution for
+ implementing a flexible and extensible design that enables
+ a programmer to develop alternative approaches to workload and
+ resource management.
</p><p style="width:90%">
The Apache HTTP web server demands its modules to
run with any MPM irrespective of its internal architecture and its
@@ -19,16 +19,14 @@
This demands a Tcl interpreters be run
on separated threads communicating with the HTTP web server
through suitable methods.
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4585"></a>Lazy bridge data structures</h3></div></div></div><p style="width:90%">
- The lazy bridge was initially developed to outline the basic tasks
- carried out by each function making a rivet MPM bridge.
- The lazy bridge attempts to be minimalist
- but it's nearly fully functional, only a few configuration
- directives (SeparateVirtualInterps and SeparateChannel)
- are ignored because fundamentally incompatible.
- The bridge is experimental but perfectly fit for many applications,
- for example it's good on development machines where server restarts
- are frequent.
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1372"></a>Lazy bridge data structures</h3></div></div></div><p style="width:90%">
+ The lazy bridge was initially developed to outline the basic tasks carried
+ out by each function making a rivet MPM bridge. The lazy bridge attempts
+ to be minimalist but it's nearly fully functional, only a few configuration
+ directives (SeparateVirtualInterps and SeparateChannel) are ignored because
+ fundamentally incompatible. The bridge is experimental but perfectly fit
+ for many applications, for example it's good on development machines where
+ server restarts are frequent.
</p><p style="width:90%">
This is the lazy bridge jump table, as such it defines the functions
implemented by the bridge.
@@ -53,8 +51,8 @@ typedef struct vhost_iface {
apr_thread_mutex_t* mutex; /* mutex protecting 'array' */
apr_array_header_t* array; /* LIFO array of lazy_tcl_worker pointers */
} vhost;</pre><p style="width:90%">
- A pointer to this data structure array is stored in the bridge status which a basic
- structure that likely every bridge has to create.
+ A pointer to this data structure array is stored in the bridge status which is a basic
+ structure that every bridge has to create.
</p><pre class="programlisting">/* Lazy bridge internal status data */
typedef struct mpm_bridge_status {
@@ -65,22 +63,18 @@ typedef struct mpm_bridge_status {
vhost* vhosts; /* array of vhost descriptors */
} mpm_bridge_status;</pre><p style="width:90%">
The lazy bridge also extends the thread private data structure with the
- data concerning the Tcl intepreter, its configuration and
+ data concerning the Tcl intepreter
</p><pre class="programlisting">/* lazy bridge thread private data extension */
typedef struct mpm_bridge_specific {
rivet_thread_interp* interp; /* thread Tcl interpreter object */
int keep_going; /* thread loop controlling variable */
- /* the request_rec and TclWebRequest *
- * are copied here to be passed to a *
- * channel */
} mpm_bridge_specific;</pre><p style="width:90%">
By design the bridge must create exactly one instance of <span style="font-family:monospace"><span class="command"><strong>mpm_bridge_status</strong></span></span>
and store its pointer in <span style="font-family:monospace"><span class="command"><strong>module_globals->mpm</strong></span></span>.
This is usually done at the very beginning of the child init script function pointed by
<span style="font-family:monospace"><span class="command"><strong>mpm_child_init</strong></span></span> in the <span style="font-family:monospace"><span class="command"><strong>rivet_bridge_table</strong></span></span> structure.
- For the lazy bridge this field in the jump table points to <span style="font-family:monospace"><span class="command"><strong>Lazy_MPM_ChildInit</strong></span></span>
- function
+ For the lazy bridge this field points to <span style="font-family:monospace"><span class="command"><strong>Lazy_MPM_ChildInit</strong></span></span> function
</p><pre class="programlisting">/*
* -- LazyBridge_ChildInit
*
@@ -141,20 +135,20 @@ void LazyBridge_ChildInit (apr_pool_t* pool, server_rec* server)
module_globals->mpm->vhosts[idx].threads_count = 0;
}
module_globals->mpm->server_shutdown = 0;
-}</pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4603"></a>Handling Tcl's exit core command</h3></div></div></div><p style="width:90%">
+}</pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1373"></a>Handling Tcl's exit core command</h3></div></div></div><p style="width:90%">
Most fields in the <span style="font-family:monospace"><span class="command"><strong>mpm_bridge_status</strong></span></span> are meant to deal
with the child exit process. Rivet supersedes the Tcl core's exit function
- with a <span style="font-family:monospace"><span class="command"><strong>::rivet::exit</strong></span></span> function and it does so in order to curb the effects
- of the core function that would force a child process to immediately exit.
- This could have unwanted side effects, like skipping the execution of important
- code dedicated to release locks or remove files. For threaded MPMs the abrupt
- child process termination could be even more disruptive as all the threads
- will be deleted without warning.
+ with <span style="font-family:monospace"><span class="command"><strong>::rivet::exit</strong></span></span> command and it does so in order to curb
+ the side effects of the core function Tcl_Exit that would force a whole child process
+ to exit immediately. This could have unwanted consequences in any
+ environment, like missing the execution of code dedicated to release locks or
+ remove files. For threaded MPMs the abrupt child process termination could be
+ even more disruptive as all threads will be deleted right away.
</p><p style="width:90%">
The <span style="font-family:monospace"><span class="command"><strong>::rivet::exit</strong></span></span> implementation calls the function pointed by
<span style="font-family:monospace"><span class="command"><strong>mpm_exit_handler</strong></span></span> which is bridge specific. Its main duty
is to take the proper action in order to release resources and force the
- bridge controlled threads to exit.
+ bridge controlled threads to exit.
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
Nonetheless the <span style="font-family:monospace"><span class="command"><strong>exit</strong></span></span> command should be avoided in ordinary mod_rivet
programming. We cannot stress this point enough. If your application must bail out
@@ -165,14 +159,14 @@ void LazyBridge_ChildInit (apr_pool_t* pool, server_rec* server)
<span style="font-family:monospace"><span class="command"><strong>exit</strong></span></span> in a sort of special <span style="font-family:monospace"><span class="command"><strong>::rivet::abort_page</strong></span></span>
implementation whose eventual action is to call the <span style="font-family:monospace"><span class="command"><strong>Tcl_Exit</strong></span></span>
library call. See the <span style="font-family:monospace"><span class="command"><strong><a class="xref" href="exit.html" title="exit">exit</a></strong></span></span>
- command for further explanations.
+ command code for further explanations.
</td></tr></table></div><p style="width:90%">
Both the worker bridge and lazy bridge
implementations of <span style="font-family:monospace"><span class="command"><strong>mpm_exit_handler</strong></span></span> call the function pointed
by <span style="font-family:monospace"><span class="command"><strong>mpm_finalize</strong></span></span> which is also the function called by the framework
when the web server shuts down. See these functions' code for further details,
they are very easy to read and understand
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm4622"></a>HTTP request processing with the lazy bridge</h3></div></div></div><p style="width:90%">
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1374"></a>HTTP request processing with the lazy bridge</h3></div></div></div><p style="width:90%">
Requests processing with the lazy bridge is done by determining for which
virtual host a request was created. The <span style="font-family:monospace"><span class="command"><strong>rivet_server_conf</strong></span></span>
structure keeps a numerical index for each virtual host. This index is used
@@ -208,16 +202,16 @@ typedef struct lazy_tcl_worker {
and the request handed to it. If no available thread is on the queue a new worker thread is
created. The code in the <span style="font-family:monospace"><span class="command"><strong>Lazy_MPM_Request</strong></span></span> easy to understand and shows
how this is working
- </p><pre class="programlisting">/* -- Lazy_MPM_Request
+ </p><pre class="programlisting">/* -- LazyBridge_Request
*
- * The lazy bridge HTTP request function. This function
+ * The lazy bridge HTTP request function. This function
* stores the request_rec pointer into the lazy_tcl_worker
* structure which is used to communicate with a worker thread.
* Then the array of idle threads is checked and if empty
* a new thread is created by calling create_worker
*/
-int Lazy_MPM_Request (request_rec* r,rivet_req_ctype ctype)
+int LazyBridge_Request (request_rec* r,rivet_req_ctype ctype)
{
lazy_tcl_worker* w;
int ap_sts;
@@ -229,16 +223,17 @@ int Lazy_MPM_Request (request_rec* r,rivet_req_ctype ctype)
array = module_globals->mpm->vhosts[conf->idx].array;
apr_thread_mutex_lock(mutex);
- /* This request may have come while the child process was
- * shutting down. We cannot run the risk that incoming requests
- * may hang the child process by keeping its threads busy,
- * so we simply return an HTTP_INTERNAL_SERVER_ERROR.
- * This is hideous and explains why the 'exit' commands must
- * be avoided at any costs when programming with mod_rivet
- */
+ /* This request may have come while the child process was
+ * shutting down. We cannot run the risk that incoming requests
+ * may hang the child process by keeping its threads busy,
+ * so we simply return an HTTP_INTERNAL_SERVER_ERROR.
+ * This is hideous and explains why the 'exit' commands must
+ * be avoided at any costs when programming with mod_rivet
+ */
- if (module_globals->mpm->server_shutdown == 1) {
- ap_log_rerror(APLOG_MARK, APLOG_ERR, APR_EGENERAL, r,
+ if (module_globals->mpm->server_shutdown == 1)
+ {
+ ap_log_rerror(APLOG_MARK,APLOG_ERR,APR_EGENERAL,r,
MODNAME ": http request aborted during child process shutdown");
apr_thread_mutex_unlock(mutex);
return HTTP_INTERNAL_SERVER_ERROR;
@@ -249,7 +244,6 @@ int Lazy_MPM_Request (request_rec* r,rivet_req_ctype ctype)
if (apr_is_empty_array(array))
{
w = create_worker(module_globals->pool,r->server);
- (module_globals->mpm->vhosts[conf->idx].threads_count)++;
}
else
{
@@ -257,7 +251,9 @@ int Lazy_MPM_Request (request_rec* r,rivet_req_ctype ctype)
}
apr_thread_mutex_unlock(mutex);
-
+
+ /* Locking the thread descriptor structure mutex */
+
apr_thread_mutex_lock(w->mutex);
w->r = r;
w->ctype = ctype;
@@ -269,7 +265,7 @@ int Lazy_MPM_Request (request_rec* r,rivet_req_ctype ctype)
while (w->status != done) {
apr_thread_cond_wait(w->condition,w->mutex);
- }
+ }
ap_sts = w->ap_sts;
w->status = idle;
@@ -287,54 +283,53 @@ int Lazy_MPM_Request (request_rec* r,rivet_req_ctype ctype)
</p><pre class="programlisting">/*
* -- request_processor
*
- * The lazy bridge worker thread. This thread initialized its control data and
+ * The lazy bridge worker thread. This thread initializes its control data and
* prepares to serve requests addressed to the virtual host which is meant to work
- * as a content generator. Virtual host server data are stored in the
+ * as a content generator. Virtual host server data are stored in the
* lazy_tcl_worker structure stored in the generic pointer argument 'data'
- *
+ *
*/
static void* APR_THREAD_FUNC request_processor (apr_thread_t *thd, void *data)
{
- lazy_tcl_worker* w = (lazy_tcl_worker*) data;
+ lazy_tcl_worker* w = (lazy_tcl_worker*) data;
rivet_thread_private* private;
int idx;
rivet_server_conf* rsc;
/* The server configuration */
- rsc = RIVET_SERVER_CONF(w->server->module_config);
+ rsc = RIVET_SERVER_CONF(w->gt;server->gt;module_config);
/* Rivet_ExecutionThreadInit creates and returns the thread private data. */
private = Rivet_ExecutionThreadInit();
- /* A bridge creates and stores in private->ext its own thread private
- * data. The lazy bridge is no exception. We just need a flag controlling
+ /* A bridge creates and stores in private->gt;ext its own thread private
+ * data. The lazy bridge is no exception. We just need a flag controlling
* the execution and an intepreter control structure */
- private->ext = apr_pcalloc(private->pool,sizeof(mpm_bridge_specific));
- private->ext->keep_going = 1;
- //private->ext->interp = Rivet_NewVHostInterp(private->pool,w->server);
- RIVET_POKE_INTERP(private,rsc,Rivet_NewVHostInterp(private->pool,rsc->default_cache_size));
- private->ext->interp->channel = private->channel;
+ private->gt;ext = apr_pcalloc(private->gt;pool,sizeof(mpm_bridge_specific));
+ private->gt;ext->gt;keep_going = true;
+ RIVET_POKE_INTERP(private,rsc,Rivet_NewVHostInterp(private->gt;pool,rsc->gt;default_cache_size));
+ private->gt;ext->gt;interp->gt;channel = private->gt;channel;
- /* The worker thread can respond to a single request at a time therefore
+ /* The worker thread can respond to a single request at a time therefore
must handle and register its own Rivet channel */
- Tcl_RegisterChannel(private->ext->interp->interp,*private->channel);
+ Tcl_RegisterChannel(private->gt;ext->gt;interp->gt;interp,*private->gt;channel);
/* From the rivet_server_conf structure we determine what scripts we
* are using to serve requests */
- private->ext->interp->scripts =
- Rivet_RunningScripts (private->pool,private->ext->interp->scripts,rsc);
+ private->gt;ext->gt;interp->gt;scripts =
+ Rivet_RunningScripts (private->gt;pool,private->gt;ext->gt;interp->gt;scripts,rsc);
/* This is the standard Tcl interpreter initialization */
- Rivet_PerInterpInit(private->ext->interp,private,w->server,private->pool);
-
- /* The child initialization is fired. Beware of the terminologic
+ Rivet_PerInterpInit(private->gt;ext->gt;interp,private,w->gt;server,private->gt;pool);
+
+ /* The child initialization is fired. Beware the terminological
* trap: we inherited from fork capable systems the term 'child'
* meaning 'child process'. In this case the child init actually
* is a worker thread initialization, because in a threaded module
@@ -343,62 +338,60 @@ static void* APR_THREAD_FUNC request_processor (apr_thread_t *thd, void *data)
Lazy_RunConfScript(private,w,child_init);
- idx = w->conf->idx;
+ idx = w->gt;conf->gt;idx;
- /* After the thread has run the configuration script we
+ /* After the thread has run the configuration script we
increment the threads counter */
- apr_thread_mutex_lock(module_globals->mpm->vhosts[idx].mutex);
- (module_globals->mpm->vhosts[idx].threads_count)++;
- apr_thread_mutex_unlock(module_globals->mpm->vhosts[idx].mutex);
+ apr_thread_mutex_lock(module_globals->gt;mpm->gt;vhosts[idx].mutex);
+ (module_globals->gt;mpm->gt;vhosts[idx].threads_count)++;
+ apr_thread_mutex_unlock(module_globals->gt;mpm->gt;vhosts[idx].mutex);
- /* The thread is now set up to serve request within the the
- * do...while loop controlled by private->keep_going */
+ /* The thread is now set up to serve request within the the
+ * do...while loop controlled by private->gt;keep_going */
- apr_thread_mutex_lock(w->mutex);
- do
+ apr_thread_mutex_lock(w->gt;mutex);
+ do
{
- while ((w->status != init) && (w->status != thread_exit)) {
- apr_thread_cond_wait(w->condition,w->mutex);
- }
- if (w->status == thread_exit) {
- private->ext->keep_going = 0;
+ while ((w->gt;status != init) && (w->gt;status != thread_exit)) {
+ apr_thread_cond_wait(w->gt;condition,w->gt;mutex);
+ }
+ if (w->gt;status == thread_exit) {
+ private->gt;ext->gt;keep_going = false;
continue;
}
- w->status = processing;
+ w->gt;status = processing;
/* Content generation */
- private->req_cnt++;
- private->ctype = w->ctype;
- private->r = w->r;
+ private->gt;req_cnt++;
+ private->gt;ctype = w->gt;ctype;
+ private->gt;r = w->gt;r;
- w->ap_sts = Rivet_SendContent(private);
+ w->gt;ap_sts = Rivet_SendContent(private);
- // if (module_globals->mpm->server_shutdown) continue;
+ w->gt;status = done;
+ apr_thread_cond_signal(w->gt;condition);
+ while (w->gt;status == done) {
+ apr_thread_cond_wait(w->gt;condition,w->gt;mutex);
+ }
- w->status = done;
- apr_thread_cond_signal(w->condition);
- while (w->status == done) {
- apr_thread_cond_wait(w->condition,w->mutex);
- }
-
/* rescheduling itself in the array of idle threads */
-
- apr_thread_mutex_lock(module_globals->mpm->vhosts[idx].mutex);
- *(lazy_tcl_worker **) apr_array_push(module_globals->mpm->vhosts[idx].array) = w;
- apr_thread_mutex_unlock(module_globals->mpm->vhosts[idx].mutex);
- } while (private->ext->keep_going);
- apr_thread_mutex_unlock(w->mutex);
-
+ apr_thread_mutex_lock(module_globals->gt;mpm->gt;vhosts[idx].mutex);
+ *(lazy_tcl_worker **) apr_array_push(module_globals->gt;mpm->gt;vhosts[idx].array) = w;
+ apr_thread_mutex_unlock(module_globals->gt;mpm->gt;vhosts[idx].mutex);
+
+ } while (private->gt;ext->gt;keep_going);
+ apr_thread_mutex_unlock(w->gt;mutex);
+
Lazy_RunConfScript(private,w,child_exit);
- ap_log_error(APLOG_MARK,APLOG_DEBUG,APR_SUCCESS,w->server,"processor thread orderly exit");
+ ap_log_error(APLOG_MARK,APLOG_DEBUG,APR_SUCCESS,w->gt;server,"processor thread orderly exit");
- apr_thread_mutex_lock(module_globals->mpm->vhosts[idx].mutex);
- (module_globals->mpm->vhosts[idx].threads_count)--;
- apr_thread_mutex_unlock(module_globals->mpm->vhosts[idx].mutex);
+ apr_thread_mutex_lock(module_globals->gt;mpm->gt;vhosts[idx].mutex);
+ (module_globals->gt;mpm->gt;vhosts[idx].threads_count)--;
+ apr_thread_mutex_unlock(module_globals->gt;mpm->gt;vhosts[idx].mutex);
apr_thread_exit(thd,APR_SUCCESS);
return NULL;
@@ -407,11 +400,15 @@ static void* APR_THREAD_FUNC request_processor (apr_thread_t *thd, void *data)
is supposed to return the rivet_thread_interp structure pointer relevant to a given
request, has a straightforward task to do since by design each thread has
one interpreter
- </p><pre class="programlisting">rivet_thread_interp* Lazy_MPM_Interp(rivet_thread_private *private,
- rivet_server_conf* conf)
+ </p><pre class="programlisting">rivet_thread_interp* LazyBridge_Interp (rivet_thread_private* private,
+ rivet_server_conf* conf,
+ rivet_thread_interp* interp)
{
+ if (interp != NULL) { private->ext->interp = interp; }
+
return private->ext->interp;
-}</pre><p style="width:90%">
+}
+</pre><p style="width:90%">
As already pointed out
running this bridge you get separate virtual interpreters and separate channels by default
and since by design each threads gets its own Tcl interpreter and Rivet channel you will
diff --git a/rivet/manual3.2/lempty.html b/rivet/manual3.2/lempty.html
index 4b7256c..75d71a5 100644
--- a/rivet/manual3.2/lempty.html
+++ b/rivet/manual3.2/lempty.html
@@ -1,7 +1,7 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>lempty</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="lassign_array.html" title="lassign_array"><link rel="next" href="lmatch.html" title="lmatch"></head><body bgc [...]
Returns 1 if <list> is empty or 0 if it has any elements.
This command emulates the TclX lempty command.
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::lempty</span> <span style="font-family:monospace; font-weight: bold;">list</span> </div></div></div><div class="refsect1"><a name="idm1391"></a><h2>Description</h2><p style="width:90%">
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::lempty</span> <span style="font-family:monospace; font-weight: bold;">list</span> </div></div></div><div class="refsect1"><a name="id2758"></a><h2>Description</h2><p style="width:90%">
Returns 1 if <list> is empty or 0 if it has any elements.
This command emulates the TclX lempty command.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="lassign_array.html"><img src="images/prev.png" alt="Prev"></a> </td><td width="20%" align="center"><a accesskey="u" href="commands.html"><img src="images/up.png" alt="Up"></a></td><td width="40%" align="right"> <a accesskey="n" href="lmatch.html"><img src="images/next.png" alt="Next"></a></td></tr><tr><td width="40%" align="left" valign="top [...]
diff --git a/rivet/manual3.2/lmatch.html b/rivet/manual3.2/lmatch.html
index a00c079..ef1febc 100644
--- a/rivet/manual3.2/lmatch.html
+++ b/rivet/manual3.2/lmatch.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>lmatch</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="lempty.html" title="lempty"><link rel="next" href="load_cookies.html" title="load_cookies"></head><body bgcol [...]
Look for elements in <list> that match <pattern>
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::lmatch</span> (<span style="font-family:monospace; font-weight: bold;">-exact</span> | <span style="font-family:monospace; font-weight: bold;">-glob</span> | <span style="font-family:monospace; font-weight: bold;">-regexp< [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::lmatch</span> (<span style="font-family:monospace; font-weight: bold;">-exact</span> | <span style="font-family:monospace; font-weight: bold;">-glob</span> | <span style="font-family:monospace; font-weight: bold;">-regexp< [...]
Look for elements in <list> that match <pattern>.
This command is a decent replacement for TclX lmatch command when TclX is
not available
diff --git a/rivet/manual3.2/load_cookies.html b/rivet/manual3.2/load_cookies.html
index f334a62..9098335 100644
--- a/rivet/manual3.2/load_cookies.html
+++ b/rivet/manual3.2/load_cookies.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>load_cookies</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="lmatch.html" title="lmatch"><link rel="next" href="load_env.html" title="load_env"></head><body bgcolor [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>load_cookies</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="lmatch.html" title="lmatch"><link rel="next" href="load_env.html" title="load_env"></head><body bgcolor [...]
Load the array of cookie variables into the specified
array name. Uses array cookies by
default.
diff --git a/rivet/manual3.2/load_env.html b/rivet/manual3.2/load_env.html
index bb885e2..048294b 100644
--- a/rivet/manual3.2/load_env.html
+++ b/rivet/manual3.2/load_env.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>load_env</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="load_cookies.html" title="load_cookies"><link rel="next" href="load_headers.html" title="load_headers"></he [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>load_env</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="load_cookies.html" title="load_cookies"><link rel="next" href="load_headers.html" title="load_headers"></he [...]
Load the array of environment variables into the specified
array name. Uses array ::request::env by
default.
diff --git a/rivet/manual3.2/load_headers.html b/rivet/manual3.2/load_headers.html
index 04ee385..0cff088 100644
--- a/rivet/manual3.2/load_headers.html
+++ b/rivet/manual3.2/load_headers.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>load_headers</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="load_env.html" title="load_env"><link rel="next" href="load_response.html" title="load_response"></head [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>load_headers</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="load_env.html" title="load_env"><link rel="next" href="load_response.html" title="load_response"></head [...]
Load the headers that come from a client request into the
provided array name, or use headers if no
name is provided.
diff --git a/rivet/manual3.2/load_response.html b/rivet/manual3.2/load_response.html
index e17acd8..767e4ab 100644
--- a/rivet/manual3.2/load_response.html
+++ b/rivet/manual3.2/load_response.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>load_response</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="load_headers.html" title="load_headers"><link rel="next" href="lremove.html" title="lremove"></head><b [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>load_response</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="load_headers.html" title="load_headers"><link rel="next" href="lremove.html" title="lremove"></head><b [...]
Load any form variables passed to this page into an
array. If <span style="font-family:monospace"><span class="command"><strong>load_response</strong></span></span> is called without
arguments the array response is created in
diff --git a/rivet/manual3.2/lremove.html b/rivet/manual3.2/lremove.html
index ca37fd2..72e0a13 100644
--- a/rivet/manual3.2/lremove.html
+++ b/rivet/manual3.2/lremove.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>lremove</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="load_response.html" title="load_response"><link rel="next" href="makeurl.html" title="makeurl"></head><body [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>lremove</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="load_response.html" title="load_response"><link rel="next" href="makeurl.html" title="makeurl"></head><body [...]
<span style="font-family:monospace"><span class="command"><strong>lremove</strong></span></span> removes from list ?<span style="font-family:monospace; font-weight: bold;">list</span>? the first occurrence
of an element matching one of the patterns listed in the command line. By specifying the
-all option every occurrence of one the patterns is removed
diff --git a/rivet/manual3.2/makeurl.html b/rivet/manual3.2/makeurl.html
index 9123d07..3c786fe 100644
--- a/rivet/manual3.2/makeurl.html
+++ b/rivet/manual3.2/makeurl.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>makeurl</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="lremove.html" title="lremove"><link rel="next" href="no_body.html" title="no_body"></head><body bgcolor="whi [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>makeurl</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="lremove.html" title="lremove"><link rel="next" href="no_body.html" title="no_body"></head><body bgcolor="whi [...]
Create a self referencing URL from a filename. <span style="font-family:monospace"><span class="command"><strong>makeurl</strong></span></span>
can be used in three ways
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">With no arguments the current script URL is returned</li><li class="listitem">
diff --git a/rivet/manual3.2/no_body.html b/rivet/manual3.2/no_body.html
index 79aed9e..223f936 100644
--- a/rivet/manual3.2/no_body.html
+++ b/rivet/manual3.2/no_body.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>no_body</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="makeurl.html" title="makeurl"><link rel="next" href="parray.html" title="parray"></head><body bgcolor="white [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>no_body</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="makeurl.html" title="makeurl"><link rel="next" href="parray.html" title="parray"></head><body bgcolor="white [...]
This command is useful for situations where it is necessary
to only return HTTP headers and no actual content. For
instance, when returning a 304 redirect.
diff --git a/rivet/manual3.2/parray.html b/rivet/manual3.2/parray.html
index ef32976..00caed8 100644
--- a/rivet/manual3.2/parray.html
+++ b/rivet/manual3.2/parray.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>parray</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="no_body.html" title="no_body"><link rel="next" href="parse.html" title="parse"></head><body bgcolor="white" t [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>parray</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="no_body.html" title="no_body"><link rel="next" href="parse.html" title="parse"></head><body bgcolor="white" t [...]
An html version of the standard Tcl
<span style="font-family:monospace"><span class="command"><strong>parray</strong></span></span> command. Displays the entire
contents of an array in a sorted, nicely-formatted way.
diff --git a/rivet/manual3.2/parse.html b/rivet/manual3.2/parse.html
index 42fcf7d..4017c0c 100644
--- a/rivet/manual3.2/parse.html
+++ b/rivet/manual3.2/parse.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>parse</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="parray.html" title="parray"><link rel="next" href="raw_post.html" title="raw_post"></head><body bgcolor="white [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>parse</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="parray.html" title="parray"><link rel="next" href="raw_post.html" title="raw_post"></head><body bgcolor="white [...]
Like the Tcl <span style="font-family:monospace"><span class="command"><strong>source</strong></span></span> command, but also
parses for Rivet <? and ?> processing tags. Using
this command, you can use one .rvt file from another.
diff --git a/rivet/manual3.2/processing.html b/rivet/manual3.2/processing.html
index baba02b..7aaea2b 100644
--- a/rivet/manual3.2/processing.html
+++ b/rivet/manual3.2/processing.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Apache Rivet HTTP Request Processing</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="directives.html" title="Apache Rivet 3.2 Configuration"><link rel="next" href="request.html" title [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Apache Rivet HTTP Request Processing</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="directives.html" title="Apache Rivet 3.2 Configuration"><link rel="next" href="request.html" title [...]
Until 2.x versions Rivet handled requests
following the vision that inspired the original design
which was summarized in the definition <span class="quote">“<span class="quote">Web programming
@@ -95,7 +95,7 @@
<span style="font-family:monospace"><span class="command"><strong>::rivet::abort_page</strong></span></span>.
The current procedure might work as a template to be
reworked into your own request handler.
- </td></tr></table></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm616"></a>Example: basic OO Rivet Application</h3></div></div></div><p style="width:90%">
+ </td></tr></table></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1343"></a>Example: basic OO Rivet Application</h3></div></div></div><p style="width:90%">
An applications may have no interest in running
a script pointed by the URL as in the traditional approach
followed by rivet inspired to the PHP philosophy of <span class="quote">“<span class="quote">scripting
diff --git a/rivet/manual3.2/raw_post.html b/rivet/manual3.2/raw_post.html
index 154d3f1..64ae3cc 100644
--- a/rivet/manual3.2/raw_post.html
+++ b/rivet/manual3.2/raw_post.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>raw_post</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="parse.html" title="parse"><link rel="next" href="redirect.html" title="redirect"></head><body bgcolor="whit [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>raw_post</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="parse.html" title="parse"><link rel="next" href="redirect.html" title="redirect"></head><body bgcolor="whit [...]
Returns the raw POST data from the request. If the request was
not a POST or there is no data, then "" - an empty string - is returned.
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="parse.html"><img src="images/prev.png" alt="Prev"></a> </td><td width="20%" align="center"><a accesskey="u" href="commands.html"><img src="images/up.png" alt="Up"></a></td><td width="40%" align="right"> <a accesskey="n" href="redirect.html"><img src="images/next.png" alt="Next"></a></td></tr><tr><td width="40%" align="left" valign="top">parse < [...]
diff --git a/rivet/manual3.2/read_file.html b/rivet/manual3.2/read_file.html
index f93ad24..d49fa2c 100644
--- a/rivet/manual3.2/read_file.html
+++ b/rivet/manual3.2/read_file.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>read_file</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="redirect.html" title="redirect"><link rel="next" href="thread_id.html" title="thread_id"></head><body bgco [...]
Read the entire contents of a file and return it as a string.
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::read_file</span> ?<span style="font-family:monospace; font-weight: bold;">file name</span>?</div></div></div><div class="refsect1"><a name="idm1616"></a><h2>Description</h2><p style="width:90%">
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::read_file</span> ?<span style="font-family:monospace; font-weight: bold;">file name</span>?</div></div></div><div class="refsect1"><a name="id2983"></a><h2>Description</h2><p style="width:90%">
This is a utility command which loads the entire content of
a file and returns it as a result.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="redirect.html"><img src="images/prev.png" alt="Prev"></a> </td><td width="20%" align="center"><a accesskey="u" href="commands.html"><img src="images/up.png" alt="Up"></a></td><td width="40%" align="right"> <a accesskey="n" href="thread_id.html"><img src="images/next.png" alt="Next"></a></td></tr><tr><td width="40%" align="left" valign="top" [...]
diff --git a/rivet/manual3.2/redirect.html b/rivet/manual3.2/redirect.html
index 5e8e761..54827b6 100644
--- a/rivet/manual3.2/redirect.html
+++ b/rivet/manual3.2/redirect.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>redirect</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="raw_post.html" title="raw_post"><link rel="next" href="read_file.html" title="read_file"></head><body bgcol [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>redirect</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="raw_post.html" title="raw_post"><link rel="next" href="read_file.html" title="read_file"></head><body bgcol [...]
<span style="font-family:monospace"><span class="command"><strong>::rivet::redirect</strong></span></span> diverts the browser to a new URL and marks
the redirection as either permanent in the browser local cache or
non permanent (default).
diff --git a/rivet/manual3.2/request.html b/rivet/manual3.2/request.html
index 980556f..635d46f 100644
--- a/rivet/manual3.2/request.html
+++ b/rivet/manual3.2/request.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Apache Child Processes Lifecycle and Request Processing</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="processing.html" title="Apache Rivet HTTP Request Processing"><link rel="next" [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Apache Child Processes Lifecycle and Request Processing</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="processing.html" title="Apache Rivet HTTP Request Processing"><link rel="next" [...]
Apache Rivet devolves to the <a class="ulink" href="" target="_top">Multi-Processing Module (MPM)</a>
the task of managing the agents responding to network requests.
An MPM is responsible for creating such agents during the start-up,
@@ -21,7 +21,7 @@
</p><p style="width:90%">
There are 4 stages in the lifetime of an Apache webserver that are relevant
to Rivet:
- </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><h4><a name="idm653"></a>Server Initialization</h4><div style="margin-bottom:1.5ex ; padding .5ex">
+ </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><h4><a name="id2021"></a>Server Initialization</h4><div style="margin-bottom:1.5ex ; padding .5ex">
Apaches starts up as a single process. During this stage Apache performs
various preliminary tasks including reading and parsing the configuration.
After the configuration has been read Rivet sets up some internal resources
@@ -42,7 +42,7 @@
in this context are IPC methods that must be initialized at this stage.
With the prefork MPM also importing from namespaces and loading packages
can be done here removing the burden from the child initialization stage.
- </div></li><li class="listitem"><h4><a name="idm659"></a>Child Process Initialization</h4><div style="margin-bottom:1.5ex ; padding .5ex">
+ </div></li><li class="listitem"><h4><a name="id2027"></a>Child Process Initialization</h4><div style="margin-bottom:1.5ex ; padding .5ex">
A child process calls the MPM bridge interface function to set up
the Tcl run time environment,either creating multiple threads each running its
Tcl interpreters or, in the case of the prefork MPM bridge, setting up
@@ -78,7 +78,7 @@
a single virtual host, therefore <span style="font-family:monospace"><span class="command"><strong>SeparateVirtualInterps</strong></span></span>
is ignored and you can't share the same interpreter among virtual host
</td></tr></table></div>
- </div></li><li class="listitem"><h4><a name="idm675"></a>Request Processing and Content Generation</h4><div style="margin-bottom:1.5ex ; padding .5ex">
+ </div></li><li class="listitem"><h4><a name="id2043"></a>Request Processing and Content Generation</h4><div style="margin-bottom:1.5ex ; padding .5ex">
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
This section explain the default request handling procedure which
was written to let Rivet 3.0 work as a drop in replacement
@@ -104,7 +104,7 @@
be running within the same "before" and "after" scripts to which
the programmer can devolve tasks common to every
page of an application.
- </div></li><li class="listitem"><h4><a name="idm685"></a>Child Process Exit</h4><div style="margin-bottom:1.5ex ; padding .5ex">
+ </div></li><li class="listitem"><h4><a name="id2053"></a>Child Process Exit</h4><div style="margin-bottom:1.5ex ; padding .5ex">
If no error condition forces the child process to a premature exit, his
life is determined by the Apache configuration parameters. To reduce
the effects of memory leaks in buggy applications the Apache webserver
@@ -122,7 +122,7 @@
to exit and be replaced by a new one when the workload demands it.
This operation implies the <span style="font-family:monospace"><span class="command"><strong>ChildExitScript</strong></span></span> be
run before the interpreter is actually deleted.
- </div></li></ol></div></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm691"></a>Apache Rivet Error and Exception Scripts Directives</h3></div></div></div><p style="width:90%">
+ </div></li></ol></div></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="id2059"></a>Apache Rivet Error and Exception Scripts Directives</h3></div></div></div><p style="width:90%">
Rivet is highly configurable and each of the webserver lifecycle stages
can be exploited to control a web application.
Not only the orderly sequence of stages
@@ -148,7 +148,7 @@
the abnormal condition. Starting with Rivet 2.1.0 <a class="xref" href="abort_page.html" title="abort_page">abort_page</a>
accepts a free form parameter that can be retrieved later with the command
<a class="xref" href="abort_code.html" title="abort_code">abort_code</a>
- </p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm701"></a>Tcl Namespaces in Rivet and the <span style="font-family:monospace"><span class="command"><strong>::request</strong></span></span> Namespace</h3></div></div></div><p style="width:90%">
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="id2069"></a>Tcl Namespaces in Rivet and the <span style="font-family:monospace"><span class="command"><strong>::request</strong></span></span> Namespace</h3></div></div></div><p style="width:90%">
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
This section explain the default request handling procedure which
was written to let Rivet 3.0 work as a drop in replacement
diff --git a/rivet/manual3.2/session_package.html b/rivet/manual3.2/session_package.html
index 1230fd6..4cfa37b 100644
--- a/rivet/manual3.2/session_package.html
+++ b/rivet/manual3.2/session_package.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Session Package</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="diodisplay_package.html" title="DIODisplay"><link rel="next" href="form.html" title="Form: An HTML Form Fields Generati [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Session Package</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="index.html" title="Apache Rivet 3.2"><link rel="prev" href="diodisplay_package.html" title="DIODisplay"><link rel="next" href="form.html" title="Form: An HTML Form Fields Generati [...]
This is session management code. It provides an interface
to allow you to generate and track a browser's visit as a
"session", giving you a unique session ID and an interface
@@ -25,13 +25,13 @@
All DB interfacing is done through DIO, though, so it
should be relatively easy to add support for other
databases.
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm3306"></a>Preparing To Use It</h3></div></div></div><p style="width:90%">Create the tables in your SQL server. With Postgres,
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1346"></a>Preparing To Use It</h3></div></div></div><p style="width:90%">Create the tables in your SQL server. With Postgres,
do a <span style="font-family:monospace"><span class="command"><strong>psql www</strong></span></span> or whatever DB you
connect as, then a backslash-i on
<code class="filename">session-create.sql</code></p><p style="width:90%">(If you need to delete the tables, use <code class="filename">session-drop.sql</code>)</p><p style="width:90%">The session code by default requires a DIO handle
called <code class="varname">DIO</code> (the name of which can be
overridden). We get it by doing a</p><pre class="programlisting">RivetServerConf ChildInitScript "package require DIO"
-RivetServerConf ChildInitScript "::DIO::handle Postgresql DIO -user www"</pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm3316"></a>Example Usage</h3></div></div></div><p style="width:90%">In your httpd.conf, add:</p><pre class="programlisting">RivetServerConf ChildInitScript "package require Session; Session SESSION"</pre><p style="width:90%">
+RivetServerConf ChildInitScript "::DIO::handle Postgresql DIO -user www"</pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1347"></a>Example Usage</h3></div></div></div><p style="width:90%">In your httpd.conf, add:</p><pre class="programlisting">RivetServerConf ChildInitScript "package require Session; Session SESSION"</pre><p style="width:90%">
This tells Rivet you want to create a session object named
SESSION in every child process Apache creates.</p><p style="width:90%">
You can configure the session at this point using numerous
@@ -52,7 +52,7 @@ RivetServerConf ChildInitScript "::DIO::handle Postgresql DIO -user www"</pre></
additional requests are received during the session, all
under the control of the key-value pairs controlling the
session object.
- </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm3328"></a>Using Sessions From Your Code</h3></div></div></div><p style="width:90%">The main methods your code will use are:</p><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spac [...]
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1348"></a>Using Sessions From Your Code</h3></div></div></div><p style="width:90%">The main methods your code will use are:</p><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spaci [...]
After doing a <span style="font-family:monospace"><span class="command"><strong>SESSION activate</strong></span></span>,
this will return a 32-byte ASCII-encoded random
hexadecimal string. Every time this browser comes
@@ -79,7 +79,7 @@ RivetServerConf ChildInitScript "::DIO::handle Postgresql DIO -user www"</pre></
none was set. (Status is set to the DIO error that
occurred, it can be fetched using the status
method.)
- </div></div></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm3374"></a>Session Configuration Options</h3></div></div></div><p style="width:90%">The following key-value pairs can be specified when a
+ </div></div></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1349"></a>Session Configuration Options</h3></div></div></div><p style="width:90%">The following key-value pairs can be specified when a
session object (like SESSION above) is created:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">sessionLifetime</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">how many seconds the session will live for.
7200 == 2 hours
</div></div></dd><dt><span class="term">sessionRefreshInterval</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
@@ -132,7 +132,7 @@ RivetServerConf ChildInitScript "::DIO::handle Postgresql DIO -user www"</pre></
file handle that debugging messages will be written
to (default
<code class="varname">stdout</code>)
- </div></div></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm3452"></a>Session Methods</h3></div></div></div><p style="width:90%">
+ </div></div></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1350"></a>Session Methods</h3></div></div></div><p style="width:90%">
The following methods can be invoked to find out
information about the current session, store and fetch
server data identified with this session, etc:
@@ -171,7 +171,7 @@ RivetServerConf ChildInitScript "::DIO::handle Postgresql DIO -user www"</pre></
If they don't have one or it isn't valid (timed out,
etc), create a session and drop a cookie on
them.
- </div></div></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm3508"></a>Getting Additional Randomness From The Entropy File</h3></div></div></div><pre class="programlisting">RivetServerConf ChildInitScript "Session SESSION -entropyFile /dev/urandom \
+ </div></div></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="id1351"></a>Getting Additional Randomness From The Entropy File</h3></div></div></div><pre class="programlisting">RivetServerConf ChildInitScript "Session SESSION -entropyFile /dev/urandom \
-entropyLength 10 -debugMode 1"</pre><p style="width:90%">
This options say we want to get randomness from an entropy
file (random data pseudo-device) of /dev/urandom, to get ten
diff --git a/rivet/manual3.2/shorthand.html b/rivet/manual3.2/shorthand.html
index 4d37bfd..044ddcd 100644
--- a/rivet/manual3.2/shorthand.html
+++ b/rivet/manual3.2/shorthand.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title><?= ... ?></title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="next" href="abort_code.html" tit [...]
Shorthand construct for single strings output
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace"><?= <span style="font-family:monospace; font-weight: bold;">$string</span> ?></span> </div></div></div><div class="refsect1"><a name="idm776"></a><h2>Description</h2><p style="width:90%">
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace"><?= <span style="font-family:monospace; font-weight: bold;">$string</span> ?></span> </div></div></div><div class="refsect1"><a name="id2143"></a><h2>Description</h2><p style="width:90%">
This construct is a simplified form to print a single string wherever
needed in a ?<span style="font-family:monospace; font-weight: bold;">.rvt</span>? template. The contruct is equivalent to
writing the following line of Tcl code
diff --git a/rivet/manual3.2/thread_id.html b/rivet/manual3.2/thread_id.html
index 13383d2..693f57c 100644
--- a/rivet/manual3.2/thread_id.html
+++ b/rivet/manual3.2/thread_id.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>thread_id</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="read_file.html" title="read_file"><link rel="next" href="try.html" title="try"></head><body bgcolor="white [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>thread_id</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="read_file.html" title="read_file"><link rel="next" href="try.html" title="try"></head><body bgcolor="white [...]
<span style="font-family:monospace"><span class="command"><strong>::rivet::thread_id</strong></span></span> either returns the hexadecimal
(default) or the decimal representation of the current thread id. This command
is useful for precise identification of an execution thread
diff --git a/rivet/manual3.2/toglyphs.html b/rivet/manual3.2/toglyphs.html
index a888c24..2ecfa1c 100644
--- a/rivet/manual3.2/toglyphs.html
+++ b/rivet/manual3.2/toglyphs.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>toGlyphs</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="asciiglyphs.html" title="AsciiGlyphs"><link rel="prev" href="asciiglyphs.html" title="AsciiGlyphs"><link rel="next" href="formbroker.html" title="The Form Broker"></head><body bgcolor="w [...]
print large ASCII glyphs
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::AsciiGlyphs toGlyphs</span> <span style="font-family:monospace; font-weight: bold;">string</span> </div></div></div><div class="refsect1"><a name="idm4243"></a><h2>Description</h2><p style="width:90%">
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::AsciiGlyphs toGlyphs</span> <span style="font-family:monospace; font-weight: bold;">string</span> </div></div></div><div class="refsect1"><a name="id5622"></a><h2>Description</h2><p style="width:90%">
prints the ASCII glyphs corresponding to the characters forming
the argument <span style="font-family:monospace; font-weight: bold;">string</span>
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="asciiglyphs.html"><img src="images/prev.png" alt="Prev"></a> </td><td width="20%" align="center"><a accesskey="u" href="asciiglyphs.html"><img src="images/up.png" alt="Up"></a></td><td width="40%" align="right"> <a accesskey="n" href="formbroker.html"><img src="images/next.png" alt="Next"></a></td></tr><tr><td width="40%" align="le [...]
diff --git a/rivet/manual3.2/try.html b/rivet/manual3.2/try.html
index bea4e88..d07232d 100644
--- a/rivet/manual3.2/try.html
+++ b/rivet/manual3.2/try.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>try</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="thread_id.html" title="thread_id"><link rel="next" href="unescape_string.html" title="unescape_string"></head><b [...]
Catch error and exception conditions
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::try</span> ?<span style="font-family:monospace; font-weight: bold;">script</span>? ?<span style="font-family:monospace; font-weight: bold;">script</span>? ?<span style="font-family:monospace; font-weight: bold;"><em class [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::try</span> ?<span style="font-family:monospace; font-weight: bold;">script</span>? ?<span style="font-family:monospace; font-weight: bold;">script</span>? ?<span style="font-family:monospace; font-weight: bold;"><em class [...]
<span style="font-family:monospace"><span class="command"><strong>::rivet::try</strong></span></span> wraps the core language
command and simply traps exceptions that might have raised
by <span style="font-family:monospace"><span class="command"><strong>::rivet::abort_page</strong></span></span> and
diff --git a/rivet/manual3.2/unescape_string.html b/rivet/manual3.2/unescape_string.html
index 1fc53fe..dee9e1c 100644
--- a/rivet/manual3.2/unescape_string.html
+++ b/rivet/manual3.2/unescape_string.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>unescape_string</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="try.html" title="try"><link rel="next" href="upload.html" title="upload"></head><body bgcolor="white [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>unescape_string</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="try.html" title="try"><link rel="next" href="upload.html" title="upload"></head><body bgcolor="white [...]
Scans through each character in the specified string looking
for escaped character sequences (characters containing a
percent sign and two hexadecimal characters), unescaping them
diff --git a/rivet/manual3.2/upload.html b/rivet/manual3.2/upload.html
index 7ea1035..fdb7f6f 100644
--- a/rivet/manual3.2/upload.html
+++ b/rivet/manual3.2/upload.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>upload</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="unescape_string.html" title="unescape_string"><link rel="next" href="url_script.html" title="url_script"></he [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>upload</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="unescape_string.html" title="unescape_string"><link rel="next" href="url_script.html" title="url_script"></he [...]
The upload command is for file upload manipulation.
See the relevant Apache Directives to further configure the
behavior of this Rivet feature.
diff --git a/rivet/manual3.2/url_script.html b/rivet/manual3.2/url_script.html
index bd57d29..2d1089c 100644
--- a/rivet/manual3.2/url_script.html
+++ b/rivet/manual3.2/url_script.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>url_script</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="upload.html" title="upload"><link rel="next" href="var.html" title="var"></head><body bgcolor="white" tex [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>url_script</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="upload.html" title="upload"><link rel="next" href="var.html" title="var"></head><body bgcolor="white" tex [...]
This command is used internally by the rivet central Tcl
procedure (::Rivet::request_handling) executed by
the default traditional code for HTTP requests processing.
diff --git a/rivet/manual3.2/var.html b/rivet/manual3.2/var.html
index b978281..f81b2a3 100644
--- a/rivet/manual3.2/var.html
+++ b/rivet/manual3.2/var.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>var</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="url_script.html" title="url_script"><link rel="next" href="wrap.html" title="wrap"></head><body bgcolor="white" [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>var</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="url_script.html" title="url_script"><link rel="next" href="wrap.html" title="wrap"></head><body bgcolor="white" [...]
The <span style="font-family:monospace"><span class="command"><strong>var</strong></span></span> command retrieves information
about GET or POST variables sent to the script via client
request. It treats both GET and POST variables the same,
diff --git a/rivet/manual3.2/wrap.html b/rivet/manual3.2/wrap.html
index d60875e..d48b26e 100644
--- a/rivet/manual3.2/wrap.html
+++ b/rivet/manual3.2/wrap.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>wrap</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="var.html" title="var"><link rel="next" href="wrapline.html" title="wrapline"></head><body bgcolor="white" text= [...]
Split a string on newlines.
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::wrap</span> ?<span style="font-family:monospace; font-weight: bold;">string</span>? ?<span style="font-family:monospace; font-weight: bold;">maxlen</span>? <span style="font-family:monospace; font-weight: bold;">html</span [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::wrap</span> ?<span style="font-family:monospace; font-weight: bold;">string</span>? ?<span style="font-family:monospace; font-weight: bold;">maxlen</span>? <span style="font-family:monospace; font-weight: bold;">html</span [...]
For each line, wrap the line at a space character to be
equal to or shorter than the maximum length value passed.
</p><p style="width:90%">
diff --git a/rivet/manual3.2/wrapline.html b/rivet/manual3.2/wrapline.html
index 6ec8932..14a0716 100644
--- a/rivet/manual3.2/wrapline.html
+++ b/rivet/manual3.2/wrapline.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>wrapline</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="wrap.html" title="wrap"><link rel="next" href="xml.html" title="xml"></head><body bgcolor="white" text="bla [...]
Split the line into multiple lines by splitting on space characters
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::wrapline</span> ?<span style="font-family:monospace; font-weight: bold;">string</span>? ?<span style="font-family:monospace; font-weight: bold;">maxlen</span>? <span style="font-family:monospace; font-weight: bold;">html</ [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::wrapline</span> ?<span style="font-family:monospace; font-weight: bold;">string</span>? ?<span style="font-family:monospace; font-weight: bold;">maxlen</span>? <span style="font-family:monospace; font-weight: bold;">html</ [...]
Given a line and a maximum length and option "-html" argument, split the line
into multiple lines by splitting on space characters and making sure each line
is less than maximum length.
diff --git a/rivet/manual3.2/xml.html b/rivet/manual3.2/xml.html
index e2966e8..fd82d10 100644
--- a/rivet/manual3.2/xml.html
+++ b/rivet/manual3.2/xml.html
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>xml</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="prev" href="wrapline.html" title="wrapline"><link rel="next" href="examples.html" title="Examples and Usage"></head><body bg [...]
XML Fragments creation
- </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::xml</span> ?<span style="font-family:monospace; font-weight: bold;">string</span>? ?<span style="font-family:monospace; font-weight: bold;">tag descriptor</span>? ?<span style="font-family:monospace; font-weight: [...]
+ </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">::rivet::xml</span> ?<span style="font-family:monospace; font-weight: bold;">string</span>? ?<span style="font-family:monospace; font-weight: bold;">tag descriptor</span>? ?<span style="font-family:monospace; font-weight: [...]
Given a string and a variable number of tag descriptors return XML fragment made
by nesting the tags with the same hierarchical order they are listed on the command
line. The tag descriptors can be a one element list (the tag) or an odd-length list whose
diff --git a/rivet/manual3.2/xml_calendar.html b/rivet/manual3.2/xml_calendar.html
index 0a69c97..641463c 100644
--- a/rivet/manual3.2/xml_calendar.html
+++ b/rivet/manual3.2/xml_calendar.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>XmlCalendar</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="calendar_package.html" title="Calendar Package"><link rel="prev" href="calendar.html" title="Calendar"><link rel="next" href="html_calendar.html" title="HtmlCalendar"></head><body bgc [...]
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>XmlCalendar</title><link rel="stylesheet" type="text/css" href="rivet.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Apache Rivet 3.2"><link rel="up" href="calendar_package.html" title="Calendar Package"><link rel="prev" href="calendar.html" title="Calendar"><link rel="next" href="html_calendar.html" title="HtmlCalendar"></head><body bgc [...]
An XmlCalendar object is created and returned. XmlCalendar objects
print XML formatted calendar tables. The markup can be customized
using the configuration options.
@@ -11,7 +11,7 @@
The first element of an option list is a tag name, the remaining terms are therefore
an even-length sublist which is interpreted as a sequence of attribute-value pairs that
will in turn become attributes of the tag.
- </p></div><div class="refsect1"><a name="idm4047"></a><h2>Methods</h2><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex ">
+ </p></div><div class="refsect1"><a name="id5428"></a><h2>Methods</h2><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex ">
cal_obj <span style="font-weight:bold ; font-family:monospace">emit</span> -opt1 val1 -opt2 val2</div></div><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex ">
cal_obj <span style="font-weight:bold ; font-family:monospace">emit</span> ?<span style="font-family:monospace; font-weight: bold;">month</span>? ?<span style="font-family:monospace; font-weight: bold;">year</span>? -opt1 val1 -opt2 val2</div></div><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex ">
cal_obj <span style="font-weight:bold ; font-family:monospace">emit</span> ?<span style="font-family:monospace; font-weight: bold;">
@@ -19,7 +19,7 @@
-opt2 val2</div></div><div style="margin-bottom:1.5ex ; padding .5ex">
The method 'emit' if invoked without arguments returns an
XML calendar table of the current month
- </div></div></dd></dl></div></div><div class="refsect1"><a name="idm4066"></a><div class="refsect2"><a name="idm4067"></a><h3>Options</h3><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">-containe [...]
+ </div></div></dd></dl></div></div><div class="refsect1"><a name="id5447"></a><div class="refsect2"><a name="id5448"></a><h3>Options</h3><div class="variablelist"><dl class="variablelist"><dt></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div class="cmdsynopsis" style="width:80%"><div style="border: 1px solid #282; margin:1ex ; padding:.4ex; padding-left: 0.8ex; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">-container [...]
attr11 val1 attr2 val2 ...)</span> </div></div><div style="margin-bottom:1.5ex ; padding .5ex">
Assigns an options list to the XML element that
will hold the whole table.
---------------------------------------------------------------------
To unsubscribe, e-mail: site-cvs-unsubscribe@tcl.apache.org
For additional commands, e-mail: site-cvs-help@tcl.apache.org