[mod.unix] Unix Technical Digest V1 #13

Ron Heiby (The Moderator) <unix-request@cbosgd.UUCP> (03/12/85)

Unix Technical Digest       Tue, 12 Feb 85       Volume  1 : Issue  13

Today's Topics:
                   System V documentation (4 msgs)
----------------------------------------------------------------------

Date: 21 Feb 85 22:55:25 GMT
From: glenm@mako.UUCP (Glen McCluskey)
Subject: System V documentation

In the AT&T Commercial Sales Documentation Catalog, a number
of publications are listed pertaining to System V.  It is not
clear what each of these pertain to based on the title.  Can
anyone help with this?

	User Reference Manual		307-109
	Programmer Reference Manual	307-113
	Programming Guide		307-103
	User Guide			307-100
	Shell Commands & Programming	307-123

Which if any of these correspond to the UNIX Programmer's
Manual, volumes 1 and 2?

	Glen McCluskey
	..tektronix!mako!glenm

------------------------------

Date: 25 Feb 85 14:58:57 GMT
From: cmf@cwruecmp.UUCP (Carl Fongheiser)
Subject: System V documentation

As it happens, you need ALL of these manuals to be equivalent to the V7
UNIX Programmer's Manual.  You still don't get everything, since documentation
on terminal ioctl's can only be found in the System Management Utilities Guide
(name may not be quite right, but it should be pretty close).

	Carl Fongheiser
	...!decvax!cwruecmp!cmf (UUCP)
	cmf@case		(CSnet)
	cmf%case@CSnet-relay.ARPA (Internet)

------------------------------

Date: 26 Feb 85 20:29:56 GMT
From: guy@rlgvax.UUCP (Guy Harris)
Subject: System V documentation

> As it happens, you need ALL of these manuals to be equivalent to the V7
> UNIX Programmer's Manual.

And probably still more stuff; our S5R2 documentation isn't quite the size
of our VMS documentation, but it's getting there (note: no value judgement
is being made).

> You still don't get everything, since documentation on terminal ioctl's
> can only be found in the System Management Utilities Guide (name may not
> be quite right, but it should be pretty close).

Actually, it's the Administrator's Reference Manual, but no matter how
thinly it's sliced it's still bologna.  *It doesn't belong there, it belongs
in the Programmer's Reference Manual*, which is where we're putting it
(are you listening, AT&T?).  The only part useful to admins is the disk
partitioning.  The rest is of infinitely more use to programmers than to
admins.

	Guy Harris
	{seismo,ihnp4,allegra}!rlgvax!guy

------------------------------

Date: 26 Feb 85 19:05:52 GMT
From: jss@sftri.UUCP (J.S.Schwarz)
Subject: System V documentation

In reply to the question of what is in the various System V "books"
I had the following on my shelf.

> 	User Reference Manual		307-109
		Section 1 (commands) and 6 (games)

> 	Programmer Reference Manual	307-113
		Section 2 (system calls), 3 (library), 4 (file formats)
		and 5 (miscellany).  Section 3 is subdived these days
	
> 	Programming Guide		307-103
		Papers on C, C Libraries, Lint, Sdb, Fortran
		Ratfor, EFL, Curses and Terminfo

> 	User Guide			307-100
		I don't have this one.
[Ed note:  I borrowed a copy of this.  It is mainly new user type information
and covers the file system, logging on and off, basic capabilities of Unix,
and Tutorials on ed, vi, sh, and "communication" (mail, uname, uuname, uuto).
There are also some quick references and glossary.  RWH.]

> 	Shell Commands & Programming	307-123
		I don't have this one
[Ed note:  I looked through a copy of this one, too.  It seems to be a more
descriptive document covering pretty much the same stuff as sh(1) in the
User Ref Man.  I would use it after the sh tutorial in the User Guide (or
maybe concurrently).  The highlight seems to be several non-trivial example
shell scripts in the back, along with some explanation.  RWH]

Also available (although not mentioned in the original question are)

>	Administrator Reference Manual	307-111
		Section 1M (commands that mostly reside in /etc)
		and Section 7 (special files, including termio stuff)
		and Section 8 (system maintenance procedures)

>	Support Tools			307-108
		Papers on make, sccs, m4, awk, ld, coff (common object
		file format), bc, lex, yacc, rje, uucp.

>	Editing Guide			307-126
		Papers on  ed, vi, sed, bfs

Mostly the "papers" are recycled Bell Labs memos rather than new
documentation.

	Jerry Schwarz
	ihnp4!attunix!jss
	Bell Labs
	Summit, N.J 

------------------------------

End of Unix Technical Digest
******************************
-- 
Ronald W. Heiby / ihnp4!{wnuxa!heiby|wnuxb!netnews}
AT&T Information Systems, Inc.
Lisle, IL  (CU-D21)