bsd.kmod.mk and manual pages.
Simon L. Nielsen
simon at FreeBSD.org
Tue Aug 26 22:21:15 UTC 2003
On 2003.08.26 19:47:34 +0200, Pawel Jakub Dawidek wrote:
> On Tue, Aug 26, 2003 at 06:02:02PM +0200, Simon L. Nielsen wrote:
> +> Normally in FreeBSD all the kernel manual pages are located under
> +> src/share/man/man?/ . I assume the reason you want to include the
> +> manual page with the module, is because it's a 3rd party module which
> +> are not being distriubted as part of FreeBSD?
> Yes, but in base system are also modules that screams for this
> Here is the list of Makefiles for modules that use variable 'NOMAN':
Well, I have a feeling that it's not that lack of build intrastructure
that keeps peple from writing manual pages for those devices. In any
case that shouldn't stop people :-).
> And those use 'MAN4' variable:
Hmm... Bluetooth was developed outside the FreeBSD tree, so it might
just be there because the author didn't now how to handle the manual
pages... I just did a quick check and I couldn't find the actual files
for the manual pages anywhere.
I think an important reason that the manual pages aren't in the sys/
part of the tree, is that they need to be build by the buildworld stage,
not buildkernel. If the manual pages were located under sys/ it would
give problems determining when to build/install them.
Not that any of this helps you :-). You could look into how some of the
third party kernel modules that are in ports are handled.
Simon L. Nielsen
FreeBSD Documentation Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Size: 187 bytes
Desc: not available
More information about the freebsd-doc