[as2api-dev] private

[David Holroyd]

Hi there,

On Fri, Sep 09, 2005 at 11:28:36AM +0200, Michael Nisi wrote:
> Just one thing. I need to document private methods too. Isn't that a common 
> issue? There should be a command line property for this. Is it there 
> already? I think most of us write applications, not libraries.

There are lots of excellent reasons not to include private type members
in the API documentation.

Since I want to promote OO best practice, it's fairly unlikely that an
option to include all private members will be added in as2api.

Do you have a specific use-case in mind that should override normal best
practice considerations?  (e.g. I believe that it's possible to make
public in a subclass a method originally defined as private in a
superclass; if true, that's probably a bug in the MM compiler, but maybe
a case that as2api needs to handle better somehow?)


dave

-- 
http://david.holroyd.me.uk/