On 14 December 2011 16:55, Anthony Liguori <anth...@codemonkey.ws> wrote: > I think in this case, we're just going to have to deviate from the standard. > The benefit is great, the practice is widespread, and there's no immediate > likelihood of changing glib's coding style practices. > > I still think we should adhere to this policy where ever possible but I > think we'll have to make an exception for extracting documentation.
Disagree. A docs tool that requires us to change our coding/naming conventions (as opposed to merely how we mark stuff up in comments or whatever) is a broken tool. Doubly so if it mandates violation of the C standards. We want to be able to document the structs/whatever we have now, not only after we've done some enormous change to every struct we have to bring it into line with somebody else's conventions. -- PMM