About This Distribution

This distribution contains a set of files that add publish and subscribe to the Web for users of Perl, Python, PHP, JavaScript, C, COM/ActiveX/.NET, Java, and Ruby.

This distribution includes the PubSub Server as a Perl Apache module (using mod_perl), a reference standalone Python PubSub Server that uses the same PubSub Protocol, a push_manager that helps with additional connection pooling, and many sample apps.

(The Perl and Python Servers work, push_manager needs a lot of work, and the apps are all in varying states of usability and needing work.)

Please have peruse the file INSTALL for installation instructions for the current Apache-based Perl PubSub Server and standalone Python PubSub Server.

Plans are in the TODO file.

See also the index.html files in the mod_pubsub directory and the mod_pubsub/kn_apps directory for an index of goodies included in this distribution. If you have questions not covered in these files, please send inquiries to the mailing list

[email protected] http://mod-pubsub.sf.net/

KnowNow makes this code freely available, to encourage adoption and unfettered experimentation. Our BSD-style license is available in the LICENSE file; its purpose is to indemnify KnowNow of legal liability while promoting free use of this set of code, tools, and documentation. Enjoy!

-- Adam Rifkin $Id: README,v 1.10 2003/05/31 04:42:29 ifindkarma Exp $

Credits

We thank Joyce Park and Robert Leftwich for their recent changes and additions to the code in this distribution. Furthermore...

A hearty thank-you goes out to all KnowNow employees and contractors who wrote the code and documentation that has been included in this distribution.

In the kn_apps directory, jscomponents is version 1.5.10 of KnowNow's JavaScript Components libraries, released in January 2002. We found these on http://developer.knownow.com/ and since they use the KnowNow license we're including them with this distribution.

kn_apps/soapstock uses an SOAP service from http://www.xmethods.com/ . Thanks, xmethods!

We thank IRT and Keith Drakard ([email protected]) for the Connect Four and Reversi games available in kn_apps/connect4 and kn_apps/reversi . These programs are distributed under the terms of the WebGames License at http://www.irt.org/games/license.txt .

In the python_pubsub directory, the following files are distributed under the same license as Python: asyncore.py, cgi.py, cgitb.py, inspect.py, pydoc.py . Refer to the file LICENSE in the Python source distribution (http://www.python.org/) for details. Note that we made some minor modifications to these files to support pubsub.py . It is our goal to get pubsub.py working out-of-the-box with a Python release without using the modified versions of these files.

Regarding that python_pubsub directory, we thank the many authors who have contributed to the files included in that distribution, including but not limited to Sam Rushing, Ka-Ping Yee, Guido van Rossum, Michael McLay, Steve Majewski, Andreas Paepcke, Timothy O'Malley, Greg Burd, Phil Harris, Andrew Athan, and Kragen Sitaker.

Also in the python_pubsub directory, we use an asynchronous HTTP/1.1 client library called asynchttp.py . We thank Downright Software http://www.dougfort.com/ and Doug Fort [email protected] for this library, which we found at http://asynchttp.sourceforge.net/ .

In the java_pubsub directory, we use HTTPClient from Ronald Tschalar http://www.innovation.ch/java/HTTPClient/. The .jar is included in the lib subdirectory.

Jef Poskanzer's excellent thttpd is used for the push_manager; these parts are copyright 1995,1998,1999,2000 by Jef Poskanzer [email protected], distributed under a separate license. See the file LICENSE in the push_manager directory for full details.