| |
| Websh, Version 3.5.0 |
| |
| Copyright 1996-2001, Netcetera AG, Switzerland |
| Copyright 2001-2002, Apache Software Foundation. |
| |
| All rights reserved. |
| |
| This software is distributed under the terms of the Apache |
| Software License, available as "license.terms". |
| |
| Websh is available from |
| |
| http://tcl.apache.org/websh/ |
| |
| Contents |
| -------- |
| |
| 1. Introduction |
| 2. Documentation |
| 3. Compiling and installing Websh |
| 4. mod_websh: Websh as Apache Module |
| 5. Support |
| |
| |
| 1. Introduction |
| --------------- |
| |
| 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. At Netcetera, we have been using it for years for |
| virtually all our customer projects, which typically are E-commerce |
| shops or electronic banking applications. |
| |
| Websh was originally developed by Netcetera AG, Switzerland and was |
| contributed to the Apache Software Foundation in 2001. |
| |
| Find more information about |
| |
| - Apache: http://www.apache.org/ |
| - Websh: http://tcl.apache.org/websh/ |
| - Netcetera AG, Switzerland: http://netcetera.ch/ |
| - Tcl: http://tcl.tk/ |
| |
| |
| 2. Documentation |
| ---------------- |
| |
| Documentation is available at |
| |
| http://tcl.apache.org/websh/ |
| |
| |
| 3. Compiling and installing Websh |
| --------------------------------- |
| |
| Websh is a pure Tcl extension, Tk is not required. You need |
| Tcl8.3 or newer to compile and install Websh 3.5.0. |
| |
| typically: |
| |
| cd unix |
| autoconf |
| ./configure |
| make |
| make test |
| |
| Make will create two targets: websh3.5.0, which is the standalone |
| Websh application (dynamically linked to Tcl) and libwebsh3.5.0.so, |
| which is a TEA (Tcl Extension Architecture) shared object that can |
| be dynamically loaded from within Tcl using [load libwebsh3.50.so]. |
| Both provide the Tcl package websh. |
| |
| If you have several versions of Tcl installed on your system, you |
| might want to specify which one should be used for Websh, e.g. |
| |
| ./configure --with-tcl=/usr/local/tcl8.3.4/lib \ |
| --with-tclinclude=/usr/local/tcl8.3.4/include/ |
| |
| Note that to compile mod_websh for Apache 2, the corresponding Tcl |
| library must be compiled using threads. |
| |
| |
| 4. mod_websh: Websh as Apache Module |
| ------------------------------------ |
| |
| Websh applications can both run in CGI mode and in mod_websh, the |
| module for Apache 1.3 and Apache 2.0. In order to build mod_websh, |
| you have to use the following configure option: |
| |
| --with-httpdinclude=/path/to/apache/header/files |
| |
| For Apache 2, you need to enable threads additionally: |
| |
| --enable-threads |
| |
| After this, |
| |
| make mod_websh.so |
| |
| will compile and build mod_websh. |
| |
| In order to use mod_websh in your Apache web server, you have |
| to do the following: |
| |
| 1) cp mod_websh.so somewhere where Apache can find it. |
| E.g. SERVER_ROOT/libexec/ |
| 2) edit the httpd.conf file and add the following lines: |
| LoadModule websh_module /path/to/apache/libexec/mod_websh.so |
| AddHandler websh .ws3 |
| 3) Optionally, you can specify a mod_websh configuration file using the |
| following directive: |
| WebshConfig /path/to/websh.conf |
| This configuration file is primarily used to configure the interpreter |
| classes (see documentation) |
| 4) HUP/restart httpd |
| |
| From now on, httpd will pass files ending in .ws3 to mod_websh. |
| |
| |
| 5. Support |
| ---------- |
| |
| For support please try the following mailing list on tcl.apache.org: |
| |
| websh-user@tcl.apache.org |
| |
| You may subscribe by sending mail to websh-user-subscribe@tcl.apache.org. |
| |
| If you would like to contribute to websh, please subscribe to: |
| |
| websh-dev@tcl.apache.org |
| |
| by sending mail to websh-dev-subscribe@tcl.apache.org. |
| |
| In addition, Netcetera is committed to provide additional support for Websh. |
| |
| You can reach us at |
| |
| support@websh.com |
| |
| and |
| |
| info@websh.com |
| |
| == Thank you for your interest in Websh == |
| |
| |
| @(#) $Id$ |