HTTPserver module
-----------------

  version: 1.0
  date: May 99
  author: Vincent CARON


This module provides a simple HTTP server to share HTML documents
over the World Wide Web. A simple CGI implementation will also be
soon implemented via DMS calls.

To configure the server, you need :

  - a TCP port: 80 is the default, but you may either not be able
    to run a server on this port or get people to connect (ports
    below 1023 are often blocked by firewalls and/or system).

  - an HTML document root folder: your server is referenced as the
    'http://x.x.x.x', where x.x.x.x is your IP (you can use the
    machine name if it is registered in the DNS), and any URL will
    be appended to the document root folder. Example:

        'http://x.x.x.x/myfolder/mydoc.html' represents the file
        [root_folder]\myfolder\mydoc.html in your SCOL partition.


To handle HTTP errors, the server can provide special HTML pages
referenced in http root folder as '/error/codeXXX.html'. Common
HTTP error codes are :

  400 Bad request
  404 Not found
  501 Not implemented

The HTTP server module provides a special filter allowing you to
automatically & dynamically compose a valid URL from a simple
HTTP path. One action ('url_in') and one event ('url_out') are
provided. Example:

    You want a client to join the /info/today.html page on your
    HTTP server module, but the client doesn't know the IP or the
    port it is running on.
    If you link an event to the 'url_in' action with an HTTP path
    as the parameter (absolute path, that is '/test/doc.html'),
    the 'url_out' event will be triggered with the complete URL
    as parameter (that is 'http://x.x.x.x[:port]/test/doc.html).
    You can link this event to the In/Out module for instance.

    Note: port is appended to the URL only if different from 80.