From owner-freebsd-doc@FreeBSD.ORG Tue Aug 26 15:21:15 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A0F9916A4C1; Tue, 26 Aug 2003 15:21:15 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 83A5943FF3; Tue, 26 Aug 2003 15:21:03 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 4F6ED10BF8C; Wed, 27 Aug 2003 00:21:02 +0200 (CEST) Date: Wed, 27 Aug 2003 00:21:02 +0200 From: "Simon L. Nielsen" To: Pawel Jakub Dawidek Message-ID: <20030826222101.GD2363@FreeBSD.org> 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> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="jL2BoiuKMElzg3CS" Content-Disposition: inline In-Reply-To: <20030826174734.GJ47959@garage.freebsd.pl> User-Agent: Mutt/1.5.4i cc: Tom Rhodes cc: freebsd-doc@FreeBSD.org Subject: Re: bsd.kmod.mk and manual pages. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 26 Aug 2003 22:21:15 -0000 --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--