On Wed, Sep 26, 2018 at 01:19:20PM -0700, Junio C Hamano wrote: > > /** > > Would we be open to consider another commenting style? > > No. You still cannot write */ in that comment section, for example, > so you cannot do "plain text" still---that is not a great trade off > to deviate from the common comment style used for other stuff. We can do: #if HEADER_DOC Write anything here except #endif! #endif /* HEADER_DOC */ But I actually think that is more jarring than a big comment (when I am reading C code, I expect to see C-like things mostly. I do agree with you that a true plain text file is nicer in terms of freedom to format, etc. But IMHO the tradeoff is easily worth it to keep the related content (function declarations and their documentation) close together. -Peff
