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 ro...@apache.org on 2011/04/22 22:46:39 UTC

svn commit: r1096031 [2/3] - /tcl/site/websh/quickref/

Modified: tcl/site/websh/quickref/context_handling.html
URL: http://svn.apache.org/viewvc/tcl/site/websh/quickref/context_handling.html?rev=1096031&r1=1096030&r2=1096031&view=diff
==============================================================================
--- tcl/site/websh/quickref/context_handling.html (original)
+++ tcl/site/websh/quickref/context_handling.html Fri Apr 22 20:46:38 2011
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Context handling</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="up" href="index.html" title="Websh Reference 3.6.0b5"><link rel="prev" href="logging.html" title="Logging"><link rel="next" href="file_handling_and_file_IO.html" title="File handling and file I/O"></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">Context handling</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="logging.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="file_handling_and_file_IO.html">Next</a></td></tr></table><hr></div><div class="section" title="Context handling"><div class="titlepage
 "><div><div><hr><h2 class="title" style="clear: both"><a name="context_handling"></a>Context handling</h2></div></div></div><div class="section" title="web::context"><div class="titlepage"><div><div><h3 class="title"><a name="web::context"></a>web::context</h3></div></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Context handling</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="up" href="index.html" title="Websh Reference 3.6.0b5"><link rel="prev" href="logging.html" title="Logging"><link rel="next" href="file_handling_and_file_IO.html" title="File handling and file I/O"></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">Context handling</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="logging.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="file_handling_and_file_IO.html">Next</a></td></tr></table><hr></div><div class="section" title="Context handling"><div class="titlepage
 "><div><div><h2 class="title" style="clear: both"><a name="context_handling"></a>Context handling</h2></div></div></div><div class="section" title="web::context"><div class="titlepage"><div><div><h3 class="title"><a name="web::context"></a><span style="font-family:monospace"><span class="command"><strong>web::context</strong></span></span></h3></div></div></div><p style="width:90%">
 	Creation
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::context</code></span>  <em class="replaceable"><code>name</code></em></span></div><p style="width:90%">
 	Creates a namespace <tt>name</tt> with the following
@@ -18,50 +18,51 @@
 
 	</p><div class="variablelist"><dl><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::cset</strong></span></span>
 	      <tt><em class="replaceable"><code>key</code></em></tt> <tt><em class="replaceable"><code>value</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		store <tt>value</tt>.
+		Set <tt>key</tt> to <tt>value</tt>.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::cappend</strong></span></span>
 	      <tt><em class="replaceable"><code>key</code></em></tt> <tt><em class="replaceable"><code>value</code></em></tt>
 	      ?<span class="optional"><tt><em class="replaceable"><code>value</code></em></tt></span>?
 	      ?<span class="optional"><tt><em class="replaceable"><code>...</code></em></tt></span>?</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		append <tt>value</tt> to existing value for
+		Appends <tt>value</tt> to existing value for
 		<tt>key</tt>.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::clappend</strong></span></span>
 	      <tt><em class="replaceable"><code>key</code></em></tt> <tt><em class="replaceable"><code>value</code></em></tt>
 	      ?<span class="optional"><tt><em class="replaceable"><code>value</code></em></tt></span>?
 	      ?<span class="optional"><tt><em class="replaceable"><code>...</code></em></tt></span>?</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		append <tt>value</tt> to existing list of
+		Appends <tt>value</tt> to existing list of
 		values for <tt>key</tt>.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::cget</strong></span></span>
 	      <tt><em class="replaceable"><code>key</code></em></tt>
 	      ?<span class="optional"><tt><em class="replaceable"><code>default</code></em></tt></span>?</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		access the value for key <tt>key</tt>, or
-		return <tt>default</tt> if
+		Accesses the value for key <tt>key</tt>, or
+		returns <tt>default</tt> if
 		<tt>key</tt> does not exist in the context. If
 		<tt>default</tt> is omitted, an empty string
 		is returned if <tt>key</tt> is unknown.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::cexists</strong></span></span>
 	      <tt><em class="replaceable"><code>key</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		returns true (1) if <tt>key</tt> exists in
+		Returns true (1) if <tt>key</tt> exists in
 		context, false (0) otherwise.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::cunset</strong></span></span>
 	      <tt><em class="replaceable"><code>key</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		remove <tt>key</tt> from context.
+		Removes <tt>key</tt> from context.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::carray</strong></span></span>
 	      <tt><em class="replaceable"><code>option</code></em></tt> <tt><em class="replaceable"><code>key</code></em></tt>
 	      <tt><em class="replaceable"><code>arg</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		array manipulation as known from the Tcl command
+		Array manipulation as known from the Tcl command
 		<span class="emphasis"><em>array</em></span>.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::cnames</strong></span></span>
 	      ?<span class="optional"><tt><em class="replaceable"><code>pattern</code></em></tt></span>?</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		lists existing keys of context matching
+		Lists existing keys of context matching
 		<tt>pattern</tt>.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::delete</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		delete the context (same as <span style="font-family:monospace"><span class="command"><strong>namespace delete <em class="replaceable"><code>name</code></em></strong></span></span>)
+		Deletes the context (same as <span style="font-family:monospace"><span class="command"><strong>namespace delete
+		<em class="replaceable"><code>name</code></em></strong></span></span>)
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::dump</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		serialize context.
+		Serializes context in a "source"-able format.
 	      </div></div></dd></dl></div><p style="width:90%">
 
-	</p><div class="example"><a name="id3106952"></a><p class="title"><b>Example 12. web::context</b></p><div class="example-contents"><pre style="background:#bbffbb ; width:75%" class="programlisting">
+	</p><div class="example"><a name="id2756576"></a><p class="title"><b>Example 12. <span style="font-family:monospace"><span class="command">web::context</span></span></b></p><div class="example-contents"><pre style="background:#bbffbb ; width:75%" class="programlisting">
 % web::context sc
 % sc::cset lang FR
 FR
@@ -69,7 +70,7 @@ FR
 % set lang [sc::cget lang EN]
 FR
 %	  </pre></div></div><p style="width:90%"><br class="example-break">
-      </p></div><div class="section" title="web::filecontext"><div class="titlepage"><div><div><h3 class="title"><a name="web::filecontext"></a>web::filecontext</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::filecontext"><div class="titlepage"><div><div><h3 class="title"><a name="web::filecontext"></a><span style="font-family:monospace"><span class="command"><strong>web::filecontext</strong></span></span></h3></div></div></div><p style="width:90%">
 
 	Creation:
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::filecontext</code></span>  <em class="replaceable"><code>name</code></em> ?<em class="replaceable"><code>options</code></em>?</span></div><p style="width:90%">
@@ -105,8 +106,8 @@ FR
 	      <span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::init</strong></span></span>
 	      ?<span class="optional"><tt><em class="replaceable"><code>id</code></em></tt></span>?
 	    </span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		load an existing session context with id
-		<tt>id</tt>, or create a new one, if
+		Loads an existing session context with id
+		<tt>id</tt>, or creates a new one, if
 		possible. Automation depends on the settings of the
 		actual context manager settings, see
 		below.</div><div style="margin-bottom:6"> If you specify an
@@ -115,21 +116,21 @@ FR
 		yourself.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::new</strong></span></span>
 	      ?<span class="optional"><tt><em class="replaceable"><code>id</code></em></tt></span>?</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		create a new session context. Automation depends on
+		Creates a new session context. Automation depends on
 		the settings of the actual context manager settings,
 		see below.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::commit</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		make session context persistent.
+		Makes session context persistent.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::id</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		return id of session.
+		Returns id of session.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::invalidate</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		delete session in memory and on file system.
+		Deletes session in memory and on file system.
 	      </div></div></dd></dl></div><p style="width:90%">
 
 	Options:
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::filecontext</code></span>  <em class="replaceable"><code>name</code></em> -perm <em class="replaceable"><code>perm</code></em></span></div><p style="width:90%">
 
-	set the file permissions of the session context files
+	Sets the file permissions of the session context files
 	<tt>perm</tt> is an unix-like octal value like 0644.
 	If not specified, files are created with the permissions defined
 	in <span style="font-family:monospace"><span class="command"><strong>web::config filepermissions</strong></span></span>,
@@ -139,7 +140,7 @@ FR
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-path</tt>
 	      <tt><em class="replaceable"><code>path</code></em></tt>
 	    </span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		specify where to store session context files and how
+		Specifies where to store session context files and how
 		to name them. Suppose that the session id is 99.
 		<span class="emphasis"><em>-path [file join .. data s%d.dat]</em></span>
 		would then cause filecontext to save the session
@@ -147,15 +148,15 @@ FR
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::filecontext</strong></span></span>
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-crypt</tt>
 	      <tt>boolean</tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		Flag to turn crypting of session context on and off.
-		Default is on.
+		Sets crypting of session context on or off.
+		Default: on.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::filecontext</strong></span></span>
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-idgen</tt>
 	      <tt><em class="replaceable"><code>idgen</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
 		Sets command <tt>idgen</tt> to find a new
 		session id. See doc of
 		<span style="font-family:monospace"><span class="command"><strong>web::filecounter</strong></span></span> below for an
-		implementation provided with Websh.
+		implementation provided by Websh.
 	      </div><div style="margin-bottom:6">
 		<tt>idgen</tt> is used in case that no
 		<tt>id</tt> argument has been passed to
@@ -164,15 +165,20 @@ FR
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-attachto</tt>
 	      <tt><em class="replaceable"><code>idparam</code></em></tt>
 	    </span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		the next using the querystring (this is one reason why
-		the querystring is encrypted). After web::dispatch has
-		parsed the querystring, web::param will report the
-		current session id, if any. <span class="emphasis"><em>Note</em></span>
+		Causes <span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::init</strong></span></span>
+		to initialize with the id given in the querystring parameter
+		<tt>idparam</tt>. (This is one important reason why
+		the querystring should be encrypted). After
+		<span style="font-family:monospace"><span class="command"><strong>web::dispatch</strong></span></span> has
+		parsed the querystring, <span style="font-family:monospace"><span class="command"><strong>web::param</strong></span></span>
+		will report the	current session id in 
+		<tt>idparam</tt>, if any. <span class="emphasis"><em>Note</em></span>
 		that you can maintain several sessions in parallel,
 		and attach every session to its own
 		<tt>idparam</tt>.
 	      </div><div style="margin-bottom:6">
-		Using <span class="emphasis"><em>web::dispatch -track</em></span>
+		Using
+		<span class="emphasis"><em><span style="font-family:monospace"><span class="command"><strong>web::dispatch -track</strong></span></span></em></span>
 		further automates the passing of session ids from
 		request to request.
 	      </div></div></dd></dl></div><p style="width:90%">
@@ -182,7 +188,7 @@ FR
 	whatever information that you might have stored in the context
 	before you initialized it as a file-based session context.
 
-      </p></div><div class="section" title="web::cookiecontext"><div class="titlepage"><div><div><h3 class="title"><a name="web::cookiecontext"></a>web::cookiecontext</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::cookiecontext"><div class="titlepage"><div><div><h3 class="title"><a name="web::cookiecontext"></a><span style="font-family:monospace"><span class="command"><strong>web::cookiecontext</strong></span></span></h3></div></div></div><p style="width:90%">
 
 	Creation:
 
@@ -209,17 +215,17 @@ FR
 
 	</p><div class="variablelist"><dl><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::init</strong></span></span>
 	      ?<span class="optional"><tt><em class="replaceable"><code>id</code></em></tt></span>?</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		load an existing session context (cookie must have
+		Loads an existing session context (cookie must have
 		been sent by the client).
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::new</strong></span></span>
 	      ?<span class="optional"><tt><em class="replaceable"><code>id</code></em></tt></span>?</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		create a new session context.
+		Creates a new session context.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::commit</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		send a cookie.
+		Sends a cookie (if no output to the page has been sent yet).
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::id</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		return id of session.
+		Returns id of session.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong><em class="replaceable"><code>name</code></em>::invalidate</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		delete session in memory and on client side.
+		Deletes session in memory and on client side.
 	      </div></div></dd></dl></div><p style="width:90%">
 
 	Options:
@@ -227,7 +233,7 @@ FR
 	</p><div class="variablelist"><dl><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::cookiecontext</strong></span></span>
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-expires</tt>
 	      <tt><em class="replaceable"><code>time</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		set the expiration date of the cookie. Possible values
+		Sets the expiration date of the cookie. Possible values
 		for <tt>time</tt> are
 		<span class="emphasis"><em>seconds</em></span> (time in seconds since
 		1970-01-01) or <span class="emphasis"><em>date-string</em></span> (any
@@ -244,24 +250,24 @@ FR
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::cookiecontext</strong></span></span>
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-path</tt>
 	      <tt><em class="replaceable"><code>path</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		set the <tt>path</tt> property of the cookie.
+		Sets the <tt>path</tt> property of the cookie.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::cookiecontext</strong></span></span>
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-domain</tt>
 	      <tt><em class="replaceable"><code>domain</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		set the <tt>domain</tt> property of the cookie.
+		Sets the <tt>domain</tt> property of the cookie.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::cookiecontext</strong></span></span>
 	      <tt><em class="replaceable"><code>name</code></em></tt>
 	      <tt>-secure</tt> <tt>boolean</tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		set the <tt>secure</tt> property of the cookie.
+		Sets the <tt>secure</tt> property of the cookie.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::cookiecontext</strong></span></span>
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-crypt</tt>
 	      <tt>boolean</tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		Flag to turn crypting of cookie context on and off.
-		Default is on.
+		Sets crypting of cookie context on or off.
+		Default: on.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::cookiecontext</strong></span></span>
 	      <tt><em class="replaceable"><code>name</code></em></tt> <tt>-channel</tt>
 	      <tt><em class="replaceable"><code>channelName</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		The response object to send the cookie to (see also
+		Sets the response object to send the cookie to (see also
 		<span style="font-family:monospace"><span class="command"><strong>web::response</strong></span></span>).
 	      </div></div></dd></dl></div><p style="width:90%">
 
@@ -274,7 +280,7 @@ FR
 	context can only be changed <span class="emphasis"><em>before</em></span>
 	anything is output on the respective channel.
 
-      </p></div><div class="section" title="web::filecounter"><div class="titlepage"><div><div><h3 class="title"><a name="web::filecounter"></a>web::filecounter</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::filecounter"><div class="titlepage"><div><div><h3 class="title"><a name="web::filecounter"></a><span style="font-family:monospace"><span class="command"><strong>web::filecounter</strong></span></span></h3></div></div></div><p style="width:90%">
 
 	This is a numeric sequence-number generator which stores its
 	state in a file. Basic usage:
@@ -292,44 +298,46 @@ FR
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>-filename</tt>
 	      <tt><em class="replaceable"><code>filename</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
 		Uses <tt>filename</tt> to store the current
-		value (no default)
+		value (no default).
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>-min</tt> <tt><em class="replaceable"><code>value</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
 		Uses this value as a minimum at start and after wrap,
-		if wrap is true (default is 0).
+		if wrap is true. Default: 0.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>-max</tt> <tt><em class="replaceable"><code>value</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		Uses this value as a maximum, if wrap is true (default is 2147483647).
+		Uses this value as a maximum, if wrap is true. Default: 2147483647.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>-seed</tt> <tt><em class="replaceable"><code>value</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		If persistent file does not yet exists, use this value
-		as a starting point (default is 0).
+		Usea this value	as a starting point if persistent file does
+		not exist yet. Default: 0.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>-incr</tt> <tt><em class="replaceable"><code>value</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		Uses this value as an increment for each 'nextval'
-		(default is 1).
+		Uses this value as an increment for each 'nextval'.
+		Default: 1.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>-perms</tt>
 	      <tt><em class="replaceable"><code>value</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
 		Sets the permissions on the newly created files.
-		(Default is configured in <span style="font-family:monospace"><span class="command"><strong>web::config filepermissions</strong></span></span>, which defaults to 0644.)
+		Default is configured in <span style="font-family:monospace"><span class="command"><strong>web::config filepermissions</strong></span></span>, which defaults to 0644.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>-wrap</tt>
 	      <tt>boolean</tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
 		Indicates whether this counter should wrap around its
-		values (from min to max) (default is false).
+		values (back to min from max). Default: false.
 	      </div></div></dd></dl></div><p style="width:90%">
 
 	After creation, a new command <tt>name</tt> is
 	registered with the following subcommands:
 
 	</p><div class="variablelist"><dl><dt><span style="background:#bbbbff"><span class="term"><tt><em class="replaceable"><code>name</code></em></tt> config</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		Return a flat list of key value pairs with the filecounter's configuration.
+		Returns a flat list of key value pairs with the 
+		filecounter's configuration.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt><em class="replaceable"><code>name</code></em></tt> nextval</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		Return the next value.
+		Returns the next value.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt><em class="replaceable"><code>name</code></em></tt> curval</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		Return the current value, that is, the value that the
-		last call to "nextval" or "getval" reported (as opposed
-		to the current value in the file).
+		Returns the current value, that is, the value that the
+		last call to "nextval" or "getval"
+		reported (as opposed to the current value in the file).
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt><em class="replaceable"><code>name</code></em></tt> getval</span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		Return the current value in the file. (Do not increment file as in "nextval".)
+		Returns the current value in the file. (Does not increment
+		file as in "nextval".)
 	      </div></div></dd></dl></div><p style="width:90%">
 
-      </p><div class="example"><a name="id3108465"></a><p class="title"><b>Example 13. web::filecounter</b></p><div class="example-contents"><pre style="background:#bbffbb ; width:75%" class="programlisting">
+      </p><div class="example"><a name="id2758135"></a><p class="title"><b>Example 13. <span style="font-family:monospace"><span class="command">web::filecounter</span></span></b></p><div class="example-contents"><pre style="background:#bbffbb ; width:75%" class="programlisting">
 % web::filecounter fc1 -filename test.dat
 fc1
 % fc1 config

Modified: tcl/site/websh/quickref/data_encryption.html
URL: http://svn.apache.org/viewvc/tcl/site/websh/quickref/data_encryption.html?rev=1096031&r1=1096030&r2=1096031&view=diff
==============================================================================
--- tcl/site/websh/quickref/data_encryption.html (original)
+++ tcl/site/websh/quickref/data_encryption.html Fri Apr 22 20:46:38 2011
@@ -1,25 +1,25 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Data encryption</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="up" href="index.html" title="Websh Reference 3.6.0b5"><link rel="prev" href="file_handling_and_file_IO.html" title="File handling and file I/O"><link rel="next" href="uri-html-_en-decoding.html" title="Uri-/html- en-/decoding"></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">Data encryption</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="file_handling_and_file_IO.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="uri-html-_en-decoding.html">Next</a></td></tr></table><hr></div><div class="section" titl
 e="Data encryption"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="data_encryption"></a>Data encryption</h2></div></div></div><p style="width:90%">
-      Encrypt (<span style="font-family:monospace"><span class="command"><strong>web::encrypt</strong></span></span>) and decrypt
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Data encryption</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="up" href="index.html" title="Websh Reference 3.6.0b5"><link rel="prev" href="file_handling_and_file_IO.html" title="File handling and file I/O"><link rel="next" href="uri-html-_en-decoding.html" title="Uri-/html- en-/decoding"></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">Data encryption</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="file_handling_and_file_IO.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="uri-html-_en-decoding.html">Next</a></td></tr></table><hr></div><div class="section" titl
 e="Data encryption"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="data_encryption"></a>Data encryption</h2></div></div></div><p style="width:90%">
+      Encrypts (<span style="font-family:monospace"><span class="command"><strong>web::encrypt</strong></span></span>) and decrypts
       (<span style="font-family:monospace"><span class="command"><strong>web::decrypt</strong></span></span>) data. By default, the
-      built-in, weak encryption is used. encryption is extensible by
-      plug-Ins.  The encryption module tries all plug-Ins from a list
-      until the first plug-In was able to en-/decrypt the input.  See
+      built-in, weak encryption is used. Encryption is extensible by
+      plug-ins.  The encryption module tries all plug-ins from a list
+      until the first plug-in was able to en-/decrypt the input.  See
       <span style="font-family:monospace"><span class="command"><strong>web::config</strong></span></span> for the configuration of the
-      plug-Ins to be used.
-    </p><div class="section" title="web::encrypt"><div class="titlepage"><div><div><h3 class="title"><a name="web::encrypt"></a>web::encrypt</h3></div></div></div><p style="width:90%">
+      plug-ins to be used.
+    </p><div class="section" title="web::encrypt"><div class="titlepage"><div><div><h3 class="title"><a name="web::encrypt"></a><span style="font-family:monospace"><span class="command"><strong>web::encrypt</strong></span></span></h3></div></div></div><p style="width:90%">
 
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::encrypt</code></span>  <em class="replaceable"><code>data</code></em></span></div><p style="width:90%">
 	Returns encrypted data.
 
-      </p></div><div class="section" title="web::decrypt"><div class="titlepage"><div><div><h3 class="title"><a name="web::decrypt"></a>web::decrypt</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::decrypt"><div class="titlepage"><div><div><h3 class="title"><a name="web::decrypt"></a><span style="font-family:monospace"><span class="command"><strong>web::decrypt</strong></span></span></h3></div></div></div><p style="width:90%">
 
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::decrypt</code></span>  <em class="replaceable"><code>data</code></em></span></div><p style="width:90%">
 
 	Returns decrypted data.
 
-	</p><div class="example"><a name="id3108846"></a><p class="title"><b>Example 15. web::encrypt</b></p><div class="example-contents"><pre style="background:#bbffbb ; width:75%" class="programlisting">
+	</p><div class="example"><a name="id2758583"></a><p class="title"><b>Example 15. <span style="font-family:monospace"><span class="command">web::encrypt</span></span></b></p><div class="example-contents"><pre style="background:#bbffbb ; width:75%" class="programlisting">
 % web::encrypt "Hello, world!"
 XDIVAhkgkxRjcfA7UTwpD7
 % web::decrypt [web::encrypt "Hello, world!"]
@@ -27,10 +27,10 @@ Hello, world!
 %	  </pre></div></div><p style="width:90%"><br class="example-break">
       </p></div><div class="section" title="Encryption plug-in D"><div class="titlepage"><div><div><h3 class="title"><a name="encryption_plug-in_D"></a>Encryption plug-in D</h3></div></div></div><p style="width:90%">
 
-      </p></div><div class="section" title="web::encryptd"><div class="titlepage"><div><div><h3 class="title"><a name="web::encryptd"></a>web::encryptd</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::encryptd"><div class="titlepage"><div><div><h3 class="title"><a name="web::encryptd"></a><span style="font-family:monospace"><span class="command"><strong>web::encryptd</strong></span></span></h3></div></div></div><p style="width:90%">
 
-	By default, Websh uses this plug-In for weak data
-	encryption for encryption (<span style="font-family:monospace"><span class="command"><strong>web::encryptd</strong></span></span>)
+	By default, Websh uses this plug-in for (very) weak data
+	encryption (<span style="font-family:monospace"><span class="command"><strong>web::encryptd</strong></span></span>)
 	and decryption (<span style="font-family:monospace"><span class="command"><strong>web::decryptd</strong></span></span>).  The
 	encryption key is managed with
 	<span style="font-family:monospace"><span class="command"><strong>web::crpytdkey</strong></span></span>.
@@ -41,18 +41,18 @@ Hello, world!
 
 	Returns encrypted <tt><em class="replaceable"><code>data</code></em></tt>.
 
-      </p></div><div class="section" title="web::decryptd"><div class="titlepage"><div><div><h3 class="title"><a name="web::decryptd"></a>web::decryptd</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::decryptd"><div class="titlepage"><div><div><h3 class="title"><a name="web::decryptd"></a><span style="font-family:monospace"><span class="command"><strong>web::decryptd</strong></span></span></h3></div></div></div><p style="width:90%">
 
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::decryptd</code></span>  <em class="replaceable"><code>data</code></em></span></div><p style="width:90%">
 
 	Returns decrypted <tt><em class="replaceable"><code>data</code></em></tt>.
 
-      </p></div><div class="section" title="web::cryptdkey"><div class="titlepage"><div><div><h3 class="title"><a name="web::cryptdkey"></a>web::cryptdkey</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::cryptdkey"><div class="titlepage"><div><div><h3 class="title"><a name="web::cryptdkey"></a><span style="font-family:monospace"><span class="command"><strong>web::cryptdkey</strong></span></span></h3></div></div></div><p style="width:90%">
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::cryptdkey</code></span>  ?<em class="replaceable"><code>key</code></em>?</span></div><p style="width:90%">
 
-	Sets the new key for encryption. If no argument is given,
+	Sets a new key for encryption. If no argument is given,
 	resets to the default key. This command does not return the
 	currently active key, in difference to other configuration
 	commands of Websh.
@@ -61,20 +61,22 @@ Hello, world!
 	<span class="emphasis"><em>For plug-in developers only</em></span>
       </p><p style="width:90%">
 	The encryption plug-in is required to implement the interface
-	described below (note that to activate your plugin, use <span style="font-family:monospace"><span class="command"><strong>web::config encryptchain</strong></span></span> and <span style="font-family:monospace"><span class="command"><strong>web::config decryptchain</strong></span></span> respectively):
+	described below (note that to activate your plug-in, use
+	<span style="font-family:monospace"><span class="command"><strong>web::config encryptchain</strong></span></span> and
+	<span style="font-family:monospace"><span class="command"><strong>web::config decryptchain</strong></span></span> respectively):
 	</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><div style="margin-bottom:6">
 	      <span style="font-family:monospace"><span class="command"><strong>web::yourencrypt</strong></span></span> accepts one argument
-	      web::yourencrypt takes a string as input and generates a
-	      string which must be URI compliant.
+	      <span style="font-family:monospace"><span class="command"><strong>web::yourencrypt</strong></span></span> takes a string as
+	      input and generates a string which must be URI compliant.
 	    </div></li><li class="listitem"><div style="margin-bottom:6">
 	      <span style="font-family:monospace"><span class="command"><strong>web::yourdecrypt</strong></span></span> accepts one argument
-	      web::yourdecrypt takes a string as input and returns a
-	      string.
-	    </div></li><li class="listitem"><div style="margin-bottom:6">symmetry: <span class="emphasis"><em><span style="font-family:monospace"><span class="command"><strong>$in ==
+	      <span style="font-family:monospace"><span class="command"><strong>web::yourdecrypt</strong></span></span> takes a string as input
+	      and returns a string.
+	    </div></li><li class="listitem"><div style="margin-bottom:6">Symmetry: <span class="emphasis"><em><span style="font-family:monospace"><span class="command"><strong>$in ==
 		  [web::yourdecrypt [web::yourencrypt
 		  $in]]</strong></span></span></em></span>
 	    </div></li><li class="listitem"><div style="margin-bottom:6">
-	      error messaging: <span class="emphasis"><em>TCL_OK</em></span> for
+	      Error messaging: <span class="emphasis"><em>TCL_OK</em></span> for
 	      success. <span class="emphasis"><em>TCL_ERROR</em></span> for any error
 	      during en-/decryption. <span class="emphasis"><em>TCL_CONTINUE</em></span>
 	      for unknown encryption type (pass on to next method).

Modified: tcl/site/websh/quickref/file_handling_and_file_IO.html
URL: http://svn.apache.org/viewvc/tcl/site/websh/quickref/file_handling_and_file_IO.html?rev=1096031&r1=1096030&r2=1096031&view=diff
==============================================================================
--- tcl/site/websh/quickref/file_handling_and_file_IO.html (original)
+++ tcl/site/websh/quickref/file_handling_and_file_IO.html Fri Apr 22 20:46:38 2011
@@ -1,45 +1,49 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>File handling and file I/O</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="up" href="index.html" title="Websh Reference 3.6.0b5"><link rel="prev" href="context_handling.html" title="Context handling"><link rel="next" href="data_encryption.html" title="Data encryption"></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">File handling and file I/O</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="context_handling.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="data_encryption.html">Next</a></td></tr></table><hr></div><div class="section" title="File handling and file 
 I/O"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="file_handling_and_file_IO"></a>File handling and file I/O</h2></div></div></div><div class="section" title="web::include"><div class="titlepage"><div><div><h3 class="title"><a name="web::include"></a>web::include</h3></div></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>File handling and file I/O</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="up" href="index.html" title="Websh Reference 3.6.0b5"><link rel="prev" href="context_handling.html" title="Context handling"><link rel="next" href="data_encryption.html" title="Data encryption"></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">File handling and file I/O</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="context_handling.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="data_encryption.html">Next</a></td></tr></table><hr></div><div class="section" title="File handling and file 
 I/O"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="file_handling_and_file_IO"></a>File handling and file I/O</h2></div></div></div><div class="section" title="web::include"><div class="titlepage"><div><div><h3 class="title"><a name="web::include"></a><span style="font-family:monospace"><span class="command"><strong>web::include</strong></span></span></h3></div></div></div><p style="width:90%">
 
-	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web_include</code></span>  <em class="replaceable"><code>fileName</code></em> ?<em class="replaceable"><code>msg</code></em>?</span></div><p style="width:90%">
+	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::include</code></span>  <em class="replaceable"><code>fileName</code></em> ?<em class="replaceable"><code>msg</code></em>?</span></div><p style="width:90%">
 
 	If the file <tt>fileName</tt> exists, it is sourced (must be a
-	script). Otherwise if the library fileName+"shared lib extension"
-	exists, it is loaded (must be a shared library). Returns 0 on success,
-	1 otherwise. If an error occurs, an error message is written to <tt>msg</tt>.
+	script). Otherwise if the library fileName+"shared lib 
+	extension"	exists, it is loaded (must be a shared library).
+	Returns 0 on success, 1 otherwise. If an error occurs, an error
+	message is written to <tt>msg</tt>.
 
-      </p></div><div class="section" title="web::readfile"><div class="titlepage"><div><div><h3 class="title"><a name="web::readfile"></a>web::readfile</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::readfile"><div class="titlepage"><div><div><h3 class="title"><a name="web::readfile"></a><span style="font-family:monospace"><span class="command"><strong>web::readfile</strong></span></span></h3></div></div></div><p style="width:90%">
 
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::readfile</code></span>  <em class="replaceable"><code>file</code></em> <em class="replaceable"><code>varName</code></em> <em class="replaceable"><code>msg</code></em></span></div><p style="width:90%">
 
-	<tt>file</tt> is read and written to
+	Reads <tt>file</tt> and writes it to
 	<tt>varName</tt>. Returns 0 on success, 1
 	otherwise. If an error occurs, an error message is written to
 	the variable <tt>msg</tt>.
 
-      </p></div><div class="section" title="web::lockfile and web::unlockfile"><div class="titlepage"><div><div><h3 class="title"><a name="web::lockfile_and_web::unlockfile"></a>web::lockfile and web::unlockfile</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::lockfile and web::unlockfile"><div class="titlepage"><div><div><h3 class="title"><a name="web::lockfile_and_web::unlockfile"></a><span style="font-family:monospace"><span class="command"><strong>web::lockfile</strong></span></span> and <span style="font-family:monospace"><span class="command"><strong>web::unlockfile</strong></span></span></h3></div></div></div><p style="width:90%">
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::lockfile</code></span>  <em class="replaceable"><code>fh</code></em></span></div><p style="width:90%">
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::unlockfile</code></span>  <em class="replaceable"><code>fh</code></em></span></div><p style="width:90%">
 
-	Interface to lockf(). lockf() works best on local filesystems.
-	Please read the documentation of lockf on your system to learn
-	about the problems and limitations of file locking. Note that
-	web::lockfile also performs a seek() and resets the file
-	cursor to the beginning of the file.
+	Interfaces <code class="function">lockf()</code>. <code class="function">lockf()</code>
+	works best on local filesystems.
+	Please read the documentation of <code class="function">lockf()</code> on your
+	system to learn	about the problems and limitations of file locking.
+	Note that
+	<span style="font-family:monospace"><span class="command"><strong>web::lockfile</strong></span></span> also performs a 
+	<code class="function">seek()</code> and
+	resets the file	cursor to the beginning of the file.
 
 	<span class="emphasis"><em>Note</em></span> that the file needs to be open for
 	writing.
 
-      </p></div><div class="section" title="web::truncatefile"><div class="titlepage"><div><div><h3 class="title"><a name="web::truncatefile"></a>web::truncatefile</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::truncatefile"><div class="titlepage"><div><div><h3 class="title"><a name="web::truncatefile"></a><span style="font-family:monospace"><span class="command"><strong>web::truncatefile</strong></span></span></h3></div></div></div><p style="width:90%">
 
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::truncatefile</code></span>  <em class="replaceable"><code>fh</code></em></span></div><p style="width:90%">
 
-	Interface to truncate(). Truncates a file based on the file
-	handle, while Tcl's file commands are based on file
+	Interfaces <code class="function">truncate()</code>. Truncates a file based on 
+	the file handle, while Tcl's file commands are based on file
 	names. This is used to truncate a file while holding the lock.
 
-      </p><div class="example"><a name="id3108726"></a><p class="title"><b>Example 14. web::lockfile</b></p><div class="example-contents"><pre style="background:#bbffbb ; width:75%" class="programlisting">
+      </p><div class="example"><a name="id2758453"></a><p class="title"><b>Example 14. <span style="font-family:monospace"><span class="command">web::lockfile</span></span></b></p><div class="example-contents"><pre style="background:#bbffbb ; width:75%" class="programlisting">
 set fh [open [web::tempfile] w]
 web::lockfile $fh
 puts $fh foo

Modified: tcl/site/websh/quickref/index.html
URL: http://svn.apache.org/viewvc/tcl/site/websh/quickref/index.html?rev=1096031&r1=1096030&r2=1096031&view=diff
==============================================================================
--- tcl/site/websh/quickref/index.html (original)
+++ tcl/site/websh/quickref/index.html Fri Apr 22 20:46:38 2011
@@ -1,6 +1,6 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Websh Reference 3.6.0b5</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="next" href="configuration.html" title="Configuration"></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">Websh Reference 3.6.0b5</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="configuration.html">Next</a></td></tr></table><hr></div><div lang="en" class="article" title="Websh Reference 3.6.0b5"><div class="titlepage"><div><div><h2 class="title"><a name="id2972033"></a>Websh Reference 3.6.0b5</h2></div><div><p class="releaseinfo">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Websh Reference 3.6.0b5</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="next" href="configuration.html" title="Configuration"></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">Websh Reference 3.6.0b5</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="configuration.html">Next</a></td></tr></table><hr></div><div lang="en" class="article" title="Websh Reference 3.6.0b5"><div class="titlepage"><div><div><h2 class="title"><a name="id2629086"></a>Websh Reference 3.6.0b5</h2></div><div><p class="releaseinfo">
       $Id$
-    </p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="index.html#intro">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="index.html#general_remarks">General remarks</a></span></dt><dt><span class="section"><a href="index.html#about">About this document</a></span></dt></dl></dd><dt><span class="section"><a href="configuration.html">Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="configuration.html#web::config">web::config</a></span></dt></dl></dd><dt><span class="section"><a href="command_dispatching_and_session_management.html">Command dispatching and session management</a></span></dt><dd><dl><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::command">web::command</a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::getcommand">web::getcommand</a></span></dt><dt><span class="section
 "><a href="command_dispatching_and_session_management.html#web::cmdurl">web::cmdurl</a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::cmdurlcfg">web::cmdurlcfg</a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#management_of_static_parameters">Management of static parameters</a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#configuration_for_web_cmdurl">Configuration for <span style="font-family:monospace"><span class="command"><strong>web::cmdurl</strong></span></span></a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::dispatch">web::dispatch</a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#session_management">Session management</a></span></dt></dl></dd><dt><span class="section"><a href="request_data_handling.html">Request data h
 andling</a></span></dt><dd><dl><dt><span class="section"><a href="request_data_handling.html#web::request">web::request</a></span></dt><dt><span class="section"><a href="request_data_handling.html#web::param">web::param</a></span></dt><dt><span class="section"><a href="request_data_handling.html#web::formvar">web::formvar</a></span></dt></dl></dd><dt><span class="section"><a href="response_data_handling.html">Response data handling</a></span></dt><dd><dl><dt><span class="section"><a href="response_data_handling.html#web::response">web::response</a></span></dt><dt><span class="section"><a href="response_data_handling.html#web::put">web::put</a></span></dt><dt><span class="section"><a href="response_data_handling.html#web::putx">web::putx</a></span></dt><dt><span class="section"><a href="response_data_handling.html#web::putxfile">web::putxfile</a></span></dt></dl></dd><dt><span class="section"><a href="logging.html">Logging</a></span></dt><dd><dl><dt><span class="section"><a h
 ref="logging.html#web::logdest">web::logdest</a></span></dt><dt><span class="section"><a href="logging.html#web::loglevel">web::loglevel</a></span></dt><dt><span class="section"><a href="logging.html#web::log">web::log</a></span></dt><dt><span class="section"><a href="logging.html#log_plug-ins">Log plug-ins</a></span></dt></dl></dd><dt><span class="section"><a href="context_handling.html">Context handling</a></span></dt><dd><dl><dt><span class="section"><a href="context_handling.html#web::context">web::context</a></span></dt><dt><span class="section"><a href="context_handling.html#web::filecontext">web::filecontext</a></span></dt><dt><span class="section"><a href="context_handling.html#web::cookiecontext">web::cookiecontext</a></span></dt><dt><span class="section"><a href="context_handling.html#web::filecounter">web::filecounter</a></span></dt></dl></dd><dt><span class="section"><a href="file_handling_and_file_IO.html">File handling and file I/O</a></span></dt><dd><dl><dt><s
 pan class="section"><a href="file_handling_and_file_IO.html#web::include">web::include</a></span></dt><dt><span class="section"><a href="file_handling_and_file_IO.html#web::readfile">web::readfile</a></span></dt><dt><span class="section"><a href="file_handling_and_file_IO.html#web::lockfile_and_web::unlockfile">web::lockfile and web::unlockfile</a></span></dt><dt><span class="section"><a href="file_handling_and_file_IO.html#web::truncatefile">web::truncatefile</a></span></dt></dl></dd><dt><span class="section"><a href="data_encryption.html">Data encryption</a></span></dt><dd><dl><dt><span class="section"><a href="data_encryption.html#web::encrypt">web::encrypt</a></span></dt><dt><span class="section"><a href="data_encryption.html#web::decrypt">web::decrypt</a></span></dt><dt><span class="section"><a href="data_encryption.html#encryption_plug-in_D">Encryption plug-in D</a></span></dt><dt><span class="section"><a href="data_encryption.html#web::encryptd">web::encryptd</a></spa
 n></dt><dt><span class="section"><a href="data_encryption.html#web::decryptd">web::decryptd</a></span></dt><dt><span class="section"><a href="data_encryption.html#web::cryptdkey">web::cryptdkey</a></span></dt><dt><span class="section"><a href="data_encryption.html#encryption_plug-in_interface_">Encryption plug-in interface</a></span></dt></dl></dd><dt><span class="section"><a href="uri-html-_en-decoding.html">Uri-/html- en-/decoding</a></span></dt><dd><dl><dt><span class="section"><a href="uri-html-_en-decoding.html#web::htmlify">web::htmlify</a></span></dt><dt><span class="section"><a href="uri-html-_en-decoding.html#web::dehtmlify">web::dehtmlify</a></span></dt><dt><span class="section"><a href="uri-html-_en-decoding.html#web::uriencode">web::uriencode</a></span></dt><dt><span class="section"><a href="uri-html-_en-decoding.html#web::uridecode">web::uridecode</a></span></dt></dl></dd><dt><span class="section"><a href="inter-process_and_-system_communication.html">Inter-proc
 ess/-system communication</a></span></dt><dd><dl><dt><span class="section"><a href="inter-process_and_-system_communication.html#web::send">web::send</a></span></dt><dt><span class="section"><a href="inter-process_and_-system_communication.html#web::recv">web::recv</a></span></dt><dt><span class="section"><a href="inter-process_and_-system_communication.html#web::msgflag">web::msgflag</a></span></dt></dl></dd><dt><span class="section"><a href="Apache_module_specific_commands.html">Apache module specific commands</a></span></dt><dd><dl><dt><span class="section"><a href="Apache_module_specific_commands.html#web::initializer">web::initializer</a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::finalizer">web::finalizer</a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::finalize">web::finalize</a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::maineval">web::
 maineval</a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::interpclasscfg">web::interpclasscfg</a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::interpcfg">web::interpcfg</a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::interpmap">web::interpmap</a></span></dt></dl></dd><dt><span class="section"><a href="misc_commands.html">Miscellaneous commands</a></span></dt><dd><dl><dt><span class="section"><a href="misc_commands.html#web::match">web::match</a></span></dt><dt><span class="section"><a href="misc_commands.html#web::tempfile">web::tempfile</a></span></dt></dl></dd></dl></div><div class="section" title="Introduction"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="intro"></a>Introduction</h2></div></div></div><div class="section" title="General remarks"><div class="titlepage"><div><div><h3 class="title"><a name="ge
 neral_remarks"></a>General remarks</h3></div></div></div><p style="width:90%">
+    </p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="index.html#intro">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="index.html#general_remarks">General remarks</a></span></dt><dt><span class="section"><a href="index.html#about">About this document</a></span></dt></dl></dd><dt><span class="section"><a href="configuration.html">Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="configuration.html#web::config"><span style="font-family:monospace"><span class="command"><strong>web::config</strong></span></span></a></span></dt></dl></dd><dt><span class="section"><a href="command_dispatching_and_session_management.html">Command dispatching and session management</a></span></dt><dd><dl><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::command"><span style="font-family:monospace"><span class="command"><strong>web::command</strong></span>
 </span></a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::getcommand"><span style="font-family:monospace"><span class="command"><strong>web::getcommand</strong></span></span></a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::cmdurl"><span style="font-family:monospace"><span class="command"><strong>web::cmdurl</strong></span></span></a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::cmdurlcfg"><span style="font-family:monospace"><span class="command"><strong>web::cmdurlcfg</strong></span></span></a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#management_of_static_parameters">Management of static parameters</a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#configuration_for_web_cmdurl">Configuration for <span style="font-fami
 ly:monospace"><span class="command"><strong>web::cmdurl</strong></span></span></a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#web::dispatch"><span style="font-family:monospace"><span class="command"><strong>web::dispatch</strong></span></span></a></span></dt><dt><span class="section"><a href="command_dispatching_and_session_management.html#session_management">Session management</a></span></dt></dl></dd><dt><span class="section"><a href="request_data_handling.html">Request data handling</a></span></dt><dd><dl><dt><span class="section"><a href="request_data_handling.html#web::request"><span style="font-family:monospace"><span class="command"><strong>web::request</strong></span></span></a></span></dt><dt><span class="section"><a href="request_data_handling.html#web::param"><span style="font-family:monospace"><span class="command"><strong>web::param</strong></span></span></a></span></dt><dt><span class="section"><a href="request
 _data_handling.html#web::formvar"><span style="font-family:monospace"><span class="command"><strong>web::formvar</strong></span></span></a></span></dt></dl></dd><dt><span class="section"><a href="response_data_handling.html">Response data handling</a></span></dt><dd><dl><dt><span class="section"><a href="response_data_handling.html#web::response"><span style="font-family:monospace"><span class="command"><strong>web::response</strong></span></span></a></span></dt><dt><span class="section"><a href="response_data_handling.html#web::put"><span style="font-family:monospace"><span class="command"><strong>web::put</strong></span></span></a></span></dt><dt><span class="section"><a href="response_data_handling.html#web::putx"><span style="font-family:monospace"><span class="command"><strong>web::putx</strong></span></span></a></span></dt><dt><span class="section"><a href="response_data_handling.html#web::putxfile"><span style="font-family:monospace"><span class="command"><strong>web:
 :putxfile</strong></span></span></a></span></dt></dl></dd><dt><span class="section"><a href="logging.html">Logging</a></span></dt><dd><dl><dt><span class="section"><a href="logging.html#web::logdest"><span style="font-family:monospace"><span class="command"><strong>web::logdest</strong></span></span></a></span></dt><dt><span class="section"><a href="logging.html#web::loglevel"><span style="font-family:monospace"><span class="command"><strong>web::loglevel</strong></span></span></a></span></dt><dt><span class="section"><a href="logging.html#web::log"><span style="font-family:monospace"><span class="command"><strong>web::log</strong></span></span></a></span></dt><dt><span class="section"><a href="logging.html#log_plug-ins">Log plug-ins</a></span></dt></dl></dd><dt><span class="section"><a href="context_handling.html">Context handling</a></span></dt><dd><dl><dt><span class="section"><a href="context_handling.html#web::context"><span style="font-family:monospace"><span class="co
 mmand"><strong>web::context</strong></span></span></a></span></dt><dt><span class="section"><a href="context_handling.html#web::filecontext"><span style="font-family:monospace"><span class="command"><strong>web::filecontext</strong></span></span></a></span></dt><dt><span class="section"><a href="context_handling.html#web::cookiecontext"><span style="font-family:monospace"><span class="command"><strong>web::cookiecontext</strong></span></span></a></span></dt><dt><span class="section"><a href="context_handling.html#web::filecounter"><span style="font-family:monospace"><span class="command"><strong>web::filecounter</strong></span></span></a></span></dt></dl></dd><dt><span class="section"><a href="file_handling_and_file_IO.html">File handling and file I/O</a></span></dt><dd><dl><dt><span class="section"><a href="file_handling_and_file_IO.html#web::include"><span style="font-family:monospace"><span class="command"><strong>web::include</strong></span></span></a></span></dt><dt><sp
 an class="section"><a href="file_handling_and_file_IO.html#web::readfile"><span style="font-family:monospace"><span class="command"><strong>web::readfile</strong></span></span></a></span></dt><dt><span class="section"><a href="file_handling_and_file_IO.html#web::lockfile_and_web::unlockfile"><span style="font-family:monospace"><span class="command"><strong>web::lockfile</strong></span></span> and <span style="font-family:monospace"><span class="command"><strong>web::unlockfile</strong></span></span></a></span></dt><dt><span class="section"><a href="file_handling_and_file_IO.html#web::truncatefile"><span style="font-family:monospace"><span class="command"><strong>web::truncatefile</strong></span></span></a></span></dt></dl></dd><dt><span class="section"><a href="data_encryption.html">Data encryption</a></span></dt><dd><dl><dt><span class="section"><a href="data_encryption.html#web::encrypt"><span style="font-family:monospace"><span class="command"><strong>web::encrypt</strong
 ></span></span></a></span></dt><dt><span class="section"><a href="data_encryption.html#web::decrypt"><span style="font-family:monospace"><span class="command"><strong>web::decrypt</strong></span></span></a></span></dt><dt><span class="section"><a href="data_encryption.html#encryption_plug-in_D">Encryption plug-in D</a></span></dt><dt><span class="section"><a href="data_encryption.html#web::encryptd"><span style="font-family:monospace"><span class="command"><strong>web::encryptd</strong></span></span></a></span></dt><dt><span class="section"><a href="data_encryption.html#web::decryptd"><span style="font-family:monospace"><span class="command"><strong>web::decryptd</strong></span></span></a></span></dt><dt><span class="section"><a href="data_encryption.html#web::cryptdkey"><span style="font-family:monospace"><span class="command"><strong>web::cryptdkey</strong></span></span></a></span></dt><dt><span class="section"><a href="data_encryption.html#encryption_plug-in_interface_">E
 ncryption plug-in interface</a></span></dt></dl></dd><dt><span class="section"><a href="uri-html-_en-decoding.html">Uri-/html- en-/decoding</a></span></dt><dd><dl><dt><span class="section"><a href="uri-html-_en-decoding.html#web::htmlify"><span style="font-family:monospace"><span class="command"><strong>web::htmlify</strong></span></span></a></span></dt><dt><span class="section"><a href="uri-html-_en-decoding.html#web::dehtmlify"><span style="font-family:monospace"><span class="command"><strong>web::dehtmlify</strong></span></span></a></span></dt><dt><span class="section"><a href="uri-html-_en-decoding.html#web::uriencode"><span style="font-family:monospace"><span class="command"><strong>web::uriencode</strong></span></span></a></span></dt><dt><span class="section"><a href="uri-html-_en-decoding.html#web::uridecode"><span style="font-family:monospace"><span class="command"><strong>web::uridecode</strong></span></span></a></span></dt></dl></dd><dt><span class="section"><a hre
 f="inter-process_and_-system_communication.html">Inter-process/-system communication</a></span></dt><dd><dl><dt><span class="section"><a href="inter-process_and_-system_communication.html#web::send"><span style="font-family:monospace"><span class="command"><strong>web::send</strong></span></span></a></span></dt><dt><span class="section"><a href="inter-process_and_-system_communication.html#web::recv"><span style="font-family:monospace"><span class="command"><strong>web::recv</strong></span></span></a></span></dt><dt><span class="section"><a href="inter-process_and_-system_communication.html#web::msgflag"><span style="font-family:monospace"><span class="command"><strong>web::msgflag</strong></span></span></a></span></dt></dl></dd><dt><span class="section"><a href="Apache_module_specific_commands.html">Apache module specific commands</a></span></dt><dd><dl><dt><span class="section"><a href="Apache_module_specific_commands.html#web::initializer"><span style="font-family:monospa
 ce"><span class="command"><strong>web::initializer</strong></span></span></a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::finalizer"><span style="font-family:monospace"><span class="command"><strong>web::finalizer</strong></span></span></a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::finalize"><span style="font-family:monospace"><span class="command"><strong>web::finalize</strong></span></span></a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::maineval"><span style="font-family:monospace"><span class="command"><strong>web::maineval</strong></span></span></a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::interpclasscfg"><span style="font-family:monospace"><span class="command"><strong>web::interpclasscfg</strong></span></span></a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands
 .html#web::interpcfg"><span style="font-family:monospace"><span class="command"><strong>web::interpcfg</strong></span></span></a></span></dt><dt><span class="section"><a href="Apache_module_specific_commands.html#web::interpmap"><span style="font-family:monospace"><span class="command"><strong>web::interpmap</strong></span></span></a></span></dt></dl></dd><dt><span class="section"><a href="misc_commands.html">Miscellaneous commands</a></span></dt><dd><dl><dt><span class="section"><a href="misc_commands.html#web::match"><span style="font-family:monospace"><span class="command"><strong>web::match</strong></span></span></a></span></dt><dt><span class="section"><a href="misc_commands.html#web::tempfile"><span style="font-family:monospace"><span class="command"><strong>web::tempfile</strong></span></span></a></span></dt></dl></dd></dl></div><div class="section" title="Introduction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="intro"></a>Introduc
 tion</h2></div></div></div><div class="section" title="General remarks"><div class="titlepage"><div><div><h3 class="title"><a name="general_remarks"></a>General remarks</h3></div></div></div><p style="width:90%">
 	Websh 3.6 (pronounced "web shell") embeds a Tcl interpreter,
 	(version 8.3 or higher) and all Tcl commands are available.
       </p><p style="width:90%">

Modified: tcl/site/websh/quickref/inter-process_and_-system_communication.html
URL: http://svn.apache.org/viewvc/tcl/site/websh/quickref/inter-process_and_-system_communication.html?rev=1096031&r1=1096030&r2=1096031&view=diff
==============================================================================
--- tcl/site/websh/quickref/inter-process_and_-system_communication.html (original)
+++ tcl/site/websh/quickref/inter-process_and_-system_communication.html Fri Apr 22 20:46:38 2011
@@ -1,11 +1,11 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Inter-process/-system communication</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="up" href="index.html" title="Websh Reference 3.6.0b5"><link rel="prev" href="uri-html-_en-decoding.html" title="Uri-/html- en-/decoding"><link rel="next" href="Apache_module_specific_commands.html" title="Apache module specific commands"></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">Inter-process/-system communication</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="uri-html-_en-decoding.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="Apache_module_specific_commands.html">Next
 </a></td></tr></table><hr></div><div class="section" title="Inter-process/-system communication"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="inter-process_and_-system_communication"></a>Inter-process/-system communication</h2></div></div></div><p style="width:90%">
-      Send to and receive from sockets.
-    </p><div class="section" title="web::send"><div class="titlepage"><div><div><h3 class="title"><a name="web::send"></a>web::send</h3></div></div></div><p style="width:90%">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Inter-process/-system communication</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="Websh Reference 3.6.0b5"><link rel="up" href="index.html" title="Websh Reference 3.6.0b5"><link rel="prev" href="uri-html-_en-decoding.html" title="Uri-/html- en-/decoding"><link rel="next" href="Apache_module_specific_commands.html" title="Apache module specific commands"></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">Inter-process/-system communication</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="uri-html-_en-decoding.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="Apache_module_specific_commands.html">Next
 </a></td></tr></table><hr></div><div class="section" title="Inter-process/-system communication"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="inter-process_and_-system_communication"></a>Inter-process/-system communication</h2></div></div></div><p style="width:90%">
+      Sends to and receives from sockets.
+    </p><div class="section" title="web::send"><div class="titlepage"><div><div><h3 class="title"><a name="web::send"></a><span style="font-family:monospace"><span class="command"><strong>web::send</strong></span></span></h3></div></div></div><p style="width:90%">
 
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::send</code></span>  <em class="replaceable"><code>channel</code></em> <em class="replaceable"><code>cmdNr</code></em> <em class="replaceable"><code>message</code></em> ?<em class="replaceable"><code>flags</code></em>?</span></div><p style="width:90%">
 
-	Send the command
+	Sends the command
 	<tt><em class="replaceable"><code>cmdNr</code></em></tt> and the
 	message <tt><em class="replaceable"><code>message</code></em></tt> to
 	channel
@@ -21,7 +21,7 @@
 	<tt>multiple</tt> or <tt>noflush</tt> with the
 	same meaning, indicating that there is more to follow and no
 	automatic flush on the channel should be done.
-      </p></div><div class="section" title="web::recv"><div class="titlepage"><div><div><h3 class="title"><a name="web::recv"></a>web::recv</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::recv"><div class="titlepage"><div><div><h3 class="title"><a name="web::recv"></a><span style="font-family:monospace"><span class="command"><strong>web::recv</strong></span></span></h3></div></div></div><p style="width:90%">
 
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::recv</code></span>  <em class="replaceable"><code>channel</code></em> <em class="replaceable"><code>cmdVarName</code></em> <em class="replaceable"><code>msgVarName</code></em> <em class="replaceable"><code>flagVarName</code></em></span></div><p style="width:90%">
@@ -29,25 +29,25 @@
 	Receives a message from <tt>channelName</tt>. The
 	other arguments are the names of the corresponding variables
 	which will contain the message.  The flags are returned
-	numeric. (To handle these flags, use the web::msgflag
-	function).
+	numeric. (To handle these flags, use the 
+	<span style="font-family:monospace"><span class="command"><strong>web::msgflag</strong></span></span>	function).
 
-      </p></div><div class="section" title="web::msgflag"><div class="titlepage"><div><div><h3 class="title"><a name="web::msgflag"></a>web::msgflag</h3></div></div></div><p style="width:90%">
+      </p></div><div class="section" title="web::msgflag"><div class="titlepage"><div><div><h3 class="title"><a name="web::msgflag"></a><span style="font-family:monospace"><span class="command"><strong>web::msgflag</strong></span></span></h3></div></div></div><p style="width:90%">
 
 	</p><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::msgflag</code></span>  ?<em class="replaceable"><code>flags</code></em>? ?<em class="replaceable"><code>testflags</code></em>?</span></div><p style="width:90%">
 
-	Set or test flags.
+	Sets or tests flags.
 
 	</p><div class="variablelist"><dl><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::msgflag</strong></span></span></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		returns a list of all known message flags.
+		Returns a list of all known message flags.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::msgflag</strong></span></span>
 	      <tt><em class="replaceable"><code>flags</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		returns the integer representation of the flags listed
+		Returns the integer representation of the flags listed
 		in <tt>flags</tt>.
 	      </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span class="command"><strong>web::msgflag</strong></span></span>
 	      <tt><em class="replaceable"><code>flags</code></em></tt>
 	      <tt><em class="replaceable"><code>testflags</code></em></tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ;  margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
-		returns 1, if the flags in <tt>testflags</tt>
+		Returns 1, if the flags in <tt>testflags</tt>
 		are set in <tt>flags</tt>.
 	      </div></div></dd></dl></div><p style="width:90%">
 



---------------------------------------------------------------------
To unsubscribe, e-mail: site-cvs-unsubscribe@tcl.apache.org
For additional commands, e-mail: site-cvs-help@tcl.apache.org