Bug 26065

Summary: assorted broken "SEE ALSO" references
Product: Documentation Reporter: rdm <rdm>
Component: Books & ArticlesAssignee: mpp
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description rdm 2001-03-25 09:10:01 UTC
	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.

Fix: 

The references will have to be analyzed and fixed on a case-
        by-case basis.
How-To-Repeat: 
	Run whatis(1) on the referenced pages and see what comes up.
Comment 1 mpp freebsd_committer freebsd_triage 2001-03-25 10:43:39 UTC
Responsible Changed
From-To: freebsd-doc->mpp

I'll handle this one.
Comment 2 mpp freebsd_committer freebsd_triage 2001-07-22 12:51:22 UTC
State Changed
From-To: open->closed

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.