Benjamin D. Smedberg wrote:
There was. But unfortunately, there is no obvious way to map our interfaces to actual DOM objects.
Sure. For DOM, things are a little different (and we don't javadoc our DOM interfaces because that would simply repeat what the spec says).
I guess I was talking more about embedding APIs. The versioning problem still exists there, though.... But that can be solved by simply creating the "latest" version based on javadoc (say daily) and snapshotting it at release time so you can always look up what the API looked up in a particular release.
Right, this was what I was thinking of too. Mozilla's embedding APIs, broadly construed (not just the stuff under http://lxr.mozilla.org/mozilla/source/embedding/) are defined by IDL. The doc-comments in those files should be as complete, correct, and well-written as we can make them.
We could scan for magic comments in XBL and XUL files too -- why not? Proposals?
/be _______________________________________________ mozilla-documentation mailing list [EMAIL PROTECTED] http://mail.mozilla.org/listinfo/mozilla-documentation
