Mailing Lists: Apple Mailing Lists
 Image of Mac OS face in stamp
Re: Apple Releases HeaderDoc 8 Public Beta with MPGL
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Apple Releases HeaderDoc 8 Public Beta with MPGL

On Mar 4, 2004, at 2:08 PM, Stiphane Sudre wrote:


On jeudi, mars 4, 2004, at 10:11 PM, David Gatwood wrote:

HeaderDoc 8 is the next generation of HeaderDoc, a tool for generating documentation from comments embedded in headers and source code.

HeaderDoc 8 adds many new features, including a new (optional) tagless syntax, code coloring, template-based index pages, improved error checking, man page output, and support for many new languages, including Java, JavaScript, Perl, PHP shell scripts, and Pascal.

HeaderDoc 8 also adds support for the Man Page Generation Language (MPGL), an XML dialect you can use to easily author well-formatted man pages. In addition to generating man pages from HeaderDoc content, HeaderDoc 8 also includes tools for converting MPGL files into man pages using the BSD mdoc macros.

For more information, see the HeaderDoc project page at

http://developer.apple.com/darwin/projects/headerdoc/

And the updated documentation and release notes?

Since this is a beta, the documentation on the website still reflects the last offically "supported" state (HeaderDoc 7.4.x, which, other than a bunch of bug fixes and formatting changes, is still basically identical in functionality to what's documented).

The documentation in the headerdoc 8.0a1 tarball is, with one or two slight exceptions, up-to-date with HeaderDoc 8, and I'll see if we can get a link to it pushed onto the website in some form.


I'm particularly interested in the MPGL thing since the Man page template of ProjectBuilder is a nightmare to understand without a strong will to spend a week on it.

Yup. That's a cool feature. The best documentation for it right now is the Syntax file and the example .mxml files in the tarball itself. I haven't written up a formal DTD, since the syntax is preliminary and may change significantly for non-function use.


David
_______________________________________________
darwin-documentation mailing list | email@hidden
Help/Unsubscribe/Archives: http://www.lists.apple.com/mailman/listinfo/darwin-documentation
Do not post admin requests to the list. They will be ignored.

References: 
 >Re: Apple Releases HeaderDoc 8 Public Beta with MPGL (From: Stéphane Sudre <email@hidden>)



Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Contact Apple | Terms of Use | Privacy Policy

Copyright © 2011 Apple Inc. All rights reserved.