kernel-doc -man -e confusion

kernel-doc -man -e confusion

[Randy Dunlap]

[-- Attachment #1: Type: text/plain, Size: 807 bytes --]

Hi Mauro,

(testing with linux-next-20260807:)

When I run
$ ./scripts/kernel-doc -man -e include/rdma/ib_mad.h
(this header file has no exported symbols),

it appears that kdoc_output.py::out_tail() is called for
each non-exported symbol. This looks extraneous to me.

Can you fix this so that out_tail() isn't called for the
non-exported symbols?

Secondary comment: I save the kernel-doc -man output to
ibmadexp.man and then run
$ man ./ibmadexp.man
(which is attached)

where I see the out_tail() output, **except** that the
SEE ALSO: line isn't printed (displayed) by the man command.
Is there a problem with the generated line
.SH "SEE ALSO"
?
Maybe it needs a blank line before it or some other kind of
formatting assistance or something around it is confusing the
'man' command?

thanks.
-- 
~Randy

[-- Attachment #2: ibmadexp.man --]
[-- Type: application/x-troff-man, Size: 14822 bytes --]