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

Make these documents build if possible.

Browse Source
This commit is contained in:
Garrett Wollman 1995-01-11 01:53:04 +00:00
parent 369cf5afc3
commit b7a1a0a5ff
17 changed files with 542 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
share/doc/psd/05.sysman/Makefile
View File

@ -1,11 +1,11 @@
# @(#)Makefile 8.1 (Berkeley) 6/8/93
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
DIR= psd/05.sysman
VOLUME= psd/05.sysman
SRCS= 0.t 1.0.t 1.1.t 1.2.t 1.3.t 1.4.t 1.5.t 1.6.t 1.7.t \
2.0.t 2.1.t 2.2.t 2.3.t 2.4.t 2.5.t a.t
MACROS= -ms
paper.ps: ${SRCS}
${TBL} ${SRCS} | ${ROFF} > ${.TARGET}
USE_TBL= yes
.include <bsd.doc.mk>

9
share/doc/psd/12.make/Makefile Normal file
View File

@ -0,0 +1,9 @@
# From: @(#)Makefile 8.1 (Berkeley) 8/14/93
# $Id$
VOLUME= psd/12.make
SRCS= tutorial.ms
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../usr.bin/make/PSD.doc
.include <bsd.doc.mk>

16
share/doc/psd/18.gprof/Makefile Normal file
View File

@ -0,0 +1,16 @@
# From: @(#)Makefile 8.1 (Berkeley) 8/14/93
# $Id$
VOLUME= psd/18.gprof
SRCS= header.me abstract.me intro.me profiling.me gathering.me \
postp.me present.me refs.me
DPADD= postp1.pic postp2.pic postp3.pic pres1.pic pres2.pic
MACROS= -me
SRCDIR= ${.CURDIR}/../../../../usr.bin/gprof/PSD.doc
USE_SOELIM= yes
USE_PIC= yes
USE_TBL= yes
USE_EQN= yes
.include <bsd.doc.mk>

46
share/doc/psd/19.curses/Makefile Normal file
View File

@ -0,0 +1,46 @@
# From: @(#)Makefile 8.1 (Berkeley) 8/14/93
# $Id$
VOLUME= psd/19.curses
SRCS= Master
MACROS= -me
LSRCDIR= ${.CURDIR}/../../../../lib/libcurses/PSD.doc
.PATH: ${LSRCDIR}
CLEANFILES+=win_st.gr twinkle1.gr twinkle2.gr life.gr intro.2.tbl appen.A.tbl \
ex1.gr ex2.gr ${DOC}.${PRINTER}+
.SUFFIXES:
.SUFFIXES: .c .gr
#
# this section formats C input source into nice troffable (or nroffable)
# versions. It uses the capabilites of "vgrind", which sets keywords in
# bold font, and comments in italics.
#
# Don't re-run vgrind unless you want to patch the output files.
VFONT= /usr/libexec/vfontedpr
.c.gr:
${VFONT} ${.IMPSRC} | grep -v "^'wh" > ${.TARGET}
.MAIN: all
Master: twinkle1.gr ex1.gr ex2.gr fns.doc intro.5 intro.2.tbl intro.0 intro.1 \
intro.3 intro.4 intro.6 macros c_macros appen.A
for a in Master ${.ALLSRC}; do \
test -e $$a || ln -s ${LSRCDIR}/$$a .; \
done
intro.2.tbl: intro.2
${TBL} ${LSRCDIR}/intro.2 > intro.2.tbl
#!!!bogus!!! If .ALLSRC worked right, this BS wouldn't be necessary.
SRCDIR= ${.OBJDIR}
.include <bsd.doc.mk>

10
share/doc/psd/20.ipctut/Makefile
View File

@ -1,13 +1,15 @@
# @(#)Makefile 8.1 (Berkeley) 8/14/93
# From: @(#)Makefile 8.1 (Berkeley) 8/14/93
# $Id$
DIR= psd/20.ipctut
VOLUME= psd/20.ipctut
SRCS= tutor.me
MACROS= -me
EXTRA= dgramread.c dgramsend.c fig2.pic fig3.pic fig8.pic pipe.c \
socketpair.c strchkread.c streamread.c streamwrite.c \
udgramread.c udgramsend.c ustreamread.c ustreamwrite.c
paper.ps: ${SRCS} ${EXTRA}
${SOELIM} ${SRCS} | ${PIC} | ${TBL} | ${ROFF} > ${.TARGET}
USE_SOELIM= yes
USE_PIC= yes
USE_TBL= yes
.include <bsd.doc.mk>

8
share/doc/psd/21.ipc/Makefile
View File

@ -1,10 +1,10 @@
# @(#)Makefile 8.1 (Berkeley) 6/8/93
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
DIR= psd/21.ipc
VOLUME= psd/21.ipc
SRCS= 0.t 1.t 2.t 3.t 4.t 5.t
MACROS= -ms
paper.ps: ${SRCS}
${TBL} ${SRCS} | ${ROFF} > ${.TARGET}
USE_TBL= yes
.include <bsd.doc.mk>

10
share/doc/psd/22.rpcgen/Makefile Normal file
View File

@ -0,0 +1,10 @@
# $Id$
VOLUME= psd/22.rpcgen
SRCS= rpcgen.ms
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../lib/libc/rpc/PSD.doc
USE_TBL= yes
.include <bsd.doc.mk>

11
share/doc/psd/23.rpc/Makefile Normal file
View File

@ -0,0 +1,11 @@
# $Id$
VOLUME= psd/23.rpc
SRCS= rpc.prog.ms
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../lib/libc/rpc/PSD.doc
USE_TBL= yes
USE_PIC= yes
.include <bsd.doc.mk>

10
share/doc/psd/24.xdr/Makefile Normal file
View File

@ -0,0 +1,10 @@
# $Id$
VOLUME= psd/24.xdr
SRCS= xdr.nts.ms
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../lib/libc/rpc/PSD.doc
USE_EQN= yes
.include <bsd.doc.mk>

10
share/doc/psd/25.xdrrfc/Makefile Normal file
View File

@ -0,0 +1,10 @@
# $Id$
VOLUME= psd/25.xdrrfc
SRCS= xdr.rfc.ms
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../lib/libc/rpc/PSD.doc
USE_TBL= yes
.include <bsd.doc.mk>

10
share/doc/psd/26.rpcrfc/Makefile Normal file
View File

@ -0,0 +1,10 @@
# $Id$
VOLUME= psd/26.rpcrfc
SRCS= rpc.rfc.ms
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../lib/libc/rpc/PSD.doc
USE_TBL= yes
.include <bsd.doc.mk>

10
share/doc/psd/27.nfsrpc/Makefile Normal file
View File

@ -0,0 +1,10 @@
# $Id$
VOLUME= psd/27.nfsrfc
SRCS= nfs.rfc.ms
MACROS= -ms
SRCDIR= ${.CURDIR}/../../../../lib/libc/rpc/PSD.doc
USE_TBL= yes
.include <bsd.doc.mk>

32
share/doc/psd/Makefile
View File

@ -1,22 +1,24 @@
# @(#)Makefile 8.1 (Berkeley) 6/8/93
# From: @(#)Makefile 8.1 (Berkeley) 6/8/93
# $Id$
# The following modules do not build/install:
# 10.gdb, 13.rcs
# The following modules are encumbered:
# 01.cacm 02.implement 03.iosys 04.uprog 06.Clang 11.adb 14.sccs
# 15.yacc 16.lex 17.m4
# The following modules do not apply to FreeBSD:
# 07.pascal 08.f77 09.f77io
# The following modules are new in FreeBSD:
# 22.rpcgen 23.rpc 24.xdr 25.xdrrfc 26.rpcrfc 27.nfsrfc
# The following modules use -me macros (which don't work):
# 20.ipctut 19.curses 18.gprof
BINDIR= /usr/share/doc/psd
FILES= 00.contents Makefile Title
SUBDIR= 01.cacm 02.implement 03.iosys 04.uprog 05.sysman 06.Clang \
07.pascal 08.f77 09.f77io 11.adb 12.make 14.sccs 15.yacc \
16.lex 17.m4 18.gprof 19.curses 20.ipctut 21.ipc
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 05.sysman 12.make 21.ipc \
22.rpcgen 23.rpc 24.xdr 25.xdrrfc 26.rpcrfc 27.nfsrpc
.include <bsd.subdir.mk>

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

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

231
share/doc/psd/contents/contents.ms Normal file
View File

@ -0,0 +1,231 @@
.\" 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.1 (Berkeley) 6/8/93
.\"
.OH '''PSD Contents'
.EH 'PSD Contents'''
.TL
UNIX Programmer's Supplementary Documents (PSD)
.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
.UX
Programmer's Reference Manual
.R
for the FreeBSD system as distributed by the FreeBSD Project. Documents
``(encumbered)'' are not distributed for legal reasons.
.SH
Documents of Historical Interest
.IP
.tl 'The Unix Time\-Sharing System''PSD:1'
.QP
Dennis Ritchie and Ken Thompson's original paper about UNIX, reprinted
from Communications of the ACM. (encumbered)
.IP
.tl 'Unix Implementation''PSD:2'
.QP
Ken Thompson's description of the implementation of the Version 7
kernel and file system. (encumbered)
.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)
.IP
.tl 'Unix Programming \- Second Edition ''PSD:4'
.QP
Describes the programming interface to the UNIX version 7 operating
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)
.IP
.tl 'Berkeley Software Architecture Manual (4.4 Edition)''PSD:5'
.QP
A concise and terse description of the system call interface
provided in Berkeley Unix, as revised for 4.4BSD.
This will never be a best seller.
.SH
Languages in common use
.IP
.tl 'The C Programming Language \- Reference Manual''PSD:6'
.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. (encumbered)
.IP
.tl 'Berkeley Pascal User\'s Manual''PSD:7'
.QP
An implementation of this language popular for learning to program.
(Not provided in FreeBSD.)
.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)
.IP
.tl 'Introduction to the f77 I/O Library''PSD:9'
.QP
A description of the revised input/output library for Fortran 77,
reflecting work carried out at Berkeley. (Not provided in FreeBSD.)
.SH
Programming Tools
.IP
.tl 'Debugging with GDB: The GNU Source-Level Debugger''PSD:10'
.QP
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.)
.IP
.tl 'A Tutorial Introduction to ADB''PSD:11'
.QP
How to debug programs using the assembly-language level \fIadb\fP debugger.
(encumbered)
.IP
.tl 'Make \- A Program for Maintaining Computer Programs''PSD:12'
.QP
Indispensable tool for making sure large programs are properly
compiled with minimal effort.
.IP
.tl 'An Introduction to the Revision Control System''PSD: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''PSD:14'
.QP
A useful introductory article for those users with
installations licensed for SCCS. (encumbered)
.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)
.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)
.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.
.IP
.tl 'gprof: a Call Graph Execution Profiler''PSD:18'
.QP
A program to show the call graph and execution time of a program.
Indispensable aid for improving the running time of almost everything.
.SH
Programming Libraries
.IP
.tl 'Screen Updating and Cursor Movement Optimization''PSD:19'
.QP
Describes the \fIcurses\fP package, an aid for writing screen-oriented,
terminal-independent programs.
.SH
General Reference
.IP
.tl 'An Introductory 4.4BSD Interprocess Communication Tutorial''PSD:20'
.QP
How to write programs that use the Interprocess Communication Facilities
of 4.4BSD.
.IP
.tl 'An Advanced 4.4BSD Interprocess Communication Tutorial''PSD:21'
.QP
The reference document (with some examples) for the Interprocess Communication
Facilities of 4.4BSD.
.IP
.tl 'RPCGEN Programming Guide''PSD:22'
.QP
Manual for the ONC RPC stub-generating program, provided by Sun Microsystems.
.IP
.tl 'Remote Procedure Call Programming Guide''PSD:23'
.QP
A tutorial introduction to programming the ONC RPC system, provided by
Sun Microsystems.
.IP
.tl 'External Data Representation: Sun Technical Notes''PSD:24'
.QP
Technical details about the design of the XDR component of ONC RPC,
provided by Sun Microsystems.
.IP
.tl 'External Data Representation Standard: Protocol Specification''PSD:25'
.QP
The Internet RFC specifying ONC XDR, provided by Sun Microsystems.
.IP
.tl 'Remote Procedure Calls: Protocol Specification''PSD:26'
.QP
The Internet RFC specifying ONC RPC, RFC 1050, as provided by Sun
Microsystems.
.IP
.tl 'Network File System: Version 2 Protocol Specification''PSD:27'
.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.

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

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

131
share/doc/psd/title/Title Normal file
View File

@ -0,0 +1,131 @@
.\" 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 3
UNIX Programmer's Supplementary Documents
(PSD)
.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 PSD:1, 2, 3, 4, 6, 11, 15, 16, and 17
are copyright 1979, AT&T Bell Laboratories, Incorporated.
Document PSD:8 is a modification of an earlier document that
is 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 PSD:10 is part of the user contributed software and is
copyright 1992 by the Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this document provided the copyright notice and this permission notice
are preserved on all copies.
.sp 2
Document PSD: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
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.