NetBSD-Bugs archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

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

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

From: David Holland <>
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" <>
 Subject: CVS commit: othersrc/usr.bin/manxref
 Date: Mon, 29 Aug 2016 05:36:31 +0000
 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
 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 \
 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

Home | Main Index | Thread Index | Old Index