Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 26 Aug 2003 18:02: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:  <20030826160202.GF403@FreeBSD.org>
In-Reply-To: <20030826155417.GI47959@garage.freebsd.pl>
References:  <20030826082220.GG47959@garage.freebsd.pl> <20030826105621.31c83b95.trhodes@FreeBSD.org> <20030826155417.GI47959@garage.freebsd.pl>

index | next in thread | previous in thread | raw e-mail

[-- Attachment #1 --]
On 2003.08.26 17:54:17 +0200, Pawel Jakub Dawidek wrote:
> On Tue, Aug 26, 2003 at 10:56:21AM -0400, Tom Rhodes wrote:
> +> Usually driver manual pages are added to section four, and then
> +> they are built with the Makefile from that location.
> +> 
> +> Or did I misinterpret your question?
> 
> I want to create Makefile for kernel module:
> 
> ---[ Makefile start ]---
> KMOD=	foo
> SRCS=	foo.c
> MAN=	foo.4
> 
> .include <bsd.kmod.mk>
> ---[ Makefile end ]---
> 
> As you can see, manual page is in the same directory, but bsd.kmod.mk
> ignores 'MAN' variable, so manual page isn't gziped on 'make' nor
> installed on 'make install'.
> 
> For example bsd.prog.mk know how to handle 'MAN' variable.
> 
> So my question is: Is there some clean way to prepare Makefile which will
> handle module with manual page?

I actually don't think so.  From a quick check it does not appear that
bsd.kmod.mk includes bsd.man.mk (which handles all the manual page
related things).

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?

You might want to ask on -hackers, since this is more of a buildsystem
problem, than documentation problem (and I don't think most of the
buildsystem guys are on -doc).

-- 
Simon L. Nielsen
FreeBSD Documentation Team

[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (FreeBSD)

iD8DBQE/S4R6h9pcDSc1mlERAoHLAKCKqsHZhAkRziVNrdU2Fzqc8iS+zACdFdsA
p2lRcVA0y6YfAWiIcKs2Cmc=
=RFXL
-----END PGP SIGNATURE-----
help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030826160202.GF403>