misc/50895: /usr/share/doc/papers needs more papers.

[ryan%freqlabs.com@localhost]

>Number:         50895
>Category:       misc
>Synopsis:       /usr/share/doc/papers needs more papers.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Mar 05 09:45:00 +0000 2016
>Originator:     Ryan Moeller
>Release:        NetBSD 7.99.26
>Organization:
>Environment:
NetBSD netbsd-bhyve.hsd1.tx.comcast.net 7.99.26 NetBSD 7.99.26 (GENERIC) #0: Thu Feb 11 06:05:11 UTC 2016  ryan%netbsd-bhyve.hsd1.tx.comcast.net@localhost:/usr/obj/sys/arch/amd64/compile/GENERIC amd64
>Description:
There are currently only three papers in /usr/share/doc/papers, the most recent of which is from 1985. I know of at least two more papers which should be in there: the UVM paper (Cranor 99) and the Rumpkernel paper (Kantee 12) are directly regarding NetBSD internals, and hopefully more work is out there, too. Another paper that could be a candidate is the Magazines/Vmem paper (Bonwick 01) which, while not specifically discussing NetBSD, is referenced  as the inspiration for our vmem implementation.

I suspect the authors of these papers would readily grant permission for NetBSD to distribute their work as part of the documentation tree.

Expanding the collection of detailed design documents is critical for preserving the history and motivations behind NetBSD's technologies. Furthermore, enriching our repository of knowledge ensures the appeal of this work to newcomers in the future. These wonderful documents, and others like them, already have been written; the hard part is already done. We need simply to include them.
>How-To-Repeat:
ls /usr/share/doc/papers/
>Fix:
Obtain permission from authors to distribute academic papers describing NetBSD's technologies.

Include these papers in the project.

(Optional) Convert documents to more universal formats (i.e. .ps, .txt).