Skip site navigation (1)Skip section navigation (2)
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:   docs/1036: lots of dead xrefs in manpages
Message-ID:  <9602190929.AA00782@itosun.ito.uni-stuttgart.de>
Resent-Message-ID: <199602190940.BAA14801@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         1036
>Category:       docs
>Synopsis:       List of dead xrefs in man pages
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 19 01:40:02 PST 1996
>Last-Modified:
>Originator:     Jens Schweikhardt
>Organization:
Uni Stuttgart
>Release:        FreeBSD 2.1-STABLE i386
>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:
>Audit-Trail:
>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





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