AutoDoc 2.0 Beta 7

FOR IMMEDIATE RELEASE

Contacts:

Don Yacktman
(801)221-0344
don@misckit.com

Carl Lindberg
Carl_Lindberg@blacksmith.com

NEW BETA 7 RELEASE OF AUTODOC 2.0 AVAILABLE

Update to Objective-C Documentation Generation Tool Is Now Available

PROVO, UT, May 11, 2000 -- An update to the popular NEXTSTEP developer tool "autodoc" is now available. This new version runs on both the OPENSTEP and MacOS X Server operating systems, and should be compilable for NT and GNUSTEP.

Beta7 is primarily a bugfix release. The main features are:

• Fixed bad bug that prevented autodoc from working on NT
• Added MiscMerge documentation
• Added special anchors to HTML template to let ProjectBuilder find documentation sections
• Changed template delimiters to avoid character set problems
• a few bug fixes (see the README for details)

AutoDoc 2 is a complete re-implementation of the original 'autodoc' Perl program written by Adam Swift. AutoDoc generates documentation for Objective-C classes, categories, and protocols by extracting comments from the source code. This allows a developer to maintain code documentation as part of the source code.

This new version is written in Objective-C. It tries to mimic all of the features in the original autodoc, so that it can be used as a drop-in replacement. It adds a few new features as well, such as HTML and [PDF]LaTeX output (in addition to RTF), WebScript support, the ability to have fixed-width sections in the comments, and the ability to generate a documentation file for each class, category, and/or protocol found in a .h/.wos file (as opposed to one doc file per .h file).

When the beta period is finished, Autodoc 2 will be donated to the MiscKit and become part of the kit itself as an example program. Before that happens, a beta test version is being made available so feedback such as suggestions, bug reports, etc. may be collected and incorporated into the program. The beta version is available from ftp.misckit.com as an OPENSTEP binary, a MacOS X Server binary, and as source code at the following URLs.

OPENSTEP/Mach 4.2 binary:

ftp://ftp.misckit.com/pub/next/misckit/AutoDoc-2.0CurrentBeta.NIS.b.tar.gz

MacOS X Server binary:

ftp://ftp.misckit.com/pub/next/misckit/AutoDoc-2.0CurrentBeta-P-b.tar.gz

Source code (as an OPENSTEP 4.2 Tool project):

ftp://ftp.misckit.com/pub/next/misckit/AutoDoc-2.0CurrentBeta.s.tar.gz

In addition to providing the FTP site, we have created a mailing list for feedback and other discussion on autodoc. The list's address (for posting messages) is:

autodoc@of.org

and subscription/cancellation requests should be sent to:

autodoc-request@of.org

This mailing list implements several measures to reduce spam and other types of abuse. For more information about these measures and how to effectively use the list, please see the informational web page at this URL:

http://www.of.org/autodoc/info.html

An archive of all posts to the list is maintained on the web at:

http://www.of.org/autodoc/

Please send any bug reports to the autodoc mailing list or, failing that, to Carl or Don directly.

Carl Lindberg

Carl Lindberg is a consultant with BLaCKSMITH and was one of the first contributors to the MiscKit.

Don Yacktman

Don Yacktman is an alumnus of Brigham Young University, with a Master of Science in Electrical and Computer Engineering. He acts as the MiscKit administrator in his spare time between various NEXTSTEP and Unix consulting projects.

The MiscKit

The MiscKit is an open source collection of free Objective-C objects designed to work with the NEXTSTEP, OPENSTEP, and Rhapsody operating systems. An active project since 1993, the kit has grown to become one of the staples in the tool chest of most Objective-C programmers. Further information is available on the web at http://www.misckit.com/.

All trademarks mentioned above belong to their respective owners.