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 2005/11/16 15:12:46 UTC
svn commit: r345021 [1/2] - in /tcl/site/websh: ./ download/ quickref/
Author: ronnie
Date: Wed Nov 16 06:11:37 2005
New Revision: 345021
URL: http://svn.apache.org/viewcvs?rev=345021&view=rev
Log:
- added websh3.6.0b3 stuff
- added signatures for downloads
- updated quickref
- minor stylesheet fix (better display of pre tag)
- hints on platforms on download page
- deleted obsoloete README in donwload dir (was not displayed anyway ;-)
- added two more qs and fixed version in faq
- added hint on repository change to home page
- renamed web::logfilter to web::loglevel
- added Apache 2.0 license
- fixed link to mailing list archive
Added:
tcl/site/websh/download/quickref-3.5.0.tar.gz.asc
tcl/site/websh/download/quickref-3.5.0p1.tar.gz.asc
tcl/site/websh/download/quickref-3.5.0p2.tar.gz.asc
tcl/site/websh/download/quickref-3.6.0b3.tar.gz (with props)
tcl/site/websh/download/quickref-3.6.0b3.tar.gz.asc
tcl/site/websh/download/websh-3.5.0.tar.gz.asc
tcl/site/websh/download/websh-3.6.0b3.tar.gz (with props)
tcl/site/websh/download/websh-3.6.0b3.tar.gz.asc
tcl/site/websh/download/websh-trunk-20051116.tar.gz (with props)
tcl/site/websh/download/websh-trunk-20051116.tar.gz.asc
Removed:
tcl/site/websh/download/README
Modified:
tcl/site/websh/copyright.ws3
tcl/site/websh/download.ws3
tcl/site/websh/faq.ws3
tcl/site/websh/index.ws3
tcl/site/websh/quickref.ws3
tcl/site/websh/quickref/Apache_module_specific_commands.html
tcl/site/websh/quickref/command_dispatching_and_session_management.html
tcl/site/websh/quickref/configuration.html
tcl/site/websh/quickref/context_handling.html
tcl/site/websh/quickref/data_encryption.html
tcl/site/websh/quickref/file_handling_and_file_IO.html
tcl/site/websh/quickref/index.html
tcl/site/websh/quickref/inter-process_and_-system_communication.html
tcl/site/websh/quickref/logging.html
tcl/site/websh/quickref/misc_commands.html
tcl/site/websh/quickref/request_data_handling.html
tcl/site/websh/quickref/response_data_handling.html
tcl/site/websh/quickref/uri-html-_en-decoding.html
tcl/site/websh/subscribe.ws3
tcl/site/websh/websh.css
tcl/site/websh/whitepaper.ws3
Modified: tcl/site/websh/copyright.ws3
URL: http://svn.apache.org/viewcvs/tcl/site/websh/copyright.ws3?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/copyright.ws3 (original)
+++ tcl/site/websh/copyright.ws3 Wed Nov 16 06:11:37 2005
@@ -14,62 +14,207 @@
Websh was first developed by <a href="http://www.netcetera.ch">Netcetera AG</a> of Zurich, Switzerland and was contributed to the ASF in 2001.<br>
Websh is now distributed under the terms of the Apache Software License:
<pre>
-/* ====================================================================
- * The Apache Software License, Version 1.1
- *
- * Copyright (c) 2000 The Apache Software Foundation. All rights
- * reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in
- * the documentation and/or other materials provided with the
- * distribution.
- *
- * 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
- * "This product includes software developed by the
- * Apache Software Foundation (http://www.apache.org/)."
- * Alternately, this acknowledgment may appear in the software itself,
- * if and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Websh", "Webshell", "Apache" and "Apache Software
- * Foundation" must not be used to endorse or promote products
- * derived from this software without prior written permission. For
- * written permission, please contact apache@apache.org.
- *
- * 5. Products derived from this software may not be called "Websh",
- * "Webshell", nor may "Websh" or "Webshell" appear in their name,
- * without prior written permission of the Apache Software
- * Foundation.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
- * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
- * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
- * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- * SUCH DAMAGE.
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many
- * individuals on behalf of the Apache Software Foundation. For more
- * information on the Apache Software Foundation, please see
- * <a href="http://www.apache.org/">http://www.apache.org/</a>.
- *
- * This software is based upon software originally written by
- * Netcetera AG, of Zurich, Switzerland. */
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
</pre>
</td>
Modified: tcl/site/websh/download.ws3
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download.ws3?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/download.ws3 (original)
+++ tcl/site/websh/download.ws3 Wed Nov 16 06:11:37 2005
@@ -17,7 +17,7 @@
{
- set srcfile [lindex [file tail [glob -nocomplain [getDocFileName download/websh*gz]]] end]
+ set srcfile [file tail [lindex [glob -nocomplain [getDocFileName download/websh-3*gz]] end]]
if {![string length $srcfile]} {
web::put "<span class=\"blue\">source code currently unavailable</span>"
} else {
@@ -37,12 +37,24 @@
</p>
<p>
- <b>Important note</b>: although Websh was developed to run under both
- Unix and Windows, the current release (3.5.0) does not support Windows
- properly. To compile Websh under Windows, a few minor changes have to
- be made to header files and the make file.<br>
- The next release (3.5.1) will feature out-of-the-box compilation for
- Windows again.
+ The Websh source code repository has recently been moved from CVS to
+ Subversion (SVN). To access the latest source from the repository, use the following (read-only) URL:</p>
+ <p> {pageLink http://svn.apache.org/repos/asf/tcl/websh/trunk}.</p>
+ <p>
+ A typical command to checkout the code would be:
+ </p>
+ <p> <tt>svn co http://svn.apache.org/repos/asf/tcl/websh/trunk websh</tt></p>
+
+ </p>
+
+ <p>
+ <b>Important note</b>: The latest release now also features a Windows XP
+ Makefile for Visual Studio nmake. Websh 3.6.0b3 has been tested to work
+ with Sun Solaris 8 and 9, Linux RedHat 8, Suse9.1, Windows XP.
+ Other Unix platforms are likely to work too.
+ Fixes for Mac OS-X 8.2 have been added and will be available in the
+ next release. A preliminary source package is provided here:
+ {pageLink download/websh-trunk-20051116.tar.gz -show websh-trunk-20051116.tar.gz}
</p>
</td>
</tr>
Added: tcl/site/websh/download/quickref-3.5.0.tar.gz.asc
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/quickref-3.5.0.tar.gz.asc?rev=345021&view=auto
==============================================================================
--- tcl/site/websh/download/quickref-3.5.0.tar.gz.asc (added)
+++ tcl/site/websh/download/quickref-3.5.0.tar.gz.asc Wed Nov 16 06:11:37 2005
@@ -0,0 +1,7 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1.4.1 (SunOS)
+
+iD8DBQBDew3DekNJSvfkDw0RAtQfAJ0bsa758JcVYxFPsHEalgyRhfueFQCePZ3h
+zPi0xR1aJwEeoMjf8fRPHs8=
+=wowG
+-----END PGP SIGNATURE-----
Added: tcl/site/websh/download/quickref-3.5.0p1.tar.gz.asc
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/quickref-3.5.0p1.tar.gz.asc?rev=345021&view=auto
==============================================================================
--- tcl/site/websh/download/quickref-3.5.0p1.tar.gz.asc (added)
+++ tcl/site/websh/download/quickref-3.5.0p1.tar.gz.asc Wed Nov 16 06:11:37 2005
@@ -0,0 +1,7 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1.4.1 (SunOS)
+
+iD8DBQBDew3PekNJSvfkDw0RAplaAJ9AjQ3bDkipo4Ahc47qbnl/YbI4jQCgihf6
+sHqJbIpOoRC7++aXZU+4S8E=
+=Q7mC
+-----END PGP SIGNATURE-----
Added: tcl/site/websh/download/quickref-3.5.0p2.tar.gz.asc
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/quickref-3.5.0p2.tar.gz.asc?rev=345021&view=auto
==============================================================================
--- tcl/site/websh/download/quickref-3.5.0p2.tar.gz.asc (added)
+++ tcl/site/websh/download/quickref-3.5.0p2.tar.gz.asc Wed Nov 16 06:11:37 2005
@@ -0,0 +1,7 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1.4.1 (SunOS)
+
+iD8DBQBDew3VekNJSvfkDw0RAiW5AJ99QU68Xx9Yk70awlPkbKtFMKRHDACfQNYg
+hvSnMkL1h+AFFMeqhE6BuLs=
+=mCaK
+-----END PGP SIGNATURE-----
Added: tcl/site/websh/download/quickref-3.6.0b3.tar.gz
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/quickref-3.6.0b3.tar.gz?rev=345021&view=auto
==============================================================================
Binary file - no diff available.
Propchange: tcl/site/websh/download/quickref-3.6.0b3.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: tcl/site/websh/download/quickref-3.6.0b3.tar.gz.asc
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/quickref-3.6.0b3.tar.gz.asc?rev=345021&view=auto
==============================================================================
--- tcl/site/websh/download/quickref-3.6.0b3.tar.gz.asc (added)
+++ tcl/site/websh/download/quickref-3.6.0b3.tar.gz.asc Wed Nov 16 06:11:37 2005
@@ -0,0 +1,7 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1.4.1 (SunOS)
+
+iD8DBQBDew4qekNJSvfkDw0RAghmAJ4hvXcQ62OgCCfof8jh6AoyawTLIwCghC2i
+8/lK1IxZMh/D1hkpmH8y6jg=
+=RKqO
+-----END PGP SIGNATURE-----
Added: tcl/site/websh/download/websh-3.5.0.tar.gz.asc
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/websh-3.5.0.tar.gz.asc?rev=345021&view=auto
==============================================================================
--- tcl/site/websh/download/websh-3.5.0.tar.gz.asc (added)
+++ tcl/site/websh/download/websh-3.5.0.tar.gz.asc Wed Nov 16 06:11:37 2005
@@ -0,0 +1,7 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1.4.1 (SunOS)
+
+iD8DBQBDew1gekNJSvfkDw0RAqueAJ9g6lfm26FFOjg2Liyh2zYFkSLuFgCZAZZn
+4e12+tnB+3LuRD4OPI97Y6Y=
+=k3Ux
+-----END PGP SIGNATURE-----
Added: tcl/site/websh/download/websh-3.6.0b3.tar.gz
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/websh-3.6.0b3.tar.gz?rev=345021&view=auto
==============================================================================
Binary file - no diff available.
Propchange: tcl/site/websh/download/websh-3.6.0b3.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: tcl/site/websh/download/websh-3.6.0b3.tar.gz.asc
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/websh-3.6.0b3.tar.gz.asc?rev=345021&view=auto
==============================================================================
--- tcl/site/websh/download/websh-3.6.0b3.tar.gz.asc (added)
+++ tcl/site/websh/download/websh-3.6.0b3.tar.gz.asc Wed Nov 16 06:11:37 2005
@@ -0,0 +1,7 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1.4.1 (SunOS)
+
+iD8DBQBDew4gekNJSvfkDw0RAmaOAJsFvrOheF26loAe0cwYnShGpD9BZACfadD4
+iDraIiGzTcg+vsD/kgaWYyc=
+=SOjv
+-----END PGP SIGNATURE-----
Added: tcl/site/websh/download/websh-trunk-20051116.tar.gz
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/websh-trunk-20051116.tar.gz?rev=345021&view=auto
==============================================================================
Binary file - no diff available.
Propchange: tcl/site/websh/download/websh-trunk-20051116.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: tcl/site/websh/download/websh-trunk-20051116.tar.gz.asc
URL: http://svn.apache.org/viewcvs/tcl/site/websh/download/websh-trunk-20051116.tar.gz.asc?rev=345021&view=auto
==============================================================================
--- tcl/site/websh/download/websh-trunk-20051116.tar.gz.asc (added)
+++ tcl/site/websh/download/websh-trunk-20051116.tar.gz.asc Wed Nov 16 06:11:37 2005
@@ -0,0 +1,7 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1.4.1 (SunOS)
+
+iD8DBQBDezrNekNJSvfkDw0RAk+fAJ9dt2wusSSU55LaLt/bFYJe6SGcvwCeOPY6
+2Ajf1NQrOq6I1DERfX3sF1Y=
+=yfqI
+-----END PGP SIGNATURE-----
Modified: tcl/site/websh/faq.ws3
URL: http://svn.apache.org/viewcvs/tcl/site/websh/faq.ws3?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/faq.ws3 (original)
+++ tcl/site/websh/faq.ws3 Wed Nov 16 06:11:37 2005
@@ -10,39 +10,55 @@
<tr valign="top">
{navbar_supp 1}
<td width="455">
-<a name="toc"></a><a name="generic"></a><h1>1 Generic Questions</h1>
+<a name="toc"></a><a name="generic"><h1>Contents</h1>
+<p>
+<a href="#generic"><b>1 Generic Questions</b></a><br>
<a href="#whatis">1.1 What is Websh?</a><br>
<a href="#version">1.2 What is the current version?</a><br>
<a href="#price">1.3 What does Websh cost?</a><br>
<a href="#download">1.4 Where can I download Websh?</a><br>
<a href="#why">1.5 Why should I use Websh?</a><br>
<a href="#mailinglist">1.6 Is there a mailing list?</a><br>
+</p>
+<p>
+<a href="#technical"><b>2 Technical Questions</b></a><br>
+<a href="#logging">2.1 How do I use the logging facility?</a><br>
+<a href="#mod_websh">2.2 How do I setup mod_websh?</a><br>
+<a href="#apache">2.3 How do I configure mod_websh for Apache 1 or Apache 2 repectively?</a>
+</p>
-<a name="whatis"><a href="#toc"><h2>1.1 What is Websh?</h2></a>
+<a name="generic"></a><a href="#toc"><h1>1 Generic Questions</h1></a>
+
+<a name="whatis"></a><a href="#toc"><h2>1.1 What is Websh?</h2></a>
Websh is a rapid development environment for building powerful and
reliable web applications. It is a standard Tcl extension and is
released as Open Source Software. Websh is versatile and handles
everything from HTML generation to data-base driven one-to-one page
-customization. Netcetera AG, has been using it for years for virtually
-all their customer projects, which typically are E-commerce shops or
-electronic banking applications.
+customization. Netcetera AG, has been using it for years in many customer
+projects, which typically are E-commerce shops or even electronic banking
+applications.
+<p>
+In addition, Websh provides mod_websh, an Apache module for the Apache 1.3
+and Apache 2 web server.
-<a name="version"><a href="#toc"><h2>1.2 What is the current version?</h2></a>
+<a name="version"></a><a href="#toc"><h2>1.2 What is the current version?</h2></a>
-Currently, version 3.5 of Websh has been released.
+Currently, version 3.6 of Websh has been released as Beta (but fully working
+version). Check the {pageLink download.ws3 -show "download area"} to get the
+latest version.
-<a name="price"><a href="#toc"><h2>1.3 What does Websh cost?</h2></a>
+<a name="price"></a><a href="#toc"><h2>1.3 What does Websh cost?</h2></a>
Nothing. It's free. Websh is released as Open Source.
-<a name="download"><a href="#toc"><h2>1.4 Where can I download Websh?</h2></a>
+<a name="download"></a><a href="#toc"><h2>1.4 Where can I download Websh?</h2></a>
The latest release of Websh is available for download at the
<a href="download.ws3">download area</a> of this site.
-<a name="why"><a href="#toc"><h2>1.5 Why should I use Websh?</h2></a>
+<a name="why"></a><a href="#toc"><h2>1.5 Why should I use Websh?</h2></a>
In today's E-commerce environment, flexibility and short
time-to-market are key characteristics for successful
@@ -55,15 +71,13 @@
With Websh, you have a win-win situation for developers and
customers.
-<a name="mailinglist"><a href="#toc"><h2>1.6 Is there a mailing list?</h2></a>
+<a name="mailinglist"></a><a href="#toc"><h2>1.6 Is there a mailing list?</h2></a>
Sure. Visit the <a href="subscribe.ws3">subscribe</a> page on this site to get more information.
-<a name="technical"><h1>2 Technical Questions</h1></a>
+<a name="technical"></a><a href="#toc"><h1>2 Technical Questions</h1></a>
-<a href="#logging">2.1 How do I use the logging facility?</a><br>
-
-<a name="logging"><a href="#toc"><h2>2.1 How do I use the logging facility?</h2></a>
+<a name="logging"></a><a href="#toc"><h2>2.1 How do I use the logging facility?</h2></a>
Before Websh sends a message to a log destination, the message
needs to pass two filters. That's why you need to specify a level when
@@ -90,11 +104,9 @@
Before log messages can reach their destination, you have to
"open up" the log destination, in two steps:
<pre>
-
-web::logfilter add foo.warning-debug
+web::loglevel add foo.warning-debug
web::logdest add foo.warning-info file foo_warn.log
web::logdest add foo.debug file foo_dbg.log
-
</pre>
This sequence of commands tells Websh to handle all messages
@@ -106,10 +118,49 @@
<br><br>
Issuing a message is easy:
<pre>
-
web::log foo.info "Hello, world !"
+</pre>
+<p>
+A sample logging setup for a script in mod_websh looks like this:
+
+<pre>
+web::initializer \{
+ web::logdest add user.-debug file -unbuffered /tmp/test.log
+ web::logfilter add *.-debug
+ web::log info "initializing interp"
+\}
+
+web::command default \{
+ web::log info "command default call number [web::interpcfg numreq]"
+ web::putx "file /tmp/dummypage.html"
+\}
+
+web::finalizer \{
+ web::log info "shutting down interp"
+\}
+
+web::dispatch
</pre>
+
+This will setup logging when the interpreter is created (during the
+first request it handles) and later, this logs can be used during the
+requests. Note that only log levels and log destinations created in the
+initializer code are accessible in the finalizer. Configurations created
+during a request is discared when the rquest ends.
+
+<a name="mod_websh"></a><a href="#toc"><h2>2.2 How do I setup mod_websh?</h2></a>
+
+If you compile and install mod_websh, a sample setup for mod_websh is
+also installed. Please refer to the README file in your installation directory.
+
+
+<a name="apache"></a><a href="#toc"><h2>2.3 How do I configure mod_websh for Apache 1 or Apache 2 repectively?</h2></a>
+
+Websh will automatically detect whether the header files of Apache 1 or
+Apache 2 are present and compile accordingly. There is no manual change
+needed to compile with a specific version. (However a compiled version will
+only run with the Apache version it was compiled with.)
</td>
</tr>
</table>
Modified: tcl/site/websh/index.ws3
URL: http://svn.apache.org/viewcvs/tcl/site/websh/index.ws3?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/index.ws3 (original)
+++ tcl/site/websh/index.ws3 Wed Nov 16 06:11:37 2005
@@ -14,13 +14,18 @@
</td>
</tr>
<tr valign="top">
- <td width="315"><img height="160" width="120" src="images/drei_klein.gif" align="left">
+ <td width="315"><p>
+<img height="160" width="120" src="images/drei_klein.gif" align="left">
The Internet is growing rapidly. Daily you find new
applications and new home-pages - new opportunities for
success and profit. The basic technologies behind the
Internet, however, have remained stable for years. Only on
- a solid base can you build new stuff.<br>
- <br>
+ a solid base can you build new stuff.
+ </p>
+ <p>
+ Check out the {pageLink /websh/examples.ws3 -show "live examples"}
+ of Websh applications on this site.
+ </p>
</td>
<td width="145">
@@ -34,16 +39,14 @@
<table border="0" cellpadding="0" cellspacing="0" width="145">
-{newsBarElement "websh 3.5.0 available:" \
- {pick the {pageLink /websh/download/websh-3.5.0.tar.gz -show "tarball"}
+{newsBarElement "Websh 3.6.0b3 available:" \
+ {pick the {pageLink /websh/download/websh-3.6.0b3.tar.gz -show "tarball"}
or browse the {pageLink /websh/download.ws3 -show "download area"}.
}
}
-{newsBarElement "Examples" \
- { Check out the<br> {pageLink /websh/examples.ws3 -show "live examples"}<br>
-of Websh applications.
- }
+{newsBarElement "Code repository moved to SVN" \
+ {Check the {pageLink download.ws3 -show "download area"} for details.}
}
Modified: tcl/site/websh/quickref.ws3
URL: http://svn.apache.org/viewcvs/tcl/site/websh/quickref.ws3?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/quickref.ws3 (original)
+++ tcl/site/websh/quickref.ws3 Wed Nov 16 06:11:37 2005
@@ -15,8 +15,14 @@
<h2>Download</h2>
Download the quick reference as tar file:<br>
- <a href="download/quickref-3.5.0p2.tar.gz">quickref-3.5.0p2.tar.gz</a>
-
+ {
+ set srcfile [file tail [lindex [glob -nocomplain [getDocFileName download/quickref-3*gz]] end]]
+ if {![string length $srcfile]} {
+ web::put "<span class=\"blue\">quickref currently unavailable</span>"
+ } else {
+ web::put "<a href=\"download/$srcfile\">$srcfile</a>"
+ }
+ }
<h2>Online</h2>
Modified: tcl/site/websh/quickref/Apache_module_specific_commands.html
URL: http://svn.apache.org/viewcvs/tcl/site/websh/quickref/Apache_module_specific_commands.html?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/quickref/Apache_module_specific_commands.html (original)
+++ tcl/site/websh/quickref/Apache_module_specific_commands.html Wed Nov 16 06:11:37 2005
@@ -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 content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Apache module specific commands</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference"><link rel="up" href="index.html" title="Websh Reference"><link rel="prev" href="inter-process_and_-system_communication.html" title="Inter-process/-system communication"><link rel="next" href="misc_commands.html" title="Miscellaneous 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">Apache module specific commands</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="inter-process_and_-system_communication.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="misc_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="Apache_module_specific_commands"></a>Apache module specific commands</h2></div></div></div><p style="width:90%">
+<html><head><meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Apache module specific commands</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference 3.6.0b3"><link rel="up" href="index.html" title="Websh Reference 3.6.0b3"><link rel="prev" href="inter-process_and_-system_communication.html" title="Inter-process/-system communication"><link rel="next" href="misc_commands.html" title="Miscellaneous 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">Apache module specific commands</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="inter-process_and_-system_communication.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="misc_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="Apache_module_specific_commands"></a>Apache module specific commands</h2></div></div></div><p style="width:90%">
Note that these commands are implemented as dummies in the CGI
version of Websh only. They don't do anything except for
web::initializer and web::finalizer, which just evaluate the
@@ -14,8 +14,40 @@
<span style="font-family:monospace"><span><strong class="command">source</strong></span></span> several modules which each call
their initialization code.
- </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::finalizer"></a>web::finalizer</h3></div></div></div><p style="width:90%">
+Also note that this code eval'd when it is first requested and read in its normal script sequence, and not prior to any other code in the script.
+ </p><p style="width:90%">
+Calling <span style="font-family:monospace"><span><strong class="command">web::loglevel</strong></span></span> and <span style="font-family:monospace"><span><strong class="command">web::logdest</strong></span></span> in any <span style="font-family:monospace"><span><strong class="command">web::initializer</strong></span></span> will tag these log levels and destinations as not to be deleted, after the request ends. This log condifguration will therefore also be available in the finalizer code, which is only eval'd after
+the last request in the interpreter has been cleaned up.
+ </p><div class="example"><a name="id352289"></a><p class="title"><b>Example 14. logging in web::initializer</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+> cat test.ws3
+web::initializer {
+ web::logdest add user.-debug file -unbuffered /tmp/test.log
+ web::loglevel add *.-debug
+ web::log info "initializing interp"
+}
+
+web::command default {
+ web::log info "command default call number [web::interpcfg numreq]"
+ web::putxfile /tmp/dummypage.html
+}
+
+
+web::finalizer {
+ web::log info "shutting down interp"
+}
+
+web::dispatch
+
+> # requesting test.ws3 three times over mod_websh:
+> more /tmp/test.log
+10/28/05 14:13:45 [20639] user.info: initializing interp
+10/28/05 14:13:45 [20639] user.info: command default call number 0
+10/28/05 14:13:46 [20639] user.info: command default call number 1
+10/28/05 14:13:47 [20639] user.info: command default call number 2
+10/28/05 14:13:47 [20639] user.info: shutting down interp</pre></div><p style="width:90%">
+Note that in the above example the lifetime of the interpreter class is set to 3 requests. (See command <span style="font-family:monospace"><span><strong class="command">web::interpclasscfg</strong></span></span>.)
+ </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::finalizer"></a>web::finalizer</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::finalizer</code></span> <em class="replaceable"><code>code</code></em></span></div><p style="width:90%">
@@ -37,14 +69,13 @@
manually. However, it can be used as a hook, when the
interpreter is deleted:
- </p><div class="example"><a name="id2918970"></a><p class="title"><b>Example 14. web::finalize</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- rename web::finalize web::finalize.orig
- proc web::myFinalize {} {
- # code to eval before finalize.orig
- finalize.orig
- # code to eval after finalize.orig
- }
- </pre></div><p style="width:90%">
+ </p><div class="example"><a name="id352440"></a><p class="title"><b>Example 15. web::finalize hook</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+rename web::finalize web::finalize.orig
+proc web::myFinalize {} {
+ # code to eval before finalize.orig
+ finalize.orig
+ # code to eval after finalize.orig
+} </pre></div><p style="width:90%">
</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::maineval"></a>web::maineval</h3></div></div></div><p style="width:90%">
@@ -146,26 +177,23 @@
The return value of that command is the name of the interpreter class
and at the same time the filename of the script for this interpreter
class.
- </p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2919537"></a>Example</h4></div></div></div><p style="width:90%">
+ </p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id353023"></a>Example</h4></div></div></div><p style="width:90%">
</p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- proc web::interpmap {filename} {
- if {[string match "/path/to/myApp" $filename]} {
- # this is my special app
- return /real/path/to/myApp
- }
- if {[string match "*.ws3"]} {
- # scripts have their own interp class
- return $filename
- }
- # default: all templates are handled by my handler
- return /my/special/template/handler
- }
- </pre><p style="width:90%">
+proc web::interpmap {filename} {
+ if {[string match "/path/to/myApp" $filename]} {
+ # this is my special app
+ return /real/path/to/myApp
+ }
+ if {[string match "*.ws3"]} {
+ # scripts have their own interp class
+ return $filename
+ }
+ # default: all templates are handled by my handler
+ return /my/special/template/handler
+} </pre><p style="width:90%">
</p><p style="width:90%">
The default implementation of web::interpmap is
- </p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- proc web::interpmap {filename} {return $filename}
- </pre><p style="width:90%">
+ </p><pre style="background:#bbffbb ; width:75%" class="programlisting">proc web::interpmap {filename} {return $filename}</pre><p style="width:90%">
which sets up a separate interpreter class for every requested URL
and takes the file itself as script.
</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="inter-process_and_-system_communication.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="misc_commands.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Inter-process/-system communication </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Miscellaneous commands</td></tr></table></div></body></html>
Modified: tcl/site/websh/quickref/command_dispatching_and_session_management.html
URL: http://svn.apache.org/viewcvs/tcl/site/websh/quickref/command_dispatching_and_session_management.html?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/quickref/command_dispatching_and_session_management.html (original)
+++ tcl/site/websh/quickref/command_dispatching_and_session_management.html Wed Nov 16 06:11:37 2005
@@ -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 content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Command dispatching and session management</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference"><link rel="up" href="index.html" title="Websh Reference"><link rel="prev" href="configuration.html" title="Configuration"><link rel="next" href="request_data_handling.html" title="Request data handling"></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">Command dispatching and session management</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="configuration.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="request_data_handling.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="command_dispatching_and_session_management"></a>Command dispatching and session management</h2></div></div></div><p style="width:90%">
+<html><head><meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Command dispatching and session management</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference 3.6.0b3"><link rel="up" href="index.html" title="Websh Reference 3.6.0b3"><link rel="prev" href="configuration.html" title="Configuration"><link rel="next" href="request_data_handling.html" title="Request data handling"></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">Command dispatching and session management</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="configuration.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="request_data_handling.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="command_dispatching_and_session_management"></a>Command dispatching and session management</h2></div></div></div><p style="width:90%">
Websh provides a command dispatching mechanism to produce,
for example, different HTML pages within one "application",
which is most likely one file on the file system. The name of
@@ -80,11 +80,10 @@
<span style="font-family:monospace"><span><strong class="command">web::config</strong></span></span> <tt>timeparam</tt>.
</p></div>
</div></div></dd></dl></div><p style="width:90%">
- </p><div class="example"><a name="id2851692"></a><p class="title"><b>Example 2. web::cmdurl</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- % web::cmdurl -notimestamp -urlformat [list scheme host scriptname pathinfo querystring] "test"
- http://websh.com/bin/returnmail/member?XDZuRD2rnsfHjFH
- %
- </pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::cmdurlcfg"></a>web::cmdurlcfg</h3></div></div></div><p style="width:90%">
+ </p><div class="example"><a name="id273455"></a><p class="title"><b>Example 2. web::cmdurl</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+% web::cmdurl -notimestamp -urlformat [list scheme host scriptname pathinfo querystring] "test"
+http://websh.com/bin/returnmail/member?XDZuRD2rnsfHjFH
+% </pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::cmdurlcfg"></a>web::cmdurlcfg</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::cmdurlcfg</code></span> ?<em class="replaceable"><code>option</code></em>? ?<em class="replaceable"><code>key</code></em>? ?<em class="replaceable"><code>value</code></em>?</span></div><p style="width:90%">
</p><p style="width:90%">
Command options are exactly like those of
@@ -166,17 +165,16 @@
the keys from the command line. The static parameter is only
used if there is no such parameter on the command line.
- </p><div class="example"><a name="id2849316"></a><p class="title"><b>Example 3. web::cmdurl</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- % web::cmdurl ""
- ?XDqPtk34XvyPh41gUBo
- % web::cmdurlcfg -scriptname bin/test_script
- % web::cmdurl ""
- bin/test_script?XDqPtk34XvyPh41gUBo
- % web::cmdurlcfg -scriptname ""
- % web::cmdurl ""
- ?XDqPtk34XvyPh41gUBo
- %
- </pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::dispatch"></a>web::dispatch</h3></div></div></div><p style="width:90%">
+ </p><div class="example"><a name="id271295"></a><p class="title"><b>Example 3. web::cmdurl</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+% web::cmdurl ""
+?XDqPtk34XvyPh41gUBo
+% web::cmdurlcfg -scriptname bin/test_script
+% web::cmdurl ""
+bin/test_script?XDqPtk34XvyPh41gUBo
+% web::cmdurlcfg -scriptname ""
+% web::cmdurl ""
+?XDqPtk34XvyPh41gUBo
+% </pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::dispatch"></a>web::dispatch</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::dispatch</code></span> ?<em class="replaceable"><code>options</code></em>?</span></div><p style="width:90%">
@@ -203,9 +201,9 @@
</div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>-postdata</tt> <tt>""</tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
do not parse any post data.
</div></div></dd><dt><span style="background:#bbbbff"><span class="term">
- <tt>-postdata</tt> <tt>?<span class="optional">#</span>?<em class="replaceable"><code>channelName</code></em></tt>
- <tt>?<span class="optional"><em class="replaceable"><code>content_length</code></em></span>?</tt>
- <tt>?<span class="optional"><em class="replaceable"><code>content_type</code></em></span>?</tt>
+ <tt>-postdata</tt> ?<span class="optional"><tt>#</tt></span>?<tt><em class="replaceable"><code>channelName</code></em></tt>
+ <tt><em class="replaceable"><code>?<span class="optional">content_length</span>?</code></em></tt>
+ <tt><em class="replaceable"><code>?<span class="optional">content_type</span>?</code></em></tt>
</span></span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
parse channel <tt>channelName</tt> (or variable named <tt>channelName</tt> if <tt>#</tt> is given) as POST data input with
length <tt>content_length</tt> and type <tt>content_type</tt>.
@@ -246,24 +244,23 @@
<tt>-cmd</tt> option, web::dispatch will call the
command "default".
- </p><div class="example"><a name="id2849767"></a><p class="title"><b>Example 4. web::command and web::dispatch</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- % set tst {puts "On the hook"}
- puts "On the hook"
- % web::command acmd {puts "this is acmd"}
- % web::dispatch -cmd acmd -querystring "" -postdata ""
- this is acmd
- % web::dispatch -cmd acmd -querystring "" -postdata "" -hook $tst
- On the hook
- this is acmd
- % set data "a=b&c=d"
- a=b&c=d
- % web::dispatch -cmd "" -querystring "" -postdata #data
- % web::formvar a
- b
- % web::formvar c
- d
- %
- </pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="session_management"></a>Session management</h3></div></div></div><p style="width:90%">
+ </p><div class="example"><a name="id271774"></a><p class="title"><b>Example 4. web::command and web::dispatch</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+% set tst {puts "On the hook"}
+puts "On the hook"
+% web::command acmd {puts "this is acmd"}
+% web::dispatch -cmd acmd -querystring "" -postdata ""
+this is acmd
+% web::dispatch -cmd acmd -querystring "" -postdata "" -hook $tst
+On the hook
+this is acmd
+% set data "a=b&c=d"
+a=b&c=d
+% web::dispatch -cmd "" -querystring "" -postdata #data
+% web::formvar a
+b
+% web::formvar c
+d
+% </pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="session_management"></a>Session management</h3></div></div></div><p style="width:90%">
Websh session management consits of two parts:
</p><div class="itemizedlist"><ul type="disc"><li><div style="margin-bottom:6">session id tracking</div></li><li><div style="margin-bottom:6">session context management</div></li></ul></div><p style="width:90%">
</p><p style="width:90%">
@@ -299,7 +296,7 @@
the corresponding session context without generating a
new session id.
</div></li></ul></div><p style="width:90%">
- </p><div class="example"><a name="id2849978"></a><p class="title"><b>Example 5. Examples</b></p><p style="width:90%">
+ </p><div class="example"><a name="id271996"></a><p class="title"><b>Example 5. Examples</b></p><p style="width:90%">
See <a href="http://tcl.apache.org/websh/examples.ws3" target="_top">http://tcl.apache.org/websh/examples.ws3</a>
for several sample application demonstrating Websh's
session management facilities.
Modified: tcl/site/websh/quickref/configuration.html
URL: http://svn.apache.org/viewcvs/tcl/site/websh/quickref/configuration.html?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/quickref/configuration.html (original)
+++ tcl/site/websh/quickref/configuration.html Wed Nov 16 06:11:37 2005
@@ -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 content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Configuration</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference"><link rel="up" href="index.html" title="Websh Reference"><link rel="prev" href="index.html" title="Websh Reference"><link rel="next" href="command_dispatching_and_session_management.html" title="Command dispatching and session management"></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">Configuration</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="command_dispatching_and_session_management.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="configuration"></a>Configuration</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::config"></a>web::config</h3></div></div></div><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::config</code></span> <em class="replaceable"><code>key</code></em> ?<em class="replaceable"><code>value</code></em>?</span></div><p style="width:90%">
+<html><head><meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Configuration</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference 3.6.0b3"><link rel="up" href="index.html" title="Websh Reference 3.6.0b3"><link rel="prev" href="index.html" title="Websh Reference 3.6.0b3"><link rel="next" href="command_dispatching_and_session_management.html" title="Command dispatching and session management"></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">Configuration</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="command_dispatching_and_session_management.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="configuration"></a>Configuration</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::config"></a>web::config</h3></div></div></div><div class="cmdsynopsis"><span style="background:#bbbbff"><span style="font-weight:bold"><code class="command">web::config</code></span> <em class="replaceable"><code>key</code></em> ?<em class="replaceable"><code>value</code></em>?</span></div><p style="width:90%">
If <tt><em class="replaceable"><code>value</code></em></tt> is
ommitted, the current value of
<tt><em class="replaceable"><code>key</code></em></tt> is returned. Note that
@@ -9,7 +9,7 @@
the old value and set it back later.
</p><div class="variablelist"><dl><dt><span style="background:#bbbbff"><span class="term"><tt>uploadfilesize</tt>
?<span class="optional"><tt><em class="replaceable"><code>size</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">
- Sets the maximum number of bytes allowed to be uploaded.
+ Sets the maximum number of bytes that will be saved, when files are uploaded in a multipart form.
Default: 0.
</div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>cmdparam</tt> ?<span class="optional"><tt><em class="replaceable"><code>name</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">
Name of the <span style="font-family:monospace"><span><strong class="command">web::command</strong></span></span> parameter in
@@ -28,20 +28,25 @@
Sets the markup characters for sections to be eval'd in
<span style="font-family:monospace"><span><strong class="command">web::putx</strong></span></span> and <span style="font-family:monospace"><span><strong class="command">web::putxfile</strong></span></span>
commands to either curly braces ({ ... }) or special tags (<?
- ... ?>). Please note that when using the tags <?
- ?>, they cannot be nested. Default: brace.
+ ... ?>). Default: brace.
</div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>version</tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
Returns the version info string.
</div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>copyright</tt></span></span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:6">
Returns a copyright message string.
</div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>encryptchain</tt> ?<span class="optional"><tt><em class="replaceable"><code>list</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">
- defines which commands should be tried, in sequence, to
+ Defines which commands should be tried, in sequence, to
encrypt a message. Default: "web::encryptd".
</div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>decryptchain</tt> ?<span class="optional"><tt><em class="replaceable"><code>list</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">
- defines which commands should be tried, in sequence, to
+ Defines which commands should be tried, in sequence, to
decrypt a message. Default: "web::decryptd".
- </div></div></dd></dl></div><div class="example"><a name="id2851135"></a><p class="title"><b>Example 1. web::config</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- % web::config decryptchain
- web::encryptd
- %
- </pre></div></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"> </td><td width="40%" align="right"> <a accesskey="n" href="command_dispatching_and_session_management.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Websh Reference </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Command dispatching and session management</td></tr></table></div></body></html>
+ </div></div></dd><dt><span style="background:#bbbbff"><span class="term"><tt>filepermissions</tt> ?<span class="optional"><tt><em class="replaceable"><code>permissions</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">
+ Defines the file permissions of files that Websh creates.
+This affects the creation of log files, filecounters, session files,
+and temporary files created when files are uploaded in multipart forms (see
+<span style="font-family:monospace"><span><strong class="command">web::formvar</strong></span></span>). Default is 0644.
+ </div></div></dd></dl></div><div class="example"><a name="id272881"></a><p class="title"><b>Example 1. web::config</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+% web::config decryptchain
+web::encryptd
+% web::config filepermissions
+0644
+% </pre></div></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"> </td><td width="40%" align="right"> <a accesskey="n" href="command_dispatching_and_session_management.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Websh Reference 3.6.0b3 </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Command dispatching and session management</td></tr></table></div></body></html>
Modified: tcl/site/websh/quickref/context_handling.html
URL: http://svn.apache.org/viewcvs/tcl/site/websh/quickref/context_handling.html?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/quickref/context_handling.html (original)
+++ tcl/site/websh/quickref/context_handling.html Wed Nov 16 06:11:37 2005
@@ -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 content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Context handling</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference"><link rel="up" href="index.html" title="Websh Reference"><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" lang="en"><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" lang="en"><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 content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Context handling</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference 3.6.0b3"><link rel="up" href="index.html" title="Websh Reference 3.6.0b3"><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" lang="en"><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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::context"></a>web::context</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
@@ -62,15 +62,14 @@
serialize context.
</div></div></dd></dl></div><p style="width:90%">
- </p><div class="example"><a name="id2915634"></a><p class="title"><b>Example 9. web::context</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- % web::context sc
- % sc::cset lang FR
- FR
- % # ... some code ...
- % set lang [sc::cget lang EN]
- FR
- %
- </pre></div><p style="width:90%">
+ </p><div class="example"><a name="id348871"></a><p class="title"><b>Example 9. web::context</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+% web::context sc
+% sc::cset lang FR
+FR
+% # ... some code ...
+% set lang [sc::cget lang EN]
+FR
+% </pre></div><p style="width:90%">
</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::filecontext"></a>web::filecontext</h3></div></div></div><p style="width:90%">
Creation:
@@ -133,6 +132,9 @@
set 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><strong class="command">web::config filepermissions</strong></span></span>,
+ which again defaults to 0644.
</p><div class="variablelist"><dl><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span><strong class="command">web::filecontext</strong></span></span>
<tt><em class="replaceable"><code>name</code></em></tt> <tt>-path</tt>
@@ -231,11 +233,14 @@
<span class="emphasis"><em>seconds</em></span> (time in seconds since
1970-01-01) or <span class="emphasis"><em>date-string</em></span> (any
time string that Tcl can scan. Note that therefore many
- relative times, such as <span class="emphasis"><em>day</em></span>,
+ relative times, such as <span class="emphasis"><em>24 hours</em></span>,
<span class="emphasis"><em>week</em></span>, <span class="emphasis"><em>2 weeks</em></span>,
<span class="emphasis"><em>tomorrow</em></span>, etc.
- are possible. Default is <span class="emphasis"><em>day</em></span> (i.e. cookie
- expires in 24 hours. Use <span class="emphasis"><em>-expires ""</em></span> to
+ are possible. Default is <span class="emphasis"><em>now + 24 hours</em></span>
+ (i.e. cookie expires in 24 hours. (Please note that the
+ behavior of some of these relative time specifiers changed
+ from Tcl8.4 to Tcl8.5.) Use
+ <span class="emphasis"><em>-expires ""</em></span> to
send a cookie without an expires parameter.
</div></div></dd><dt><span style="background:#bbbbff"><span class="term"><span style="font-family:monospace"><span><strong class="command">web::cookiecontext</strong></span></span>
<tt><em class="replaceable"><code>name</code></em></tt> <tt>-path</tt>
@@ -287,26 +292,26 @@
<tt>-wrap</tt>
</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
+ Uses <tt>filename</tt> to store the current
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,
+ Uses this value as a minimum at start and after wrap,
if wrap is true (default is 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 is 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
+ If persistent file does not yet exists, use this value
as a starting point (default is 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'
+ Uses this value as an increment for each 'nextval'
(default is 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 0644).
+ Sets the permissions on the newly created files.
+ (Default is configured in <span style="font-family:monospace"><span><strong class="command">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
+ Indicates whether this counter should wrap around its
values (from min to max) (default is false).
</div></div></dd></dl></div><p style="width:90%">
@@ -314,22 +319,21 @@
registered with the following two subcommands:
</p><div class="variablelist"><dl><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.
+ Return 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
+ Return the current value, that is, the value that the
last call to "nextval" reported (as opposed
to the current value in the file).
</div></div></dd></dl></div><p style="width:90%">
- </p><div class="example"><a name="id2917387"></a><p class="title"><b>Example 10. web::filecounter</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- % web::filecounter handleName -filename "test.dat"
- handleName
- % # from now on, use handleName <curval|nextval|config>
- % handleName config
- file test.dat handle handleName seed 0 min 0 max 2147483647 incr 1 wrap false curr {not valid}
- % web::filecounter otherHandleName -filename "othertest.dat" -min 1 -max 10 -seed 1 -incr 2 -wrap 1
- otherHandleName
- % otherHandleName config
- file othertest.dat handle otherHandleName seed 1 min 1 max 10 incr 2 wrap true curr {not valid}
- %
- </pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="logging.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="file_handling_and_file_IO.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Logging </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> File handling and file I/O</td></tr></table></div></body></html>
+ </p><div class="example"><a name="id350677"></a><p class="title"><b>Example 10. web::filecounter</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+% web::filecounter handleName -filename "test.dat"
+handleName
+% # from now on, use handleName <curval|nextval|config>
+% handleName config
+file test.dat handle handleName seed 0 min 0 max 2147483647 incr 1 wrap false curr {not valid}
+% web::filecounter otherHandleName -filename "othertest.dat" -min 1 -max 10 -seed 1 -incr 2 -wrap 1
+otherHandleName
+% otherHandleName config
+file othertest.dat handle otherHandleName seed 1 min 1 max 10 incr 2 wrap true curr {not valid}
+% </pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="logging.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="file_handling_and_file_IO.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Logging </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> File handling and file I/O</td></tr></table></div></body></html>
Modified: tcl/site/websh/quickref/data_encryption.html
URL: http://svn.apache.org/viewcvs/tcl/site/websh/quickref/data_encryption.html?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/quickref/data_encryption.html (original)
+++ tcl/site/websh/quickref/data_encryption.html Wed Nov 16 06:11:37 2005
@@ -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 content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Data encryption</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference"><link rel="up" href="index.html" title="Websh Reference"><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" lang="en"><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%">
+<html><head><meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>Data encryption</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference 3.6.0b3"><link rel="up" href="index.html" title="Websh Reference 3.6.0b3"><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" lang="en"><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><strong class="command">web::encrypt</strong></span></span>) and decrypt
(<span style="font-family:monospace"><span><strong class="command">web::decrypt</strong></span></span>) data. By default, the
built-in, weak encryption is used. encryption is extensible by
@@ -20,13 +20,12 @@
Returns decrypted data.
- </p><div class="example"><a name="id2917832"></a><p class="title"><b>Example 12. web::encrypt</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- % web::encrypt "Hello, world!"
- XDIVAhkgkxRjcfA7UTwpD7
- % web::decrypt [web::encrypt "Hello, world!"]
- Hello, world!
- %
- </pre></div><p style="width:90%">
+ </p><div class="example"><a name="id351147"></a><p class="title"><b>Example 12. web::encrypt</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+% web::encrypt "Hello, world!"
+XDIVAhkgkxRjcfA7UTwpD7
+% web::decrypt [web::encrypt "Hello, world!"]
+Hello, world!
+% </pre></div><p style="width:90%">
</p></div><div class="section" lang="en"><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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::encryptd"></a>web::encryptd</h3></div></div></div><p style="width:90%">
Modified: tcl/site/websh/quickref/file_handling_and_file_IO.html
URL: http://svn.apache.org/viewcvs/tcl/site/websh/quickref/file_handling_and_file_IO.html?rev=345021&r1=345020&r2=345021&view=diff
==============================================================================
--- tcl/site/websh/quickref/file_handling_and_file_IO.html (original)
+++ tcl/site/websh/quickref/file_handling_and_file_IO.html Wed Nov 16 06:11:37 2005
@@ -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 content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>File handling and file I/O</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference"><link rel="up" href="index.html" title="Websh Reference"><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" lang="en"><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" lang="en"><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 content="text/html; charset=ISO-8859-1" http-equiv="Content-Type"><title>File handling and file I/O</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Websh Reference 3.6.0b3"><link rel="up" href="index.html" title="Websh Reference 3.6.0b3"><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" lang="en"><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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="web::include"></a>web::include</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%">
@@ -40,10 +40,9 @@
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="id2917689"></a><p class="title"><b>Example 11. web::lockfile</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
- set fh [open [web::tempfile] w]
- web::lockfile $fh
- puts $fh foo
- web::unlockfile $fh
- close $fh
- </pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="context_handling.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="data_encryption.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Context handling </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Data encryption</td></tr></table></div></body></html>
+ </p><div class="example"><a name="id350987"></a><p class="title"><b>Example 11. web::lockfile</b></p><pre style="background:#bbffbb ; width:75%" class="programlisting">
+set fh [open [web::tempfile] w]
+web::lockfile $fh
+puts $fh foo
+web::unlockfile $fh
+close $fh </pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="context_handling.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="data_encryption.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Context handling </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Data encryption</td></tr></table></div></body></html>
---------------------------------------------------------------------
To unsubscribe, e-mail: site-cvs-unsubscribe@tcl.apache.org
For additional commands, e-mail: site-cvs-help@tcl.apache.org