d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Get the USD to format under the new structure.

Browse Source
This commit is contained in:
Garrett Wollman 1995-01-11 03:24:33 +00:00
parent be3dff6e36
commit 417ed37975
16 changed files with 551 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
share/doc/usd/04.csh/Makefile Normal file
View File

@ -0,0 +1,9 @@
# @(#)Makefile 8.1 (Berkeley) 8/14/93
# $Id: Makefile,v 1.2 1994/09/24 02:54:22 davidg Exp $
VOLUME= usd/04.csh
SRCS= tabs csh.1 csh.2 csh.3 csh.4 csh.a csh.g
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../bin/csh/USD.doc
.include <bsd.doc.mk>

12
share/doc/usd/07.mail/Makefile Normal file
View File

@ -0,0 +1,12 @@
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
VOLUME= usd/07.mail
SRCS= mail0.nr mail1.nr mail2.nr mail3.nr mail4.nr mail5.nr mail6.nr \
mail7.nr mail8.nr mail9.nr maila.nr
MACROS= -me
SRCDIR= ${.CURDIR}/../../../../usr.bin/mail/USD.doc
USE_TBL= yes
.include <bsd.doc.mk>

20
share/doc/usd/10.exref/Makefile Normal file
View File

@ -0,0 +1,20 @@
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
VOLUME= usd/10.exref
SRCS= ex.rm
MACROS= -ms
CLEANFILES=summary.*
SRCDIR= ${.CURDIR}/../../../../usr.bin/vi/USD.doc/exref
USE_TBL= yes
.include <bsd.doc.mk>
all: paper.${PRINTER} summary.${PRINTER}
summary.${PRINTER}: ex.summary
(cd ${SRCDIR}; ${ROFF} ${.ALLSRC}) > ${.TARGET}
afterinstall:
${INSTALL} ${COPY} -o ${BINOWN} -g ${BINGRP} -m ${BINMODE} \
summary.${PRINTER} ${DESTDIR}${BINDIR}/${VOLUME}

18
share/doc/usd/11.vitut/Makefile Normal file
View File

@ -0,0 +1,18 @@
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
VOLUME= usd/11.edit
SRCS= edittut.ms
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../usr.bin/vi/USD.doc/edit
USE_TBL= yes
# index for versatec is different from the one in edit.tut
# because the fonts are different and entries reference page
# rather than section numbers. if you have a typesetter
# you should just use the index in edit.tut, and ignore editvindex.
#editvindex:
# ${TROFF} ${MACROS} -n22 edit.vindex
.include <bsd.doc.mk>

24
share/doc/usd/12.vi/Makefile Normal file
View File

@ -0,0 +1,24 @@
# From: @(#)Makefile 8.1 (Berkeley) 8/14/93
# $Id$
VOLUME= usd/12.vi
SRCS= vi.in vi.chars
MACROS= -ms
CLEANFILES+=summary.* viapwh.*
SRCDIR= ${.CURDIR}/../../../../usr.bin/vi/USD.doc/vitut
USE_TBL= yes
.include <bsd.doc.mk>
all: paper.${PRINTER} summary.${PRINTER} viapwh.${PRINTER}
summary.${PRINTER}: vi.summary
(cd ${SRCDIR}; ${ROFF} ${.ALLSRC}) > ${.TARGET}
viapwh.${PRINTER}: vi.apwh.ms
(cd ${SRCDIR}; ${ROFF} ${.ALLSRC}) > ${.TARGET}
afterinstall:
${INSTALL} ${COPY} -o ${BINOWN} -g ${BINGRP} -m ${BINMODE} \
summary.${PRINTER} viapwh.${PRINTER} \
${DESTDIR}${BINDIR}/${VOLUME}

25
share/doc/usd/13.viref/Makefile Normal file
View File

@ -0,0 +1,25 @@
# From: @(#)Makefile 8.16 (Berkeley) 8/15/94
# $Id$
VOLUME= usd/13.viref
SRCS= vi.ref ${.OBJDIR}/index.so
FILES= ${SRCS} ex.cmd.roff set.opt.roff vi.cmd.roff
MACROS= -me
CLEANFILES+=vi.ref.txt index index.so
USE_SOELIM= yes
USE_TBL= yes
SRCDIR= ${.CURDIR}/../../../../usr.bin/vi/USD.doc/vi.ref
# some day, this will actually work...
${.OBJDIR}/index.so: vi.ref
# Build index.so, side-effect of building the paper.
(cd ${SRCDIR}; soelim vi.ref) | ${TBL} | ${ROFF} > /dev/null
sed -e 's/MINUSSIGN/\\-/' \
-e 's/DOUBLEQUOTE/""/' \
-e "s/SQUOTE/'/" \
-e 's/ /__SPACE/g' < index | \
sort -u '-t ' +0 -1 +1n | awk -f ${SRCDIR}/merge.awk | \
sed -e 's/__SPACE/ /g' > index.so
rm -f index
.include <bsd.doc.mk>

7
share/doc/usd/18.msdiffs/Makefile
View File

@ -1,7 +1,8 @@
# @(#)Makefile 8.1 (Berkeley) 6/8/93
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
DIR= usd/18.msdiffs
VOLUME= usd/18.msdiffs
SRCS= ms.diffs
MACROS= -msU
MACROS= -ms
.include <bsd.doc.mk>

5
share/doc/usd/19.memacros/Makefile
View File

@ -1,6 +1,7 @@
# @(#)Makefile 8.1 (Berkeley) 6/8/93
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
DIR= usd/19.memacros
VOLUME= usd/19.memacros
SRCS= intro.me
MACROS= -me

5
share/doc/usd/20.meref/Makefile
View File

@ -1,6 +1,7 @@
# @(#)Makefile 8.1 (Berkeley) 6/8/93
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
DIR= usd/20.meref
VOLUME= usd/20.meref
SRCS= ref.me
MACROS= -me

10
share/doc/usd/30.rogue/Makefile Normal file
View File

@ -0,0 +1,10 @@
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
DIR= usd/30.rogue
SRCS= rogue.me
MACROS= -me
SRCDIR= ${.CURDIR}/../../../../games/rogue/USD.doc
USE_TBL= yes
.include <bsd.doc.mk>

10
share/doc/usd/31.trek/Makefile Normal file
View File

@ -0,0 +1,10 @@
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
VOLUME= usd/31.trek
SRCS= trek.me
MACROS= -me
SRCDIR= ${.CURDIR}/../../../../games/trek/USD.doc
USE_TBL= yes
.include <bsd.doc.mk>

33
share/doc/usd/Makefile
View File

@ -1,24 +1,19 @@
# @(#)Makefile 8.2 (Berkeley) 4/20/94
# From: @(#)Makefile 8.2 (Berkeley) 4/20/94
# $Id$
# The following modules do not build/install:
# 08.mh
# The following modules are encumbered:
# 01.begin 02.learn 03.shell 05.dc 06.bc 09.edtut 10.edadv 15.sed 16.awk
# 17.msmacros 21.troff 22.trofftut 23.eqn 24.eqnguide 25.tbl 26.refer
# 27.invert 28.bib 29.diction
# The following modules are not provided:
# 14.jove
# The following modules use -me (which doesn't work)
# 19.memacros 20.meref 30.rogue 31.trek
BINDIR= /usr/share/doc/usd
FILES= 00.contents Makefile Title
SUBDIR= 01.begin 02.learn 03.shell 04.csh 05.dc 06.bc 07.mail 09.edtut \
10.edadv 11.vitut 12.exref 13.viref 14.jove 15.sed 16.awk 17.msmacros \
18.msdiffs 19.memacros 20.meref 21.troff 22.trofftut 23.eqn \
24.eqnguide 25.tbl 26.refer 27.invert 28.bib 29.diction 30.rogue \
31.trek
Title.ps: ${FILES}
groff Title > ${.TARGET}
contents.ps: ${FILES}
groff -ms 00.contents > ${.TARGET}
beforeinstall:
install -c -o ${BINOWN} -g ${BINGRP} -m 444 ${FILES} \
${DESTDIR}${BINDIR}
SUBDIR= title contents 04.csh 07.mail 10.exref 11.vitut 12.vi 13.viref \
18.msdiffs
.include <bsd.subdir.mk>

9
share/doc/usd/contents/Makefile Normal file
View File

@ -0,0 +1,9 @@
# $Id$
VOLUME= usd
SRCS= contents.ms
FILES= ${SRCS}
DOC= contents
MACROS= -ms
.include <bsd.doc.mk>

262
share/doc/usd/contents/contents.ms Normal file
View File

@ -0,0 +1,262 @@
.\" Copyright (c) 1986, 1993
.\" 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 8.2 (Berkeley) 4/20/94
.\"
.de ND
.KE
.sp
.KS
..
.OH '''USD Contents'
.EH 'USD Contents'''
.TL
UNIX User's Supplementary Documents (USD)
.sp
\s-24.4 Berkeley Software Distribution\s+2
.sp
\fRJune, 1993\fR
.PP
This volume contains documents which supplement the manual pages in
.I
The Unix User's Reference Manual
.R
for the 4.4BSD system as distributed by U.C. Berkeley.
.sp
.KS
.SH
Getting Started
.ND
.IP
.tl 'Unix for Beginners \- Second Edition''USD:1'
.QP
An introduction to the most basic uses of the system.
.ND
.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.
.ND
.SH
Basic Utilities
.ND
.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.
.ND
.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.
.ND
.IP
.tl 'DC \- An Interactive Desk Calculator''USD:5'
.QP
A super HP calculator, if you do not need floating point.
.ND
.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.
.ND
.SH
Communicating with the World
.ND
.IP
.tl 'Mail Reference Manual''USD:7'
.QP
Complete details on one of the programs for sending and reading your mail.
.ND
.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.
.ND
.SH
Text Editing
.ND
.IP
.tl 'A Tutorial Introduction to the Unix Text Editor''USD:9'
.QP
An easy way to get started with the line editor,
.I ed.
.ND
.IP
.tl 'Advanced Editing on Unix''USD:10'
.QP
The next step.
.ND
.IP
.tl 'An Introduction to Display Editing with Vi''USD:11'
.QP
The document to learn to use the \fIvi\fR screen editor.
.ND
.IP
.tl 'Ex Reference Manual (Version 3.7)''USD:12'
.QP
The final reference for the \fIex\fR editor.
.ND
.IP
.tl 'Vi Reference Manual''USD:13'
.QP
The definitive reference for the \fInvi\fR editor.
.ND
.IP
.tl 'Jove Manual for UNIX Users''USD:14'
.QP
Jove is a small, self-documenting, customizable display editor, based on
EMACS. A plausible alternative to
.I vi.
.ND
.IP
.tl 'SED \- A Non-interactive Text Editor''USD:15'
.QP
Describes a one-pass variant of
.I ed
useful as a filter for processing large files.
.ND
.IP
.tl 'AWK \- A Pattern Scanning and Processing Language (Second Edition)''USD:16'
.QP
A program for data selection and transformation.
.ND
.SH
Document Preparation
.ND
.IP
.tl 'Typing Documents on UNIX: Using the \-ms Macros with Troff and Nroff''USD:17'
.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.
.ND
.IP
.tl 'A Revised Version of \-ms''USD:18'
.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'
.QP
Another popular macro package for
.I nroff.
.ND
.IP
.tl '\-me Reference Manual''USD:20'
.QP
The final word on \-me.
.ND
.IP
.tl 'NROFF/TROFF User\'s Manual''USD:21'
.QP
Extremely detailed information about these document formatting programs.
.ND
.IP
.tl 'A TROFF Tutorial''USD:22'
.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.
.ND
.IP
.tl 'A System for Typesetting Mathematics''USD:23'
.QP
Describes
.I eqn,
an easy-to-learn language for high-quality mathematical typesetting.
.ND
.IP
.tl 'Typesetting Mathematics \- User\'s Guide (Second Edition)''USD:24'
.QP
More details about how to use
.I eqn.
.ND
.IP
.tl 'Tbl \- A Program to Format Tables''USD:25'
.QP
A program for easily typesetting tabular material.
.ND
.IP
.tl 'Refer \- A Bibliography System''USD:26'
.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.
.ND
.IP
.tl 'Some Applications of Inverted Indexes on the UNIX System''USD:27'
.QP
Mike Lesk's paper describes the
.I refer
programs in a somewhat larger context.
.ND
.IP
.tl 'BIB \- A Program for Formatting Bibliographies''USD:28'
.QP
This is an alternative to
.I refer
for expanding citations in documents.
.ND
.IP
.tl 'Writing Tools \- The STYLE and DICTION Programs''USD:29'
.QP
These are programs which can help you understand and improve your
writing style.
.ND
.SH
Amusements
.ND
.IP
.tl 'A Guide to the Dungeons of Doom''USD:30'
.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'
.QP
You are the Captain of the Starship Enterprise. Wipe out the
Klingons and save the Federation.
.KE

8
share/doc/usd/title/Makefile Normal file
View File

@ -0,0 +1,8 @@
# $Id$
VOLUME= usd
SRCS= Title
FILES= ${SRCS}
DOC= Title
.include <bsd.doc.mk>

120
share/doc/usd/title/Title Normal file
View File

@ -0,0 +1,120 @@
.\" Copyright (c) 1986, 1993 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 8.2 (Berkeley) 4/19/94
.\"
.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.4 Berkeley Software Distribution
.sp |5.75i
.ft R
.pt 12
.vs 16
.ce
June, 1993
.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
\&
.sp |1i
.hy 0
.ps 10
.vs 12p
Copyright 1979, 1980, 1983, 1986, 1993
The Regents of the University of California. All rights reserved.
.sp 2
Other than the specific documents listed below as copyrighted by AT&T,
redistribution and use of this manual in source and binary forms,
with or without modification, are permitted provided that the
following conditions are met:
.sp 0.5
.in +0.2i
.ta 0.2i
.ti -0.2i
1) Redistributions of this manual must retain the copyright
notices on this page, this list of conditions and the following disclaimer.
.ti -0.2i
2) Software or documentation that incorporates part of this manual must
reproduce the copyright notices on this page, this list of conditions and
the following disclaimer in the documentation and/or other materials
provided with the distribution.
.ti -0.2i
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.''
.ti -0.2i
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.
.in -0.2i
.sp
\fB\s-1THIS 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.\s+1\fP
.sp 2
Documents USD:1, 2, 3, 5, 6, 9, 10, 15, 16, 17, 21, 22, 23, 24, 25, 26, 27,
and 29 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, 14, and 28 are part of the
user contributed software.
.sp 2
The views and conclusions contained in this manual are those of the
authors and should not be interpreted as representing official policies,
either expressed or implied, of the Regents of the University of California.