

$Id: README,v 1.1.1.1 1999/03/31 20:53:26 damon Exp $

This is directory in which the configuration files for Apache and NeoWebScript
reside.

The functions of the various files are described in the documentation under
theory of operation.

Briefly:

init.tcl: not to be confused with Tcl's init.tcl library routine, this is
	read once when the primary interpreter is started.  If you modify
	this file, you must restart your webserver.

devel.tcl: optionally read when each slave interpreter is created.  For
	experimental routines that haven't yet been rolled into init.tcl.
	If debugging is disabled, it is read once when init.tcl is run.
	This is more efficient if you are not debugging.  We tend to leave
	debugging turned on.

common.tcl: additional routines loaded in by init.tcl.  Sames rules for
	changes apply.

client.tcl: routines that are installed into the safe/slave interpreter.
	Overlaps some of the names found in common.tcl.

unknown.tcl: definition of unknown for the slave.  This file is cached
	by init.tcl upon server startup, so the file is only read once
	during the life of httpd.  NeoWebScript-2.3's unknown.tcl is based
	on you using NeoSoft's integrated Tcl (neotcl7.5), which is based
	on Itcl 2.1.  If you decide to use a different version of Tcl
	(vs. Itcl2.1's tcl7.5) then grab a copy of init.tcl from the
	distribution and copy it into unknown.tcl.  You can delete extra
	routines that won't ever be used, like auto_mkindex.

nwslocal/local.tcl: 
	You should place your permanent local extensions in this directory.
	Init.tcl will attempt to source local.tcl and will display any
	errors encountered.  The proc "local_setup" may be created to
	perform any per-user-interpreter setup functions you want, such
	as additional procedure definitions, variable settings, more
	aliases etc.
	
	
