Yet another kernel-doc parsing issue

Lukas Bulwahn lukas.bulwahn at gmail.com
Fri Feb 26 10:21:47 UTC 2021


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


More information about the Linux-kernel-mentees mailing list