Yet another kernel-doc parsing issue

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Aditya,

here is another example of expressions that kernel-doc cannot properly parse:

include/rdma/ib_cm.h:571: warning: cannot understand function
prototype: 'const char *__attribute_const__ ibcm_reject_msg(int
reason); '
include/rdma/iw_cm.h:224: warning: cannot understand function
prototype: 'const char *__attribute_const__ iwcm_reject_msg(int
reason); '
include/rdma/rdma_cm.h:348: warning: cannot understand function
prototype: 'const char *__attribute_const__ rdma_reject_msg(struct
rdma_cm_id *id,                                                 int
reason); '

It is probably easy to extend the current patterns of attributes in
kernel-doc by just __attribute_const__, but that is of course only a
quick hotfix for kernel-doc. You can start with that.

But maybe you can come up with a better general solution? I see that
there are multiple tools in the kernel that need to maintain a list of
attributes for their internal C parsers, maybe you find a way to
refactor them that they share a common file for recording the valid
and supported attributes.


Best regards,

Lukas



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux