[Xcb] Some autogenerated docs questions...

[Vincent Torri]

On Wed, 23 Jun 2010, Josh Triplett wrote:

> On Wed, Jun 23, 2010 at 08:42:02PM -0700, Jamey Sharp wrote:
>> On Tue, Jun 22, 2010 at 2:33 PM, Ulrich Eckhardt <doomster at knuut.de> wrote:
>>> Third thing is the include guards. These are currently like "__RES_H". In this
>>> case, the name is unfortunately generic. Further, any macro or identifier
>>> containing two consecutive underscores is reserved to the compiler. I'd use
>>> something starting with XCB, like XCB_<name>_HEADER_INCLUDE_GUARD. This is
>>> long enough to make any collisions very unlikely and more portable.
>>
>> We discussed this recently on the list, and consensus was that yeah,
>> somebody should fix that. Perhaps that somebody is you?
>
> I wouldn't suggest going as verbose as _HEADER_INCLUDE_GUARD; XCB_RES_H
> or similar should probably suffice.  (The bikeshed should be *blue*,
> darnit. :) )

Jeremy Kolb and myself gave several suggestions about that xml doc some 
years ago.

look at the ML around october/november 2006, january 2007, december 2007, 
etc... without much feedback. Look especially the proposal of the 
sync.html proposal

Vincent