Sacha Wilder's doc fixes, phase 2.

diff --git a/share/doc/ps1/00.contents/00.contents b/share/doc/ps1/00.contents/00.contents
new file mode 100644 (file)
index 0000000..18062ea
--- /dev/null
+++ b/share/doc/ps1/00.contents/00.contents
@@ -0,0 +1,172 @@
+.\" Copyright (c) 1986 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)00.contents 5.3 (Berkeley) 6/7/90
+.\"
+.OH '''PS1 Contents'
+.EH 'PS1 Contents'''
+.TL
+UNIX Programmer's Supplementary Documents, Volume 1 (PS1)
+.sp
+\s-24.3 Berkeley Software Distribution, Virtual \s-2VAX\s+2\-11 Version\s+2
+.sp
+\fRApril, 1986\fR
+.PP
+These two volumes contain documents which supplement the manual pages in
+.I
+The
+.UX
+Programmer's Reference Manual
+.R
+for the Virtual \s-2VAX\s0-11 version of the system as distributed by U.C.
+Berkeley.
+.SH
+Languages in common use (other languages in Programmer's Supplement, volume 2)
+.IP
+.tl 'The C Programming Language \- Reference Manual''PS1:1'
+.QP
+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.
+
+.IP
+.tl 'A Portable Fortran 77 Compiler''PS1:2'
+.QP
+A revised version of the document which originally appeared in
+Volume 2b of the Bell Labs documentation;
+this version reflects the ongoing work at Berkeley.
+
+.IP
+.tl 'Introduction to the f77 I/O Library''PS1:3'
+.QP
+A description of the revised input/output library for Fortran 77, 
+reflecting work carried out at Berkeley.
+
+.IP
+.tl 'Berkeley Pascal User\'s Manual''PS1:4'
+.QP
+An implementation of this language popular for learning to program.
+
+.IP
+.tl 'Berkeley Vax/UNIX Assembler Reference Manual''PS1:5'
+.QP
+The usage and syntax of the assembler;  useful mostly by compiler writers.
+
+.IP
+.SH
+General Reference
+.IP
+.tl 'Berkeley Software Architecture Manual (4.3 Edition)''PS1:6'
+.QP
+A concise and terse description of the system call interface
+provided in Berkeley Unix, as revised for 4.3BSD.
+This will never be a best seller.
+
+.IP
+.tl 'An Introductory 4.3BSD Interprocess Communication Tutorial''PS1:7'
+.QP
+How to write programs that use the Interprocess Communication Facilities
+of 4.3BSD.
+
+.IP
+.tl 'An Advanced 4.3BSD Interprocess Communication Tutorial''PS1:8'
+.QP
+The reference document (with some examples) for the Interprocess Communication 
+Facilities of 4.3BSD.
+
+.SH
+Programming Tools
+.IP
+.tl 'Lint, A C Program Checker''PS1:9'
+.QP
+Checks C programs for syntax errors, type violations, portability problems,
+and a variety of probable errors.
+
+.IP
+.tl 'A Tutorial Introduction to ADB''PS1:10'
+.QP
+How to debug programs using the \fIadb\fP debugger.
+For hints on the use of ADB for debugging the
+.UX
+kernel, see ``Using ADB to Debug the Kernel'', SMM:3
+
+.IP
+.tl 'Debugging with dbx''PS1:11'
+.QP
+How to debug programs without having to know much about machine language.
+
+.IP
+.tl 'Make \- A Program for Maintaining Computer Programs''PS1:12'
+.QP
+Indispensable tool for making sure large programs are properly
+compiled with minimal effort. 
+
+.IP
+.tl 'An Introduction to the Revision Control System''PS1:13'
+.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.
+
+.IP
+.tl 'An Introduction to the Source Code Control System''PS1:14'
+.QP
+A useful introductory article for those users with
+installations licensed for SCCS.
+
+.IP
+.tl 'YACC: Yet Another Compiler-Compiler''PS1:15'
+.QP
+Converts a BNF specification of a language and semantic actions
+written in C into a compiler for that language.
+
+.IP
+.tl 'LEX \- A Lexical Analyzer Generator''PS1: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.
+
+.IP
+.tl 'The M4 Macro Processor''PS1:17'
+.QP
+M4 is a macro processor useful in its own right and as a
+front-end for C, Ratfor, and Cobol.
+
+.SH
+Programming Libraries
+.IP
+.tl 'Screen Updating and Cursor Movement Optimization''PS1:18'
+.QP
+Describes the \fIcurses\fP package, an aid for writing screen-oriented,
+terminal-independent programs.
+

diff --git a/share/doc/ps1/00.contents/Makefile b/share/doc/ps1/00.contents/Makefile
new file mode 100644 (file)
index 0000000..3a7f865
--- /dev/null
+++ b/share/doc/ps1/00.contents/Makefile
@@ -0,0 +1,10 @@
+VOLUME=        ps1
+DOC=   00.contents
+
+SRCS=  00.contents
+MACROS=        -ms
+
+.include <bsd.doc.mk>
+
+${DOC}.${PRINTER}: ${SRCS}
+       ( cd ${.CURDIR} ; ${ROFF} ${SRCS} ) > ${.TARGET}

diff --git a/share/doc/ps1/Title/Makefile b/share/doc/ps1/Title/Makefile
new file mode 100644 (file)
index 0000000..34fdca3
--- /dev/null
+++ b/share/doc/ps1/Title/Makefile
@@ -0,0 +1,9 @@
+VOLUME=        ps1
+DOC=   Title
+
+SRCS=  Title
+
+.include <bsd.doc.mk>
+
+${DOC}.${PRINTER}: ${SRCS}
+       ( cd ${.CURDIR} ; ${ROFF} ${SRCS} ) > ${.TARGET}

diff --git a/share/doc/ps1/Title/Title b/share/doc/ps1/Title/Title
new file mode 100644 (file)
index 0000000..599737b
--- /dev/null
+++ b/share/doc/ps1/Title/Title
@@ -0,0 +1,98 @@
+.\" Copyright (c) 1986 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)Title       6.3 (Berkeley) 4/17/91
+.\"
+.ps 18
+.vs 22
+.sp 2.75i
+.ft B
+.ce 3
+UNIX Programmer's Supplementary Documents
+Volume 1
+(PS1)
+.ps 14
+.vs 16
+.sp |4i
+.ce 2
+4.3 Berkeley Software Distribution
+Virtual VAX\-11 Version
+.sp |5.75i
+.ft R
+.pt 12
+.vs 16
+.ce
+April, 1986
+.sp |8.2i
+.ce 5
+Computer Systems Research Group
+Computer Science Division
+Department of Electrical Engineering and Computer Science
+University of California
+Berkeley, California  94720
+.bp
+.ll 5.3i
+.in 1.25i
+.hy 0
+.ps 10
+.vs 12p
+.sp |2.5i
+Copyright 1979, 1980, 1983, 1986 Regents of the University of California.
+Permission to copy these documents or any portion thereof as necessary
+for licensed use of the software is granted to licensees of this
+software, provided this copyright notice and statement of permission
+are included.
+.sp 2
+Documents PS1:1, 9, 10, 12, 15, 16, and 17
+are copyright 1979, AT&T Bell Laboratories, Incorporated.
+Documents PS1:2, and 5 are modifications of earlier documents that
+are copyrighted 1979 by AT&T Bell Laboratories, Incorporated.
+Holders of \x'-1p'UNIX\v'-4p'\s-3TM\s0\v'4p'/32V,
+System III, or System V software licenses are
+permitted to copy these documents, or any portion of them,
+as necessary for licensed use of the software,
+provided this copyright notice and statement of permission
+are included.
+.sp 2
+Document PS1:13 is part of the user contributed software and is
+copyright 1983 by Walter F. Tichy.
+Permission to copy the RCS documentation or any portion thereof as
+necessary for licensed use of the software is granted to licensees
+of this software, provided this copyright notice is included.
+.sp 2
+This manual reflects system enhancements made at Berkeley and sponsored
+in part by the Defense Advanced Research Projects Agency
+(DoD), Arpa Order No. 4871 monitored by the Naval Electronics Systems
+Command under contract No. N00039-84-C-0089.
+The views and conclusions contained in these documents are those of the
+authors and should not be interpreted as representing official policies,
+either expressed or implied, of the Defense Research Projects Agency
+or of the US Government.

diff --git a/share/doc/smm/00.contents/00.contents b/share/doc/smm/00.contents/00.contents
new file mode 100644 (file)
index 0000000..908c4ff
--- /dev/null
+++ b/share/doc/smm/00.contents/00.contents
@@ -0,0 +1,177 @@
+.\" Copyright (c) 1986 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)00.contents 5.3 (Berkeley) 4/17/91
+.\"
+.OH '''SMM Contents'
+.EH 'SMM Contents'''
+.TL
+UNIX System Manager's Manual (SMM)
+.sp
+\s-24.3 Berkeley Software Distribution, Virtual \s-2VAX\s+2\-11 Version\s+2
+.sp
+\fRApril, 1986\fR
+.PP
+This volume contains manual pages and supplementary documents useful to system
+administrators.
+The information in these documents applies to
+the Virtual \s-2VAX\s0-11 version of the system as distributed by U.C.
+Berkeley.
+.SH
+Reference Manual \- Section 8
+.tl '''(8)'
+.IP
+Section 8 of the UNIX Programmer's Manual contains information related to
+system operation, administration,  and maintenance.
+.SH
+System Installation and Administration
+.IP
+.tl 'Installing and Operating 4.3BSD on the VAX''SMM:1'
+.QP
+The definitive reference document for those occasions when
+you find you need to start over again.
+
+.IP
+.tl 'Building 4.3BSD UNIX Systems with \fIConfig\fP''SMM:2'
+.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 'Using ADB to Debug the Kernel''SMM:3'
+.QP
+Techniques for figuring out after the fact why the kernel crashed.
+
+.IP
+.tl 'Disc Quotas in a UNIX Environment''SMM:4'
+.QP
+A light introduction to the techniques
+for limiting the use of disc resources.
+
+.IP
+.tl 'Fsck \- The UNIX File System Check Program''SMM:5'
+.QP
+A reference document for using the \fIfsck\fP program during
+times of file system distress.
+
+.IP
+.tl 'Line Printer Spooler Manual''SMM:6'
+.QP
+This document describes the structure and installation procedure
+for the line printer spooling system.  
+
+.IP
+.tl 'Sendmail Installation and Operation Guide''SMM:7'
+.QP
+The last word in installing and operating the \fIsendmail\fP program.
+
+.IP
+.tl 'Timed Installation and Operation Guide''SMM:8'
+.QP
+Describes how to maintain time synchronization between machines
+in a local network.
+
+.IP
+.tl 'UUCP Implementation Description''SMM:9'
+.QP
+Describes the implementation of uucp; for the installer and administrator.
+
+.IP
+.tl 'USENET Version B Installation''SMM:10'
+.QP
+How to install and maintain the News system.
+
+.IP
+.tl 'Name Server Operations Guide''SMM:11'
+.QP
+If you have a network this will be of interest.
+
+.SH
+Supporting Documentation
+
+.IP
+.tl 'Bug Fixes and Changes in 4.3BSD''SMM:12'
+.QP
+This document summarizes changes visible to the user accustomed to 4.2BSD.
+
+.IP
+.tl 'Changes to the Kernel in 4.3BSD''SMM:13'
+.QP
+A summary for the hard-core of changes in the kernel from 4.2BSD to 4.3BSD.
+
+.IP
+.tl 'A Fast File System for UNIX''SMM:14'
+.QP
+A description of the 4.2BSD file system organization, design and implementation.
+
+.IP
+.tl '4.3BSD Networking Implementation Notes''SMM:15'
+.QP
+A concise description of the system interfaces used within the
+networking subsystem.
+
+.IP
+.tl 'Sendmail \- An Internetwork Mail Router''SMM:16'
+.QP
+An overview document on the design and implementation of \fIsendmail\fP.
+
+.IP
+.tl 'On the Security of UNIX''SMM:17'
+.QP
+Hints on how to break UNIX, and how to avoid your system being broken.
+
+.IP
+.tl 'Password Security \- A Case History''SMM:18'
+.QP
+How the bad guys used to be able to break the password algorithm, and why
+they cannot now (at least not so easily).
+
+.IP
+.tl 'A Tour Through the Portable C Compiler''SMM:19'
+.QP
+How the portable C compiler works inside.  
+
+.IP
+.tl 'Writing NROFF Terminal Descriptions''SMM:20'
+.QP
+A description of how to add a printer with new characteristics
+to Version 7 \fInroff\fP.
+
+.IP
+.tl 'A Dial\-Up Network of UNIX Systems''SMM:21'
+.QP
+Describes UUCP, a program for communicating files between UNIX systems.
+
+.IP
+.tl 'The Berkeley UNIX Time Synchronization Protocol''SMM:22'
+.QP
+The protocols and algorithms used by timed,
+the network time synchronization daemon.

diff --git a/share/doc/smm/00.contents/Makefile b/share/doc/smm/00.contents/Makefile
new file mode 100644 (file)
index 0000000..e191b18
--- /dev/null
+++ b/share/doc/smm/00.contents/Makefile
@@ -0,0 +1,10 @@
+VOLUME=        smm
+DOC=   00.contents
+
+SRCS=  00.contents
+MACROS=        -ms
+
+.include <bsd.doc.mk>
+
+${DOC}.${PRINTER}: ${SRCS}
+       ( cd ${.CURDIR} ; ${ROFF} ${SRCS} ) > ${.TARGET}

diff --git a/share/doc/smm/Title/Makefile b/share/doc/smm/Title/Makefile
new file mode 100644 (file)
index 0000000..4da6a63
--- /dev/null
+++ b/share/doc/smm/Title/Makefile
@@ -0,0 +1,9 @@
+VOLUME=        smm
+DOC=   Title
+
+SRCS=  Title
+
+.include <bsd.doc.mk>
+
+${DOC}.${PRINTER}: ${SRCS}
+       ( cd ${.CURDIR} ; ${ROFF} ${SRCS} ) > ${.TARGET}

diff --git a/share/doc/smm/Title/Title b/share/doc/smm/Title/Title
new file mode 100644 (file)
index 0000000..88db771
--- /dev/null
+++ b/share/doc/smm/Title/Title
@@ -0,0 +1,150 @@
+.\" Copyright (c) 1986 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)Title       6.4 (Berkeley) 4/17/91
+.\"
+.ps 18
+.vs 22
+.sp 2.75i
+.ft B
+.ce 2
+UNIX System Manager's Manual
+(SMM)
+.ps 14
+.vs 16
+.sp |4i
+.ce 2
+4.3 Berkeley Software Distribution
+Virtual VAX\-11 Version
+.sp |5.75i
+.ft R
+.pt 12
+.vs 16
+.ce
+April, 1986
+.sp |8.2i
+.ce 5
+Computer Systems Research Group
+Computer Science Division
+Department of Electrical Engineering and Computer Science
+University of California
+Berkeley, California  94720
+.bp
+.ll 5.3i
+.in 1.25i
+.hy 0
+.ps 10
+.vs 12p
+.sp |2.8i
+Copyright 1979, 1980, 1983, 1986 Regents of the University of California.
+Permission to copy these documents or any portion thereof as necessary
+for licensed use of the software is granted to licensees of this
+software, provided this copyright notice and statement of permission
+are included.
+.sp 2
+Documents SMM:17, 18, and 21
+are copyright 1979, AT&T Bell Laboratories, Incorporated.
+Documents SMM:9 and 19 are modifications of earlier documents that
+are copyrighted 1979 by AT&T Bell Laboratories, Incorporated.
+Holders of \x'-1p'UNIX\v'-4p'\s-3TM\s0\v'4p'/32V,
+System III, or System V software licenses are
+permitted to copy these documents, or any portion of them,
+as necessary for licensed use of the software,
+provided this copyright notice and statement of permission
+are included.
+.sp 2
+Document SMM:10 is part of the user contributed software.
+.sp 2
+This manual reflects system enhancements made at Berkeley and sponsored
+in part by the Defense Advanced Research Projects Agency
+(DoD), Arpa Order No. 4871 monitored by the Naval Electronics Systems
+Command under contract No. N00039-84-C-0089.
+The views and conclusions contained in these documents are those of the
+authors and should not be interpreted as representing official policies,
+either expressed or implied, of the Defense Research Projects Agency
+or of the US Government.
+.\".br
+.\".ll 6.5i
+.\".lt 6.5i
+.\".po .75i
+.\".in 0i
+.\".af % i
+.\".ds ET\"
+.\".de HD
+.\".po 0
+.\".lt 7.4i
+.\".tl ''''
+.\".lt
+.\".po
+.\"'sp 18p
+.\".if o .tl '\\*(ET''- % -'
+.\".if e .tl '- % -''\\*(ET'
+.\"'sp 18p
+.\".ns
+.\"..
+.\".de FO
+.\"'sp 18p
+.\".if e .tl '\s9\\*(Dt''\\*(Ed\s0'
+.\".if o .tl '\s9\\*(Ed''\\*(Dt\s0'
+.\"'bp
+.\"..
+.\".wh 0 HD
+.\".wh -60p FO
+.\".bp 1
+.\".ds ET \s9\f2Table \|of \|Contents\fP\s0
+.\".ds Ed 4.3BSD
+.\".ds Dt April \|1986
+.\".ce
+.\"\f3TABLE \|OF \|CONTENTS\fP
+.\".nr x .5i
+.\".in +\nxu
+.\".nf
+.\".ta \n(.lu-\nxuR
+.\".de xx
+.\"\\$1\f3 \a \fP\\$2
+.\"..
+.\".de t
+.\".sp 1v
+.\".ne .5i
+.\".cs 3
+.\".ti -.5i
+.\".ss 18
+.\"\f3\s9\\$2. \\$3\s0\fP
+.\".ss 12
+.\".if t .sp .5v
+.\".cs 3 36
+.\".so \\$1
+.\"..
+.\".t /usr/man/man0/toc8 8 "System Maintenance"
+.\".in -.5i
+.\".cs 3
+.\".if n .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 80n
+.\".if t .ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i

diff --git a/share/doc/usd/00.contents/00.contents b/share/doc/usd/00.contents/00.contents
new file mode 100644 (file)
index 0000000..123ee6b
--- /dev/null
+++ b/share/doc/usd/00.contents/00.contents
@@ -0,0 +1,247 @@
+.\" Copyright (c) 1986 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)00.contents 5.2 (Berkeley) 4/17/91
+.\"
+.OH '''USD Contents'
+.EH 'USD Contents'''
+.TL
+UNIX User's Supplementary Documents (USD)
+.sp
+\s-24.3 Berkeley Software Distribution, Virtual \s-2VAX\s+2\-11 Version\s+2
+.sp
+\fRFebruary, 1986\fR
+.PP
+This volume contains documents which supplement the manual pages in
+.I
+The Unix User's Reference Manual
+.R
+for the Virtual \s-2VAX\s0-11 version of the system as distributed by U.C.
+Berkeley, and Volumes 2a and 2b as provided by Bell Laboratories.
+
+.SH
+Getting Started
+.IP
+.tl 'Unix for Beginners \- Second Edition''USD:1'
+.QP
+An introduction to the most basic uses of the system.
+.IP
+.tl 'Learn \- Computer\-Aided Instruction on UNIX (Second Edition)''USD:2'
+.QP
+Describes a computer-aided instruction program that walks new users through
+the basics of files, the editor, and document prepararation software.
+.SH
+Basic Utilities
+.IP
+.tl 'An Introduction to the UNIX Shell''USD:3'
+.QP
+Steve Bourne's introduction to the capabilities of 
+.I sh,
+a command interpreter especially popular for writing shell scripts.
+.IP
+.tl 'An Introduction to the C shell''USD:4'
+.QP
+This introduction to
+.I csh,
+(a command interpreter popular for interactive work)  describes many 
+commonly used UNIX commands, assumes little prior knowledge of UNIX,
+and has a glossary useful for beginners.
+.IP
+.tl 'DC \- An Interactive Desk Calculator''USD:5'
+.QP
+A super HP calculator, if you do not need floating point.
+.IP
+.tl 'BC \- An Arbitrary Precision Desk-Calculator Language''USD:6'
+.QP
+A front end for DC that provides infix notation, control flow, and 
+built\-in functions.
+.SH
+Communicating with the World
+.IP
+.tl 'Mail Reference Manual''USD:7'
+.QP
+Complete details on one of the programs for sending and reading your mail.
+.IP
+.tl 'The Rand MH Message Handling System''USD:8'
+.QP
+This system for managing your computer mail uses lots of small programs, 
+instead of one large one.
+.IP
+.tl 'How to Read the Network News''USD:9'
+.QP
+Describes how news works (generally) and some alternatives for reading it,
+.I readnews
+and 
+.I vnews .
+.IP
+.tl 'How to Use USENET Effectively''USD:10'
+.QP
+Describes the customs, protocols, and etiquette of network news, plus answers
+to the questions most frequently asked by newcomers to the network.
+.IP
+.tl 'Notesfile Reference Manual''USD:11'
+.QP
+This feature-packed system for maintaining computer-aided discussion groups is
+also useful for reading netnews.
+.SH
+Text Editing
+.IP
+.tl 'A Tutorial Introduction to the Unix Text Editor''USD:12'
+.QP
+An easy way to get started with the line editor, 
+.I ed.
+.IP
+.tl 'Advanced Editing on Unix''USD:13'
+.QP
+The next step.
+.IP
+.tl 'Edit: A Tutorial''USD:14'
+.QP
+An introduction to 
+.I edit, 
+a line\-oriented editor which is a version of 
+.I ex, 
+assuming no previous knowledge of UNIX or text editing.
+.IP
+.tl 'An Introduction to Display Editing with Vi''USD:15'
+.QP
+The document to learn to use the \fIvi\fR screen editor.
+.IP
+.tl 'Ex Reference Manual (Version 3.7)''USD:16'
+.QP
+The final reference for the \fIex\fR editor, which underlies both \fIedit\fR
+and \fIvi\fR. 
+.IP
+.tl 'Jove Manual for UNIX Users''USD:17'
+.QP
+Jove is a small, self-documenting, customizable display editor, based on
+EMACS.  A plausible alternative to 
+.I vi.
+.IP
+.tl 'SED \- A Non-interactive Text Editor''USD:18'
+.QP
+Describes a one-pass variant of 
+.I ed
+useful as a filter for processing large files.
+.IP
+.tl 'AWK \- A Pattern Scanning and Processing Language (Second Edition)''USD:19'
+.QP
+A program for data selection and transformation.
+.SH
+Document Preparation
+.IP
+.tl 'Typing Documents on UNIX: Using the \-ms Macros with Troff and Nroff''USD:20'
+.QP
+Describes and gives examples of the basic use of the typesetting tools and 
+``-ms'', a frequently used package of formatting requests that make it easier 
+to lay out most documents.
+.IP
+.tl 'A Revised Version of \-ms''USD:21'
+.QP
+A brief description of the Berkeley revisions made to the \-ms formatting
+macros for nroff and troff.
+.IP
+.tl 'Writing Papers with \fInroff\fR using \-me''USD:22'
+.QP
+Another popular macro package for
+.I nroff.
+.IP
+.tl '\-me Reference Manual''USD:23'
+.QP
+The final word on \-me.
+.IP
+.tl 'NROFF/TROFF User\'s Manual''USD:24'
+.QP
+Extremely detailed information about these document formatting programs.
+.KS
+.IP
+.tl 'A TROFF Tutorial''USD:25'
+.QP
+An introduction to the most basic uses of
+.I troff 
+for those who really want to know such things, or want to write their 
+own macros.
+.KE
+.KS
+.IP
+.tl 'A System for Typesetting Mathematics''USD:26'
+.QP
+Describes 
+.I eqn, 
+an easy-to-learn language for high-quality mathematical typesetting.
+.IP
+.tl 'Typesetting Mathematics \- User\'s Guide (Second Edition)''USD:27'
+.QP
+More details about how to use 
+.I eqn.
+.IP
+.KE
+.tl 'Tbl \- A Program to Format Tables''USD:28'
+.QP
+A program for easily typesetting tabular material.
+.IP
+.tl 'Refer \- A Bibliography System''USD:29'
+.QP
+An introduction to one set of tools used to maintain bibliographic databases. 
+The major program, 
+.I refer,
+is used to automatically retrieve and format the references 
+based on document citations.
+.IP
+.tl 'Some Applications of Inverted Indexes on the UNIX System''USD:30'
+.QP
+Mike Lesk's paper describes the
+.I refer 
+programs in a somewhat larger context.
+.IP
+.tl 'BIB \- A Program for Formatting Bibliographies''USD:31'
+.QP
+This is an alternative to
+.I refer
+for expanding citations in documents.
+.IP
+.tl 'Writing Tools \- The STYLE and DICTION Programs''USD:32'
+.QP
+These are programs which can help you understand and improve your 
+writing style.
+.SH 
+Amusements
+.IP
+.tl 'A Guide to the Dungeons of Doom''USD:33'
+.QP
+An introduction to the popular game of \fIrogue\fP, a fantasy game
+which is one of the biggest known users of VAX cycles.
+.IP
+.tl 'Star Trek''USD:34'
+.QP
+You are the Captain of the Starship Enterprise.  Wipe out the
+Klingons and save the Federation.
+.IP

diff --git a/share/doc/usd/00.contents/Makefile b/share/doc/usd/00.contents/Makefile
new file mode 100644 (file)
index 0000000..db20edd
--- /dev/null
+++ b/share/doc/usd/00.contents/Makefile
@@ -0,0 +1,10 @@
+VOLUME=        usd
+DOC=   00.contents
+
+SRCS=  00.contents
+MACROS=        -ms
+
+.include <bsd.doc.mk>
+
+${DOC}.${PRINTER}: ${SRCS}
+       ( cd ${.CURDIR} ; ${ROFF} ${SRCS} ) > ${.TARGET}

diff --git a/share/doc/usd/Title/Makefile b/share/doc/usd/Title/Makefile
new file mode 100644 (file)
index 0000000..e752080
--- /dev/null
+++ b/share/doc/usd/Title/Makefile
@@ -0,0 +1,9 @@
+VOLUME=        usd
+DOC=   Title
+
+SRCS=  Title
+
+.include <bsd.doc.mk>
+
+${DOC}.${PRINTER}: ${SRCS}
+       ( cd ${.CURDIR} ; ${ROFF} ${SRCS} ) > ${.TARGET}

diff --git a/share/doc/usd/Title/Title b/share/doc/usd/Title/Title
new file mode 100644 (file)
index 0000000..0dec260
--- /dev/null
+++ b/share/doc/usd/Title/Title
@@ -0,0 +1,92 @@
+.\" Copyright (c) 1986 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)Title       6.2 (Berkeley) 4/17/91
+.\"
+.ps 18
+.vs 22
+.sp 2.75i
+.ft B
+.ce 2
+UNIX User's Supplementary Documents
+(USD)
+.ps 14
+.vs 16
+.sp |4i
+.ce 2
+4.3 Berkeley Software Distribution
+Virtual VAX\-11 Version
+.sp |5.75i
+.ft R
+.pt 12
+.vs 16
+.ce
+April, 1986
+.sp |8.2i
+.ce 5
+Computer Systems Research Group
+Computer Science Division
+Department of Electrical Engineering and Computer Science
+University of California
+Berkeley, California  94720
+.bp
+.ll 5.3i
+.in 1.25i
+.hy 0
+.ps 10
+.vs 12p
+.sp |3i
+Copyright 1979, 1980, 1983, 1986 Regents of the University of California.
+Permission to copy these documents or any portion thereof as necessary
+for licensed use of the software is granted to licensees of this
+software, provided this copyright notice and statement of permission
+are included.
+.sp 2
+Documents USD:1, 2, 3, 5, 6, 12, 13, 18, 19, 20, 24, 25, 26, 27, 28,
+30, and 32 are copyright 1979, AT&T Bell Laboratories, Incorporated.
+Holders of \x'-1p'UNIX\v'-4p'\s-3TM\s0\v'4p'/32V,
+System III, or System V software licenses are
+permitted to copy these documents, or any portion of them,
+as necessary for licensed use of the software,
+provided this copyright notice and statement of permission
+are included.
+.sp 2
+Documents USD:8, 9, 10, 11, 17, and 31 are part of the
+user contributed software.
+.sp 2
+This manual reflects system enhancements made at Berkeley and sponsored
+in part by the Defense Advanced Research Projects Agency
+(DoD), Arpa Order No. 4871 monitored by the Naval Electronics Systems
+Command under contract No. N00039-84-C-0089.
+The views and conclusions contained in these documents are those of the
+authors and should not be interpreted as representing official policies,
+either expressed or implied, of the Defense Research Projects Agency
+or of the US Government.