CVS commit: src

["David A. Holland" <dholland%netbsd.org@localhost>]

Module Name:    src
Committed By:   dholland
Date:           Sat Jul  5 19:22:43 UTC 2014

Modified Files:
        src/bin/csh/USD.doc: Makefile
        src/bin/sh/USD.doc: Makefile
        src/external/bsd/atf/share/doc/atf: Makefile
        src/external/bsd/bind: Makefile.inc
        src/external/bsd/kyua-atf-compat/share/doc/kyua-atf-compat: Makefile
        src/external/bsd/kyua-cli: Makefile.inc
        src/external/bsd/kyua-testers/share/doc/kyua-testers: Makefile
        src/external/bsd/ntp: Makefile.inc
        src/external/bsd/ntp/html: Makefile
        src/external/bsd/nvi/docs/USD.doc/exref: Makefile
        src/external/bsd/nvi/docs/USD.doc/vi.ref: Makefile
        src/external/bsd/nvi/docs/USD.doc/vitut: Makefile
        src/external/ibm-public/postfix: Makefile.inc
        src/games/rogue/USD.doc: Makefile
        src/games/trek/USD.doc: Makefile
        src/gnu/usr.bin/groff/contrib/mom/examples: Makefile
        src/gnu/usr.bin/groff/contrib/mom/momdoc: Makefile
        src/lib/libbz2: Makefile
        src/lib/libcurses/PSD.doc: Makefile
        src/share/doc/psd/05.sysman: Makefile
        src/share/doc/psd/20.ipctut: Makefile
        src/share/doc/psd/21.ipc: Makefile
        src/share/doc/smm/04.quotas: Makefile
        src/share/doc/smm/06.nfs: Makefile
        src/share/doc/smm/18.net: Makefile
        src/share/doc/smm/config: Makefile
        src/share/doc/usd/17.msmacros: Makefile
        src/share/doc/usd/18.msdiffs: Makefile
        src/share/doc/usd/19.memacros: Makefile
        src/share/doc/usd/20.meref: Makefile
        src/usr.bin/gprof: Makefile
        src/usr.bin/gprof/PSD.doc: Makefile
        src/usr.bin/mail/USD.doc: Makefile
        src/usr.bin/make/PSD.doc: Makefile
        src/usr.sbin/lpr/SMM.doc: Makefile
        src/usr.sbin/timed/SMM.doc/timed: Makefile
        src/usr.sbin/timed/SMM.doc/timedop: Makefile

Log Message:
Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.


To generate a diff of this commit:
cvs rdiff -u -r1.8 -r1.9 src/bin/csh/USD.doc/Makefile
cvs rdiff -u -r1.2 -r1.3 src/bin/sh/USD.doc/Makefile
cvs rdiff -u -r1.6 -r1.7 src/external/bsd/atf/share/doc/atf/Makefile
cvs rdiff -u -r1.20 -r1.21 src/external/bsd/bind/Makefile.inc
cvs rdiff -u -r1.1 -r1.2 \
    src/external/bsd/kyua-atf-compat/share/doc/kyua-atf-compat/Makefile
cvs rdiff -u -r1.3 -r1.4 src/external/bsd/kyua-cli/Makefile.inc
cvs rdiff -u -r1.1 -r1.2 \
    src/external/bsd/kyua-testers/share/doc/kyua-testers/Makefile
cvs rdiff -u -r1.13 -r1.14 src/external/bsd/ntp/Makefile.inc
cvs rdiff -u -r1.2 -r1.3 src/external/bsd/ntp/html/Makefile
cvs rdiff -u -r1.2 -r1.3 src/external/bsd/nvi/docs/USD.doc/exref/Makefile
cvs rdiff -u -r1.2 -r1.3 src/external/bsd/nvi/docs/USD.doc/vi.ref/Makefile
cvs rdiff -u -r1.2 -r1.3 src/external/bsd/nvi/docs/USD.doc/vitut/Makefile
cvs rdiff -u -r1.16 -r1.17 src/external/ibm-public/postfix/Makefile.inc
cvs rdiff -u -r1.6 -r1.7 src/games/rogue/USD.doc/Makefile
cvs rdiff -u -r1.5 -r1.6 src/games/trek/USD.doc/Makefile
cvs rdiff -u -r1.8 -r1.9 src/gnu/usr.bin/groff/contrib/mom/examples/Makefile
cvs rdiff -u -r1.3 -r1.4 src/gnu/usr.bin/groff/contrib/mom/momdoc/Makefile
cvs rdiff -u -r1.17 -r1.18 src/lib/libbz2/Makefile
cvs rdiff -u -r1.11 -r1.12 src/lib/libcurses/PSD.doc/Makefile
cvs rdiff -u -r1.9 -r1.10 src/share/doc/psd/05.sysman/Makefile
cvs rdiff -u -r1.6 -r1.7 src/share/doc/psd/20.ipctut/Makefile
cvs rdiff -u -r1.6 -r1.7 src/share/doc/psd/21.ipc/Makefile
cvs rdiff -u -r1.8 -r1.9 src/share/doc/smm/04.quotas/Makefile
cvs rdiff -u -r1.3 -r1.4 src/share/doc/smm/06.nfs/Makefile
cvs rdiff -u -r1.6 -r1.7 src/share/doc/smm/18.net/Makefile
cvs rdiff -u -r1.2 -r1.3 src/share/doc/smm/config/Makefile
cvs rdiff -u -r1.2 -r1.3 src/share/doc/usd/17.msmacros/Makefile
cvs rdiff -u -r1.4 -r1.5 src/share/doc/usd/18.msdiffs/Makefile
cvs rdiff -u -r1.3 -r1.4 src/share/doc/usd/19.memacros/Makefile
cvs rdiff -u -r1.3 -r1.4 src/share/doc/usd/20.meref/Makefile
cvs rdiff -u -r1.28 -r1.29 src/usr.bin/gprof/Makefile
cvs rdiff -u -r1.7 -r1.8 src/usr.bin/gprof/PSD.doc/Makefile
cvs rdiff -u -r1.6 -r1.7 src/usr.bin/mail/USD.doc/Makefile
cvs rdiff -u -r1.3 -r1.4 src/usr.bin/make/PSD.doc/Makefile
cvs rdiff -u -r1.6 -r1.7 src/usr.sbin/lpr/SMM.doc/Makefile
cvs rdiff -u -r1.6 -r1.7 src/usr.sbin/timed/SMM.doc/timed/Makefile
cvs rdiff -u -r1.3 -r1.4 src/usr.sbin/timed/SMM.doc/timedop/Makefile

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.