Sync usage with man page.
[netbsd-mini2440.git] / share / doc / psd / 00.contents
blobf1a15b439cfe0988fbe80348793ca612397bc1d9
1 .\"     $NetBSD: 00.contents,v 1.2 1998/01/09 06:54:37 perry Exp $
2 .\"
3 .\" Copyright (c) 1986, 1993
4 .\"     The Regents of the University of California.  All rights reserved.
5 .\"
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
8 .\" are met:
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\"    notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\"    notice, this list of conditions and the following disclaimer in the
13 .\"    documentation and/or other materials provided with the distribution.
14 .\" 3. Neither the name of the University nor the names of its contributors
15 .\"    may be used to endorse or promote products derived from this software
16 .\"    without specific prior written permission.
17 .\"
18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" SUCH DAMAGE.
29 .\"
30 .\"     @(#)00.contents 8.1 (Berkeley) 6/8/93
31 .\"
32 .OH '''PSD Contents'
33 .EH 'PSD Contents'''
34 .TL
35 UNIX Programmer's Supplementary Documents (PSD)
36 .sp
37 \s-24.4 Berkeley Software Distribution\s+2
38 .sp
39 \fRJune, 1993\fR
40 .PP
41 This volume contains documents which supplement the manual pages in
43 The
44 .UX
45 Programmer's Reference Manual
47 for the 4.4BSD system as distributed by U.C. Berkeley.
48 .SH
49 Documents of Historical Interest
50 .IP
51 .tl 'The Unix Time\-Sharing System''PSD:1'
52 .QP
53 Dennis Ritchie and Ken Thompson's original paper about UNIX, reprinted 
54 from Communications of the ACM.
56 .IP
57 .tl 'Unix Implementation''PSD:2'
58 .QP
59 Ken Thompson's description of the implementation of the Version 7
60 kernel and file system.
62 .IP
63 .tl 'The Unix I/O System''PSD:3'
64 .QP
65 Dennis Ritchie's overview of the I/O System of Version 7; still helpful for 
66 those writing device drivers.
68 .IP
69 .tl 'Unix Programming \- Second Edition ''PSD:4'
70 .QP
71 Describes the programming interface to the UNIX version 7 operating
72 system and the standard I/O library.  Should be supplemented by
73 Kernighan and Pike, ``The UNIX Programming Environment'',
74 Prentice-Hall, 1984 and especially by the Programmer Reference Manual
75 section 2 (system calls) and 3 (library routines).
77 .IP
78 .tl 'Berkeley Software Architecture Manual (4.4 Edition)''PSD:5'
79 .QP
80 A concise and terse description of the system call interface
81 provided in Berkeley Unix, as revised for 4.4BSD.
82 This will never be a best seller.
84 .SH
85 Languages in common use
86 .IP
87 .tl 'The C Programming Language \- Reference Manual''PSD:6'
88 .QP
89 Official statement of the syntax of C.
90 Should be supplemented by ``The C Programming Language,''
91 B.W. Kernighan and D.M. Ritchie, Prentice-Hall, 1978, that
92 contains a tutorial introduction and many examples.
94 .IP
95 .tl 'Berkeley Pascal User\'s Manual''PSD:7'
96 .QP
97 An implementation of this language popular for learning to program.
99 .IP
100 .tl 'A Portable Fortran 77 Compiler''PSD:8'
102 A revised version of the document which originally appeared in
103 Volume 2b of the Bell Labs documentation;
104 this version reflects the work done at Berkeley.
107 .tl 'Introduction to the f77 I/O Library''PSD:9'
109 A description of the revised input/output library for Fortran 77, 
110 reflecting work carried out at Berkeley.
113 Programming Tools
115 .tl 'Debugging with GDB: The GNU Source-Level Debugger''PSD:10'
117 How to debug programs using the source level \fIgdb\fP debugger
118 (or how to debug programs without having to know much about machine language).
121 .tl 'A Tutorial Introduction to ADB''PSD:11'
123 How to debug programs using the assembly-language level \fIadb\fP debugger.
126 .tl 'Make \- A Program for Maintaining Computer Programs''PSD:12'
128 Indispensable tool for making sure large programs are properly
129 compiled with minimal effort. 
132 .tl 'An Introduction to the Revision Control System''PSD:13'
134 RCS is a user-contributed tool for working together with other people
135 without stepping on each other's toes.
136 An alternative to \fIsccs\fR for controlling software changes.
139 .tl 'An Introduction to the Source Code Control System''PSD:14'
141 A useful introductory article for those users with
142 installations licensed for SCCS.
145 .tl 'YACC: Yet Another Compiler-Compiler''PSD:15'
147 Converts a BNF specification of a language and semantic actions
148 written in C into a compiler for that language.
151 .tl 'LEX \- A Lexical Analyzer Generator''PSD:16'
153 Creates a recognizer for a set of regular expressions:
154 each regular expression can be followed by arbitrary C code
155 to be executed upon finding the regular expression.
158 .tl 'The M4 Macro Processor''PSD:17'
160 M4 is a macro processor useful in its own right and as a
161 front-end for C, Ratfor, and Cobol.
164 .tl 'gprof: a Call Graph Execution Profiler''PSD:18'
166 A program to show the call graph and execution time of a program.
167 Indispensable aid for improving the running time of almost everything.
170 Programming Libraries
172 .tl 'Screen Updating and Cursor Movement Optimization''PSD:19'
174 Describes the \fIcurses\fP package, an aid for writing screen-oriented,
175 terminal-independent programs.
178 General Reference
180 .tl 'An Introductory 4.4BSD Interprocess Communication Tutorial''PSD:20'
182 How to write programs that use the Interprocess Communication Facilities
183 of 4.4BSD.
186 .tl 'An Advanced 4.4BSD Interprocess Communication Tutorial''PSD:21'
188 The reference document (with some examples) for the Interprocess Communication 
189 Facilities of 4.4BSD.