[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [MiNT] Bit-Depth and Graphics stuff....



On 07/17/2010 04:47 AM, Paul Wratt wrote:

> On API proposals, I hark back to the use of wiki in making them
> available in a permanent form (as opposed to the list or a text file),

A wiki is a poor tool for this. API docs (even for unimplemented stuff)
belongs in the source of the AES itself (or perhaps in the bindings, but
ideally the bindings should be automatically created from the source
too), so it can easily be extracted during the build process. It's the
only way to make sure that the docs are up to date. Keeping docs and
sources separate means that the docs simply won't be updated - this is
how programmers work ;-)

Jo Even