Re: misc/9627: Manual pages sometimes aren't well cross referenced.

[David Holland <dholland-bugs%netbsd.org@localhost>]

The following reply was made to PR misc/9627; it has been noted by GNATS.

From: David Holland <dholland-bugs%netbsd.org@localhost>
To: gnats-bugs%netbsd.org@localhost
Cc: 
Subject: Re: misc/9627: Manual pages sometimes aren't well cross referenced.
Date: Mon, 29 Aug 2016 05:38:48 +0000

 From: "David A. Holland" <dholland%netbsd.org@localhost>
 To: source-changes%NetBSD.org@localhost
 Subject: CVS commit: othersrc/usr.bin/manxref
 Date: Mon, 29 Aug 2016 05:36:31 +0000
 Mail-Followup-To: source-changes-d%NetBSD.org@localhost
 
 Module Name:	othersrc
 Committed By:	dholland
 Date:		Mon Aug 29 05:36:31 UTC 2016
 
 Added Files:
 	othersrc/usr.bin/manxref: Makefile array.c array.h exceptions.c
 	    exceptions.h main.c manxref.1 mem.c mem.h page.c page.h pagename.h
 	    pathnames.h readpage.c readpage.h
 
 Log Message:
 Add manxref, a tool for analyzing man-page crossreferences across a
 whole system's worth of man pages.
 
 Pursuant to PR 9627, and a much simpler script therein, where it was
 suggested that man page crossreferences mostly ought to be
 bidirectional.
 
 This does not appear to be the case. There are a lot of cases where a
 reference in one direction does not imply a reference back; for
 example, make(1) refers to chdir(2) for good reasons, but there's no
 sensible reason for chdir(2) to refer to make(1). Likewise, lots of
 driver pages refer to bus pages for buses they attach to, but the
 reverse links aren't necessarily useful as there are a lot of them.
 
 Note: this program is not related to the Isle of Man.
 
 
 To generate a diff of this commit:
 cvs rdiff -u -r0 -r1.1 othersrc/usr.bin/manxref/Makefile \
     othersrc/usr.bin/manxref/array.c othersrc/usr.bin/manxref/array.h \
     othersrc/usr.bin/manxref/exceptions.c \
     othersrc/usr.bin/manxref/exceptions.h othersrc/usr.bin/manxref/main.c \
     othersrc/usr.bin/manxref/manxref.1 othersrc/usr.bin/manxref/mem.c \
     othersrc/usr.bin/manxref/mem.h othersrc/usr.bin/manxref/page.c \
     othersrc/usr.bin/manxref/page.h othersrc/usr.bin/manxref/pagename.h \
     othersrc/usr.bin/manxref/pathnames.h othersrc/usr.bin/manxref/readpage.c \
     othersrc/usr.bin/manxref/readpage.h
 
 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.