[src/trunk]: src Reorg docs, part 3:

[dholland <dholland%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/d5980a76c4f8
branches:  trunk
changeset: 330335:d5980a76c4f8
user:      dholland <dholland%NetBSD.org@localhost>
date:      Sat Jul 05 19:23:15 2014 +0000

description:
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.

diffstat:

 sbin/fsck_ffs/SMM.doc/Makefile     |  10 ++++++----
 share/doc/smm/05.fastfs/Makefile   |  16 +++++++++-------
 share/doc/smm/17.password/Makefile |   8 ++++----
 3 files changed, 19 insertions(+), 15 deletions(-)

diffs (67 lines):

diff -r c587358c8649 -r d5980a76c4f8 sbin/fsck_ffs/SMM.doc/Makefile
--- a/sbin/fsck_ffs/SMM.doc/Makefile    Sat Jul 05 19:23:00 2014 +0000
+++ b/sbin/fsck_ffs/SMM.doc/Makefile    Sat Jul 05 19:23:15 2014 +0000
@@ -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>
diff -r c587358c8649 -r d5980a76c4f8 share/doc/smm/05.fastfs/Makefile
--- a/share/doc/smm/05.fastfs/Makefile  Sat Jul 05 19:23:00 2014 +0000
+++ b/share/doc/smm/05.fastfs/Makefile  Sat Jul 05 19:23:15 2014 +0000
@@ -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>
diff -r c587358c8649 -r d5980a76c4f8 share/doc/smm/17.password/Makefile
--- a/share/doc/smm/17.password/Makefile        Sat Jul 05 19:23:00 2014 +0000
+++ b/share/doc/smm/17.password/Makefile        Sat Jul 05 19:23:15 2014 +0000
@@ -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>