README for W3-msql 1.0          David J. Hughes         Bambi@Hughes.com.au
----------------------------------------------------------------------------



Introduction
------------

www-msql is an interface between the World-Wide Web and mSQL.  It is a
mechanism that can be used to greatly simplify the use of an SQL
database behind a web server.  Using W3-msql, you can embed SQL queries
within your pages and have the results generated on the fly.

The www-msql program is intended to be run as a CGI script.  It should
be referenced as

                /cgi-bin/w3-msql/db/sample.html

where /db/sample.html is a W3-mSQL enhanced html file within your WWW
document tree.  W3-mSQL will process the specified page and "fill in
the blanks" by interpreting and processing the embedded mSQL commands.



Installation
------------

Edit the Makefile to reflect your system. Becuase W3-mSQL uses the mSQL
client library, it needs to be linked with support for sockets.  On some
OS's that implies a -lsocket and a -lnsl for the link libraries.

Once you are happy with the Makefile, build the software using "make".
After it has compiled, copy w3-msql to your cgi-bin directory.


Documentation
-------------

Documentation for this package is available in w3-msql.html in the doc
directory.  The W3-mSQL Home Page is in the Hughes Technologies area at
http://AusWeb.com.au/computer/Hughes/w3-msql/.   The WWW service is
provided by Web Publishing Australia.




Copyright
---------

W3-mSQL is Copyright (c) 1995  Hughes Technologies Pty Ltd

Permission to use, copy, and distribute for non-commercial purposes,
is hereby granted without fee, providing that the above copyright
notice appear in all copies and that both the copyright notice and this
permission notice appear in supporting documentation.

This software is provided "as is" without any expressed or implied warranty.

