man -> mdoc

["James K. Lowden" <jklowden%schemamania.org@localhost>]

How desirable is it to convert the remaining 969 man pages in the
tree that use -man to use mdoc macros instead?  

man macros: 
$ find . -name '*.[1-9]' -exec grep -l '^\.SH' {} + | wc -l
     969
$ find . -name '*.[1-9]' -exec grep -l '^\.SH' {} + \
  | while read F; do dirname $F; done | uniq | wc -l
     146

mdoc macros: 
$ find . -name '*.[1-9]' -exec grep -l '^\.Nm' {} + | wc -l
    3373
$ find . -name '*.[1-9]' -exec grep -l '^\.Nm' {} + 
  | while read F; do dirname $F; done | uniq | wc -l
     928

(YMMV.  My tree is old and there are pages out there with odd
extensions.)  

ISTM some tedious string slinging with e.g. Perl might bring these pages
into the modern era, thereby facilitating indexing etc.  

Many of them are imported, and in most cases I doubt the upstream would
regard mdoc as progress.  Even so, I count some 49 that appear to be
native sons of NetBSD.  

Attached is a small summary that counts the -man files by directory for
your perusal.  

--jkl

   1 ./bin/csh/USD.doc
   1 ./common/dist/zlib
 335 ./crypto/external/bsd/openssl/lib/libcrypto/man
   2 ./crypto/external/bsd/openssl/lib/libdes
   3 ./dist/bzip2
   4 ./dist/dhcp/client
   2 ./dist/dhcp/common
   1 ./dist/dhcp/dhcpctl
   6 ./dist/dhcp/doc/ja_JP.eucJP
   1 ./dist/dhcp/omapip
   1 ./dist/dhcp/relay
   3 ./dist/dhcp/server
   4 ./dist/ipf/ipsend
  19 ./dist/ipf/man
   1 ./dist/nvi/docs/vi.man
   2 ./dist/nvi/regex
   1 ./dist/pppd/chat
   1 ./dist/pppd/pppd
   1 ./dist/pppd/pppdump
   1 ./dist/pppd/pppstats
   2 ./external/bsd/am-utils/dist/amd
   2 ./external/bsd/am-utils/dist/amq
   1 ./external/bsd/am-utils/dist/fixmount
   1 ./external/bsd/am-utils/dist/fsinfo
   1 ./external/bsd/am-utils/dist/hlfsd
   1 ./external/bsd/am-utils/dist/mk-amd-map
   3 ./external/bsd/am-utils/dist/scripts
   1 ./external/bsd/am-utils/dist/wire-test
   2 ./external/bsd/bind/dist/bin/check
   2 ./external/bsd/bind/dist/bin/confgen
   3 ./external/bsd/bind/dist/bin/dig
   6 ./external/bsd/bind/dist/bin/dnssec
   3 ./external/bsd/bind/dist/bin/named
   1 ./external/bsd/bind/dist/bin/nsupdate
   3 ./external/bsd/bind/dist/bin/pkcs11
   2 ./external/bsd/bind/dist/bin/rndc
   5 ./external/bsd/bind/dist/bin/tools
  17 ./external/bsd/bind/dist/lib/lwres/man
   1 ./external/bsd/bind/dist
   1 ./external/bsd/bind/dist/contrib/idn/idnkit-1.0-src/tools/idnconv
   1 ./external/bsd/bind/dist/contrib/idn/idnkit-1.0-src/tools/runidn
   1 ./external/bsd/bind/dist/contrib/nslint-2.1a3
   1 ./external/bsd/bind/dist/contrib/query-loc-0.4.0
   1 ./external/bsd/bind/dist/contrib/sdb/ldap
   5 ./external/bsd/bind/dist/contrib/zkt/man
   1 ./external/bsd/byacc/dist
   1 ./external/bsd/flex/bin
   1 ./external/bsd/flex/dist/doc
   3 ./external/bsd/less/dist
   1 ./external/bsd/libbind/dist/doc
   1 ./external/bsd/libpcap/dist
   1 ./external/bsd/ntp/dist/ElectricFence
   1 ./external/bsd/ntp/dist/arlib
   1 ./external/bsd/ntp/dist/ntpd
   1 ./external/bsd/ntp/dist/ntpdc
   1 ./external/bsd/ntp/dist/ntpq
   1 ./external/bsd/ntp/dist/ntpsnmpd
   1 ./external/bsd/ntp/dist/sntp
   2 ./external/bsd/ntp/dist/util
   1 ./external/bsd/openldap/dist/contrib/slapd-modules/allop
   1 ./external/bsd/openldap/dist/contrib/slapd-modules/cloak
   1 ./external/bsd/openldap/dist/contrib/slapd-modules/lastmod
   1 ./external/bsd/openldap/dist/contrib/slapd-modules/nops
   1 ./external/bsd/openldap/dist/contrib/slapd-modules/nssov
   9 ./external/bsd/openldap/dist/doc/man/man1
  37 ./external/bsd/openldap/dist/doc/man/man3
  43 ./external/bsd/openldap/dist/doc/man/man5
  10 ./external/bsd/openldap/dist/doc/man/man8
  99 ./external/bsd/openldap/man
   1 ./external/bsd/pcc/dist/pcc/f77/f77
   2 ./external/bsd/wpa/dist/hostapd
   7 ./external/bsd/wpa/dist/wpa_supplicant/doc/docbook
   1 ./external/cddl/osnet/dist/cmd/dtrace
   1 ./external/cddl/osnet/sbin/zfs
   1 ./external/cddl/osnet/sbin/zpool
   1 ./external/cddl/osnet/usr.sbin/zdb
  47 ./external/gpl2/lvm2/dist/man
   1 ./external/gpl2/lvm2/dist/scripts/lvm2create_initrd
   1 ./external/gpl2/xcvs/dist/doc
   2 ./external/gpl2/xcvs/dist/man
  15 ./external/gpl3/binutils/dist/binutils/doc
   1 ./external/gpl3/binutils/dist/gas/doc
   1 ./external/gpl3/binutils/dist/gprof
   1 ./external/gpl3/binutils/dist/ld
  17 ./external/gpl3/gcc/dist/gcc/doc
   1 ./external/gpl3/gcc/dist/libstdc++-v3/doc/doxygen
   1 ./external/gpl3/gcc/dist/zlib
   1 ./external/gpl3/gcc/usr.bin/cpp
   1 ./external/gpl3/gcc/usr.bin/g++
   1 ./external/gpl3/gcc/usr.bin/gcc
   1 ./external/gpl3/gcc/usr.bin/gcov
   1 ./external/gpl3/gdb/dist/gdb
   1 ./external/gpl3/gdb/dist/gdb/gdbserver
   2 ./external/gpl3/gdb/dist/readline/doc
   1 ./external/gpl3/gdb/dist/sim/common
   1 ./external/historical/nawk/dist
  18 ./external/ibm-public/postfix/dist/man/man1
  21 ./external/ibm-public/postfix/dist/man/man5
  26 ./external/ibm-public/postfix/dist/man/man8
   1 ./external/lgpl3/gmp/dist
   1 ./external/lgpl3/mpfr/dist
   2 ./external/mit/lua/dist/doc
   1 ./external/public-domain/xz/dist/src/lzmainfo
   1 ./external/public-domain/xz/dist/src/xz
   1 ./external/public-domain/xz/dist/src/xzdec
   8 ./gnu/dist/autoconf/man
   2 ./gnu/dist/bc/doc
   4 ./gnu/dist/diffutils/man
   1 ./gnu/dist/gcc4/libstdc++-v3/docs/doxygen
   1 ./gnu/dist/gdb6/gdb
   1 ./gnu/dist/gdb6/gdb/gdbserver
   2 ./gnu/dist/gdb6/readline/doc
   1 ./gnu/dist/gdb6/sim/common
   6 ./gnu/dist/gettext/gettext-runtime/man
  17 ./gnu/dist/gettext/gettext-tools/man
   1 ./gnu/dist/gmake
   1 ./gnu/dist/grep/doc
   1 ./gnu/dist/grep/src
   8 ./gnu/dist/texinfo/doc
   1 ./gnu/usr.bin/rcs/ci
   1 ./gnu/usr.bin/rcs/co
   1 ./gnu/usr.bin/rcs/ident
   1 ./gnu/usr.bin/rcs/merge
   3 ./gnu/usr.bin/rcs/rcs
   1 ./gnu/usr.bin/rcs/rcsclean
   1 ./gnu/usr.bin/rcs/rcsdiff
   1 ./gnu/usr.bin/rcs/rcsfreeze
   1 ./gnu/usr.bin/rcs/rcsmerge
   1 ./gnu/usr.bin/rcs/rlog
   1 ./lib/libc/time
  22 ./lib/libm/complex
   3 ./lib/libwrap
   1 ./share/doc/iso/wiscman
   1 ./share/me
   1 ./usr.bin/lex
   2 ./usr.sbin/bootp/bootpd
   1 ./usr.sbin/bootp/bootpef
   1 ./usr.sbin/bootp/bootptest
   1 ./usr.sbin/map-mbone
   1 ./usr.sbin/mrinfo
   1 ./usr.sbin/mtrace
   1 ./usr.sbin/rpc.pcnfsd
   2 ./usr.sbin/sup/source
   1 ./usr.sbin/tcpdchk
   1 ./usr.sbin/tcpdmatch
   1 ./usr.sbin/traceroute