]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/commit - scripts/kernel-doc
kernel-doc: add support for specifying extra files for EXPORT_SYMBOLs
authorJani Nikula <jani.nikula@intel.com>
Tue, 7 Jun 2016 08:00:52 +0000 (11:00 +0300)
committerJani Nikula <jani.nikula@intel.com>
Fri, 10 Jun 2016 08:29:19 +0000 (11:29 +0300)
commit88c2b57da4ce3c8b5f849dc5356bdea9e2ed1134
tree11abd7211827f7a473ce07549ccf859933f75419
parent1ad560e43c911e19751df65dd2af21341d02eac5
kernel-doc: add support for specifying extra files for EXPORT_SYMBOLs

If the kernel-doc comments for functions are not in the same file as the
EXPORT_SYMBOL statements, the -export and -internal output selections do
not work as expected. This is typically the case when the kernel-doc
comments are in header files next to the function declarations and the
EXPORT_SYMBOL statements are next to the function definitions in the
source files.

Let the user specify additional source files in which to look for the
EXPORT_SYMBOLs using the new -export-file FILE option, which may be
given multiple times.

The pathological example for this is include/net/mac80211.h, which has
all the kernel-doc documentation for the exported functions defined in a
plethora of source files net/mac80211/*.c.

Signed-off-by: Jani Nikula <jani.nikula@intel.com>
scripts/kernel-doc