Re: [Adobe-source-devel] ui-core documentation

[Sean P. <sp...@ad...>]

We've gone back and forth on this - for the ui-core, I'm fine with 
putting it in the file directly (I think the UI code is still at the 
stage of just being example code - still needs a lot of work before I'd 
promote it to the library). We can always split the docs out later (the 
hard part is writing them!).
Sean

On Apr 5, 2005, at 1:08 AM, Ralph Thomas wrote:

> Hi list,
>
>   I've started work on documenting the ui-core API. The rest of the
> ASL documentation is done using external doxygen files. I'd much
> rather use inline doxygen, because I think this is easier to maintain
> (as I'm more likely to remember to update the documentation when I
> change an API if the documentation is at the same place), and because
> I don't like to switch between my text editor and a documentation
> viewer.
>
> What are your opinions?
>
> Thanks,
>   Ralph
>
> PS: The dox files in documentation/concepts have the wrong copyright 
> notice on.
>
>
> -------------------------------------------------------
> SF email is sponsored by - The IT Product Guide
> Read honest & candid reviews on hundreds of IT Products from real 
> users.
> Discover which products truly live up to the hype. Start reading now.
> http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
> _______________________________________________
> Adobe-source-devel mailing list
> Ado...@li...
> https://lists.sourceforge.net/lists/listinfo/adobe-source-devel