Re: Embedded GNUstep - new rumours about embedded MacOS X and call for support

[Graham J Lee]

On 24 Dec 2006, at 10:35, Richard Frith-Macdonald wrote:

> On 24 Dec 2006, at 10:16, Matt Rice wrote:
>
> > i'm not going to go so far as to object to this, but
> > it seems as though there are already alot of
> > unimplemented methods and classes in GNUstep, and it
> > would be nice if they were easier to find when one
> > wanted to work on something,
>
> It would be quite easy to mark all unimplemented stubs consistently  
> so that autogsdoc would document them as unimplemented, and they  
> would raise an exception at runtime...
>
> - (id) aMethod
> {
>   /** not implemented */
>   [self notImplemented: _cmd];
>   return nil.
> }
>
> We could even extend autogsdoc  so that '/** <notimplemented /> */'  
> could be auto-expanded to a big red warning in the documentation  
> along with a request that someone work on it and instruction to  
> them abbout how they can get started.
>
> Worth doing?

Definitely - I tend to look at the source only after I've observed  
that it doesn't do what the documentation promised so if the big red  
warning was in the docs, I'd see it earlier...it also provides a  
quick way to see where to hack ;-).

Could autogsdoc also output a list of all /** <notimplemented /> */  
methods into a TODO document?  :)

Cheers,
Graham.

--
Graham J Lee
http://www.thaesofereode.info/