#set TITLE = "config file"
#include top

.SH Config file
QUISP uses the same config file as 
#set FILE = "../../sqlman/html/shsql_handbook.html"
#set TAG = "shsql."
#include link
See the 
#set FILE = "http://quisp.sourceforge.net/sqlman/html/config.html"
#set TAG = "shsql config file manual page"
#include link
for additional info.
A basic config file is set up when you create a new project using \fCnewproject.sh\fR

#include space
A config file is simply a set of attribute: value pairs.  Here's an example:
.nf
defaultrtn: docs/home
debugtag:   zizzer
.fi

#include space

The following additional config file attributes are supported:

.LP
\fBshellmetachars:\fR
.IP \0
A list of shell metacharacters to screen out when building shell commands.
See the
#set FILE = "shell.html"
#set TAG = "#shell manual page."
#include link
Also can be set dynamically using the
#set FILE = "mode.html"
#set TAG = "#mode"
#include link
directive.
.br
Example: \fCshellmetachars: '"`\fR

#include space
.ig >>
<a name=defaultrtn></a>
.>>
.LP
\fBdefaultrtn:\fR
.IP \0
Default page to display if none is specified.  Name is relative to \fC./pages\fR
in the project directory.
.br
Example: \fCdefaultrtn: docs/homepage\fR

#include space
.ig >>
<a name=doctag></a>
.>>
.LP
\fBdoctag:\fR
.IP \0
Set a symbol to use in place of \fCrtn\fR for specifying return pages in URLs.
.br
Example: \fCdoctag: doc\fR

#include space
.ig >>
<a name=debugtag></a>
.>>
.LP
\fBdebugtag:\fR
.IP \0
Any user can add \fC_DEBUG=1\fR to an invoking URL which causes QUISP to
display diagnostic information.
If \fC_DEBUG\fR shows information that you don't wish for the world to see, use this
setting to change the variable name to something obscure.
.br
Example: \fCfibizy\fR
.br
then for debug mode use \fCfibizy=1\fR in the URL..

#include space
.ig >>
<a name=allownonprint></a>
.>>
.LP
\fBallownonprint:\fR
.IP \0
Normally, QUISP scans the first several lines of a requested page
file and if any characters outside normal lower ascii range are found a "not displayable"
error will result.  If you want to disenable this feature, use \fCallownonprint: 1\fR.

#include space
.ig >>
<a name=cgipath></a>
.>>
.LP
\fBcgipath:\fR
.IP \0
Allows a specific command PATH to be set for the cgi environment (only).
Value should be a legitimate PATH specification.
.br
Example: \fCcgipath: /bin:/usr/bin:/home/steve/mybin\fR
.br
An alternative way to set the PATH would be to use something like this in your config file:
.br
\fCputenv: PATH=/bin:/usr/bin:/home/steve/mybin\fR
.br
but this would be in affect for command line uses as well as CGI.


#include space
.ig >>
<a name=cpulimit></a>
.>>
.LP
\fBcpulimit:\fR
.IP \0
Normally, QUISP sets a resource limit of 20 seconds of cpu time.  Any request
that runs over this terminates with a SIGLIMIT error.  This limit may be raised or lowered
using this attribute.
.br
Example: \fCcpulimit: 10\fR



#include space

.SH DATE-RELATED
.LP
There are a number of date-related config file attributes.. these are documented
#set FILE = "http://ploticus.sourceforge.net/doc/config.html#dates"
#set TAG = "here."
#include link


#include bottom
