#set TITLE = "Installing, examples, support and troubleshooting"
#include top

.SH Installing QUISP

.IP \(bu
Download from \fCquisp.sourceforge.net\fR.
Software distribution directory can be located anywhere (user directory or system directory)

#include space2
.IP \(bu
If you're building \fCquisp_pl\fR (ploticus-enabled), take a look 
at \fCploticus/Makefile_api\fR in case you want to change any of the settings.
#set FILE = "graphic.html#setup"
#set TAG = "More info on quisp_pl and graphics"
#include link

#include space2

.IP \(bu
In the top level of the distribution, type: \fCmake all\fR
.br
\fBgcc\fR is required.  There are no external library dependencies.
You can be any UID to do the build.
This will build shsql and quisp (and libploticus if appropriate).
The resulting executables will be placed in \fC./bin\fR

#include space2

.IP \(bu
Add the quisp bin to your search \fBPATH\fR to make the command line
utilities (\fCquisputil\fR and \fCshsql\fR) available.

#include space2

.IP \(bu
Here's how to proceed with
#set FILE = "project_setup.html"
#set TAG = "setting up a QUISP-powered web site and trying some canned examples."
#include link


#include space

.SH Troubleshooting hints

.IP \(bu
You can add \fC_DEBUG=1\fR to an invoking URL to get diagnostic information
(the name _DEBUG can be changed to something more obscure in your config file
if desired).

#include space2
.IP \(bu
Use your browser's \fCShow source\fR feature to see the raw HTML.  Sometimes error messages
are hidden in formatted result (especially within tables or option lists), but will be visible 
in the raw HTML.  Note that 
standard error (eg. error messages from subprocesses) is not captured when in CGI mode.


#include space 
.IP \(bu
Try invoking \fCquisp\fR manually.  Supply user variables and values on the command
line as var=value pairs, eg. \fCquisp rtn=mypage x=2\fR.  The generated HTML
will be written to the screen.  You will also see any standard error content.

#include space
.IP \(bu
\fBWhat's the path name of my cgi bin?\fR 
Check with your local web administrators.

#include space2

.IP \(bu
\fBWhy can't my web browser find quisp?\fR
Where CGI programs need to reside, and how they are named, can vary from site to site.
Check with your local web administrators.

#include space2

.IP \(bu
\fBThe web server seems to be executing quisp, but quisp can't see any files outside
of the cgi bin or html docs directories.\fR
Some web servers are configured to not allow CGI programs to access files outside of 
these areas.  Check with your local web administrators.  If the restriction can't be
relaxed you may need to put the quisp shsql trees within the allowed directories.


#include space 
.SH Support
.IP \0
Bugs and questions to Steve Grubb at \fCscg@jax.org\fR.
I am always happy to hear of interesting applications that this software used for.
.IP
#set FILE = "http://ploticus.sourceforge.net/steve.html"
#set TAG = "About the author."
#include link



#include bottom
