Sync usage with man page.
[netbsd-mini2440.git] / share / doc / usd / 01.begin / u5
blob60870b037bf30748a866af9acb4389c275a82094
1 .\"     $NetBSD$
2 .\"
3 .\" Copyright (C) Caldera International Inc.  2001-2002.
4 .\" 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 and documentation must retain the above
10 .\"    copyright 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. All advertising materials mentioning features or use of this software
15 .\"    must display the following acknowledgement:
16 .\"     This product includes software developed or owned by Caldera
17 .\"     International, Inc.
18 .\" 4. Neither the name of Caldera International, Inc. nor the names of other
19 .\"    contributors may be used to endorse or promote products derived from
20 .\"    this software without specific prior written permission.
21 .\"
22 .\" USE OF THE SOFTWARE PROVIDED FOR UNDER THIS LICENSE BY CALDERA
23 .\" INTERNATIONAL, INC. AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR
24 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
25 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
26 .\" IN NO EVENT SHALL CALDERA INTERNATIONAL, INC. BE LIABLE FOR ANY DIRECT,
27 .\" INDIRECT INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
28 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
29 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
31 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
32 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33 .\" POSSIBILITY OF SUCH DAMAGE.
34 .\"
35 .\"     @(#)u5  8.1 (Berkeley) 6/8/93
36 .\"
37 .SH
38 V.  UNIX READING LIST
39 .SH
40 General:
41 .LP
42 K. L. Thompson and D. M. Ritchie,
43 .IT The
44 .ul
45 .UC UNIX
46 .ul
47 Programmer's Manual,
48 Bell Laboratories, 1978 (PS2:3)\(dd
49 Lists commands,
50 system routines and interfaces, file formats,
51 and some of the maintenance procedures.
52 You can't live without this,
53 although you will probably only need to read section 1.
54 .LP
55 D. M. Ritchie and K. L. Thompson,
56 ``The
57 .UC UNIX
58 Time-sharing System,''
59 CACM, July 1974. (PS2:1)\(dd
60 .FS
61 \(dg These documents (previously in Volume 2 of the Bell Labs
62 Unix distribution) are provided among the "User Supplementary"
63 Documents for 4.3BSD, available from the Usenix Association.
64 .FE
65 .FS
66 \(dd These are among the "Programmer Supplementary" Documents for 4.3BSD.
67 PS1 is Volume 1, PS2 is Volume 2.
68 .FE
69 An overview of the system,
70 for people interested in operating systems.
71 Worth reading by anyone who programs.
72 Contains a remarkable number of one-sentence observations
73 on how to do things right.
74 .LP
75 The Bell System Technical Journal
76 (BSTJ)
77 Special Issue on 
78 .UC UNIX ,
79 July/August, 1978,
80 contains many papers describing recent developments,
81 and some retrospective material.
82 .LP
83 The 2nd International Conference on Software Engineering
84 (October, 1976)
85 contains several 
86 papers describing the use of the
87 Programmer's Workbench
88 .UC PWB ) (
89 version of
90 .UC UNIX .
91 .SH
92 Document Preparation:
93 .LP
94 B. W. Kernighan,
95 ``A Tutorial Introduction to the
96 .UC UNIX
97 Text Editor'' (USD:12)
98 and
99 ``Advanced Editing on
100 .UC UNIX ,''
101 (USD:13) Bell Laboratories, 1978.\(dg
102 Beginners need the introduction;
103 the advanced material will help you get the most
104 out of the editor.
106 M. E. Lesk,
107 ``Typing Documents on
108 .UC UNIX ,''
109 Bell Laboratories, 1978. (USD:20)\(dg
110 Describes the
111 .UL \-ms
112 macro package, which isolates the novice
113 from the vagaries of
114 .UL nroff
116 .UL troff ,
117 and takes care of most formatting situations.
118 If this specific package isn't available on your system,
119 something similar probably is.
120 The most likely alternative is the
121 .UC PWB/UNIX
122 macro package
123 .UL \-mm ;
124 see your local guru if you use
125 .UC PWB/UNIX .*
127 *The macro package -me is additionally available on Berkeley Unix Systems.
128 -mm is typically not available.
131 B. W. Kernighan and L. L. Cherry,
132 ``A System for Typesetting Mathematics,''
133 Bell Laboratories Computing Science Tech. Rep. 17. (USD:26)\(dg
135 M. E. Lesk,
136 ``Tbl \(em A Program to Format Tables,''
137 Bell Laboratories CSTR 49, 1976. (USD:28)\(dg
139 J. F. Ossanna, Jr.,
140 ``NROFF/TROFF User's Manual,''
141 Bell Laboratories CSTR 54, 1976. (USD:24)\(dg
142 .UL troff
143 is the basic formatter used by
144 .UL \-ms ,
145 .UL eqn
147 .UL tbl .
148 The reference manual is indispensable
149 if you are going to write or maintain these
150 or similar programs.
151 But start with:
153 B. W. Kernighan,
154 ``A TROFF Tutorial,''
155 Bell Laboratories, 1976. (USD:25)\(dg
156 An attempt to unravel the intricacies of
157 .UL troff .
159 Programming:
161 B. W. Kernighan and D. M. Ritchie,
163 The C Programming Language,
164 Prentice-Hall, 1978.
165 Contains a tutorial introduction,
166 complete discussions of all language features,
167 and the reference manual.
169 B. W. Kernighan and R. Pike,
171 The Unix Programming Environment,
172 Prentice-Hall, 1984.
173 Contains many examples of C programs which use the system
174 interfaces, and explanations of ``why''.
176 B. W. Kernighan and D. M. Ritchie,
177 .UC UNIX \& ``
178 Programming,''
179 Bell Laboratories, 1978. (PS2:3)\(dd
180 Describes how to interface with the system from C programs:
181 I/O calls, signals, processes.
183 S. R. Bourne,
184 ``An Introduction to the
185 .UC UNIX
186 Shell,''
187 Bell Laboratories, 1978. (USD:3)\(dg
188 An introduction and reference manual for the Version 7 shell.
189 Mandatory reading if you intend to make effective use
190 of the programming power
191 of this shell.
193 S. C. Johnson,
194 ``Yacc \(em Yet Another Compiler-Compiler,''
195 Bell Laboratories CSTR 32, 1978. (PS1:15)\(dd
197 M. E. Lesk,
198 ``Lex \(em A Lexical Analyzer Generator,''
199 Bell Laboratories CSTR 39, 1975. (PS1:16)\(dd
201 S. C. Johnson,
202 ``Lint, a C Program Checker,''
203 Bell Laboratories CSTR 65, 1977. (PS1:9)\(dd
205 S. I. Feldman,
206 ``MAKE \(em A Program for Maintaining Computer Programs,''
207 Bell Laboratories CSTR 57, 1977. (PS1:12)\(dd
209 J. F. Maranzano and S. R. Bourne,
210 ``A Tutorial Introduction to ADB,''
211 Bell Laboratories CSTR 62, 1977. (PS1:10)\(dd
212 An introduction to a powerful but complex debugging tool.
214 S. I. Feldman and P. J. Weinberger,
215 ``A Portable Fortran 77 Compiler,''
216 Bell Laboratories, 1978. (PS1:2)\(dd
217 A full Fortran 77 for
218 .UC UNIX
219 systems.