[lkml]   [2014]   [Jun]   [30]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
SubjectRe: [PATCH] scripts/kernel-doc: handle object-like macros
On 6/29/2014 5:52 AM, Randy Dunlap wrote:
> On 06/23/14 05:15, Horia Geanta wrote:
>> Object-like macros are different than function-like macros:
>> They are not parsed correctly, generating invalid intermediate
>> files (xmls) for cases like:
>> #define BIT_MASK (0xFF << BIT_SHIFT)
>> where "OxFF <<" is considered to be parameter type.
>> When parsing, we can differentiate beween these two types of macros by


>> checking whether there is at least one whitespace b/w "#define" and
>> first opening paranthesis.
> parenthesis.

Thanks, I'll fix both typos in v2.

> Where did you see a problem? I tested the patch and all of the
> Documentation/DocBook/*.xml files are the same without or with the patch.

Indeed, right now there is no kernel-doc for "object-like" macros in

I am preparing documentation for not-yet-upstreamed code in
drivers/crypto/caam and I thought it would be useful to use kernel-doc
for some of the #defines.

Doc would look like this (no @param list, no "Return" section, only a

* DEFAULT_SEC_ERA - the default value for the SEC era in case the user
* provides an unsupported value.


 \ /
  Last update: 2014-06-30 16:21    [W:0.070 / U:20.752 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site