CVS commit: othersrc/usr.bin/manxref

["David A. Holland" <dholland%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.