On Wed, Apr 13, 2022 at 03:29:30PM +0530, Vinod Koul wrote: > On 13-04-22, 11:53, Jules Maselbas wrote: > > On Wed, Apr 13, 2022 at 11:32:23AM +0530, Vinod Koul wrote: > > > On 07-04-22, 12:21, Jules Maselbas wrote: > > > > Update the syntax used by the documentation of phy operation functions. > > > > This is to unify the syntax with the newly added documentation. > > > > > > Is there any reason for using this sytax, is it documented somewhere..? > > > How does this syntax help? > > > > I don't have any particular reason for this syntax, this syntax have been > > suggested by Randy Dunlap. > > Is this documented somewhere? Yes this is documented in Documentation/doc-guide/kernel-doc.rst: ``%CONST`` Name of a constant. (No cross-referencing, just formatting.) My understanding is that this formating should be used for the constant NULL and not for literal values, such as 0. What you do think? Should I revert to using a straight 0 in the return value doc? -- Jules
