Yet another kernel-doc parsing issue

From: Lukas Bulwahn <lukas.bulwahn@gmail.com>
Date: 2021-02-26 10:22:59
Also in: linux-kernel-mentees

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
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help