What's New in Version 3.0

This release contains loads of bug fixes. Special thank-you's and profuse gratitude to the many Cocoon users who selflessly debugged their pet peeves and sent me the code changes. (However, I am record-keeping-impaired and don't have an accurate list of all the problems that were fixed.) Following is a list of the major features added to this release:

Support for Code without Sentinels!!!: Cocoon can now do a passable job of processing source code without all the sentinels and many of the formatting conventions it normally requires. The only catch is that it sometimes picks up stuff it shouldn't, and may miss some stuff it should catch. For best results, use sentinels and adhere to the formatting conventions, but to get up and running with legacy code, this capability is invaluable.
Generating Keywords from Class Names: Cocoon can now help you populate the keyword cross-reference page by doing a simple parse of class names. Case-differences are assumed to mark word boundaries. Each word found is entered as a keyword for the class.
Support for a Keyword Search Facility: If your Web server can support Perl CGI scripts, you can get a simple boolean keyword search page as part of the Cocoon output.
Support for OS/2: An OS/2 port was provided by several Cocoon users. Thanks! Check out the Makefile...
Support for Nested Classes: Nested class declarations will now work. The nested class gets a Web page all its own, with a backward reference to the containing class. The containing class has the nested class listed as a member. Nested classes are not included in the documentation page for the library.
Suppress Output of Full Member Function Declarations: For member functions, Cocoon will by default include the function declaration as it was found in the source code. This was done to assist cases where argument documentation was co-mingled with the function declaration. You can now suppress this part of the member function documentaton.
Support for Sites without Web Servers: If you want to access the documenation produced by Cocoon without relying on a Web server--e.g. on a local, non-networked PC--you can tell Cocoon to use the 'file' protocol, rather than 'http'.

Cocoon 3.0. Created with pride, distributed with fear... by jkotula@unimax.com