Installation instructions for the Python Object Publisher (Bobo)

  Bobo installation can be a bit tricky because it involves interaction
  with another application, namely a web server.  Installation is further
  complicated by the fact that there are a number of different ways to 
  connect Bobo with a web server, including CGI, Persistent CGI, 
  Fast CGI and Medusa, among others.  

  This document describes setting up Bobo to work with CGI on Unix.

  It also attempts to lay out some basic principles so that you can 
  better understand how to use Bobo with CGI and other mechanisms.

Publishing modules

  There are two basic modules used for publisging objects with Bobo:

  cgi_module_publisher.py -- This is the main publishing module.  It 
    translates data in the form of a CGI environment into Python method
    invocations.

  CGIResponse -- A support module that defines response objects.

  These two modules must be somewhere in the software path.  They could
  be in the same location as application modules or in a system area.

  Additional scripts or modules are needed depending on the actual
  publishing mechanism employed.

Publishing modules using CGI on Unix.

  A Python script, cgi-module-publisher, is included that supports 
  publishing modules with CGI on Unix. It takes advantage of Unix
  symbolic links to simplify the publishing process slightly.

  The steps (and non-steps) to publish a module using CGI on Unix are:

    - Do not copy the module to be published to the cgi-bin directory.

    - Copy the files: cgi_module_publisher.pyc and CGIResponse.pyc to
      the directory containing the module to be published, or to a
      directory in the standard (compiled in) Python search path.

    - Copy the file cgi-module-publisher to the directory containing
      the module to be published.

    - Create a symbolic link from cgi-module-publisher (in the
      directory containing the module to be published) to the module
      name in the cgi-bin directory.

Publishing modules using CGI on Windows.

  Windows doesn't have symbolic links, so you can't use the trick
  described above.  

  Mike Fletcher wrote a script that build's custom CGI wrapper scripts
  for use on windows.  See the file win_wrap.

