Date: Wed, 27 Aug 2003 00:21:02 +0200 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: Pawel Jakub Dawidek <nick@garage.freebsd.pl> Cc: freebsd-doc@FreeBSD.org Subject: Re: bsd.kmod.mk and manual pages. Message-ID: <20030826222101.GD2363@FreeBSD.org> In-Reply-To: <20030826174734.GJ47959@garage.freebsd.pl> References: <20030826082220.GG47959@garage.freebsd.pl> <20030826105621.31c83b95.trhodes@FreeBSD.org> <20030826155417.GI47959@garage.freebsd.pl> <20030826160202.GF403@FreeBSD.org> <20030826174734.GJ47959@garage.freebsd.pl>
next in thread | previous in thread | raw e-mail | index | archive | help
--jL2BoiuKMElzg3CS Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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? >=20 > Yes, but in base system are also modules that screams for this > functionality:) > Here is the list of Makefiles for modules that use variable 'NOMAN': [CUT] 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: >=20 > /sys/modules/netgraph/bluetooth/bluetooth/Makefile > /sys/modules/netgraph/bluetooth/bt3c/Makefile > /sys/modules/netgraph/bluetooth/h4/Makefile > /sys/modules/netgraph/bluetooth/hci/Makefile > /sys/modules/netgraph/bluetooth/l2cap/Makefile > /sys/modules/netgraph/bluetooth/socket/Makefile > /sys/modules/netgraph/bluetooth/ubt/Makefile > /sys/modules/netgraph/bluetooth/ubtbcmfw/Makefile 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. --=20 Simon L. Nielsen FreeBSD Documentation Team --jL2BoiuKMElzg3CS Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQE/S91Nh9pcDSc1mlERAhrcAJ46X+cw6UO9g5za8O1GhwGD0yZGUACfVp/n dJZm6y7ScxI8E2fyoSbrHZI= =TvDl -----END PGP SIGNATURE----- --jL2BoiuKMElzg3CS--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030826222101.GD2363>