Reorg docs, part 3:

Move the documents that are papers to /usr/share/doc/papers.
Give them suitable names (including the author and year).

The key property of papers that distinguishes them from documentation
is that they're historical: they're published at a particular time and
aren't updated or maintained. (Except cosmetically.)

We should only ship papers that are of interest to users, either for
historical perspective or because they're the original research
writeup of stuff that went into the system and is still pertinent.

The ffs papers clearly meet this standard; the other one here (about
passwords, in 1978) is probably past its sell-by date.
This commit is contained in:
dholland 2014-07-05 19:23:15 +00:00
parent dcc711d503
commit 0580599ec4
3 changed files with 19 additions and 15 deletions

View File

@ -1,10 +1,12 @@
# $NetBSD: Makefile,v 1.4 2014/07/05 19:22:03 dholland Exp $
# $NetBSD: Makefile,v 1.5 2014/07/05 19:23:15 dholland Exp $
# @(#)Makefile 8.1 (Berkeley) 6/8/93
SECTION=smm
ARTICLE=fsck_ffs
SECTION=papers
ARTICLE=mckusick85-fsck
SRCS= 0.t 1.t 2.t 3.t 4.t
MACROS= -ms
EXTRAHTMLFILES=fsck_ffs1.png fsck_ffs2.png fsck_ffs3.png fsck_ffs4.png
EXTRAHTMLFILES=\
mckusick85-fsck1.png mckusick85-fsck2.png \
mckusick85-fsck3.png mckusick85-fsck4.png
.include <bsd.doc.mk>

View File

@ -1,17 +1,19 @@
# $NetBSD: Makefile,v 1.6 2014/07/05 19:22:03 dholland Exp $
# $NetBSD: Makefile,v 1.7 2014/07/05 19:23:15 dholland Exp $
#
# @(#)Makefile 8.1 (Berkeley) 6/8/93
SECTION=smm
ARTICLE=fastfs
SECTION=papers
ARTICLE=mckusick84-ffs
SRCS= 0.t 1.t 2.t 3.t 4.t 5.t 6.t
MACROS= -ms
ROFF_TBL=yes
ROFF_EQN=yes
EXTRAHTMLFILES=\
fastfs1.png fastfs2.png fastfs3.png fastfs4.png fastfs5.png \
fastfs6.png fastfs7.png fastfs8.png fastfs9.png fastfs10.png \
fastfs11.png fastfs12.png fastfs13.png fastfs14.png fastfs15.png \
fastfs16.png fastfs-9.png
mckusick84-ffs1.png mckusick84-ffs2.png mckusick84-ffs3.png \
mckusick84-ffs4.png mckusick84-ffs5.png mckusick84-ffs6.png \
mckusick84-ffs7.png mckusick84-ffs8.png mckusick84-ffs9.png \
mckusick84-ffs10.png mckusick84-ffs11.png mckusick84-ffs12.png \
mckusick84-ffs13.png mckusick84-ffs14.png mckusick84-ffs15.png \
mckusick84-ffs16.png mckusick84-ffs-9.png
.include <bsd.doc.mk>

View File

@ -1,9 +1,9 @@
# $NetBSD: Makefile,v 1.2 2014/07/05 19:22:04 dholland Exp $
# $NetBSD: Makefile,v 1.3 2014/07/05 19:23:16 dholland Exp $
SECTION=smm
ARTICLE=password
SECTION=papers
ARTICLE=morris78-password
SRCS= password.ms
MACROS= -ms
EXTRAHTMLFILES=password1.png
EXTRAHTMLFILES=morris78-password1.png
.include <bsd.doc.mk>