[comp.unix.questions] Summary of SCCS document references

rsalz@bbn.com (Rich Salz) (06/06/88)

A few weeks ago I asked for information on any documentats about SCCS --
papers, proceedings, etc.  Thanks to
	George W. Leach <reggie@pdn.uucp>
	Sandy Franklin <franklin%asbf-imp.huachuca-em.arpa@HUACHUCA-EM.ARPA>
	Tracey Baker <mhuxu!tab>
	Sharan Kalwani <mcf!shan>

Here's the list of what I had and what I got.  My commentary is in [square
brackets].
	Allman's intro to SCCS, in PS1 of the 4.3BSD documents.
	[How to use a setuid front-end.]

	The Sun 3.x manual pages.  [Penultimate authority (source
	is the ultimate authority).  Fairly extensive.  The 4.3BSD
	manuals have the sccs(1) command (Allman's front-end), and
	refer to the other commands as get(SCCS), but don't have the
	actual documentation anywhere.  Strange.]

	Sun "Source Code Control System," in their "Programming
	Utilities" manual (orange tabs).  [This is an edit of
	Allman's document.]

	"N"th-generation photostat of "Source Code Control System
	User's Guide," which seems to be part of a PWB
	documentation set.  It was written by L. E. Bonanni and C.
	A. Salemi, and includes a three-page note by Bonanni and A.
	Guyton (4/1/80 revision) called "Function and Use of an
	SCCS Interface Program."  [Very detailed information on how
	to use almost every flag on every command.]

	Sun "Low Level SCCS," in their "Programming Utilities"
	manual.  [This is an edit of the Bonanni/Salemi document.]

	Rochkind, M.J., "The source code control system", IEEE
	Transactions on Software Engineering, SE-1(4), December
	1975, pp. 364-369.  [Real simple "what is SCCS and source
	control, anyway?" document.  Not surprising, given the
	date.]

	Rochkind, Marc J., "The Source Code Control System", in
	Proceedings of the First National Conference on Software
	Engineering, Washington, D.C., September 11-12, 1975, pp.
	37-43.  NOTE: this conference was sponsored by the National
	Bureau of Standards and the IEEE Computer Society.  IEEE
	Catalog No. 75CH0992-8C.  [Our library is tracking this
	down.]

I also got references to the following books.  Most are useless.
	A chapter on SCCS in "UNIX V and XENIX System V
	Programmer's Toolkit" by Myril Clement Shaw & Susan Soltis
	Shaw, TAB Books, 1986.  [Could not find.]

	A section on SCCS in "UNIX Shell Programming" by Lowell Jay
	Arthur, John Wiley & Sons, 1986.  [Could not find.]

       AT&T, "UNIX System V : Support Tools Guide", AT&T, 1986
       [If this is the one I remember, it's got a mostly-black
       cover and is a poorly-formatted intro.]

       AT&T, "UNIX System V : Programmer's Guide", Prentice Hall,
       1987.  [This is an edit of the Bonanni/Salemi document,
       with perhaps a bit more introduction.]

       K. Christian, "UNIX Operating System -- 2nd Edition", Wiley,
       1988.  [Has five pages (admin -i, get, get -e) and then ends
       with "it should now be apparent how to use SCCS in a mature
       software product."  Amazing]

The course notes for the "Unix System Software Development -- 1002" course
taught by AT&T Technologies got high marks from Sandy:
	"The issue I have is SG Issue 11/84, copyright 1984 by
	AT&T.  The SCCS section is broken down into 9 lessons, and
	contains exercises (with answers), covering such topics as
	Delta Numbering, the get Command, delta Command, SCCS ID
	Keywords, admin Command, prs Command, Supporting SCCS
	Commands, and SCCS Security Precautions."

A couple of people wanted to know what RCS documents I had.
Here's the list; all are by Walter Tichy:

	"Design, Implementation, and Evaluation of a Revision
	Control System," in Proceedings of the 6th International
	Conference on Software Engineering, IEEE, Tokyo, Sept.
	1982.  [Spends time comparing to SCCS, and a brief section
	on named revisions.]

	"RCS -- A System for Version Control" in Software --
	Practice and Experience, Vol. 15(7), pgs 637-654 (July
	1985). [Lots of info on the structure of the datafile.]

	BSD4.3 PS1 manual, "An Introduction to the Revision Control
	Systems." [Basic introduction and manpages.]
-- 
Please send comp.sources.unix-related mail to rsalz@uunet.uu.net.