From schweikh@ito.uni-stuttgart.de  Mon Feb 19 01:30:13 1996
Received: from ito.uni-stuttgart.de (hoesun.ito.uni-stuttgart.de [129.69.65.20])
          by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id BAA14137
          for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 Feb 1996 01:30:05 -0800 (PST)
Received: from itosun.ito.uni-stuttgart.de by ito.uni-stuttgart.de (5.x/SMI-SVR4/BelWue-2.0)
	id AA00649; Mon, 19 Feb 1996 10:29:27 +0100
Received: by itosun.ito.uni-stuttgart.de (5.x/SVR4/BelWue-1.0.3)
	id AA00782; Mon, 19 Feb 1996 10:29:22 +0100
Message-Id: <9602190929.AA00782@itosun.ito.uni-stuttgart.de>
Date: Mon, 19 Feb 1996 10:29:21 +0100 (MET)
From: schweikh@ito.uni-stuttgart.de (Jens Schweikhardt)
To: FreeBSD-gnats-submit@freebsd.org
Subject: lots of dead xrefs in manpages

>Number:         1036
>Category:       docs
>Synopsis:       List of dead xrefs in man pages
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    mpp
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 19 01:40:02 PST 1996
>Closed-Date:    Sat Dec 14 15:27:05 PST 1996
>Last-Modified:  Sat Dec 14 15:27:35 PST 1996
>Originator:     Jens Schweikhardt
>Release:        FreeBSD 2.1-STABLE i386
>Organization:
Uni Stuttgart
>Environment:

	2.1.0 Release

	[My email address expires in April 96]

>Description:

Many man pages have references to nonexisting man pages.
I have written a shell script to find these dead cross references.
Running it on /usr/share/man resulted in the following.
The format is three fields per line: the man page source file,
the command name, and the section it should be found in.
A reference to 'program(8)' is considered dead when 'man 8 program'
reports 'No entry for program in section 8 of the manual'.
I have included the script at the end, so you can compare what
dead references your system has. Man pages are a moving target, I know.

The dead xrefs can be categorized into
1) Case sensitivity problems:
	/usr/share/man/man2/sigvec.2.gz Execve 2
2) Invalid characters in .Xr macro problems:
	/usr/share/man/man3/glob.3.gz (Csh 1
3) Man page available but in another section:
	/usr/share/man/man4/cd.4.gz disklabel 1 (should be 8)
4) Man page unavailable
	/usr/share/man/man1/checknr.1.gz lint 1

>How-To-Repeat:

	See script at the end.

checking /usr/share/man...
/usr/share/man/man3/glob.3.gz (Csh 1
/usr/share/man/man3/globfree.3.gz (Csh 1
/usr/share/man/man1/window.1.gz (environ 5
/usr/share/man/man1/window.1.gz (pty 4
/usr/share/man/man1/window.1.gz (socketpair 4
/usr/share/man/man5/inetd.conf.5.gz Comsat 8
/usr/share/man/man8/inetd.8.gz Comsat 8
/usr/share/man/man1/window.1.gz Csh 1
/usr/share/man/man2/sigvec.2.gz Execve 2
/usr/share/man/man2/sigaction.2.gz Execve 2
/usr/share/man/man2/fcntl.2.gz Flock 2
/usr/share/man/man2/intro.2.gz Getdtablesize 2
/usr/share/man/man2/open.2.gz Getdtablesize 2
/usr/share/man/man2/errno.2.gz Getdtablesize 2
/usr/share/man/man2/nfssvc.2.gz Mount_nfs 8
/usr/share/man/man8/mount_null.8.gz Mount_null 8
/usr/share/man/man1/vacation.1.gz Sendmail 8
/usr/share/man/man2/socket.2.gz Setsockopt 2
/usr/share/man/man5/inetd.conf.5.gz Tftpd 8
/usr/share/man/man8/inetd.8.gz Tftpd 8
/usr/share/man/man8/route.8.gz XNSrouted 8
/usr/share/man/man8/routed.8.gz XNSrouted 8
/usr/share/man/man4/yp.4.gz Ypbind 8
/usr/share/man/man4/yp.4.gz Ypbind 8
/usr/share/man/man4/yp.4.gz Ypserv 8
/usr/share/man/man3/setjmp.3.gz abort 2
/usr/share/man/man3/_longjmp.3.gz abort 2
/usr/share/man/man3/_setjmp.3.gz abort 2
/usr/share/man/man3/longjmp.3.gz abort 2
/usr/share/man/man3/longjmperr.3.gz abort 2
/usr/share/man/man3/longjmperror.3.gz abort 2
/usr/share/man/man3/sigsetjmp.3.gz abort 2
/usr/share/man/man3/siglongjmp.3.gz abort 2
/usr/share/man/man1/hexdump.1.gz adb 1
/usr/share/man/man5/types.5.gz adb 1
/usr/share/man/man5/core.5.gz adb 1
/usr/share/man/man4/i386/ahc.4.gz aic7xxx_asm 1
/usr/share/man/man4/ahc.4.gz aic7xxx_asm 1
/usr/share/man/man5/ar.5.gz arcv 8
/usr/share/man/man8/boot_vax.8.gz arff 8
/usr/share/man/man8/telnetd.8.gz bftp 1
/usr/share/man/man8/telnetd.8.gz bftp 1
/usr/share/man/man8/sendmail.8.gz binmail 1
/usr/share/man/man3/vlimit.3.gz break 2
/usr/share/man/man1/error.1.gz ccom 1
/usr/share/man/man1/checknr.1.gz checkeq 1
/usr/share/man/man8/mtree.8.gz chown 1
/usr/share/man/man1/lpr.1.gz cifplot 1
/usr/share/man/man2/reboot.2.gz crash 8
/usr/share/man/man8/init.8.gz crash 8
/usr/share/man/man8/boot_sparc.8.gz crash 8
/usr/share/man/man8/makekey.8.gz crypt 1
/usr/share/man/man5/aliases.5.gz dbm 3
/usr/share/man/man5/aliases.5.gz dbm 3
/usr/share/man/man8/pwd_mkdb.8.gz dbm 3
/usr/share/man/man5/stab.5.gz dbx 1
/usr/share/man/man5/core.5.gz dbx 1
/usr/share/man/man5/a.out.5.gz dbx 5
/usr/share/man/man1/devmenu.1.gz dialog 3
/usr/share/man/man1/devmenu.1.gz dialog 3
/usr/share/man/man4/cd.4.gz disklabel 1
/usr/share/man/man4/cd.4.gz disklabel 1
/usr/share/man/man4/sd.4.gz disklabel 1
/usr/share/man/man4/sd.4.gz disklabel 1
/usr/share/man/man4/sd.4.gz disklabel 1
/usr/share/man/man4/sd.4.gz disklabel 1
/usr/share/man/man4/sd.4.gz dk 4
/usr/share/man/man4/sd.4.gz dk 4
/usr/share/man/man8/rdump.8.gz dump 5
/usr/share/man/man8/dump.8.gz dump 5
/usr/share/man/man8/restore.8.gz dumpdir 8
/usr/share/man/man8/rrestore.8.gz dumpdir 8
/usr/share/man/man8/dumpon.8.gz dumpon 2
/usr/share/man/man7/environ.7.gz edit 1
/usr/share/man/man4/nsip.4.gz en 4
/usr/share/man/man1/bg.1.gz ex 1
/usr/share/man/man1/csh.1.gz ex 1
/usr/share/man/man1/limit.1.gz ex 1
/usr/share/man/man1/alias.1.gz ex 1
/usr/share/man/man1/dirs.1.gz ex 1
/usr/share/man/man1/fg.1.gz ex 1
/usr/share/man/man1/foreach.1.gz ex 1
/usr/share/man/man1/history.1.gz ex 1
/usr/share/man/man1/jobs.1.gz ex 1
/usr/share/man/man1/popd.1.gz ex 1
/usr/share/man/man1/pushd.1.gz ex 1
/usr/share/man/man1/rehash.1.gz ex 1
/usr/share/man/man1/repeat.1.gz ex 1
/usr/share/man/man1/suspend.1.gz ex 1
/usr/share/man/man1/stop.1.gz ex 1
/usr/share/man/man1/source.1.gz ex 1
/usr/share/man/man1/ctags.1.gz ex 1
/usr/share/man/man1/ctags.1.gz ex 1
/usr/share/man/man1/ctags.1.gz ex 1
/usr/share/man/man1/error.1.gz ex 1
/usr/share/man/man1/fmt.1.gz ex 1
/usr/share/man/man1/mkstr.1.gz ex 1
/usr/share/man/man3/regcomp.3.gz ex 1
/usr/share/man/man3/regexec.3.gz ex 1
/usr/share/man/man3/regerror.3.gz ex 1
/usr/share/man/man3/re_comp.3.gz ex 1
/usr/share/man/man3/regexp.3.gz ex 1
/usr/share/man/man3/re_exec.3.gz ex 1
/usr/share/man/man3/regsub.3.gz ex 1
/usr/share/man/man3/tgoto.3.gz ex 1
/usr/share/man/man3/termcap.3.gz ex 1
/usr/share/man/man3/tgetent.3.gz ex 1
/usr/share/man/man3/tgetflag.3.gz ex 1
/usr/share/man/man3/tgetnum.3.gz ex 1
/usr/share/man/man3/tgetstr.3.gz ex 1
/usr/share/man/man3/tputs.3.gz ex 1
/usr/share/man/man3/tparm.3.gz ex 1
/usr/share/man/man5/termcap.5.gz ex 1
/usr/share/man/man5/vgrindefs.5.gz ex 1
/usr/share/man/man7/environ.7.gz ex 1
/usr/share/man/man7/environ.7.gz ex 1
/usr/share/man/man7/hier.7.gz ex 1
/usr/share/man/man1/ps.1.gz exec 2
/usr/share/man/man2/mmap.2.gz exec 2
/usr/share/man/man3/sysctl.3.gz exec 2
/usr/share/man/man3/sysconf.3.gz exec 2
/usr/share/man/man2/fcntl.2.gz execv 2
/usr/share/man/man1/gprof.1.gz exit 2
/usr/share/man/man2/execve.2.gz exit 2
/usr/share/man/man2/vfork.2.gz exit 2
/usr/share/man/man2/wait.2.gz exit 2
/usr/share/man/man2/wait.2.gz exit 2
/usr/share/man/man2/wait.2.gz exit 2
/usr/share/man/man2/wait3.2.gz exit 2
/usr/share/man/man2/wait3.2.gz exit 2
/usr/share/man/man2/wait3.2.gz exit 2
/usr/share/man/man2/wait4.2.gz exit 2
/usr/share/man/man2/wait4.2.gz exit 2
/usr/share/man/man2/wait4.2.gz exit 2
/usr/share/man/man2/waitpid.2.gz exit 2
/usr/share/man/man2/waitpid.2.gz exit 2
/usr/share/man/man2/waitpid.2.gz exit 2
/usr/share/man/man3/err.3.gz exit 2
/usr/share/man/man3/abort.3.gz exit 2
/usr/share/man/man3/verr.3.gz exit 2
/usr/share/man/man3/errx.3.gz exit 2
/usr/share/man/man3/verrx.3.gz exit 2
/usr/share/man/man3/warn.3.gz exit 2
/usr/share/man/man3/vwarn.3.gz exit 2
/usr/share/man/man3/warnx.3.gz exit 2
/usr/share/man/man3/vwarnx.3.gz exit 2
/usr/share/man/man3/regcomp.3.gz exit 2
/usr/share/man/man3/regexec.3.gz exit 2
/usr/share/man/man3/regerror.3.gz exit 2
/usr/share/man/man3/regexp.3.gz exit 2
/usr/share/man/man3/regsub.3.gz exit 2
/usr/share/man/man1/error.1.gz f77 1
/usr/share/man/man1/gprof.1.gz f77 1
/usr/share/man/man3/getcap.3.gz fclose 2
/usr/share/man/man3/cgetcap.3.gz fclose 2
/usr/share/man/man3/cgetclose.3.gz fclose 2
/usr/share/man/man3/cgetent.3.gz fclose 2
/usr/share/man/man3/cgetfirst.3.gz fclose 2
/usr/share/man/man3/cgetmatch.3.gz fclose 2
/usr/share/man/man3/cgetnext.3.gz fclose 2
/usr/share/man/man3/cgetnum.3.gz fclose 2
/usr/share/man/man3/cgetset.3.gz fclose 2
/usr/share/man/man3/cgetstr.3.gz fclose 2
/usr/share/man/man3/cgetustr.3.gz fclose 2
/usr/share/man/man4/sd.4.gz fdisk 1
/usr/share/man/man4/sd.4.gz fdisk 1
/usr/share/man/man4/sd.4.gz fdisk 1
/usr/share/man/man3/getcap.3.gz fopen 2
/usr/share/man/man3/cgetcap.3.gz fopen 2
/usr/share/man/man3/cgetclose.3.gz fopen 2
/usr/share/man/man3/cgetent.3.gz fopen 2
/usr/share/man/man3/cgetfirst.3.gz fopen 2
/usr/share/man/man3/cgetmatch.3.gz fopen 2
/usr/share/man/man3/cgetnext.3.gz fopen 2
/usr/share/man/man3/cgetnum.3.gz fopen 2
/usr/share/man/man3/cgetset.3.gz fopen 2
/usr/share/man/man3/cgetstr.3.gz fopen 2
/usr/share/man/man3/cgetustr.3.gz fopen 2
/usr/share/man/man1/uuencode.1.gz format 5
/usr/share/man/man1/uudecode.1.gz format 5
/usr/share/man/man8/i386/bad144.8.gz format 8
/usr/share/man/man8/badsect.8.gz format 8
/usr/share/man/man8/mfs.8.gz format 8
/usr/share/man/man8/newfs.8.gz format 8
/usr/share/man/man8/mount_mfs.8.gz format 8
/usr/share/man/man8/bad144.8.gz format 8
/usr/share/man/man8/clri.8.gz fsdb 8
/usr/share/man/man4/i386/fdc.4.gz ft 1
/usr/share/man/man4/fdc.4.gz ft 1
/usr/share/man/man3/cuserid.3.gz geteuid 3
/usr/share/man/man2/getpid.2.gz gethostid 2
/usr/share/man/man2/getppid.2.gz gethostid 2
/usr/share/man/man1/hostname.1.gz gethostname 2
/usr/share/man/man3/rcmd.3.gz gethostname 2
/usr/share/man/man3/rresvport.3.gz gethostname 2
/usr/share/man/man3/iruserok.3.gz gethostname 2
/usr/share/man/man3/ruserok.3.gz gethostname 2
/usr/share/man/man5/resolver.5.gz gethostname 2
/usr/share/man/man8/rwhod.8.gz gethostname 2
/usr/share/man/man4/route.4.gz getkerninfo 2
/usr/share/man/man1/logname.1.gz getlogin 3
/usr/share/man/man3/getpwent.3.gz getlogin 3
/usr/share/man/man3/endpwent.3.gz getlogin 3
/usr/share/man/man3/setpassent.3.gz getlogin 3
/usr/share/man/man3/getpwnam.3.gz getlogin 3
/usr/share/man/man3/getpwuid.3.gz getlogin 3
/usr/share/man/man3/setpwent.3.gz getlogin 3
/usr/share/man/man3/setpwfile.3.gz getlogin 3
/usr/share/man/man2/mmap.2.gz getpagesize 2
/usr/share/man/man2/munmap.2.gz getpagesize 2
/usr/share/man/man2/fcntl.2.gz getpwname 3
/usr/share/man/man2/fcntl.2.gz getpwname 3
/usr/share/man/man4/termios.4.gz getty 2
/usr/share/man/man8/routed.8.gz htable 8
/usr/share/man/man8/clri.8.gz icheck 8
/usr/share/man/man3/linkaddr.3.gz ifconfig 4
/usr/share/man/man3/linkntoa.3.gz ifconfig 4
/usr/share/man/man4/inet.4.gz igmp 4
/usr/share/man/man7/hier.7.gz imp 4
/usr/share/man/man5/exports.5.gz inet 5
/usr/share/man/man3/j0.3.gz infnan 3
/usr/share/man/man3/j1.3.gz infnan 3
/usr/share/man/man3/jn.3.gz infnan 3
/usr/share/man/man3/y0.3.gz infnan 3
/usr/share/man/man3/y1.3.gz infnan 3
/usr/share/man/man3/yn.3.gz infnan 3
/usr/share/man/man3/exp.3.gz infnan 3
/usr/share/man/man3/lgamma.3.gz infnan 3
/usr/share/man/man3/sqrt.3.gz infnan 3
/usr/share/man/man3/acosh.3.gz infnan 3
/usr/share/man/man3/asinh.3.gz infnan 3
/usr/share/man/man3/atanh.3.gz infnan 3
/usr/share/man/man3/expm1.3.gz infnan 3
/usr/share/man/man3/log.3.gz infnan 3
/usr/share/man/man3/log10.3.gz infnan 3
/usr/share/man/man3/log1p.3.gz infnan 3
/usr/share/man/man3/pow.3.gz infnan 3
/usr/share/man/man3/gamma.3.gz infnan 3
/usr/share/man/man3/cbrt.3.gz infnan 3
/usr/share/man/man1/intro.1.gz intro 4
/usr/share/man/man2/ioctl.2.gz intro 4
/usr/share/man/man4/cltp.4.gz intro 4
/usr/share/man/man4/icmp.4.gz intro 4
/usr/share/man/man4/idp.4.gz intro 4
/usr/share/man/man4/inet.4.gz intro 4
/usr/share/man/man4/inet.4.gz intro 4
/usr/share/man/man4/ip.4.gz intro 4
/usr/share/man/man4/lo.4.gz intro 4
/usr/share/man/man4/netintro.4.gz intro 4
/usr/share/man/man4/ns.4.gz intro 4
/usr/share/man/man4/nsip.4.gz intro 4
/usr/share/man/man4/spp.4.gz intro 4
/usr/share/man/man4/tcp.4.gz intro 4
/usr/share/man/man4/clnp.4.gz intro 4
/usr/share/man/man4/udp.4.gz intro 4
/usr/share/man/man4/unix.4.gz intro 4
/usr/share/man/man4/networking.4.gz intro 4
/usr/share/man/man1/netstat.1.gz iostat 1
/usr/share/man/man1/systat.1.gz iostat 1
/usr/share/man/man8/pstat.8.gz iostat 1
/usr/share/man/man8/swapinfo.8.gz iostat 1
/usr/share/man/man2/reboot.2.gz kadb 4
/usr/share/man/man2/reboot.2.gz kadb 4
/usr/share/man/man1/passwd.1.gz kerberos 1
/usr/share/man/man1/yppasswd.1.gz kerberos 1
/usr/share/man/man1/su.1.gz kerberos 1
/usr/share/man/man7/hier.7.gz kerberos 1
/usr/share/man/man7/hier.7.gz kerberos 1
/usr/share/man/man1/rlogin.1.gz kerberos 3
/usr/share/man/man1/rsh.1.gz kerberos 3
/usr/share/man/man5/core.5.gz kgdb 1
/usr/share/man/man8/boot_sparc.8.gz kgdb 8
/usr/share/man/man1/passwd.1.gz kinit 1
/usr/share/man/man1/passwd.1.gz kinit 1
/usr/share/man/man1/yppasswd.1.gz kinit 1
/usr/share/man/man1/yppasswd.1.gz kinit 1
/usr/share/man/man1/su.1.gz kinit 1
/usr/share/man/man1/passwd.1.gz kpasswdd 8
/usr/share/man/man1/yppasswd.1.gz kpasswdd 8
/usr/share/man/man1/rcp.1.gz krb_realmofhost 3
/usr/share/man/man1/rlogin.1.gz krb_realmofhost 3
/usr/share/man/man1/rlogin.1.gz krb_realmofhost 3
/usr/share/man/man1/rsh.1.gz krb_realmofhost 3
/usr/share/man/man1/rsh.1.gz krb_realmofhost 3
/usr/share/man/man1/telnet.1.gz krb_realmofhost 3
/usr/share/man/man1/rlogin.1.gz krb_sendauth 3
/usr/share/man/man1/rsh.1.gz krb_sendauth 3
/usr/share/man/man3/gethostbyname.3.gz libc 3
/usr/share/man/man3/endhostent.3.gz libc 3
/usr/share/man/man3/gethostbyaddr.3.gz libc 3
/usr/share/man/man3/sethostent.3.gz libc 3
/usr/share/man/man3/gethostent.3.gz libc 3
/usr/share/man/man3/herror.3.gz libc 3
/usr/share/man/man3/intro.3.gz libc 3
/usr/share/man/man3/intro.3.gz libc functions
/usr/share/man/man1/checknr.1.gz lint 1
/usr/share/man/man1/error.1.gz lint 1
/usr/share/man/man1/error.1.gz lint 1
/usr/share/man/man1/error.1.gz lint 1
/usr/share/man/man1/error.1.gz lint 1
/usr/share/man/man1/error.1.gz lint 1
/usr/share/man/man1/ps.1.gz lisp 1
/usr/share/man/man1/fstat.1.gz ln 2
/usr/share/man/man8/ac.8.gz login 8
/usr/share/man/man4/i386/lpt.4.gz lpa 4
/usr/share/man/man4/lpt.4.gz lpa 4
/usr/share/man/man1/lpr.1.gz lpd 1
/usr/share/man/man1/lpr.1.gz lpd 1
/usr/share/man/man4/i386/lpt.4.gz lptcontrol 1
/usr/share/man/man4/i386/lpt.4.gz lptcontrol 1
/usr/share/man/man4/i386/lpt.4.gz lptcontrol 1
/usr/share/man/man4/lpt.4.gz lptcontrol 1
/usr/share/man/man4/lpt.4.gz lptcontrol 1
/usr/share/man/man4/lpt.4.gz lptcontrol 1
/usr/share/man/man8/mfs.8.gz mkfs 8
/usr/share/man/man8/fsck.8.gz mkfs 8
/usr/share/man/man8/newfs.8.gz mkfs 8
/usr/share/man/man8/mount_mfs.8.gz mkfs 8
/usr/share/man/man8/restore.8.gz mkfs 8
/usr/share/man/man8/rrestore.8.gz mkfs 8
/usr/share/man/man8/tunefs.8.gz mkfs 8
/usr/share/man/man1/mkfifo.1.gz mknod 1
/usr/share/man/man8/pwd_mkdb.8.gz mkpasswd 8
/usr/share/man/man1/gprof.1.gz monitor 3
/usr/share/man/man5/dir.5.gz mount 1
/usr/share/man/man8/showmount.8.gz mount 1
/usr/share/man/man8/mount.8.gz mount_lofs 8
/usr/share/man/man8/mount_null.8.gz mount_lofs 8
/usr/share/man/man8/mount_umap.8.gz mount_lofs 8
/usr/share/man/man8/mount_union.8.gz mount_lofs 8
/usr/share/man/man8/mount_union.8.gz mount_lofs 8
/usr/share/man/man3/ftok.3.gz msgget 2
/usr/share/man/man3/ftok.3.gz msgget 2
/usr/share/man/man4/st.4.gz mt 4
/usr/share/man/man1/tcopy.1.gz mtio 4
/usr/share/man/man8/rmt.8.gz mtio 4
/usr/share/man/man7/hier.7.gz mtree 1
/usr/share/man/man8/clri.8.gz ncheck 8
/usr/share/man/man1/vacation.1.gz ndbm 3
/usr/share/man/man8/makemap.8.gz ndbm 3
/usr/share/man/man4/i386/fe.4.gz netstat 8
/usr/share/man/man4/i386/fe.4.gz netstat 8
/usr/share/man/man4/fe.4.gz netstat 8
/usr/share/man/man4/fe.4.gz netstat 8
/usr/share/man/man1/idprio.1.gz nice 2
/usr/share/man/man1/rtprio.1.gz nice 2
/usr/share/man/man2/rtprio.2.gz nice 2
/usr/share/man/man5/link.5.gz nlist 5
/usr/share/man/man1/symorder.1.gz nm 3
/usr/share/man/man8/lpd.8.gz pac 1
/usr/share/man/man3/getpagesize.3.gz pagesize 1
/usr/share/man/man3/alloca.3.gz pagesize 2
/usr/share/man/man3/malloc.3.gz pagesize 2
/usr/share/man/man1/error.1.gz pc 1
/usr/share/man/man1/gprof.1.gz pc 1
/usr/share/man/man3/stdio.3.gz pc 1
/usr/share/man/man3/intro.3.gz pc 1
/usr/share/man/man5/stab.5.gz pc 1
/usr/share/man/man5/stab.5.gz pc 1
/usr/share/man/man4/i386/pcvt.4.gz pc 4
/usr/share/man/man4/i386/pcvt.4.gz pc 4
/usr/share/man/man4/i386/pcvt.4.gz pc 4
/usr/share/man/man4/pcvt.4.gz pc 4
/usr/share/man/man4/pcvt.4.gz pc 4
/usr/share/man/man4/pcvt.4.gz pc 4
/usr/share/man/man1/scon.1.gz pcvt 8
/usr/share/man/man1/loadfont.1.gz pcvt 8
/usr/share/man/man8/ispcvt.8.gz pcvt 8
/usr/share/man/man1/error.1.gz pi 1
/usr/share/man/man1/mkstr.1.gz pi 1
/usr/share/man/man1/pkg_info.1.gz pkg_add 8
/usr/share/man/man1/pkg_create.1.gz pkg_add 8
/usr/share/man/man1/pkg_delete.1.gz pkg_add 8
/usr/share/man/man1/pkg_delete.1.gz pkg_add 8
/usr/share/man/man1/pkg_delete.1.gz pkg_add 8
/usr/share/man/man1/pkg_add.1.gz pkg_create 8
/usr/share/man/man1/pkg_add.1.gz pkg_create 8
/usr/share/man/man1/pkg_add.1.gz pkg_create 8
/usr/share/man/man1/pkg_add.1.gz pkg_create 8
/usr/share/man/man1/pkg_add.1.gz pkg_create 8
/usr/share/man/man1/pkg_info.1.gz pkg_create 8
/usr/share/man/man1/pkg_info.1.gz pkg_create 8
/usr/share/man/man1/pkg_delete.1.gz pkg_create 8
/usr/share/man/man1/pkg_delete.1.gz pkg_create 8
/usr/share/man/man1/pkg_add.1.gz pkg_delete 8
/usr/share/man/man1/pkg_add.1.gz pkg_delete 8
/usr/share/man/man1/pkg_info.1.gz pkg_delete 8
/usr/share/man/man1/pkg_create.1.gz pkg_delete 8
/usr/share/man/man1/cdplay.1.gz play 1
/usr/share/man/man7/environ.7.gz plot 1
/usr/share/man/man3/intro.3.gz plot 3
/usr/share/man/man3/intro.3.gz plot 3
/usr/share/man/man8/lpd.8.gz plot 3
/usr/share/man/man1/gprof.1.gz prof 1
/usr/share/man/man1/gprof.1.gz prof 1
/usr/share/man/man2/sigvec.2.gz ptrace 2
/usr/share/man/man2/sigaction.2.gz ptrace 2
/usr/share/man/man2/wait.2.gz ptrace 2
/usr/share/man/man2/wait3.2.gz ptrace 2
/usr/share/man/man2/wait4.2.gz ptrace 2
/usr/share/man/man2/waitpid.2.gz ptrace 2
/usr/share/man/man3/exec.3.gz ptrace 2
/usr/share/man/man3/exec.3.gz ptrace 2
/usr/share/man/man3/signal.3.gz ptrace 2
/usr/share/man/man3/execl.3.gz ptrace 2
/usr/share/man/man3/execl.3.gz ptrace 2
/usr/share/man/man3/execle.3.gz ptrace 2
/usr/share/man/man3/execle.3.gz ptrace 2
/usr/share/man/man3/execlp.3.gz ptrace 2
/usr/share/man/man3/execlp.3.gz ptrace 2
/usr/share/man/man3/execv.3.gz ptrace 2
/usr/share/man/man3/execv.3.gz ptrace 2
/usr/share/man/man3/execvp.3.gz ptrace 2
/usr/share/man/man3/execvp.3.gz ptrace 2
/usr/share/man/man1/df.1.gz quot 8
/usr/share/man/man1/du.1.gz quot 8
/usr/share/man/man2/getrlimit.2.gz quota 2
/usr/share/man/man2/setrlimit.2.gz quota 2
/usr/share/man/man6/fortune.6.gz regcmp 3
/usr/share/man/man4/termios.4.gz rlogind 2
/usr/share/man/man8/sendmail.8.gz rmail 1
/usr/share/man/man8/rbootd.8.gz rmp 4
/usr/share/man/man8/ncrcontrol.8.gz scsi 5
/usr/share/man/man1/ul.1.gz setenv 1
/usr/share/man/man2/getgid.2.gz setgid 3
/usr/share/man/man2/getegid.2.gz setgid 3
/usr/share/man/man2/setsid.2.gz setpgid 3
/usr/share/man/man3/tcgetpgrp.3.gz setpgid 3
/usr/share/man/man3/tcsetpgrp.3.gz setpgid 3
/usr/share/man/man7/hier.7.gz spell 1
/usr/share/man/man3/scsi.3.gz ssc 4
/usr/share/man/man1/mt.1.gz st 1
/usr/share/man/man4/st.4.gz st 1
/usr/share/man/man4/st.4.gz st 1
/usr/share/man/man4/st.4.gz st 1
/usr/share/man/man4/st.4.gz st 1
/usr/share/man/man1/symorder.1.gz strip 3
/usr/share/man/man3/vis.3.gz strunvis 3
/usr/share/man/man3/vis.3.gz strunvis 3
/usr/share/man/man3/strvis.3.gz strunvis 3
/usr/share/man/man3/strvis.3.gz strunvis 3
/usr/share/man/man3/strvisx.3.gz strunvis 3
/usr/share/man/man3/strvisx.3.gz strunvis 3
/usr/share/man/man8/amd.8.gz symlinks 2
/usr/share/man/man8/halt.8.gz sync 1
/usr/share/man/man8/fastboot.8.gz sync 1
/usr/share/man/man8/reboot.8.gz sync 1
/usr/share/man/man8/fasthalt.8.gz sync 1
/usr/share/man/man1/kbdmap.1.gz sysconfig 8
/usr/share/man/man1/vidfont.1.gz sysconfig 8
/usr/share/man/man3/sysctl.3.gz sysctl 1
/usr/share/man/man3/gethostid.3.gz sysctl 2
/usr/share/man/man3/gethostid.3.gz sysctl 2
/usr/share/man/man3/getbootfile.3.gz sysctl 2
/usr/share/man/man3/getbootfile.3.gz sysctl 2
/usr/share/man/man3/getdomainname.3.gz sysctl 2
/usr/share/man/man3/gethostname.3.gz sysctl 2
/usr/share/man/man3/getloadavg.3.gz sysctl 2
/usr/share/man/man3/sethostid.3.gz sysctl 2
/usr/share/man/man3/sethostid.3.gz sysctl 2
/usr/share/man/man3/sethostname.3.gz sysctl 2
/usr/share/man/man3/setdomainname.3.gz sysctl 2
/usr/share/man/man1/vacation.1.gz syslog 8
/usr/share/man/man1/vacation.1.gz syslog 8
/usr/share/man/man5/termcap.5.gz term 7
/usr/share/man/man5/termcap.5.gz termlib 3
/usr/share/man/man3/vtimes.3.gz time 2
/usr/share/man/man3/ftime.3.gz time 2
/usr/share/man/man5/tzfile.5.gz time 2
/usr/share/man/man5/tzfile.5.gz time 2
/usr/share/man/man4/tty.4.gz tip 2
/usr/share/man/man4/tp.4.gz tpperf 8
/usr/share/man/man4/tp.4.gz tpperf 8
/usr/share/man/man3/exec.3.gz trace 2
/usr/share/man/man3/execl.3.gz trace 2
/usr/share/man/man3/execle.3.gz trace 2
/usr/share/man/man3/execlp.3.gz trace 2
/usr/share/man/man3/execv.3.gz trace 2
/usr/share/man/man3/execvp.3.gz trace 2
/usr/share/man/man1/netstat.1.gz trsp 8
/usr/share/man/man8/trpt.8.gz trsp 8
/usr/share/man/man4/esis.4.gz un 4
/usr/share/man/man1/chfn.1.gz upchsh 1
/usr/share/man/man1/chpass.1.gz upchsh 1
/usr/share/man/man1/chsh.1.gz upchsh 1
/usr/share/man/man2/fsync.2.gz update 8
/usr/share/man/man2/sync.2.gz update 8
/usr/share/man/man2/sync.2.gz update 8
/usr/share/man/man8/sync.8.gz update 8
/usr/share/man/man5/uuencode.5.gz uusend 1
/usr/share/man/man5/uuencode.format.5.gz uusend 1
/usr/share/man/man1/ps.1.gz vadvise 2
/usr/share/man/man1/ps.1.gz vadvise 2
/usr/share/man/man1/fstat.1.gz vmstat 1
/usr/share/man/man1/netstat.1.gz vmstat 1
/usr/share/man/man1/nfsstat.1.gz vmstat 1
/usr/share/man/man1/systat.1.gz vmstat 1
/usr/share/man/man8/pstat.8.gz vmstat 1
/usr/share/man/man8/swapinfo.8.gz vmstat 1
/usr/share/man/man8/iostat.8.gz vmstat 1
/usr/share/man/man3/system.3.gz wait 3
/usr/share/man/man3/getvfsent.3.gz waitpid 3
/usr/share/man/man3/getvfsbyname.3.gz waitpid 3
/usr/share/man/man3/getvfsbytype.3.gz waitpid 3
/usr/share/man/man3/setvfsent.3.gz waitpid 3
/usr/share/man/man3/endvfsent.3.gz waitpid 3
/usr/share/man/man3/vfsisloadable.3.gz waitpid 3
/usr/share/man/man3/vfsload.3.gz waitpid 3
/usr/share/man/man3/fnmatch.3.gz wordexp 3
/usr/share/man/man4/st.4.gz wt 4
/usr/share/man/man4/st.4.gz wt 4
/usr/share/man/man7/hier.7.gz xget 1
/usr/share/man/man8/mail.local.8.gz xsend 1
/usr/share/man/man1/ypcat.1.gz yp 8
/usr/share/man/man1/ypmatch.1.gz yp 8
/usr/share/man/man3/ethers.3.gz yp 8
/usr/share/man/man3/ether_line.3.gz yp 8
/usr/share/man/man3/ether_aton.3.gz yp 8
/usr/share/man/man3/ether_ntoa.3.gz yp 8
/usr/share/man/man3/ether_ntohost.3.gz yp 8
/usr/share/man/man3/ether_hostton.3.gz yp 8
/usr/share/man/man8/ypxfr.8.gz yp 8
/usr/share/man/man8/yppush.8.gz yp 8
/usr/share/man/man8/ypserv.8.gz yp 8
/usr/share/man/man8/ypbind.8.gz yp 8
/usr/share/man/man8/yppasswdd.8.gz ypcat 8
/usr/share/man/man1/chfn.1.gz ypchfn 1
/usr/share/man/man1/chpass.1.gz ypchfn 1
/usr/share/man/man1/chsh.1.gz ypchfn 1
/usr/share/man/man8/yppasswdd.8.gz ypchfn 1
/usr/share/man/man1/chfn.1.gz ypchpass 1
/usr/share/man/man1/chpass.1.gz ypchpass 1
/usr/share/man/man1/chsh.1.gz ypchpass 1
/usr/share/man/man8/yppasswdd.8.gz ypchsh 1
/usr/share/man/man4/yp.4.gz ypset 8
/usr/share/man/man8/ypbind.8.gz ypset 8
/usr/share/man/man8/ypbind.8.gz ypset 8


#!/bin/sh
#
# dead-xrefs - check manual sources for dead cross references, e.g. a
#              reference to program(8) where 'man 8 program' would
#              report 'No entry for program in section 8 of the manual'
#
# NOTE: only works for BSD style man pages that use the .Xr macro.
#
# Jens Schweikhardt -- FEB 96

#set -x
progname=$(basename "$0")
MANDIR=/usr/share/man
if test $# -gt 1; then
	echo "usage: $progname [mandir]"
	echo "  where mandir defaults to $MANDIR"
	exit 1
fi 1>&2

test "$1" != "" && MANDIR="$1"
TMP=${TMPDIR:-/tmp}/dead-xrefs

echo "checking $MANDIR..."

# Find the compressed manual sources and grep for .Xr macros.
find $MANDIR/man? -name '*.gz' -print |
while read m; do
	echo "$m"
	zgrep '^\.Xr ' "$m" |
	sed 's/^\.Xr //;s/[ .,;)]*$//;s/\\&//;s/  [ ]*/ /'
done > $TMP

# Make another file with the source file names removed.
# This file has the names of dead references, e.g. 'dbx 1'.
grep -v / $TMP |
sort -u |
awk 'NF==2' |
while read name section; do
	if ! man -w $section $name > /dev/null 2>&1; then
		echo $name $section
	fi
done > ${TMP}-dead

# Tack on the source file names, so that we can grep the results later.
awk '{
	if ($0 ~ /^\//) { file = $0 } else { print file, $0 }
}' < $TMP > ${TMP}-named

# Grep for the filenames with dead references.
while read name section; do
	grep " $name $section$" ${TMP}-named
done < ${TMP}-dead

# cleanup
# rm -f ${TMP}*
>Fix:
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->mpp 
Responsible-Changed-By: mpp 
Responsible-Changed-When: Mon Feb 19 12:13:42 PST 1996 
Responsible-Changed-Why:  
I'm already working in this area... 

From: "Mike Pritchard" <mpp@mpp.minn.net>
To: schweikh@ito.uni-stuttgart.de (Jens Schweikhardt)
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/1036: lots of dead xrefs in manpages
Date: Mon, 19 Feb 1996 14:20:19 -0600 (CST)

 Jens Schweikhardt wrote:
 > 
 > >Synopsis:       List of dead xrefs in man pages
 > 
 > 	2.1.0 Release
 > 
 > Many man pages have references to nonexisting man pages.
 > I have written a shell script to find these dead cross references.
 > Running it on /usr/share/man resulted in the following.
 > The format is three fields per line: the man page source file,
 > the command name, and the section it should be found in.
 > A reference to 'program(8)' is considered dead when 'man 8 program'
 > reports 'No entry for program in section 8 of the manual'.
 > I have included the script at the end, so you can compare what
 > dead references your system has. Man pages are a moving target, I know.
 
 A lot of these have already been fixed in -current by myself over
 that past month or so, and the rest are already on my hit list.  
 The program "manck" in ports already does what your script does, plus 
 it does additional checks that your script doesn't.  I will give the 
 supplied script a run to make sure that "manck" isn't missing anything.
 --  
 Mike Pritchard
 mpp@minn.net
 "Go that way.  Really fast.  If something gets in your way, turn"
State-Changed-From-To: open->closed 
State-Changed-By: mpp 
State-Changed-When: Sat Dec 14 15:27:05 PST 1996 
State-Changed-Why:  
Fixed in -current. 
>Unformatted:
To: FreeBSD-gnats-submit@freebsd.org
Subject: List of dead xrefs in man pages
From: schweikh@ito.uni-stuttgart.de
Reply-To: schweikh@ito.uni-stuttgart.de
X-send-pr-version: 3.2


