1In July 2014 the layout of /usr/share/doc was drastically rearranged.
2Because of the lack of rename support in CVS, the source dirs for the
3docs have not yet been rearranged to match. (And also, many of the
4source dirs are scattered across the tree and are hard to find
5anyhow.)
6
7The following is a hopefully complete list of the /usr/share/doc docs
8and where they come from. For things in external, I've listed where
9the makefiles that install the docs are; these point to the doc
10sources, which are usually somewhere somewhat different.
11
12
13Reference docs (in /usr/share/doc/reference/ref[1-9])
14------------------------------------------------------------
15
16          ref1/atf            src/external/bsd/atf
17          ref1/bzip           src/lib/libbz2
18          ref1/config                   src/share/doc/smm/config
19          ref1/csh            src/bin/csh/USD.doc
20          ref1/ex                       src/external/bsd/nvi/docs/USD.doc/exref
21          ref1/gprof                    src/usr.bin/gprof/PSD.doc
22          ref1/kyua/*                   src/external/bsd/kyua-*/share/doc/kyua-*
23          ref1/mail           src/usr.bin/mail/USD.doc
24          ref1/make           src/usr.bin/make/USD.doc
25          ref1/roff/memacros  src/share/doc/usd/19.memacros
26          ref1/roff/meref               src/share/doc/usd/20.meref
27          ref1/roff/msdiffs   src/share/doc/usd/18.msdiffs
28          ref1/roff/msmacros  src/share/doc/usd/17.msmacros
29          ref1/roff/mom                 src/gnu/usr.bin/groff/contrib/mom/momdoc
30          ref1/roff/mom_examples        src/gnu/usr.bin/groff/contrib/mom/examples
31          ref1/sh                       src/bin/sh/USD.doc
32          ref1/vi                       src/external/bsd/nvi/docs/USD.doc/vi.ref
33
34          ref3/curses                   src/lib/libcurses/PSD.doc
35          ref3/sysman                   src/share/doc/psd/05.sysman
36          ref3/sockets                  src/share/doc/psd/20.ipctut
37          ref3/sockets-advanced         src/share/doc/psd/21.ipc
38
39          ref6/rogue                    src/games/rogue/USD.doc
40          ref6/trek           src/games/trek/USD.doc
41
42          ref7/quotas                   src/share/doc/smm/04.quotas
43
44          ref8/bind9                    src/external/bsd/bind/bin/html
45          ref8/lpd            src/usr.sbin/lpr/SMM.doc
46          ref8/ntp            src/external/bsd/ntp/html
47          ref8/postfix                  src/external/ibm-public/postfix/share/html
48          ref8/timedop                  src/usr.sbin/timed/SMM.doc/timedop
49          ref8/timed                    src/usr.sbin/timed/SMM.doc/timed
50
51          ref9/net            src/share/doc/smm/18.net
52          ref9/nfs            src/share/doc/smm/06.nfs
53
54Papers (in /usr/share/doc/papers)
55------------------------------------------------------------
56
57          mckusick84-ffs                src/share/doc/smm/05.fastfs
58          mckusick85-fsck               src/sbin/fsck_ffs/SMM.doc
59          morris78-password   src/share/doc/smm/17.password
60
61User supplementary documents (in /usr/share/doc/usd)
62------------------------------------------------------------
63
64          beginner            src/share/doc/usd/01.begin
65          ed                            external/bsd/nvi/docs/USD.doc/edit
66          vi                            external/bsd/nvi/docs/USD.doc/vitut
67
68System manager manual (in /usr/share/doc/smm)
69------------------------------------------------------------
70
71          (none)
72
73Programmer supplementary documents (in /usr/share/doc/psd)
74------------------------------------------------------------
75
76          (none)
77
78
79
80Here is a list of the historic documents as of just before the reorg:
81------------------------------------------------------------
82
83          usd/01.begin                  kept in USD
84          usd/02.learn                  missing
85          usd/03.shell                  -> ref1/sh
86          usd/04.csh                    -> ref1/csh
87          usd/05.dc           missing
88          usd/06.bc           missing
89          usd/07.mail                   -> ref1/mail
90          usd/08.mh           missing
91          usd/09.edtut                  missing
92          usd/10.edadv                  missing
93          usd/11.edit                   kept in USD
94          usd/12.ex           -> ref1/ex
95          usd/12.vi           kept in USD
96          usd/13.viref                  -> ref1/vi
97          usd/14.jove                   missing
98          usd/15.sed                    missing
99          usd/16.awk                    missing
100          usd/17.msmacros               -> ref1/roff/msmacros
101          usd/18.msdiffs                -> ref1/roff/msdiffs
102          usd/19.memacros               -> ref1/roff/memacros
103          usd/20.meref                  -> ref1/roff/meref
104          usd/21.troff                  missing
105          usd/22.trofftut               missing
106          usd/23.eqn                    missing
107          usd/24.eqnguide               missing
108          usd/25.tbl                    missing
109          usd/26.refer                  missing
110          usd/27.invert                 missing
111          usd/28.bib                    missing
112          usd/29.diction                missing
113          usd/30.rogue                  -> ref6/rogue
114          usd/31.trek                   -> ref6/trek
115
116          smm/01.setup                  kept (for now) in SMM
117          smm/02.config                 -> ref1/config
118          smm/03.fsck_ffs               -> papers/mckusick85-fsck
119          smm/04.quotas                 -> ref7/quotas
120          smm/05.fastfs                 -> papers/mckusick84-ffs
121          smm/06.nfs                    -> ref9/nfs
122          smm/07.lpd                    -> ref8/lpd
123          smm/11.timedop                -> ref8/timed
124          smm/12.timed                  -> ref5/timed
125          smm/13.amd                    missing
126          smm/16.security               missing
127          smm/17.password               -> papers/morris78-password
128          smm/18.net                    -> ref9/net
129
130          (It is not clear what happened to SMM docs 8-10, 14-15, and 19+.)
131
132          psd/01.cacm                   missing
133          psd/02.implement    missing
134          psd/03.iosys                  missing
135          psd/04.uprog                  missing
136          psd/05.sysman                 -> ref3/sysman
137          psd/06.Clang                  missing
138          psd/07.pascal                 missing
139          psd/08.f77                    missing
140          psd/09.f77io                  missing
141          psd/10.gdb                    missing
142          psd/11.adb                    missing
143          psd/12.make                   -> ref1/make
144          psd/13.rcs                    missing
145          psd/14.sccs                   missing
146          psd/15.yacc                   missing
147          psd/16.lex                    missing
148          psd/17.m4           missing
149          psd/18.gprof                  -> ref1/gprof
150          psd/19.curses                 -> ref3/curses
151          psd/20.ipctut                 -> ref3/sockets
152          psd/21.ipc                    -> ref3/sockets-advanced
153