[BACK]Return to u5 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / share / doc / usd / 01.begin

File: [cvs.NetBSD.org] / src / share / doc / usd / 01.begin / u5 (download)

Revision 1.1, Thu Nov 29 12:35:07 2007 UTC (13 years ago) by mjf
Branch: MAIN
CVS Tags: yamt-pf42-baseX, yamt-pf42-base4, yamt-pf42-base3, yamt-pf42-base2, yamt-pf42-base, yamt-pf42, yamt-pagecache-tag8, yamt-pagecache-base9, yamt-pagecache-base8, yamt-pagecache-base7, yamt-pagecache-base6, yamt-pagecache-base5, yamt-pagecache-base4, yamt-pagecache-base3, yamt-pagecache-base2, yamt-pagecache-base, yamt-pagecache, wrstuden-revivesa-base-3, wrstuden-revivesa-base-2, wrstuden-revivesa-base-1, wrstuden-revivesa-base, wrstuden-revivesa, tls-maxphys-base, tls-maxphys, tls-earlyentropy-base, tls-earlyentropy, riastradh-xf86-video-intel-2-7-1-pre-2-21-15, riastradh-drm2-base3, riastradh-drm2-base2, riastradh-drm2-base1, riastradh-drm2-base, riastradh-drm2, prg-localcount2-base3, prg-localcount2-base2, prg-localcount2-base1, prg-localcount2-base, prg-localcount2, phil-wifi-base, phil-wifi-20200421, phil-wifi-20200411, phil-wifi-20200406, phil-wifi-20191119, phil-wifi-20190609, phil-wifi, pgoyette-localcount-base, pgoyette-localcount-20170426, pgoyette-localcount-20170320, pgoyette-localcount-20170107, pgoyette-localcount-20161104, pgoyette-localcount-20160806, pgoyette-localcount-20160726, pgoyette-localcount, pgoyette-compat-merge-20190127, pgoyette-compat-base, pgoyette-compat-20190127, pgoyette-compat-20190118, pgoyette-compat-1226, pgoyette-compat-1126, pgoyette-compat-1020, pgoyette-compat-0930, pgoyette-compat-0906, pgoyette-compat-0728, pgoyette-compat-0625, pgoyette-compat-0521, pgoyette-compat-0502, pgoyette-compat-0422, pgoyette-compat-0415, pgoyette-compat-0407, pgoyette-compat-0330, pgoyette-compat-0322, pgoyette-compat-0315, pgoyette-compat, perseant-stdc-iso10646-base, perseant-stdc-iso10646, netbsd-9-base, netbsd-9-1-RELEASE, netbsd-9-0-RELEASE, netbsd-9-0-RC2, netbsd-9-0-RC1, netbsd-9, netbsd-8-base, netbsd-8-2-RELEASE, netbsd-8-1-RELEASE, netbsd-8-1-RC1, netbsd-8-0-RELEASE, netbsd-8-0-RC2, netbsd-8-0-RC1, netbsd-8, netbsd-7-nhusb-base-20170116, netbsd-7-nhusb-base, netbsd-7-nhusb, netbsd-7-base, netbsd-7-2-RELEASE, netbsd-7-1-RELEASE, netbsd-7-1-RC2, netbsd-7-1-RC1, netbsd-7-1-2-RELEASE, netbsd-7-1-1-RELEASE, netbsd-7-1, netbsd-7-0-RELEASE, netbsd-7-0-RC3, netbsd-7-0-RC2, netbsd-7-0-RC1, netbsd-7-0-2-RELEASE, netbsd-7-0-1-RELEASE, netbsd-7-0, netbsd-7, netbsd-6-base, netbsd-6-1-RELEASE, netbsd-6-1-RC4, netbsd-6-1-RC3, netbsd-6-1-RC2, netbsd-6-1-RC1, netbsd-6-1-5-RELEASE, netbsd-6-1-4-RELEASE, netbsd-6-1-3-RELEASE, netbsd-6-1-2-RELEASE, netbsd-6-1-1-RELEASE, netbsd-6-1, netbsd-6-0-RELEASE, netbsd-6-0-RC2, netbsd-6-0-RC1, netbsd-6-0-6-RELEASE, netbsd-6-0-5-RELEASE, netbsd-6-0-4-RELEASE, netbsd-6-0-3-RELEASE, netbsd-6-0-2-RELEASE, netbsd-6-0-1-RELEASE, netbsd-6-0, netbsd-6, netbsd-5-base, netbsd-5-2-RELEASE, netbsd-5-2-RC1, netbsd-5-2-3-RELEASE, netbsd-5-2-2-RELEASE, netbsd-5-2-1-RELEASE, netbsd-5-2, netbsd-5-1-RELEASE, netbsd-5-1-RC4, netbsd-5-1-RC3, netbsd-5-1-RC2, netbsd-5-1-RC1, netbsd-5-1-5-RELEASE, netbsd-5-1-4-RELEASE, netbsd-5-1-3-RELEASE, netbsd-5-1-2-RELEASE, netbsd-5-1-1-RELEASE, netbsd-5-1, netbsd-5-0-RELEASE, netbsd-5-0-RC4, netbsd-5-0-RC3, netbsd-5-0-RC2, netbsd-5-0-RC1, netbsd-5-0-2-RELEASE, netbsd-5-0-1-RELEASE, netbsd-5-0, netbsd-5, mjf-devfs2-base, mjf-devfs2, matt-premerge-20091211, matt-nb8-mediatek-base, matt-nb8-mediatek, matt-nb6-plus-nbase, matt-nb6-plus-base, matt-nb6-plus, matt-nb5-pq3-base, matt-nb5-pq3, matt-nb5-mips64-u2-k2-k4-k7-k8-k9, matt-nb5-mips64-u1-k1-k5, matt-nb5-mips64-premerge-20101231, matt-nb5-mips64-premerge-20091211, matt-nb5-mips64-k15, matt-nb5-mips64, matt-nb4-mips64-k7-u2a-k9b, matt-mips64-premerge-20101231, matt-mips64-base2, matt-armv6-nbase, matt-armv6-base, localcount-20160914, keiichi-mipv6-nbase, keiichi-mipv6-base, keiichi-mipv6, jym-xensuspend-nbase, jym-xensuspend-base, jym-xensuspend, is-mlppp-base, is-mlppp, hpcarm-cleanup-nbase, hpcarm-cleanup-base, cube-autoconf-base, cube-autoconf, cherry-xenmp-base, cherry-xenmp, bouyer-socketcan-base1, bouyer-socketcan-base, bouyer-socketcan, bouyer-quota2-nbase, bouyer-quota2-base, bouyer-quota2, agc-symver-base, agc-symver, HEAD
Branch point for: matt-armv6

Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.

.\"	$NetBSD: u5,v 1.1 2007/11/29 12:35:07 mjf Exp $
.\"
.\" Copyright (C) Caldera International Inc.  2001-2002.
.\" 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 and documentation 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 or owned by Caldera
.\"	International, Inc.
.\" 4. Neither the name of Caldera International, Inc. nor the names of other
.\"    contributors may be used to endorse or promote products derived from
.\"    this software without specific prior written permission.
.\"
.\" USE OF THE SOFTWARE PROVIDED FOR UNDER THIS LICENSE BY CALDERA
.\" INTERNATIONAL, INC. 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 CALDERA INTERNATIONAL, INC. 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.
.\"
.\"	@(#)u5	8.1 (Berkeley) 6/8/93
.\"
.SH
V.  UNIX READING LIST
.SH
General:
.LP
K. L. Thompson and D. M. Ritchie,
.IT The
.ul
.UC UNIX
.ul
Programmer's Manual,
Bell Laboratories, 1978 (PS2:3)\(dd
Lists commands,
system routines and interfaces, file formats,
and some of the maintenance procedures.
You can't live without this,
although you will probably only need to read section 1.
.LP
D. M. Ritchie and K. L. Thompson,
``The
.UC UNIX
Time-sharing System,''
CACM, July 1974. (PS2:1)\(dd
.FS
\(dg These documents (previously in Volume 2 of the Bell Labs
Unix distribution) are provided among the "User Supplementary"
Documents for 4.3BSD, available from the Usenix Association.
.FE
.FS
\(dd These are among the "Programmer Supplementary" Documents for 4.3BSD.
PS1 is Volume 1, PS2 is Volume 2.
.FE
An overview of the system,
for people interested in operating systems.
Worth reading by anyone who programs.
Contains a remarkable number of one-sentence observations
on how to do things right.
.LP
The Bell System Technical Journal
(BSTJ)
Special Issue on 
.UC UNIX ,
July/August, 1978,
contains many papers describing recent developments,
and some retrospective material.
.LP
The 2nd International Conference on Software Engineering
(October, 1976)
contains several 
papers describing the use of the
Programmer's Workbench
.UC PWB ) (
version of
.UC UNIX .
.SH
Document Preparation:
.LP
B. W. Kernighan,
``A Tutorial Introduction to the
.UC UNIX
Text Editor'' (USD:12)
and
``Advanced Editing on
.UC UNIX ,''
(USD:13) Bell Laboratories, 1978.\(dg
Beginners need the introduction;
the advanced material will help you get the most
out of the editor.
.LP
M. E. Lesk,
``Typing Documents on
.UC UNIX ,''
Bell Laboratories, 1978. (USD:20)\(dg
Describes the
.UL \-ms
macro package, which isolates the novice
from the vagaries of
.UL nroff
and
.UL troff ,
and takes care of most formatting situations.
If this specific package isn't available on your system,
something similar probably is.
The most likely alternative is the
.UC PWB/UNIX
macro package
.UL \-mm ;
see your local guru if you use
.UC PWB/UNIX .*
.FS
*The macro package -me is additionally available on Berkeley Unix Systems.
-mm is typically not available.
.FE
.LP
B. W. Kernighan and L. L. Cherry,
``A System for Typesetting Mathematics,''
Bell Laboratories Computing Science Tech. Rep. 17. (USD:26)\(dg
.LP
M. E. Lesk,
``Tbl \(em A Program to Format Tables,''
Bell Laboratories CSTR 49, 1976. (USD:28)\(dg
.LP
J. F. Ossanna, Jr.,
``NROFF/TROFF User's Manual,''
Bell Laboratories CSTR 54, 1976. (USD:24)\(dg
.UL troff
is the basic formatter used by
.UL \-ms ,
.UL eqn
and
.UL tbl .
The reference manual is indispensable
if you are going to write or maintain these
or similar programs.
But start with:
.LP
B. W. Kernighan,
``A TROFF Tutorial,''
Bell Laboratories, 1976. (USD:25)\(dg
An attempt to unravel the intricacies of
.UL troff .
.SH
Programming:
.LP
B. W. Kernighan and D. M. Ritchie,
.ul
The C Programming Language,
Prentice-Hall, 1978.
Contains a tutorial introduction,
complete discussions of all language features,
and the reference manual.
.LP
B. W. Kernighan and R. Pike,
.ul
The Unix Programming Environment,
Prentice-Hall, 1984.
Contains many examples of C programs which use the system
interfaces, and explanations of ``why''.
.LP
B. W. Kernighan and D. M. Ritchie,
.UC UNIX \& ``
Programming,''
Bell Laboratories, 1978. (PS2:3)\(dd
Describes how to interface with the system from C programs:
I/O calls, signals, processes.
.LP
S. R. Bourne,
``An Introduction to the
.UC UNIX
Shell,''
Bell Laboratories, 1978. (USD:3)\(dg
An introduction and reference manual for the Version 7 shell.
Mandatory reading if you intend to make effective use
of the programming power
of this shell.
.LP
S. C. Johnson,
``Yacc \(em Yet Another Compiler-Compiler,''
Bell Laboratories CSTR 32, 1978. (PS1:15)\(dd
.LP
M. E. Lesk,
``Lex \(em A Lexical Analyzer Generator,''
Bell Laboratories CSTR 39, 1975. (PS1:16)\(dd
.LP
S. C. Johnson,
``Lint, a C Program Checker,''
Bell Laboratories CSTR 65, 1977. (PS1:9)\(dd
.LP
S. I. Feldman,
``MAKE \(em A Program for Maintaining Computer Programs,''
Bell Laboratories CSTR 57, 1977. (PS1:12)\(dd
.LP
J. F. Maranzano and S. R. Bourne,
``A Tutorial Introduction to ADB,''
Bell Laboratories CSTR 62, 1977. (PS1:10)\(dd
An introduction to a powerful but complex debugging tool.
.LP
S. I. Feldman and P. J. Weinberger,
``A Portable Fortran 77 Compiler,''
Bell Laboratories, 1978. (PS1:2)\(dd
A full Fortran 77 for
.UC UNIX
systems.