NetBSD-Docs archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

man0/Makefile, mkman, and generating document



I am generating documents containing our manpages.

src/share/man/man0/Makefile can create them. But mkman (in same directory) 
builds list of files that aren't really included:

Here are some for just man1.

Please review. Maybe I missed some. Maybe they are correct and are 
installed in base system. Or maybe we shouldn't have in source. Please 
share your comments. A noman file is available there to list files not 
wanted. But the following is a long list.

(Just to be clear: I don't think I want the following list of man pages 
printed in the book.)

../../../gnu/dist/autoconf/man/autoconf.1
../../../gnu/dist/autoconf/man/autoheader.1
../../../gnu/dist/autoconf/man/autoreconf.1
../../../gnu/dist/autoconf/man/autoscan.1
../../../gnu/dist/autoconf/man/autoupdate.1
../../../gnu/dist/autoconf/man/config.guess.1
../../../gnu/dist/autoconf/man/config.sub.1
../../../gnu/dist/autoconf/man/ifnames.1

../../../dist/libarchive/tar/bsdtar.1
../../../dist/libarchive/cpio/bsdcpio.1

../../../dist/bzip2/bzdiff.1
../../../dist/bzip2/bzgrep.1

../../../external/bsd/pcc/dist/pcc/cc/ccom/ccom.1

../../../crypto/dist/heimdal/kuser/copy_cred_cache.1
../../../crypto/dist/heimdal/appl/kf/kf.1
../../../crypto/dist/heimdal/kuser/kimpersonate.1
../../../crypto/dist/heimdal/tools/krb5-config.1
../../../crypto/dist/heimdal/appl/otp/otp.1
../../../crypto/dist/heimdal/appl/otp/otpprint.1
../../../crypto/dist/heimdal/appl/afsutil/pagsh.1
../../../crypto/dist/heimdal/appl/push/pfrom.1
../../../crypto/dist/heimdal/appl/kx/rxtelnet.1
../../../crypto/dist/heimdal/appl/kx/rxterm.1
../../../crypto/dist/heimdal/appl/kx/tenletxr.1  (sic?)
../../../crypto/dist/heimdal/appl/xnlock/xnlock.1

../../../gnu/dist/binutils/binutils/doc/dlltool.1
../../../gnu/dist/binutils/binutils/doc/nlmconv.1
../../../gnu/dist/binutils/binutils/doc/windres.1

../../../gnu/dist/gettext/gettext-runtime/man/envsubst.1
../../../gnu/dist/gettext/gettext-tools/man/gettextize.1
../../../gnu/dist/gettext/gettext-tools/man/msgfilter.1
../../../gnu/dist/gettext/gettext-tools/man/msggrep.1

../../../gnu/dist/gdb6/gdb/gdbserver/gdbserver.1

../../../dist/bind/contrib/idn/idnkit-1.0-src/tools/idnconv/idnconv.1
../../../dist/bind/contrib/query-loc-0.4.0/query-loc.1
../../../dist/bind/contrib/queryperf/input/sample.1

../../../dist/ntp/ntpd/ntpdsim.1

../../../gnu/dist/postfix/man/man1/qmqp-sink.1
../../../gnu/dist/postfix/man/man1/qmqp-source.1
../../../gnu/dist/postfix/man/man1/qshape.1
../../../gnu/dist/postfix/man/man1/smtp-sink.1
../../../gnu/dist/postfix/man/man1/smtp-source.1

../../../dist/smbfs/smbutil/smbutil.1


src/share/man/man0/noman can list for grep -v

Also I see in two places:

man1:../../../dist/wpa/hostapd/hostapd_cli.1
man8:../../../usr.sbin/wpa/hostapd_cli/hostapd_cli.8

man1:../../../dist/ntp/ntpd/ntpd.1
man8:../../../usr.sbin/ntp/ntpd/ntpd.8
man1:../../../dist/ntp/ntpdc/ntpdc.1
man8:../../../usr.sbin/ntp/ntpdc/ntpdc.8
man1:../../../dist/ntp/ntpq/ntpq.1
man8:../../../usr.sbin/ntp/ntpq/ntpq.8


Also make sure nslookup is in 1 not 8

And missing:

postsuper.1
src/gnu/dist/postfix/man/man1/postsuper.1
(I don't know why was missing from mkman work.)


By the way, should a book of manpages have a page for duplicate webpages?
like:
clear(1) see tput(1)
cu(1) see tip(1)
entire page that only has that?

I don't think I want to duplicate. 4.4BSD SMM didn't appear to have the 
duplicates, but you could find in the list of man pages at front.


Now above is for man1 -- but I plan to do man8 first -- so I may be 
posting an email about it too ...


Home | Main Index | Thread Index | Old Index