Re: tweaking installkernel

[YONETANI Tomokazu <qhwt+dragonfly-submit@xxxxxxxxxx>]

On Sat, Aug 07, 2004 at 10:11:23AM -0700, Matthew Dillon wrote:
>     Hmm.  Well, I like the directory creation part but I do not want to
>     move the manual pages out of the context of their related module build.

Matt, manpages under /sys are as follows:
  boot/common/loader.8
  boot/forth/loader.4th.8
  boot/forth/loader.conf.5
  boot/i386/pxeldr/pxeboot.8
  dev/misc/joy/joy.8
  emulation/ibcs2/ibcs2.8
  emulation/linux/linux.8
  emulation/svr4/svr4.8
  net/ef/ef.4

and my patch doesn't touch anything under /sys/boot because it's built
as part of buildworld and not related to installkernel. joy.8, ibcs2.8,
linux.8, and svr4.8 correspond to the wrapper scripts in the same directory.

As for ef.4, it's sensitive to NOMAN=true, and adding NOMAN=true to
installkernel can work around the problem. But ef.4 is the only section 4
manual page that gets installed during installkernel and other section 4
manual pages are already under share/man/man4 . IOW most of manpages under
/sys is already "out of the context of their related module build."

And if we can scrap the kldload wrappers, the four man pages are not needed.
Some of them pretend to be manpages for the emulator modules themselves,
but they're not, and description is very simple. If we need manpages for
emulation modules, we probably want to roll our own.

And manpages for these wrapper scripts are more than just useless. Take
joy(8) for example. If you run `man joy' it displays man page for the wrapper
script, whose only job is to do `kldload joy'. If you want to read
joy(4) (which is way more descriptive) you have to run `man 4 joy'
because of the default search order of sections.