Hi James,
ie why we use do...while(0) loops in SERVER_START_REQ
This is a fairly common idiom in C macros. See here for an explanation: http://www.everything2.com/index.pl?node_id=1180050
Because it's a common trick, I'm not sure it's worth explaining. Describing at a high level what SERVER_START_REQ and SERVER_END_REQ do for the macro-phobic might be useful though.
As far as documenting the server API, again I agree with you: it's a worthwhile task. There's even a todo list item for it assigned to Alexandre.. but I wouldn't hold my breath for him to provide something parseable by newbies. If you're starting to understand it, maybe writing it down would be a good idea.
--Juan
__________________________________ Do you Yahoo!? Yahoo! Small Business - Try our new resources site! http://smallbusiness.yahoo.com/resources/
Juan Lang juan_lang@yahoo.com writes:
As far as documenting the server API, again I agree with you: it's a worthwhile task. There's even a todo list item for it assigned to Alexandre.. but I wouldn't hold my breath for him to provide something parseable by newbies.
protocol.def itself is the documentation of the protocol, there is no need for more. It's pretty much self-explaining anyway, and people who can't figure it out by reading the code have no business messing around with the server protocol. Consider it as the entrance exam for server hacking ;-)
-
Alexandre Julliard -
Juan Lang