I think adding a thread like php.net is nice too. I find a lot of neat snippets and such in the php.net threads, and that could be really neat here on a.cc.
The PHP manual is full of crap, ten year old comments that were bogus to begin with.
Any chance you'll fix the bug with multiple functions with a single doc entry?
No. First off, if someone cannot tell what getr24() does, he shouldn't even own a compiler. The Allegro documentation is written in a haphazard format. There's no way to tell, other than by (probably a safe) assumption, that 10 functions are grouped together. Even if I were to copy the description to each function, it'd end up like:
Given a color in the format being used by the specified color depth, these functions extract one of the red, green, blue, or alpha components (ranging 0-255).
and then the same people who are confused about getr24 would now be confused about why functions is plural and that it says it extracts one of those four things.
The real solution is to edit the allegro._tx and include an individual description for each function like:
getr - extracts the red component
getb - extracts the blue component
And that, anyone can do.
Could you maybe give me the SQL dump of the documentation, so I can import it into my IRC bot?
Most of it is just in flat html files. Attached is an XML conversion of the allegro._tx file. It should be a billion infinities easier to work with than the original mess.