quisp: installing, examples, support and troubleshooting

quick server pages
| Manual page for Installing,(examples,)

## Installing QUISP

- Download from `quisp.sourceforge.net`.`` Software distribution directory can be located anywhere (user directory or system directory)
- If you're building `quisp_pl` (ploticus-enabled), take a look at `ploticus/Makefile_api` in case you want to change any of the settings.`` More info on quisp_pl and graphics
- In the top level of the distribution, type: `make all`
  gcc 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 `./bin`
- Add the quisp bin to your search PATH to make the command line utilities (`quisputil` and `shsql`) available.``
- Here's how to proceed with setting up a QUISP-powered web site and trying some canned examples.``

## Troubleshooting hints

- You can add `_DEBUG=1` to an invoking URL to get diagnostic information (the name _DEBUG can be changed to something more obscure in your config file if desired).``
- Use your browser's `Show source` 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.``
- Try invoking `quisp` manually. Supply user variables and values on the command line as var=value pairs, eg. `quisp rtn=mypage x=2`. The generated HTML will be written to the screen. You will also see any standard error content.``
- What's the path name of my cgi bin? Check with your local web administrators.``
- Why can't my web browser find quisp? Where CGI programs need to reside, and how they are named, can vary from site to site.`` Check with your local web administrators.``
- The web server seems to be executing quisp, but quisp can't see any files outside of the cgi bin or html docs directories. 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.``

## Support

  Bugs and questions to Steve Grubb at `scg@jax.org`.`` I am always happy to hear of interesting applications that this software used for.``

  About the author.``
  quick server pages
  Copyright Steve Grubb

Markup created by unroff 1.0, `` `` February 16, 2005.