On Fri, Apr 26, 2019 at 02:00:18PM -0700, Sean Christopherson wrote: > On Thu, Apr 25, 2019 at 04:31:40PM -0700, Xing, Cedric wrote: > > > While this may format nicely in .rst (I haven't checked), it's damn near > > > unreadable in its raw form. Escaping '%' in kernel-doc is unresolved at > > > this point, but this definitely is an argument for allowing the %CONST > > > interpretation to be disabled entirely. > > > > > > > I know very little about kernel-doc. Not quite sure which markup means what. > > Or if you don't mind, could you just write up the whole thing (you have > > written half of it in your email already) so I can include it into my next > > revision? > > Hmm, at this point I'd say just ignore the comment entirely. It's > something we need to sort out in the "official" series anyways. To get started: https://www.kernel.org/doc/Documentation/kernel-doc-nano-HOWTO.txt /Jarkko