kernel-doc -man -e confusion

Randy Dunlap <[email protected]>
Newsgroups org.kernel.vger.linux-doc
Message-ID <[email protected]>
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
ibmadexp.man (application/x-troff-man, 14.5 KB) - not displayed
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.