You are viewing a plain text version of this content. The canonical link for it is here.
Posted to rivet-dev@tcl.apache.org by da...@apache.org on 2003/02/22 02:04:24 UTC
cvs commit: tcl-rivet/src/buildscripts aardvark.tcl
davidw 2003/02/21 17:04:24
Modified: . ChangeLog
doc rivet.xml
doc/html commands.html directives.html examples.html
help.html index.html installation.html
internals.html upgrading.html
src make.tcl
src/buildscripts aardvark.tcl
Log:
* src/buildscripts/aardvark.tcl (aardvark::Nodes): Add command to
return list of all nodes.
* doc/rivet.xml: Add some information on the precedence of the
different Conf options. Change information about DirConf - it isn't
allowed in .htaccess files.
Revision Changes Path
1.98 +9 -0 tcl-rivet/ChangeLog
Index: ChangeLog
===================================================================
RCS file: /home/cvs/tcl-rivet/ChangeLog,v
retrieving revision 1.97
retrieving revision 1.98
diff -u -r1.97 -r1.98
--- ChangeLog 21 Feb 2003 03:08:56 -0000 1.97
+++ ChangeLog 22 Feb 2003 01:04:23 -0000 1.98
@@ -1,3 +1,12 @@
+2003-02-21 David N. Welton <da...@dedasys.com>
+
+ * src/buildscripts/aardvark.tcl (aardvark::Nodes): Add command to
+ return list of all nodes.
+
+ * doc/rivet.xml: Add some information on the precedence of the
+ different Conf options. Change information about DirConf - it
+ isn't allowed in .htaccess files.
+
2003-02-19 David N. Welton <da...@dedasys.com>
* src/buildscripts/aardvark.test: Add test script and files for
1.18 +6 -3 tcl-rivet/doc/rivet.xml
Index: rivet.xml
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/rivet.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- rivet.xml 30 Dec 2002 18:42:35 -0000 1.17
+++ rivet.xml 22 Feb 2003 01:04:23 -0000 1.18
@@ -197,7 +197,11 @@
<para>
These directives are used within the Apache httpd server
- configuration files to modify Apache Rivet's behaviour.
+ configuration files to modify Apache Rivet's behaviour. Their
+ precedence is as follows: <command>RivetDirConf</command>,
+ <command>RivetUserConf</command>,
+ <command>RivetServerConf</command>, meaning that DirConf will
+ override UserConf, which will in turn override ServerConf.
</para>
<variablelist>
@@ -443,8 +447,7 @@
<command>RivetServerConf</command>, except that they are
only valid for the directory where they are specified, and
its subdirectories. It may be specified in
- <command>Directory</command> sections, as well as in
- <filename>.htaccess</filename> files.
+ <command>Directory</command> sections.
</para>
</listitem>
</varlistentry>
1.11 +35 -35 tcl-rivet/doc/html/commands.html
Index: commands.html
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/html/commands.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- commands.html 30 Dec 2002 18:42:35 -0000 1.10
+++ commands.html 22 Feb 2003 01:04:23 -0000 1.11
@@ -1,38 +1,38 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Rivet Tcl Commands and Variables</title><meta name="generator" content="DocBook XSL Stylesheets V1.56.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="directives.html" title="Rivet Apache Directives"><link rel="next" href="examples.html" title="Examples and Usage"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Rivet Tcl Commands and Variables</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="directives.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="examples.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><hr><h2 class="title" style="clear: both"><a name="commands"></a>Rivet Tcl Commands and Variables</h2></div></div><div class="variablelist"><dl><dt><span class="term">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Rivet Tcl Commands and Variables</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="directives.html" title="Rivet Apache Directives"><link rel="next" href="examples.html" title="Examples and Usage"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Rivet Tcl Commands and Variables</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="directives.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="examples.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="commands"></a>Rivet Tcl Commands and Variables</h2></div></div><div></div></div><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">var</span> (<span style="font-family:monospace; text-decoration:underline">get</span> | <span style="font-family:monospace; text-decoration:underline">list</span> | <span style="font-family:monospace; text-decoration:underline">exists</span> | <span style="font-family:monospace; text-decoration:underline">number</span> | <span style="font-family:monospace; text-decoration:underline">all</span>)</span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
- The <span style="font-family:monospace"><b>var</b></span> command retrieves information
+ The <span style="font-family:monospace"><b class="command">var</b></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,
regardless of their origin. Note that there are two
- additional forms of <span style="font-family:monospace"><b>var</b></span>:
- <span style="font-family:monospace"><b>var_qs</b></span> and <span style="font-family:monospace"><b>var_post</b></span>.
+ additional forms of <span style="font-family:monospace"><b class="command">var</b></span>:
+ <span style="font-family:monospace"><b class="command">var_qs</b></span> and <span style="font-family:monospace"><b class="command">var_post</b></span>.
These two restrict the retrieval of information to
parameters arriving very the querystring
(?foo=bar&bee=bop) or POSTing, respectively.
</div><div class="variablelist"><dl><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">get</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>varname</tt></i></span> <span style="font-family:monospace; text-decoration:underline"><i><tt>?default?</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">get</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>varname</tt></i></span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>?<span class="optional">default</span>?</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Returns the value of variable
- <tt><span style="text-decoration:underline"><i><tt>varname</tt></i></span></tt>
+ <tt><span style="text-decoration:underline"><i class="replaceable"><tt>varname</tt></i></span></tt>
as a string (even if there are multiple values). If
the variable doesn't exist as a GET or POST
variable, the
- <tt><span style="text-decoration:underline"><i><tt>?default?</tt></i></span></tt>
+ <tt><span style="text-decoration:underline"><i class="replaceable"><tt>?<span class="optional">default</span>?</tt></i></span></tt>
value is returned, otherwise "" - an empty string -
is returned.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">list</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>varname</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">list</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>varname</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Returns the value of variable
- <tt><span style="text-decoration:underline"><i><tt>varname</tt></i></span></tt> as a
+ <tt><span style="text-decoration:underline"><i class="replaceable"><tt>varname</tt></i></span></tt> as a
list, if there are multiple values.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">exists</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>varname</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">exists</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>varname</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Returns 1 if
- <tt><span style="text-decoration:underline"><i><tt>varname</tt></i></span></tt>
+ <tt><span style="text-decoration:underline"><i class="replaceable"><tt>varname</tt></i></span></tt>
exists, 0 if it doesn't.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">number</span></span></div>
@@ -49,36 +49,36 @@
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">The upload command is for file upload manipulation.
See the relevant Apache Directives to further configure the
behavior of this Rivet feature.</div><div class="variablelist"><dl><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">channel</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>uploadname</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">channel</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>uploadname</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
When given the name of a file upload
- <tt><span style="text-decoration:underline"><i><tt>uploadname</tt></i></span></tt>,
+ <tt><span style="text-decoration:underline"><i class="replaceable"><tt>uploadname</tt></i></span></tt>,
returns a Tcl channel that can be used to access the
uploaded file.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">save</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>uploadname</tt></i></span> <span style="font-family:monospace; text-decoration:underline"><i><tt>filename</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">save</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>uploadname</tt></i></span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>filename</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Saves the
- <tt><span style="text-decoration:underline"><i><tt>uploadname</tt></i></span></tt> in
+ <tt><span style="text-decoration:underline"><i class="replaceable"><tt>uploadname</tt></i></span></tt> in
the file
- <tt><span style="text-decoration:underline"><i><tt>filename</tt></i></span></tt>.
+ <tt><span style="text-decoration:underline"><i class="replaceable"><tt>filename</tt></i></span></tt>.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">data</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>uploadname</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">data</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>uploadname</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Returns data uploaded to the server. This is binary clean
- in other words, it will work even with files like
images, executables, compressed files, and so on.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">size</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>uploadname</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">size</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>uploadname</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Returns the size of the file uploaded.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">type</span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
- If the <tt>Content-type</tt> is set, it is
+ If the <tt class="varname">Content-type</tt> is set, it is
returned, otherwise, an empty string.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">filename</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>uploadname</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">filename</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>uploadname</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Returns the filename on the remote host that uploaded the file.
</div></div></dd><dt><span class="term">
@@ -89,7 +89,7 @@
</div></div></dd></dl></div><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
See <a href="examples.html#upload" title="Example�4.�File Upload">Example�4</a>.
</div></div></dd></dl></div><div class="variablelist"><dl><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_env</span> ?<span style="font-family:monospace; text-decoration:underline"><i><tt>array_name</tt></i></span>?</span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_env</span> ?<span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>array_name</tt></i></span>?</span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Load the array of environment variables into the specified
array name. Uses array <tt><span style="text-decoration:underline">::request::env</span></tt> by
@@ -100,71 +100,71 @@
for most uses - it's ok to access it as
<tt><span style="text-decoration:underline">env</span></tt>.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_headers</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>array_name</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_headers</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>array_name</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Load the headers that come from a client request into the
provided array name, or use <tt><span style="text-decoration:underline">headers</span></tt> if no
name is provided.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_cookies</span> ?<span style="font-family:monospace; text-decoration:underline"><i><tt>array_name</tt></i></span>?</span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_cookies</span> ?<span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>array_name</tt></i></span>?</span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Load the array of cookie variables into the specified
array name. Uses array <tt><span style="text-decoration:underline">cookies</span></tt> by
default.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">include</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>filename_name</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">include</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>filename_name</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
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.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">parse</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>filename</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">parse</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>filename</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
- Like the Tcl <span style="font-family:monospace"><b>source</b></span> command, but also
+ Like the Tcl <span style="font-family:monospace"><b class="command">source</b></span> command, but also
parses for Rivet <? and ?> processing tags. Using
this command, you can use one .rvt file from another.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">headers</span> (<span style="font-family:monospace; text-decoration:underline">set</span> | <span style="font-family:monospace; text-decoration:underline">redirect</span> | <span style="font-family:monospace; text-decoration:underline">add</span> | <span style="font-family:monospace; text-decoration:underline">type</span> | <span style="font-family:monospace; text-decoration:underline">numeric</span>)</span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
- The <span style="font-family:monospace"><b>headers</b></span> command is for setting and
+ The <span style="font-family:monospace"><b class="command">headers</b></span> command is for setting and
parsing HTTP headers.
</div><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
<div class="variablelist"><dl><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">redirect</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>uri</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">redirect</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>uri</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Redirect from the current page to a new
URI. <span class="emphasis"><em>Must</em></span> be done in the first block
of TCL code.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">setcookie</span> <span style="font-family:monospace; text-decoration:underline">-name</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>cookie-name</tt></i></span> <span style="font-family:monospace; text-decoration:underline">-value</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>cookie-value</tt></i></span> ?<span style="font-family:monospace; text-decoration:underline">-expires <i><tt>date/time</tt></i></span>? ?<span style="font-family:monospace; text-decoration:underline">-domain <i><tt>domain</tt></i></span>? ?<span style="font-family:monospace; text-decoration:underline">-path <i><tt>path</tt></i></span>? ?<span style="font-family:monospace; text-decoration:underline">-secure</span>?</span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">setcookie</span> <span style="font-family:monospace; text-decoration:underline">-name</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>cookie-name</tt></i></span> <span style="font-family:monospace; text-decoration:underline">-value</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>cookie-value</tt></i></span> ?<span style="font-family:monospace; text-decoration:underline">-expires <i class="replaceable"><tt>date/time</tt></i></span>? ?<span style="font-family:monospace; text-decoration:underline">-domain <i class="replaceable"><tt>domain</tt></i></span>? ?<span style="font-family:monospace; text-decoration:underline">-path <i class="replaceable"><tt>path</tt></i></span>? ?<span style="font-family:monospace; text-decoration:underline">-secure</span>?</span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
This command is for setting cookies for the server to send
to the client. <tt><span style="text-decoration:underline">cookie-name</span></tt> is the name
of the cookie, <tt><span style="text-decoration:underline">cookie-value</span></tt> is the data
associated with the cookie. <tt><span style="text-decoration:underline">-expires</span></tt>
sets an expiration date for the cookie, and must be in the
- format <tt>'DD-Mon-YY HH:MM:SS'</tt>,
+ format <tt class="constant">'DD-Mon-YY HH:MM:SS'</tt>,
<tt><span style="text-decoration:underline">-path</span></tt> sets the path for which the cookie
is valid, and <tt><span style="text-decoration:underline">-secure</span></tt> specifies that the
cookie is only to be transmitted if the connection is
secure (HTTPS).
- </div></div></dd><dt><span class="term"><div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">type</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>content-type</tt></i></span></span></div>
+ </div></div></dd><dt><span class="term"><div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">type</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>content-type</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
- This command sets the <tt>Content-type</tt>
+ This command sets the <tt class="constant">Content-type</tt>
header returned by the script, which is useful if you wish
to send content other than HTML with Rivet - PNG or jpeg
images, for example.
- </div></div></dd><dt><span class="term"><div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">set</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>headername</tt></i></span> <span style="font-family:monospace; text-decoration:underline"><i><tt>value</tt></i></span></span></div>
+ </div></div></dd><dt><span class="term"><div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">set</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>headername</tt></i></span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>value</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Set arbitrary header names and values.
</div></div></dd></dl></div>
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">makeurl</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>filename</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">makeurl</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>filename</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Create a self referencing URL from a filename. For example:
<pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">makeurl /tclp.gif</pre>
returns
- <tt>http://[hostname]:[port]/tclp.gif</tt>.
+ <tt class="constant">http://[hostname]:[port]/tclp.gif</tt>.
where hostname and port are the hostname and port of the
server in question.
</div></div></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="directives.html">Prev</a>�</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">�<a accesskey="n" href="examples.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Rivet Apache Directives�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�Examples and Usage</td></tr></table></div></body></html>
1.10 +23 -20 tcl-rivet/doc/html/directives.html
Index: directives.html
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/html/directives.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- directives.html 18 Dec 2002 08:09:45 -0000 1.9
+++ directives.html 22 Feb 2003 01:04:23 -0000 1.10
@@ -1,31 +1,35 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Rivet Apache Directives</title><meta name="generator" content="DocBook XSL Stylesheets V1.56.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="installation.html" title="Apache Rivet Installation"><link rel="next" href="commands.html" title="Rivet Tcl Commands and Variables"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Rivet Apache Directives</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="installation.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="commands.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><hr><h2 class="title" style="clear: both"><a name="directives"></a>Rivet Apache Directives</h2></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Rivet Apache Directives</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="installation.html" title="Apache Rivet Installation"><link rel="next" href="commands.html" title="Rivet Tcl Commands and Variables"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Rivet Apache Directives</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="installation.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="commands.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="directives"></a>Rivet Apache Directives</h2></div></div><div></div></div><p style="width:90%">
These directives are used within the Apache httpd server
- configuration files to modify Apache Rivet's behaviour.
+ configuration files to modify Apache Rivet's behaviour. Their
+ precedence is as follows: <span style="font-family:monospace"><b class="command">RivetDirConf</b></span>,
+ <span style="font-family:monospace"><b class="command">RivetUserConf</b></span>,
+ <span style="font-family:monospace"><b class="command">RivetServerConf</b></span>, meaning that DirConf will
+ override UserConf, which will in turn override ServerConf.
</p><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">RivetServerConf</span> (<span style="font-family:monospace; text-decoration:underline">CacheSize</span> | <span style="font-family:monospace; text-decoration:underline">GlobalInitScript</span> | <span style="font-family:monospace; text-decoration:underline">ChildInitScript</span> | <span style="font-family:monospace; text-decoration:underline">ChildExitScript</span> | <span style="font-family:monospace; text-decoration:underline">BeforeScript</span> | <span style="font-family:monospace; text-decoration:underline">AfterScript</span> | <span style="font-family:monospace; text-decoration:underline">ErrorScript</span> | <span style="font-family:monospace; text-decoration:underline">UploadDirectory</span> | <span style="font-family:monospace; text-decoration:underline">UploadMaxSize</span> | <span style="font-family:monospace; text-decoration:underline">UploadFilesToVar</span> | <span style="font-family:monospace; text-decoration:underline">SeperateVirtualInterps</span>)</span></div>
- </span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex"><span style="font-family:monospace"><b>RivetServerConf</b></span> specifies a global
+ </span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex"><span style="font-family:monospace"><b class="command">RivetServerConf</b></span> specifies a global
option that is valid for the whole server.
</div><div class="variablelist"><dl><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">CacheSize</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>size</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">CacheSize</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>size</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Sets the size of the internal page cache, where
- <tt><span style="text-decoration:underline"><i><tt>size</tt></i></span></tt> is
+ <tt><span style="text-decoration:underline"><i class="replaceable"><tt>size</tt></i></span></tt> is
the number of byte-compiled pages to be cached for
future use. Default is
- <span style="font-family:monospace"><b>MaxRequestsPerChild</b></span> / 5, or 50,
- if <span style="font-family:monospace"><b>MaxRequestsPerChild</b></span> is 0.
+ <span style="font-family:monospace"><b class="command">MaxRequestsPerChild</b></span> / 5, or 50,
+ if <span style="font-family:monospace"><b class="command">MaxRequestsPerChild</b></span> is 0.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">GlobalInitScript</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>script</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">GlobalInitScript</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>script</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Tcl script that is run when each interpreter is
- initialized. <i><tt><tt><span style="text-decoration:underline">script</span></tt></tt></i>
+ initialized. <i class="replaceable"><tt><tt><span style="text-decoration:underline">script</span></tt></tt></i>
is an actual Tcl script, so to run a file, you would
do:
<pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">Rivet_Script GlobalInitScript "source /var/www/foobar.tcl"</pre>
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">ChildInitScript</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>script</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">ChildInitScript</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>script</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Script to be evaluated when each Apache child
process is initialized. This is the recommended
@@ -33,14 +37,14 @@
connections to other facilities (such as databases)
and so on.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">ChildExitScript</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>script</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">ChildExitScript</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>script</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Script to be evaluated when each Apache child
process exits. This is the logical place to clean
up resources created in
<tt><span style="text-decoration:underline">ChildInitScript</span></tt>.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">BeforeScript</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>script</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">BeforeScript</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>script</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Script to be evaluated before each server parsed
(.rvt) page. This can be used to create a standard
@@ -55,11 +59,11 @@
evaluated.
</div>
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">AfterScript</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>script</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">AfterScript</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>script</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
Script to be called after each server parsed (.rvt) page.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">ErrorScript</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>script</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">ErrorScript</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>script</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
When Rivet encounters an error in a script, it
constructs an HTML page with some information about
@@ -69,9 +73,9 @@
pages. This may be useful if you want to make sure
that users never view your source code.
</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">UploadDirectory</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>directory</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">UploadDirectory</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>directory</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">Directory to place uploaded files.</div></div></dd><dt><span class="term">
- <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">UploadMaxSize</span> <span style="font-family:monospace; text-decoration:underline"><i><tt>size</tt></i></span></span></div>
+ <div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">UploadMaxSize</span> <span style="font-family:monospace; text-decoration:underline"><i class="replaceable"><tt>size</tt></i></span></span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">Maximum size for uploaded files.</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-family:monospace; text-decoration:underline">UploadFilesToVar</span> (<span style="font-family:monospace; text-decoration:underline">yes</span> | <span style="font-family:monospace; text-decoration:underline">no</span>)</span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
@@ -92,16 +96,15 @@
<div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">RivetDirConf</span> (<span style="font-family:monospace; text-decoration:underline">BeforeScript</span> | <span style="font-family:monospace; text-decoration:underline">AfterScript</span> | <span style="font-family:monospace; text-decoration:underline">ErrorScript</span> | <span style="font-family:monospace; text-decoration:underline">UploadDirectory</span>)</span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
These options are the same as for
- <span style="font-family:monospace"><b>RivetServerConf</b></span>, except that they are
+ <span style="font-family:monospace"><b class="command">RivetServerConf</b></span>, except that they are
only valid for the directory where they are specified, and
its subdirectories. It may be specified in
- <span style="font-family:monospace"><b>Directory</b></span> sections, as well as in
- <tt>.htaccess</tt> files.
+ <span style="font-family:monospace"><b class="command">Directory</b></span> sections.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><span style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">RivetUserConf</span> (<span style="font-family:monospace; text-decoration:underline">BeforeScript</span> | <span style="font-family:monospace; text-decoration:underline">AfterScript</span> | <span style="font-family:monospace; text-decoration:underline">ErrorScript</span> | <span style="font-family:monospace; text-decoration:underline">UploadDirectory</span>)</span></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
These options are the same as for
- <span style="font-family:monospace"><b>RivetServerConf</b></span>, except that they are
+ <span style="font-family:monospace"><b class="command">RivetServerConf</b></span>, except that they are
only valid for the directory where they are specified, and
its subdirectories.
</div></div></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="installation.html">Prev</a>�</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">�<a accesskey="n" href="commands.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Apache Rivet Installation�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�Rivet Tcl Commands and Variables</td></tr></table></div></body></html>
1.10 +9 -9 tcl-rivet/doc/html/examples.html
Index: examples.html
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/html/examples.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- examples.html 30 Dec 2002 18:42:35 -0000 1.9
+++ examples.html 22 Feb 2003 01:04:23 -0000 1.10
@@ -1,5 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Examples and Usage</title><meta name="generator" content="DocBook XSL Stylesheets V1.56.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="next" href="help.html" title="Resources - How to Get Help"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Examples and Usage</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="commands.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="help.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><hr><h2 class="title" style="clear: both"><a name="examples"></a>Examples and Usage</h2></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Examples and Usage</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="commands.html" title="Rivet Tcl Commands and Variables"><link rel="next" href="help.html" title="Resources - How to Get Help"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Examples and Usage</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="commands.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="help.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="examples"></a>Examples and Usage</h2></div></div><div></div></div><p style="width:90%">
Some examples of Rivet usage follow. Some prior Tcl knowledge
is assumed. If you don't know much Tcl, don't worry, it's easy,
and there are some good resources available on the web that will
@@ -8,7 +8,7 @@
As with any tool, it's always nice to see something work, so
let's create a small "Hello World" page.</p><p style="width:90%">
Assuming you have Apache configured correctly, create a file
- called <tt>hello.rvt</tt> where Apache can find
+ called <tt class="filename">hello.rvt</tt> where Apache can find
it, with the following content:
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"><?
puts "Hello World"
@@ -94,36 +94,36 @@
}
?></pre><p style="width:90%">
The first statement checks to make sure that the
- <tt>boss</tt> variable has been passed to the
+ <tt class="varname">boss</tt> variable has been passed to the
script, and then does something with that information. If
it's not present, an error is added to the list of errors.
</p><p style="width:90%">
In the second block of code, the variable
- <tt>salary</tt> is fetched, with one more error
+ <tt class="varname">salary</tt> is fetched, with one more error
check - because it's a number, it needs to be composed of
digits.
</p><p style="width:90%">
- The <tt>boss</tt> variable isn't required to have
+ The <tt class="varname">boss</tt> variable isn't required to have
been sent - we set it to "Mr. Burns" if it isn't among the
information we received.
</p><p style="width:90%">
The last bit of variable handing code is a bit trickier.
- Because <tt>skills</tt> is a listbox, and can
+ Because <tt class="varname">skills</tt> is a listbox, and can
potentially have multiple values, we opt to receive them as a
list, so that at some point, we could iterate over them.
</p><p style="width:90%">
The script then checks to make sure that
- <tt>errlist</tt> is empty (printing an error if it
+ <tt class="varname">errlist</tt> is empty (printing an error if it
is) and outputting a thankyou message.
</p></div><div class="example"><a name="upload"></a><p class="title"><b>Example�4.�File Upload</b></p><p style="width:90%">
The following HTML in one file, say,
- <tt>upload.html</tt>
+ <tt class="filename">upload.html</tt>
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"><form action="foo.rvt" enctype="multipart/form-data"
method="post">
<input type="file" name="MyUpload"></input>
</form></pre><p style="width:90%">
Can be used with the following Tcl code, in a second file
- (<tt>upload.rvt</tt> for instance)
+ (<tt class="filename">upload.rvt</tt> for instance)
in order to create a file upload form.
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"><?
upload save MyUpload /tmp/uploadfiles/file1
1.11 +6 -6 tcl-rivet/doc/html/help.html
Index: help.html
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/html/help.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- help.html 30 Dec 2002 18:42:35 -0000 1.10
+++ help.html 22 Feb 2003 01:04:23 -0000 1.11
@@ -1,16 +1,16 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Resources - How to Get Help</title><meta name="generator" content="DocBook XSL Stylesheets V1.56.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="examples.html" title="Examples and Usage"><link rel="next" href="internals.html" title="Rivet Internals"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Resources - How to Get Help</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="examples.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="internals.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><hr><h2 class="title" style="clear: both"><a name="help"></a>Resources - How to Get Help</h2></div></div><div class="section"><div class="titlepage"><div><h3 class="title"><a name="id5381102"></a>Mailing Lists</h3></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Resources - How to Get Help</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="examples.html" title="Examples and Usage"><link rel="next" href="internals.html" title="Rivet Internals"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Resources - How to Get Help</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="examples.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="internals.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="help"></a>Resources - How to Get Help</h2></div></div><div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id5390605"></a>Mailing Lists</h3></div></div><div></div></div><p style="width:90%">
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. Send email to
- <tt><<a href="mailto:rivet-user@tcl.apache.org">rivet-user@tcl.apache.org</a>></tt>. If you have a
+ <tt class="email"><<a href="mailto:rivet-user@tcl.apache.org">rivet-user@tcl.apache.org</a>></tt>. If you have a
question, idea, or comment about the Rivet code itself, please
- send us email at <tt><<a href="mailto:rivet-dev@tcl.apache.org">rivet-dev@tcl.apache.org</a>></tt>. To
+ send us email at <tt class="email"><<a href="mailto:rivet-dev@tcl.apache.org">rivet-dev@tcl.apache.org</a>></tt>. To
subscribe to either list, post email to
- <tt><<a href="mailto:rivet-list-subscribe@tcl.apache.org">rivet-<i><tt>list</tt></i>-subscribe@tcl.apache.org</a>></tt>.
+ <tt class="email"><<a href="mailto:rivet-list-subscribe@tcl.apache.org">rivet-<i class="replaceable"><tt>list</tt></i>-subscribe@tcl.apache.org</a>></tt>.
</p><p style="width:90%">
The mailing list archives are available at <a href="http://www.apachelabs.org" target="_top">http://www.apachelabs.org</a>
- </p></div><div class="section"><div class="titlepage"><div><h3 class="title"><a name="websites"></a>Web Sites</h3></div></div><p style="width:90%">
+ </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="websites"></a>Web Sites</h3></div></div><div></div></div><p style="width:90%">
There are several web sites that cover Apache and Tcl
extensively.
</p><div class="itemizedlist"><ul type="disc"><li><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
@@ -27,7 +27,7 @@
</div></li><li><div style=" margin:1ex ; margin-bottom:1.5ex ; padding .5ex">
<a 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><h3 class="title"><a name="id5380995"></a>Bug Tracking System</h3></div></div><p style="width:90%">
+ </div></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id5390498"></a>Bug Tracking System</h3></div></div><div></div></div><p style="width:90%">
Apache Rivet uses the Apache Bug Tracking system at <a href="http://nagoya.apache.org/bugzilla/" target="_top">http://nagoya.apache.org/bugzilla/</a>. Here,
you can report problems, or check and see if existing issues
are already known and being dealt with.
1.11 +5 -5 tcl-rivet/doc/html/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/html/index.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- index.html 30 Dec 2002 18:42:35 -0000 1.10
+++ index.html 22 Feb 2003 01:04:23 -0000 1.11
@@ -1,9 +1,9 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Apache Rivet</title><meta name="generator" content="DocBook XSL Stylesheets V1.56.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="next" href="installation.html" title="Apache Rivet Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Apache Rivet</th></tr><tr><td width="20%" align="left">�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="installation.html">Next</a></td></tr></table><hr></div><div class="article"><div class="titlepage"><div><h1 class="title"><a name="id5375470"></a>Apache Rivet</h1></div><div><div class="author"><h3 class="author">David Welton</h3><div class="affiliation"><div class="address"><p><br>
- ��<tt><<a href="mailto:davidw@apache.org">davidw@apache.org</a>></tt><br>
- </p></div></div></div></div><div><div class="author"><h3 class="author">Damon Courtney</h3><div class="affiliation"><div class="address"><p><br>
- ��<tt><<a href="mailto:damonc@apache.org">damonc@apache.org</a>></tt><br>
- </p></div></div></div></div><div><p class="copyright">Copyright � 2002 Apache Software Foundation</p></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><a href="index.html#id5375538">Introduction to Apache Rivet</a></dt><dt><a href="installation.html">Apache Rivet Installation</a></dt><dt><a href="directives.html">Rivet Apache Directives</a></dt><dt><a href="commands.html">Rivet Tcl Commands and Variables</a></dt><dt><a href="examples.html">Examples and Usage</a></dt><dt><a href="help.html">Resources - How to Get Help</a></dt><dd><dl><dt><a href="help.html#id5381102">Mailing Lists</a></dt><dt><a href="help.html#websites">Web Sites</a></dt><dt><a href="help.html#id5380995">Bug Tracking System</a></dt></dl></dd><dt><a href="internals.html">Rivet Internals</a></dt><dd><dl><dt><a href="internals.html#id5381037">Initialization</a></dt><dt><a href="internals.html#id5381072">RivetChan</a></dt><dt><a href="internals.html#id5380042">Page Parsing, Execution and Cacheing</a></dt></dl></dd><dt><a href="upgrading.html">Upgrading from mod_dtcl or NeoWebScript</a></dt><dd><dl><dt><a href="upgrading.html#id5380119">mod_dtcl</a></dt><dt><a href="upgrading.html#id5380134">NeoWebScript</a></dt></dl></dd></dl></div><div class="section"><div class="titlepage"><div><hr><h2 class="title" style="clear: both"><a name="id5375538"></a>Introduction to Apache Rivet</h2></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Apache Rivet</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="next" href="installation.html" title="Apache Rivet Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Apache Rivet</th></tr><tr><td width="20%" align="left">�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="installation.html">Next</a></td></tr></table><hr></div><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="id5385000"></a>Apache Rivet</h1></div><div><div class="author"><h3 class="author"><span class="firstname">David</span> <span class="surname">Welton</span></h3><div class="affiliation"><div class="address"><p><br>
+ ��<tt class="email"><<a href="mailto:davidw@apache.org">davidw@apache.org</a>></tt><br>
+ </p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Damon</span> <span class="surname">Courtney</span></h3><div class="affiliation"><div class="address"><p><br>
+ ��<tt class="email"><<a href="mailto:damonc@apache.org">damonc@apache.org</a>></tt><br>
+ </p></div></div></div></div><div><p class="copyright">Copyright � 2002 Apache Software Foundation</p></div></div><div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><a href="index.html#id5385077">Introduction to Apache Rivet</a></dt><dt><a href="installation.html">Apache Rivet Installation</a></dt><dt><a href="directives.html">Rivet Apache Directives</a></dt><dt><a href="commands.html">Rivet Tcl Commands and Variables</a></dt><dt><a href="examples.html">Examples and Usage</a></dt><dt><a href="help.html">Resources - How to Get Help</a></dt><dd><dl><dt><a href="help.html#id5390605">Mailing Lists</a></dt><dt><a href="help.html#websites">Web Sites</a></dt><dt><a href="help.html#id5390498">Bug Tracking System</a></dt></dl></dd><dt><a href="internals.html">Rivet Internals</a></dt><dd><dl><dt><a href="internals.html#id5390540">Initialization</a></dt><dt><a href="internals.html#id5390575">RivetChan</a></dt><dt><a href="internals.html#id5389545">Page Parsing, Execution and Cacheing</a></dt></dl></dd><dt><a href="upgrading.html">Upgrading from mod_dtcl or NeoWebScript</a></dt><dd><dl><dt><a href="upgrading.html#id5389622">mod_dtcl</a></dt><dt><a href="upgrading.html#id5389637">NeoWebScript</a></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="id5385077"></a>Introduction to Apache Rivet</h2></div></div><div></div></div><p style="width:90%">
Apache Rivet is a system for creating dynamic web content via a
programming language integrated with Apache Web Server. It is
designed to be fast, powerful and extensible, consume few system
1.9 +10 -10 tcl-rivet/doc/html/installation.html
Index: installation.html
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/html/installation.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- installation.html 18 Dec 2002 08:09:45 -0000 1.8
+++ installation.html 22 Feb 2003 01:04:23 -0000 1.9
@@ -1,5 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Apache Rivet Installation</title><meta name="generator" content="DocBook XSL Stylesheets V1.56.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="index.html" title="Apache Rivet"><link rel="next" href="directives.html" title="Rivet Apache Directives"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Apache Rivet Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="directives.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><hr><h2 class="title" style="clear: both"><a name="installation"></a>Apache Rivet Installation</h2></div></div><div class="procedure"><ol type="1"><li><p class="title"><b>Check Dependencies</b></p><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Apache Rivet Installation</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="index.html" title="Apache Rivet"><link rel="next" href="directives.html" title="Rivet Apache Directives"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Apache Rivet Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="directives.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="installation"></a>Apache Rivet Installation</h2></div></div><div></div></div><div class="procedure"><ol type="1"><li><p class="title"><b>Check Dependencies</b></p><p style="width:90%">
To install Rivet, you will need Tcl 8.2 or greater and
Apache 1.3.xx. It is known to run on Linux, FreeBSD,
OpenBSD, and Solaris and HPUX. Windows NT is also possible
@@ -29,29 +29,29 @@
for this project. It utilizes the information included in
Apache and Tcl regarding their configurations, in order to
compile itself via a series of Tcl scripts, which are
- located in the <tt>buildscripts/</tt> directory.
+ located in the <tt class="filename">buildscripts/</tt> directory.
</p><ol type="a"><li><p class="title"><b>Edit src/make.tcl</b></p><p style="width:90%">
It may be necessary to edit
- <tt>src/make.tcl</tt> by hand in order to
+ <tt class="filename">src/make.tcl</tt> by hand in order to
set certain options. Try the next step first, and see
if it's successful.
</p></li><li><p style="width:90%">At this point, you are ready to run the build
system:</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">cd src/
-./make.tcl <i><tt>option</tt></i></pre><p style="width:90%">where <i><tt>option</tt></i> can be
+./make.tcl <i class="replaceable"><tt>option</tt></i></pre><p style="width:90%">where <i class="replaceable"><tt>option</tt></i> can be
either <tt><span style="text-decoration:underline">shared</span></tt> or
<tt><span style="text-decoration:underline">static</span></tt>.
</p></li><li><p class="title"><b>Install</b></p><p style="width:90%">
- Now, you are ready to run the <span style="font-family:monospace"><b>./make.tcl
+ Now, you are ready to run the <span style="font-family:monospace"><b class="command">./make.tcl
install</b></span> command to install the resulting
files. This should copy the shared object (like
- <tt>mod_rivet.so</tt>, if one was
+ <tt class="filename">mod_rivet.so</tt>, if one was
successfully created, into Apache's
- <tt>libexec</tt> directory, as well as
+ <tt class="filename">libexec</tt> directory, as well as
install some support scripts and various code.
</p></li></ol></li><li><p class="title"><b>Apache Configuration Files</b></p><p style="width:90%">
Rivet is relatively easy to configure - we start off by
adding the module itself:
- </p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">LoadModule rivet_module <i><tt>/usr/lib/apache/1.3/mod_rivet.so</tt></i></pre><p style="width:90%">
+ </p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">LoadModule rivet_module <i class="replaceable"><tt>/usr/lib/apache/1.3/mod_rivet.so</tt></i></pre><p style="width:90%">
This tells Apache to load the Rivet shared object, wherever
it happens to reside on your file system. Now we have to
tell Apache what kind of files are "Rivet" files and how to
@@ -59,9 +59,9 @@
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">AddType application/x-httpd-rivet .rvt
AddType application/x-rivet-tcl .tcl</pre><p style="width:90%">
These tell Apache to process files with the
- <tt>.rvt</tt> and <tt>.tcl</tt>
+ <tt class="filename">.rvt</tt> and <tt class="filename">.tcl</tt>
extensions as Rivet files.
</p><p style="width:90%">
For other directives that Rivet provides for Apache
- configuration, please see <a href="directives.html" title="Rivet Apache Directives">the section called “Rivet Apache Directives”</a>.
+ configuration, please see <a href="directives.html" title="Rivet Apache Directives">Section�, “Rivet Apache Directives”</a>.
</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a>�</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">�<a accesskey="n" href="directives.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Apache Rivet�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�Rivet Apache Directives</td></tr></table></div></body></html>
1.11 +12 -12 tcl-rivet/doc/html/internals.html
Index: internals.html
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/html/internals.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- internals.html 30 Dec 2002 18:42:35 -0000 1.10
+++ internals.html 22 Feb 2003 01:04:23 -0000 1.11
@@ -1,39 +1,39 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Rivet Internals</title><meta name="generator" content="DocBook XSL Stylesheets V1.56.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="help.html" title="Resources - How to Get Help"><link rel="next" href="upgrading.html" title="Upgrading from mod_dtcl or NeoWebScript"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Rivet Internals</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="help.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="upgrading.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><hr><h2 class="title" style="clear: both"><a name="internals"></a>Rivet Internals</h2></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Rivet Internals</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="help.html" title="Resources - How to Get Help"><link rel="next" href="upgrading.html" title="Upgrading from mod_dtcl or NeoWebScript"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Rivet Internals</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="help.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="upgrading.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="internals"></a>Rivet Internals</h2></div></div><div></div></div><p style="width:90%">
This section easily falls out of date, as new code is added, old
code is removed, and changes are made. The best place to look
is the source code itself. If you are interested in the changes
themselves FIXME.
- </p><div class="section"><div class="titlepage"><div><h3 class="title"><a name="id5381037"></a>Initialization</h3></div></div><p style="width:90%">
+ </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id5390540"></a>Initialization</h3></div></div><div></div></div><p style="width:90%">
When Apache is started, (or when child Apache processes are
started if a threaded Tcl is used),
- <tt>Rivet_InitTclStuff</tt> is called, which
+ <tt class="function">Rivet_InitTclStuff</tt> is called, which
creates a new interpreter, or one interpreter per virtual
host, depending on the configuration. It also initializes
- various things, like the RivetChan
+ various things, like the <span class="structname">RivetChan</span>
channel system, creates the Rivet-specific Tcl commands, and
- executes Rivet's <tt>init.tcl</tt>. The caching
+ executes Rivet's <tt class="filename">init.tcl</tt>. The caching
system is also set up, and if there is a
- <span style="font-family:monospace"><b>GlobalInitScript</b></span>, it is run.
- </p></div><div class="section"><div class="titlepage"><div><h3 class="title"><a name="id5381072"></a>RivetChan</h3></div></div><p style="width:90%">
- The RivetChan system was created in
+ <span style="font-family:monospace"><b class="command">GlobalInitScript</b></span>, it is run.
+ </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id5390575"></a>RivetChan</h3></div></div><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 lets us use, for instance, the
- regular <span style="font-family:monospace"><b>puts</b></span> command in .rvt pages. It
+ regular <span style="font-family:monospace"><b class="command">puts</b></span> command in .rvt pages. It
works by creating a channel that buffers output, and, at
predetermined times, passes it on to Apache's IO system.
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><h3 class="title"><a name="id5380042"></a>Page Parsing, Execution and Cacheing</h3></div></div><p style="width:90%">
+ </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id5389545"></a>Page Parsing, Execution and Cacheing</h3></div></div><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
- becomes a large <span style="font-family:monospace"><b>puts</b></span> statement, and
+ becomes a large <span style="font-family:monospace"><b class="command">puts</b></span> statement, and
everything inside them remains Tcl code.
</p><p style="width:90%">
Each .rvt file is evaluated in its own
- <tt>::request</tt> namespace, so that it is not
+ <tt class="constant">::request</tt> namespace, so that it is not
necessary to create and tear down interpreters after each
page. By running in its own namespace, though, each page will
not run afoul of local variables created by other scripts,
1.11 +3 -3 tcl-rivet/doc/html/upgrading.html
Index: upgrading.html
===================================================================
RCS file: /home/cvs/tcl-rivet/doc/html/upgrading.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- upgrading.html 30 Dec 2002 18:42:35 -0000 1.10
+++ upgrading.html 22 Feb 2003 01:04:23 -0000 1.11
@@ -1,13 +1,13 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Upgrading from mod_dtcl or NeoWebScript</title><meta name="generator" content="DocBook XSL Stylesheets V1.56.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="internals.html" title="Rivet Internals"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Upgrading from mod_dtcl or NeoWebScript</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="internals.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�</td></tr></table><hr></div><div class="section"><div class="titlepage"><div><hr><h2 class="title" style="clear: both"><a name="upgrading"></a>Upgrading from mod_dtcl or NeoWebScript</h2></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Upgrading from mod_dtcl or NeoWebScript</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Apache Rivet"><link rel="up" href="index.html" title="Apache Rivet"><link rel="previous" href="internals.html" title="Rivet Internals"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Upgrading from mod_dtcl or NeoWebScript</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="internals.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�</td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="upgrading"></a>Upgrading from mod_dtcl or NeoWebScript</h2></div></div><div></div></div><p style="width:90%">
Rivet is a break from the past, in that we, the authors, have
attempted to take what we like best about our past efforts, and
leave out or change things we no longer care for. Backwards
compatibility was not a primary goal when creating Rivet, but we
do provide this information which may be of use to those wishing
to upgrade from mod_dtcl or NWS installations.
- </p><div class="section"><div class="titlepage"><div><h3 class="title"><a name="id5380119"></a>mod_dtcl</h3></div></div><p style="width:90%">
+ </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id5389622"></a>mod_dtcl</h3></div></div><div></div></div><p style="width:90%">
Rivet was originally based on the dtcl code, but it has
changed (improved!) quite a bit. The concepts remain the
same, but many of the commands have changed.
- </p></div><div class="section"><div class="titlepage"><div><h3 class="title"><a name="id5380134"></a>NeoWebScript</h3></div></div><p style="width:90%">TODO</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="internals.html">Prev</a>�</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">�</td></tr><tr><td width="40%" align="left" valign="top">Rivet Internals�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�</td></tr></table></div></body></html>
+ </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id5389637"></a>NeoWebScript</h3></div></div><div></div></div><p style="width:90%">TODO</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="internals.html">Prev</a>�</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">�</td></tr><tr><td width="40%" align="left" valign="top">Rivet Internals�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�</td></tr></table></div></body></html>
1.29 +13 -3 tcl-rivet/src/make.tcl
Index: make.tcl
===================================================================
RCS file: /home/cvs/tcl-rivet/src/make.tcl,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- make.tcl 21 Feb 2003 03:08:57 -0000 1.28
+++ make.tcl 22 Feb 2003 01:04:24 -0000 1.29
@@ -2,8 +2,6 @@
# the next line restarts using tclsh \
exec tclsh "$0" "$@"
-# make.tcl
-#
# $Id$
#
# This file is responsible for the top-level "make" style processing.
@@ -250,6 +248,18 @@
close $fl
cd [file join .. ..]
exec tar czvf tcl-rivet-${VERSION}.tgz tcl-rivet/
+ }
+}
+
+AddNode help {
+ tcl {
+ puts "Usage: $::argv0 target"
+ puts "Targets are the following:"
+ }
+ tcl {
+ foreach nd [lsort [Nodes]] {
+ puts "\t$nd"
+ }
}
}
1.11 +18 -2 tcl-rivet/src/buildscripts/aardvark.tcl
Index: aardvark.tcl
===================================================================
RCS file: /home/cvs/tcl-rivet/src/buildscripts/aardvark.tcl,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- aardvark.tcl 21 Feb 2003 03:08:57 -0000 1.10
+++ aardvark.tcl 22 Feb 2003 01:04:24 -0000 1.11
@@ -213,6 +213,22 @@
}
}
+# aardvark::Nodes --
+#
+# Return a list of all the nodes.
+#
+# Arguments:
+# None.
+#
+# Results:
+# List of all the nodes.
+
+
+proc aardvark::Nodes { } {
+ variable grph
+ return [$grph nodes]
+}
+
proc aardvark::Run { } {
global ::argv
variable grph
@@ -231,5 +247,5 @@
}
namespace eval aardvark {
- namespace export AddNode Run Verbose sh tcl depends
+ namespace export AddNode Run Verbose sh tcl depends Nodes
}
---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-cvs-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-cvs-help@tcl.apache.org