README
1 ------------------
2 Websh, Version 3.6
3 ------------------
4
5 Copyright 1996-2001, Netcetera AG, Switzerland
6 Copyright 2001-2005, Apache Software Foundation.
7
8 All rights reserved.
9
10 This software is distributed under the terms of the Apache
11 Software License, available as "LICENSE".
12
13 Websh is available from
14
15 http://tcl.apache.org/websh/
16
17Contents
18--------
19
20 1. Introduction
21 2. Documentation
22 3. Compiling and installing Websh (Unix)
23 4. mod_websh: Websh as Apache Module (Unix)
24 5. Compiling and installing Websh and mod_websh (Windows XP)
25 6. Support
26
27
281. Introduction
29---------------
30
31Websh is a rapid development environment for building powerful and
32reliable web applications. It is a standard Tcl extension and is
33released as Open Source Software. Websh is versatile and handles
34everything from HTML generation to data-base driven one-to-one page
35customization. At Netcetera, we have been using it for years for
36virtually all our customer projects, which typically are E-commerce
37shops or electronic banking applications.
38
39Websh was originally developed by Netcetera AG, Switzerland and was
40contributed to the Apache Software Foundation in 2001.
41
42Find more information about
43
44- Apache: http://www.apache.org/
45- Websh: http://tcl.apache.org/websh/
46- Netcetera AG, Switzerland: http://netcetera.ch/
47- Tcl: http://tcl.tk/
48
49
502. Documentation
51----------------
52
53Documentation is available at
54
55 http://tcl.apache.org/websh/
56
57
583. Compiling and installing Websh (Unix)
59----------------------------------------
60
61Please note that we use some GNU make extensions, so make sure that
62you try to compile Websh using a GNU version of make (or gmake) when
63compiling under UNIX.
64
65Websh is a pure Tcl extension, Tk is not required. You need
66Tcl8.3 or newer to compile and install Websh 3.6.
67
68typically:
69
70 cd unix
71 autoconf
72 ./configure
73 make
74 make test
75 make apachetest
76 make install
77
78Make will create three targets: websh3.6.<patch>, which is the standalone
79Websh application (dynamically linked to Tcl and libwebsh3.6.<patch>.so)
80and libwebsh3.6.<patch>.so, which is a TEA (Tcl Extension Architecture)
81compliant shared object that can be dynamically loaded from within Tcl
82using [load libwebsh3.6.<patch>.so]. Both provide the Tcl package
83websh. The third target is mod_websh3.6.<patch>.so (also dynamically
84linked to Tcl and libwebsh3.6.<patch>.so), which is the Websh Apache
85module.
86
87If you have several versions of Tcl and Apache installed on your system,
88you might want to specify which one should be used for Websh, e.g.
89
90 ./configure --with-tcl=/usr/local/tcl8.4.19 \
91 --with-httpdinclude=/usr/local/httpd-2.0.63/include
92
93Note that to compile mod_websh for Apache 2, the corresponding Tcl
94library must be compiled using threads and threads should be enabled
95for Websh:
96
97 ./configure --enable-threads
98
99By default, Websh is installed to /usr/local
100To change this location, provide the --prefix option to configure:
101
102 ./configure --prefix=/opt
103
104
1054. mod_websh: Websh as Apache Module
106------------------------------------
107
108Websh applications can both run in CGI mode and in mod_websh, the
109module for Apache 1.3 to Apache 2.2. In order to build mod_websh,
110you have to use the following configure option:
111
112 --with-httpdinclude=/path/to/apache/header/files
113
114For Apache 2, you need to enable threads additionally:
115
116 --enable-threads
117
118After this,
119
120 make mod_websh.so
121
122will compile and build mod_websh. Note that mod_websh3.6.<patch>.so will
123also be compiled by default when 'make all' is invoked.
124
125In order to use mod_websh in your Apache web server, please refer
126to the file doc/mod_websh/README
127
128A sample setup to serve SSI-type HTML with Websh-snipplets and CGI-type
129scripts is found in doc/mod_websh and will be installed with the
130'make install' command.
131
132
1335. Compiling and installing Websh and mod_websh (Windows XP)
134------------------------------------------------------------
135
136Websh currently provides a Makefile for Microsoft Visual Studio 6.0 nmake.
137
138Please refer to the file src/win/README for details.
139
140
1416. Support
142----------
143
144For support please try the following mailing list on tcl.apache.org:
145
146 websh-user@tcl.apache.org
147
148You may subscribe by sending mail to websh-user-subscribe@tcl.apache.org.
149
150If you would like to contribute to websh, please subscribe to:
151
152 websh-dev@tcl.apache.org
153
154by sending mail to websh-dev-subscribe@tcl.apache.org.
155
156In addition, Netcetera is committed to provide additional support for Websh.
157
158You can reach us at
159
160 support@websh.com
161
162and
163
164 info@websh.com
165
166
167== Thank you for your interest in Websh ==
168
169@(#) $Id: README 777449 2009-05-22 10:13:35Z ronnie $
170