From rdm@cfcl.com  Sun Mar 25 00:09:10 2001
Return-Path: <rdm@cfcl.com>
Received: from idiom.com (idiom.com [216.240.32.1])
	by hub.freebsd.org (Postfix) with ESMTP id 11F1E37B71A
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 25 Mar 2001 00:09:10 -0800 (PST)
	(envelope-from rdm@cfcl.com)
Received: from cfcl.com (cpe-24-221-169-54.ca.sprintbbd.net [24.221.169.54])
	by idiom.com (8.9.3/8.9.3) with ESMTP id AAA11741
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 25 Mar 2001 00:09:09 -0800 (PST)
Received: (from rdm@localhost)
	by cfcl.com (8.11.1/8.11.1) id f2P8AMe43170;
	Sun, 25 Mar 2001 00:10:22 -0800 (PST)
	(envelope-from rdm)
Message-Id: <200103250810.f2P8AMe43170@cfcl.com>
Date: Sun, 25 Mar 2001 00:10:22 -0800 (PST)
From: Rich Morin <rdm@cfcl.com>
Reply-To: rdm@cfcl.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: assorted broken "SEE ALSO" references
X-Send-Pr-Version: 3.2

>Number:         26065
>Category:       docs
>Synopsis:       assorted broken "SEE ALSO" references
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    mpp
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Mar 25 00:10:01 PST 2001
>Closed-Date:    Sun Jul 22 04:51:22 PDT 2001
>Last-Modified:  Sun Jul 22 04:53:45 PDT 2001
>Originator:     Rich Morin
>Release:        FreeBSD 4.2-RELEASE i386
>Organization:
Canta Forda Computer Laboratory
>Environment:

        FreeBSD fb42.cfcl.com 4.2-RELEASE FreeBSD 4.2-RELEASE #0:
        Mon Nov 20 13:02:55 GMT 2000
        jkh@bento.FreeBSD.org:/usr/src/sys/compile/GENERIC  i386

>Description:

	A number of SEE ALSO references point to nonexistent pages.
        In some cases, I have been able to supply a hint.  Here,
        in any event, is the list:

 Referencing page          Referenced page           Hint
 ================          ===============           ====
 clear(1)                  termcap(3)                termcap(5)
 grog(1)                   doctype(1)
 grohtml(1)                afmtodit(1)
 ipresend(1)               snoop(1m)
 ipresend(1)               tcpdump(8)                tcpdump(1)
 ipresend(1)               etherfind(8c)
 k5init(1)                 krb5.conf(5)              krb.conf(5)
 mcon(1)                   X(1)
 openssl(1)                asn1parse(1)
 openssl(1)                ca(1)
 openssl(1)                config(5)
 openssl(1)                crl(1)
 openssl(1)                crl2pkcs7(1)
 openssl(1)                dgst(1)
 openssl(1)                dhparam(1)
 openssl(1)                dsa(1)
 openssl(1)                dsaparam(1)
 openssl(1)                enc(1)
 openssl(1)                gendsa(1)
 openssl(1)                genrsa(1)
 openssl(1)                nseq(1)
 perlipc(1)                IO::Socket(3)
 perlipc(1)                Socket(3)
 tput(1)                   termcap(3)                termcap(5)

 sched_get_priority_max(2) sched_get_scheduler(2)    sched_getscheduler(2)
 sched_get_priority_min(2) sched_get_scheduler(2)    sched_getscheduler(2)
 sched_rr_get_interval(2)  sched_get_scheduler(2)    sched_getscheduler(2)

 kvm_nlist(3)              kldsym(2)
 readline(3)               bash(1)                   not installed
 tf_close(3)               krb(3)                    krb_mk_req(3)
 tf_get_pname(3)           krb(3)
 tf_get_pinst(3)           krb(3)
 tf_get_cred(3)            krb(3)
 tf_init(3)                krb(3)
 tf_util(3)                krb(3)

 daic(4)                   isdnctl(1)

 dhcp-options(5)           dhcpd.conf(5)
 dhcp-options(5)           dhcpd.leases(5)
 krb(5)                    krb_equiv(3)              krb.equiv(5)

 chat(8)                   uucico(1)                 uucico(8)
 hpropd(8)                 hprop(8)
 ntptime(8)                ntp_adjtime(2)            adjtime(2)
 ntptime(8)                ntp_gettime(2)            clock_gettime(2)
 rtquery(8)                gated(8)
 ssl(8)                    asn1parse(1)
 ssl(8)                    ca(1)
 ssl(8)                    config(5)
 ssl(8)                    crl(1)
 ssl(8)                    crl2pkcs7(1)
 ssl(8)                    dgst(1)
 ssl(8)                    dhparam(1)
 ssl(8)                    dsa(1)
 ssl(8)                    dsaparam(1)
 ssl(8)                    enc(1)
 ssl(8)                    gendsa(1)
 ssl(8)                    genrsa(1)
 ssl(8)                    nseq(1)

 BUS_SETUP_INTR(9)         BUS_TEARDOWN_INTR(9)
 VFS_UNMOUNT(9)            vflush(9)
 VOP_LOOKUP(9)             VOP_ABORTOP(9)
 boot(9)                   at_shutdown(9)
 boot(9)                   vfs_unmountall(9)
 cpu_switch(9)             issignal(9)
 mi_switch(9)              issignal(9)

        Also, a minor nit - The whatis(1) entry for k_hasafs(3) is broken.

>How-To-Repeat:

	Run whatis(1) on the referenced pages and see what comes up.

>Fix:

	The references will have to be analyzed and fixed on a case-
        by-case basis.
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->mpp 
Responsible-Changed-By: mpp 
Responsible-Changed-When: Sun Mar 25 01:43:39 PST 2001 
Responsible-Changed-Why:  
I'll handle this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=26065 
State-Changed-From-To: open->closed 
State-Changed-By: mpp 
State-Changed-When: Sun Jul 22 04:51:22 PDT 2001 
State-Changed-Why:  
I fixed some of the bad cross reference entries, but most are from 
contributed software, and need to either be brought up with the 
original software author or the current maintainer. 

All of the broken section 9 xrefs are indead broken because the 
man pages they reference do not exist yet.  I'll file a new PR 
with that list so hopefully someone will start working on them. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=26065 
>Unformatted:
