Update to include a link to the referenced papers when PRINTERDEVICE=html

PR:             docs/22140
Submitted by:   Cyrille Lefevre <clefevre@citeweb.net>

4 files changed, 280 insertions, 61 deletions

diff --git a/share/doc/papers/contents/contents.ms b/share/doc/papers/contents/contents.ms
index bf96340..09f1114 100644
--- a/share/doc/papers/contents/contents.ms
+++ b/share/doc/papers/contents/contents.ms
@@ -36,130 +36,195 @@ UNIX Papers
 
 .IP
 .tl '\fBBerkeley Pascal''px\fP'
+.if \n(.U \{\
+.br
+.>> <a href="px.html">px.html</a>
+.\}
 .QP
 Berkeley Pascal
 PX Implementation Notes
 .br
 Version 2.0
-
+.sp
 Performance Effects of Disk Subsystem Choices
 for VAX\(dg Systems Running 4.2BSD UNIX. 
-
+.sp
 William N. Joy, M. Kirk McKusick.
-
+.sp
 Revised  January, 1979.
 
-
+.sp
 .IP
 .tl '\fBDisk Performance''diskperf\fP'
+.if \n(.U \{\
+.br
+.>> <a href="diskperf.html">diskperf.html</a>
+.\}
 .QP
 Performance Effects of Disk Subsystem Choices
 for VAX\(dg Systems Running 4.2BSD UNIX. 
-
+.sp
 Bob Kridle, Marshall Kirk McKusick. 
-
+.sp
 Revised July 27, 1983.
 
-
+.sp
 .IP
 .tl '\fBTune the 4.2BSD Kernel''kerntune\fP'
+.if \n(.U \{\
+.br
+.>> <a href="kerntune.html">kerntune.html</a>
+.\}
 .QP
 Using gprof to Tune the 4.2BSD Kernel.
-
+.sp
 Marshall Kirk McKusick. 
-
+.sp
 Revised May 21, 1984 (?).
 
-
+.sp
 .IP
 .tl '\fBNew Virtual Memory''newvm\fP'
+.if \n(.U \{\
+.br
+.>> <a href="newvm.html">newvm.html</a>
+.\}
 .QP
 A New Virtual Memory Implementation for Berkeley.
-
+.sp
 Marshall Kirk McKusick, Michael J. Karels.
-
+.sp
 Revised 1986.
 
-
+.sp
 .IP
 .tl '\fBKernel Malloc''kernmalloc\fP'
+.if \n(.U \{\
+.br
+.>> <a href="kernmalloc.html">kernmalloc.html</a>
+.\}
 .QP
 Design of a General Purpose Memory Allocator for the 4.3BSD UNIX Kernel.
-
+.sp
 Marshall Kirk McKusick, Michael J. Karels.
-
+.sp
 Reprinted from:
 \fIProceedings of the San Francisco USENIX Conference\fP,
 pp. 295-303, June 1988.
 
-
+.sp
 .IP
 .tl '\fBRelease Engineering''relengr\fP'
+.if \n(.U \{\
+.br
+.>> <a href="releng.html">releng.html</a>
+.\}
 .QP
 The Release Engineering of 4.3\s-1BSD\s0.
-
+.sp
 Marshall Kirk McKusick, Michael J. Karels, Keith Bostic.
-
+.sp
 Revised 1989.
 
-
+.sp
 .IP
 .tl '\fBBeyond 4.3BSD''beyond4.3\fP'
+.if \n(.U \{\
+.br
+.>> <a href="beyond43.html">beyond43.html</a>
+.\}
 .QP
 Current Research by The Computer Systems Research Group of Berkeley.
-
+.sp
 Marshall Kirk McKusick, Michael J Karels, Keith Sklower, Kevin Fall, 
 Marc Teitelbaum, Keith Bostic. 
-
+.sp
 Revised February 2, 1989.
 
-
+.sp
 .IP
 .tl '\fBMemory Based Filesystem''memfs\fP'
+.if \n(.U \{\
+.br
+.>> <a href="memfs.html">memfs.html</a>
+.\}
 .QP
 A Pageable Memory Based Filesystem.
-
+.sp
 Marshall Kirk McKusick, Michael J. Karels, Keith Bostic.
-
+.sp
 Revised 1990.
 
-
+.sp
 .IP
 .tl '\fBFilesystem Interface''fsinterface\fP'
+.if \n(.U \{\
+.br
+.>> <a href="fsinterface.html">fsinterface.html</a>
+.\}
 .QP
 Toward a Compatible Filesystem Interface.
-
+.sp
 Michael J. Karels, Marshall Kirk McKusick.
-
+.sp
 Conference of the European Users' Group, September 1986. 
 Last modified April 16, 1991.
 
-
+.sp
 .IP
 .tl '\fBSystem Performance''sysperf\fP'
+.if \n(.U \{\
+.br
+.>> <a href="sysperf.html">sysperf.html</a>
+.\}
 .QP
 Measuring and Improving the Performance of Berkeley UNIX.
-
+.sp
 Marshall Kirk McKusick, Samuel J. Leffler, Michael J. Karels.
-
+.sp
 Revised April 17, 1991.
 
-
+.sp
 .IP
 .tl '\fBNot Quite NFS''nqnfs\fP'
+.if \n(.U \{\
+.br
+.>> <a href="nqnfs.html">nqnfs.html</a>
+.\}
 .QP
 Not Quite NFS, Soft Cache Consistency for NFS.
-
+.sp
 Rick Macklem.
-
+.sp
 Reprinted with permission from the "Proceedings of the Winter 1994 Usenix
 Conference", January 1994, San Francisco.
 
+.sp
 .IP
 .tl '\fBMalloc(3)''malloc\fP'
+.if \n(.U \{\
+.br
+.>> <a href="malloc.html">malloc.html</a>
+.\}
 .QP
 Malloc(3) in modern Virtual Memory environments.
-
+.sp
 Poul-Henning Kamp.
-
+.sp
 Revised April 5, 1996.
+
+.sp
+.IP
+.tl '\fBJails: Confining the omnipotent root''jail\fP'
+.if \n(.U \{\
+.br
+.>> <a href="jail.html">jail.html</a>
+.\}
+.QP
+The jail system call sets up a jail and locks the current process in it.
+.sp
+Poul-Henning Kamp, Robert N. M. Watson.
+.sp
+This paper was presented at the 2nd International System Administration
+and Networking Conference "SANE 2000" May 22-25, 2000 in Maastricht,
+The Netherlands and is published in the proceedings.
diff --git a/share/doc/psd/contents/contents.ms b/share/doc/psd/contents/contents.ms
index fa3b33e..46e042d 100644
--- a/share/doc/psd/contents/contents.ms
+++ b/share/doc/psd/contents/contents.ms
@@ -30,13 +30,18 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)00.contents	8.1 (Berkeley) 6/8/93
+.\" $FreeBSD$
 .\"
 .OH '''PSD Contents'
 .EH 'PSD Contents'''
 .TL
 UNIX Programmer's Supplementary Documents (PSD)
+.if \n(.U \{\
+.br
+.>> <a href="Title.html">Title.html</a>
+.\}
 .sp
-\s-24.4 Berkeley Software Distribution\s+2
+\s-2 4.4 Berkeley Software Distribution\s+2
 .sp
 \fRJune, 1993\fR
 .PP
@@ -55,19 +60,19 @@ Documents of Historical Interest
 .QP
 Dennis Ritchie and Ken Thompson's original paper about UNIX, reprinted 
 from Communications of the ACM.  (encumbered)
-
+.sp
 .IP
 .tl 'Unix Implementation''PSD:2'
 .QP
 Ken Thompson's description of the implementation of the Version 7
 kernel and file system.  (encumbered)
-
+.sp
 .IP
 .tl 'The Unix I/O System''PSD:3'
 .QP
 Dennis Ritchie's overview of the I/O System of Version 7; still helpful for 
 those writing device drivers.  (encumbered)
-
+.sp
 .IP
 .tl 'Unix Programming \- Second Edition ''PSD:4'
 .QP
@@ -76,9 +81,13 @@ system and the standard I/O library.  Should be supplemented by
 Kernighan and Pike, ``The UNIX Programming Environment'',
 Prentice-Hall, 1984 and especially by the Programmer Reference Manual
 section 2 (system calls) and 3 (library routines).  (encumbered)
-
+.sp
 .IP
 .tl 'Berkeley Software Architecture Manual (4.4 Edition)''PSD:5'
+.if \n(.U \{\
+.br
+.>> <a href="05.sysman/paper.html">05.sysman/paper.html</a>
+.\}
 .QP
 A concise and terse description of the system call interface
 provided in Berkeley Unix, as revised for 4.4BSD.
@@ -93,20 +102,20 @@ Official statement of the syntax of C.
 Should be supplemented by ``The C Programming Language,''
 B.W. Kernighan and D.M. Ritchie, Prentice-Hall, 1978, that
 contains a tutorial introduction and many examples.  (encumbered)
-
+.sp
 .IP
 .tl 'Berkeley Pascal User\'s Manual''PSD:7'
 .QP
 An implementation of this language popular for learning to program.  
 (Not provided in FreeBSD.)
-
+.sp
 .IP
 .tl 'A Portable Fortran 77 Compiler''PSD:8'
 .QP
 A revised version of the document which originally appeared in
 Volume 2b of the Bell Labs documentation;
 this version reflects the work done at Berkeley.  (encumbered)
-
+.sp
 .IP
 .tl 'Introduction to the f77 I/O Library''PSD:9'
 .QP
@@ -121,53 +130,65 @@ Programming Tools
 How to debug programs using the source level \fIgdb\fP debugger
 (or how to debug programs without having to know much about machine language).
 (A TeXinfo version is provided separately.)
-
+.sp
 .IP
 .tl 'A Tutorial Introduction to ADB''PSD:11'
 .QP
 How to debug programs using the assembly-language level \fIadb\fP debugger.
 (encumbered)
-
+.sp
 .IP
 .tl 'Make \- A Program for Maintaining Computer Programs''PSD:12'
+.if \n(.U \{\
+.br
+.>> <a href="12.make/paper.html">12.make/paper.html</a>
+.\}
 .QP
 Indispensable tool for making sure large programs are properly
 compiled with minimal effort. 
-
+.sp
 .IP
 .tl 'An Introduction to the Revision Control System''PSD:13'
+.if \n(.U \{\
+.br
+.>> <a href="13.rcs/paper.html">13.rcs/paper.html</a>
+.\}
 .QP
 RCS is a user-contributed tool for working together with other people
 without stepping on each other's toes.
 An alternative to \fIsccs\fR for controlling software changes.
-
+.sp
 .IP
 .tl 'An Introduction to the Source Code Control System''PSD:14'
 .QP
 A useful introductory article for those users with
 installations licensed for SCCS.  (encumbered)
-
+.sp
 .IP
 .tl 'YACC: Yet Another Compiler-Compiler''PSD:15'
 .QP
 Converts a BNF specification of a language and semantic actions
 written in C into a compiler for that language.  (encumbered)
-
+.sp
 .IP
 .tl 'LEX \- A Lexical Analyzer Generator''PSD:16'
 .QP
 Creates a recognizer for a set of regular expressions:
 each regular expression can be followed by arbitrary C code
 to be executed upon finding the regular expression.  (encumbered)
-
+.sp
 .IP
 .tl 'The M4 Macro Processor''PSD:17'
 .QP
 M4 is a macro processor useful in its own right and as a
 front-end for C, Ratfor, and Cobol.
-
+.sp
 .IP
 .tl 'gprof: a Call Graph Execution Profiler''PSD:18'
+.if \n(.U \{\
+.br
+.>> <a href="18.gprof/paper.html">18.gprof/paper.html
+.\}
 .QP
 A program to show the call graph and execution time of a program.
 Indispensable aid for improving the running time of almost everything.
@@ -184,53 +205,89 @@ terminal-independent programs.
 General Reference
 .IP
 .tl 'An Introductory 4.4BSD Interprocess Communication Tutorial''PSD:20'
+.if \n(.U \{\
+.br
+.>> <a href="20.ipctut/paper.html">20.ipctut/paper.html
+.\}
 .QP
 How to write programs that use the Interprocess Communication Facilities
 of 4.4BSD.
-
+.sp
 .IP
 .tl 'An Advanced 4.4BSD Interprocess Communication Tutorial''PSD:21'
+.if \n(.U \{\
+.br
+.>> <a href="21.ipc/paper.html">21.ipc/paper.html
+.\}
 .QP
 The reference document (with some examples) for the Interprocess Communication 
 Facilities of 4.4BSD.
-
+.sp
 .IP
 .tl 'RPCGEN Programming Guide''PSD:22'
+.if \n(.U \{\
+.br
+.>> <a href="22.rpcgen/paper.html">22.rpcgen/paper.html
+.\}
 .QP
 Manual for the ONC RPC stub-generating program, provided by Sun Microsystems.
-
+.sp
 .IP
 .tl 'Remote Procedure Call Programming Guide''PSD:23'
+.if \n(.U \{\
+.br
+.>> <a href="23.rpc/paper.html">23.rpc/paper.html
+.\}
 .QP
 A tutorial introduction to programming the ONC RPC system, provided by
 Sun Microsystems.
-
+.sp
 .IP
 .tl 'External Data Representation: Sun Technical Notes''PSD:24'
+.if \n(.U \{\
+.br
+.>> <a href="24.xdr/paper.html">24.xdr/paper.html
+.\}
 .QP
 Technical details about the design of the XDR component of ONC RPC,
 provided by Sun Microsystems.
-
+.sp
 .IP
 .tl 'External Data Representation Standard: Protocol Specification''PSD:25'
+.if \n(.U \{\
+.br
+.>> <a href="25.xdrrfc/paper.html">25.xdrrfc/paper.html
+.\}
 .QP
 The Internet RFC specifying ONC XDR, provided by Sun Microsystems.
-
+.sp
 .IP
 .tl 'Remote Procedure Calls: Protocol Specification''PSD:26'
+.if \n(.U \{\
+.br
+.>> <a href="26.rpcrfc/paper.html">26.rpcrfc/paper.html
+.\}
 .QP
 The Internet RFC specifying ONC RPC, RFC 1050, as provided by Sun
 Microsystems.
-
+.sp
 .IP
 .tl 'Network File System: Version 2 Protocol Specification''PSD:27'
+.if \n(.U \{\
+.br
+.>> <a href="27.nfsrpc/paper.html">27.nfsrpc/paper.html
+.\}
 .QP
 The Internet RFC specifying NFS, as provided by Sun Microsystems.
 Note that the NFS-compatible filesystem itself, while
 compliant with this specification, was not provided by Sun.
-
+.sp
 .IP
 .tl 'CVS II: Parallelizing Software Development''PSD:28'
+.if \n(.U \{\
+.br
+.>> <a href="28.cvs/paper.html">28.cvs/paper.html
+.\}
 .QP
 CVS  (Concurrent Versions System) is a front end to the
 RCS revision control system  which  extends  the  notion  of
diff --git a/share/doc/smm/contents/contents.ms b/share/doc/smm/contents/contents.ms
index 539f22d..11332f2 100644
--- a/share/doc/smm/contents/contents.ms
+++ b/share/doc/smm/contents/contents.ms
@@ -36,8 +36,12 @@
 .EH 'SMM Contents'''
 .TL
 UNIX System Manager's Manual (SMM)
+.if \n(.U \{\
+.br
+.>> <a href="Title.html">Title.html</a>
+.\}
 .sp
-\s-24.4 Berkeley Software Distribution\s+2
+\s-2 4.4 Berkeley Software Distribution\s+2
 .sp
 \fRJune, 1993\fR
 .PP
@@ -55,36 +59,60 @@ system operation, administration,  and maintenance.
 System Installation and Administration
 .IP
 .tl 'Installing and Operating 4.4BSD''SMM:1'
+.if \n(.U \{\
+.br
+.>> <a href="01.setup/paper.html">01.setup/paper.html</a>
+.\}
 .QP
 The definitive reference document for those occasions when
 you find you need to start over again.
 
 .IP
 .tl 'Building 4.4BSD Kernels with \fIConfig\fP''SMM:2'
+.if \n(.U \{\
+.br
+.>> <a href="02.config/paper.html">02.config/paper.html</a>
+.\}
 .QP
 In-depth discussions of the use and operation of the \fIconfig\fP
 program, and how to build your very own Unix kernel.
 
 .IP
 .tl 'Fsck \- The UNIX File System Check Program''SMM:3'
+.if \n(.U \{\
+.br
+.>> <a href="03.fsck/paper.html">03.fsck/paper.html</a>
+.\}
 .QP
 A reference document for using the \fIfsck\fP program during
 times of file system distress.
 
 .IP
 .tl 'Disc Quotas in a UNIX Environment''SMM:4'
+.if \n(.U \{\
+.br
+.>> <a href="04.quotas/paper.html">04.quotas/paper.html</a>
+.\}
 .QP
 A light introduction to the techniques
 for limiting the use of disc resources.
 
 .IP
 .tl 'A Fast File System for UNIX''SMM:5'
+.if \n(.U \{\
+.br
+.>> <a href="05.fastfs/paper.html">05.fastfs/paper.html</a>
+.\}
 .QP
 A description of the 4.4BSD file system organization,
 design and implementation.
 
 .IP
 .tl 'The 4.4BSD NFS Implementation''SMM:6'
+.if \n(.U \{\
+.br
+.>> <a href="06.nfs/paper.html">06.nfs/paper.html</a>
+.\}
 .QP
 An overview of the design, implementation, and use of NFS on 4.4BSD.
 
@@ -96,24 +124,40 @@ for the line printer spooling system.
 
 .IP
 .tl 'Sendmail Installation and Operation Guide''SMM:8'
+.if \n(.U \{\
+.br
+.>> <a href="08.sendmailop/paper.html">08.sendmailop/paper.html</a>
+.\}
 .QP
 The last word in installing and operating the \fIsendmail\fP program.
 
 .ne 3
 .IP
 .tl 'Name Server Operations Guide for BIND''SMM:10'
+.if \n(.U \{\
+.br
+.>> <a href="10.named/paper.html">10.named/paper.html</a>
+.\}
 .QP
 Setting up and operating the name to Internet addressing software.
 If you have a network this will be of interest.
 
 .IP
 .tl 'Timed Installation and Operation Guide''SMM:11'
+.if \n(.U \{\
+.br
+.>> <a href="11.timedop/paper.html">11.timedop/paper.html</a>
+.\}
 .QP
 Describes how to maintain time synchronization between machines
 in a local network.
 
 .IP
 .tl 'The Berkeley UNIX Time Synchronization Protocol''SMM:12'
+.if \n(.U \{\
+.br
+.>> <a href="12.timed/paper.html">12.timed/paper.html</a>
+.\}
 .QP
 The protocols and algorithms used by timed,
 the network time synchronization daemon.
@@ -146,6 +190,10 @@ they cannot now (at least not so easily).
 
 .IP
 .tl 'Networking Implementation Notes, 4.4BSD Edition''SMM:18'
+.if \n(.U \{\
+.br
+.>> <a href="18.net/paper.html">18.net/paper.html</a>
+.\}
 .QP
 A concise description of the system interfaces used within the
 networking subsystem.
diff --git a/share/doc/usd/contents/contents.ms b/share/doc/usd/contents/contents.ms
index eae0ba8..ad2025f 100644
--- a/share/doc/usd/contents/contents.ms
+++ b/share/doc/usd/contents/contents.ms
@@ -30,6 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)00.contents	8.2 (Berkeley) 4/20/94
+.\" $FreeBSD$
 .\"
 .de ND
 .KE
@@ -40,8 +41,12 @@
 .EH 'USD Contents'''
 .TL
 UNIX User's Supplementary Documents (USD)
+.if \n(.U \{\
+.br
+.>> <a href="Title.html">Title.html</a>
+.\}
 .sp
-\s-24.4 Berkeley Software Distribution\s+2
+\s-2 4.4 Berkeley Software Distribution\s+2
 .sp
 \fRJune, 1993\fR
 .PP
@@ -78,6 +83,10 @@ a command interpreter especially popular for writing shell scripts.
 .ND
 .IP
 .tl 'An Introduction to the C shell''USD:4'
+.if \n(.U \{\
+.br
+.>> <a href="04.csh/paper.html">04.csh/paper.html</a>
+.\}
 .QP
 This introduction to
 .I csh,
@@ -101,6 +110,10 @@ Communicating with the World
 .ND
 .IP
 .tl 'Mail Reference Manual''USD:7'
+.if \n(.U \{\
+.br
+.>> <a href="07.mail/paper.html">07.mail/paper.html</a>
+.\}
 .QP
 Complete details on one of the programs for sending and reading your mail.
 .ND
@@ -121,21 +134,37 @@ An easy way to get started with the line editor,
 .ND
 .IP
 .tl 'Advanced Editing on Unix''USD:10'
+.if \n(.U \{\
+.br
+.>> <a href="10.exref/paper.html">10.exref/paper.html</a>
+.\}
 .QP
 The next step.
 .ND
 .IP
 .tl 'An Introduction to Display Editing with Vi''USD:11'
+.if \n(.U \{\
+.br
+.>> <a href="11.vitut/paper.html">11.vitut/paper.html</a>
+.\}
 .QP
 The document to learn to use the \fIvi\fR screen editor.
 .ND
 .IP
 .tl 'Ex Reference Manual (Version 3.7)''USD:12'
+.if \n(.U \{\
+.br
+.>> <a href="12.vi/paper.html">12.vi/paper.html</a>
+.\}
 .QP
 The final reference for the \fIex\fR editor.
 .ND
 .IP
 .tl 'Vi Reference Manual''USD:13'
+.if \n(.U \{\
+.br
+.>> <a href="13.viref/paper.html">13.viref/paper.html</a>
+.\}
 .QP
 The definitive reference for the \fInvi\fR editor.
 .ND
@@ -170,18 +199,30 @@ to lay out most documents.
 .ND
 .IP
 .tl 'A Revised Version of \-ms''USD:18'
+.if \n(.U \{\
+.br
+.>> <a href="18.msdiffs/paper.html">18.msdiffs/paper.html</a>
+.\}
 .QP
 A brief description of the Berkeley revisions made to the \-ms formatting
 macros for nroff and troff.
 .ND
 .IP
 .tl 'Writing Papers with \fInroff\fR using \-me''USD:19'
+.if \n(.U \{\
+.br
+.>> <a href="19.memacros/paper.html">19.memacros/paper.html</a>
+.\}
 .QP
 Another popular macro package for
 .I nroff.
 .ND
 .IP
 .tl '\-me Reference Manual''USD:20'
+.if \n(.U \{\
+.br
+.>> <a href="20.meref/paper.html">20.meref/paper.html</a>
+.\}
 .QP
 The final word on \-me.
 .ND
@@ -250,12 +291,20 @@ Amusements
 .ND
 .IP
 .tl 'A Guide to the Dungeons of Doom''USD:30'
+.if \n(.U \{\
+.br
+.>> <a href="30.rogue/paper.html">30.rogue/paper.html</a>
+.\}
 .QP
 An introduction to the popular game of \fIrogue\fP, a fantasy game
 which is one of the biggest known users of VAX cycles.
 .ND
 .IP
 .tl 'Star Trek''USD:31'
+.if \n(.U \{\
+.br
+.>> <a href="31.trek/paper.html">31.trek/paper.html</a>
+.\}
 .QP
 You are the Captain of the Starship Enterprise.  Wipe out the
 Klingons and save the Federation.