> I agree on both counts. I just like to read these in plain text
> while I am coding for Git (or reviewing patches coded for Git).
>
> The reason why I have mild preference to D/technical/ over in-header
> doc is only because I find even these asterisks at the left-side-end
> distracting; it is not that materials in D/technical could be passed
> through AsciiDoc.
/**
Would we be open to consider another commenting style?
AFAICT the asterisks are a cultural thing and not enforced by
and old compiler not understanding these comments.
Just like ending the comment in an asymetric fashion ;-) */
(I am not seriously proposing unbalanced comments, but for
longer documenting comments we may want to consider,
omitting the asterisk?)