[unix-history] / usr / src / usr.bin / sccs / sccs.1

.TH SCCS 1
.UC
.SH NAME
sccs \- front end for the
.SM SCCS
subsystem
.SH SYNOPSIS
.B sccs
[
.B \-r
] [
.BI \-p path
] command [ flags ] [ args ]
.SH DESCRIPTION
.I Sccs
is a front end
to csvax:eric.
that make them mesh more cleanly
with the rest of UNIX.
It also runs as a special user
.B sccs
so that the
.SM SCCS
file protection
can be used to advantage.
.PP
Basically,
.I sccs
runs the
.I command
with the specified
.I flags
and
.I args.
Each
argument
is modified to be prepended
with ``SCCS/s.''
unless it begins with ``s.'',
contains a `\|/\|' character,
or specifies a directory.
.PP
Flags to be interpreted by the
.I sccs
program must be before the
.I command
argument.
Flags to be passed to the actual
.SM SCCS
program
must come after the
.I command
argument.
These flags are specific to the command
and are discussed in the documentation for that command.
.PP
The
.B \-r
flag runs
.I sccs
as the real user
rather than as the pseudo-user
.B sccs.
The
.B \-p
flag defines the pathname of the directory
in which
.SM SCCS
will be found;
``SCCS'' is the default.
.PP
Certain commands (such as
.IR admin )
cannot be run by all users,
since it would allow anyone to change the authorizations.
If the file
.I ADMINFILE
exists in the
.SM SCCS
directory,
lines of the form
.sp 0.3
.in +0.5i
.B A
.I uid
.in
.sp 0.3
in this file
authorize the user with
the numerical
user id
.I uid
to run protected commands.
If the file is not present,
anyone can run all commands.
This file can be expected to expand
to contain more information
in the future.
.SH EXAMPLES
.de BX
.nf
.in +0.5i
.sp 0.3
..
.de EX
.fi
.in -0.5i
.sp 0.3
..
To get a file for editting,
edit it,
and produce a new delta:
.BX
% sccs get \-e file.c
% ex file.c
% sccs delta file.c
.EX
To get a file from another directory:
.BX
% sccs \-p/usr/src/sccs/s. get cc.c
.EX
or
.BX
% sccs get /usr/src/sccs/s.cc.c
.EX
To make a delta of a large number of files
in the current directory:
.BX
% sccs delta *.c
.EX
In a makefile, to get source files
from an
.SM SCCS
file if it does not already exist:
.BX
SRCS = <list of source files>
OBJS = <list of object files>
.sp 0.4
$(OBJS): $(SRCS)
.sp 0.4
$(SRCS):
	sccs get $(REL) $@
.EX
.SH "SEE ALSO"
admin(SCCS),
chghist(SCCS),
comb(SCCS),
delta(SCCS),
get(SCCS),
help(SCCS),
prt(SCCS),
rmdel(SCCS),
sccsdiff(SCCS),
what(SCCS),
sccsdir(UCB)
.SH AUTHOR
Eric Allman (csvax:eric)
.SH DISCLAIMER
Since it is not yet clear
what this program should do,
it should not be considered
a stable program product.
Please send any
constructive suggestions
to csvax:eric.
Commit	Line	Data
39ae1365 EA	1	.TH SCCS 1
	2	.UC
	3	.SH NAME
	4	sccs \- front end for the
	5	.SM SCCS
	6	subsystem
	7	.SH SYNOPSIS
	8	.B sccs
	9	[
	10	.B \-r
	11	] [
	12	.BI \-p path
	13	] command [ flags ] [ args ]
	14	.SH DESCRIPTION
	15	.I Sccs
	16	is a front end
	17	to csvax:eric.
	18	that make them mesh more cleanly
	19	with the rest of UNIX.
	20	It also runs as a special user
	21	.B sccs
	22	so that the
	23	.SM SCCS
	24	file protection
	25	can be used to advantage.
	26	.PP
	27	Basically,
	28	.I sccs
	29	runs the
	30	.I command
	31	with the specified
	32	.I flags
	33	and
	34	.I args.
	35	Each
	36	argument
	37	is modified to be prepended
324bd523	38	with ``SCCS/s.''
39ae1365 EA	39	unless it begins with ``s.'',
	40	contains a `\\|/\\|' character,
	41	or specifies a directory.
	42	.PP
	43	Flags to be interpreted by the
	44	.I sccs
	45	program must be before the
	46	.I command
	47	argument.
	48	Flags to be passed to the actual
	49	.SM SCCS
	50	program
	51	must come after the
	52	.I command
	53	argument.
	54	These flags are specific to the command
	55	and are discussed in the documentation for that command.
	56	.PP
	57	The
	58	.B \-r
	59	flag runs
	60	.I sccs
	61	as the real user
	62	rather than as the pseudo-user
	63	.B sccs.
	64	The
	65	.B \-p
70caf673 EA	66	flag defines the pathname of the directory
70caf673 EA	67	in which
39ae1365	68	.SM SCCS
70caf673 EA	69	will be found;
	70	``SCCS'' is the default.
	71	.PP
	72	Certain commands (such as
	73	.IR admin )
	74	cannot be run by all users,
	75	since it would allow anyone to change the authorizations.
	76	If the file
	77	.I ADMINFILE
	78	exists in the
	79	.SM SCCS
	80	directory,
	81	lines of the form
	82	.sp 0.3
	83	.in +0.5i
	84	.B A
	85	.I uid
	86	.in
	87	.sp 0.3
	88	in this file
	89	authorize the user with
	90	the numerical
	91	user id
	92	.I uid
	93	to run protected commands.
	94	If the file is not present,
	95	anyone can run all commands.
	96	This file can be expected to expand
	97	to contain more information
	98	in the future.
39ae1365 EA	99	.SH EXAMPLES
	100	.de BX
	101	.nf
	102	.in +0.5i
	103	.sp 0.3
	104	..
	105	.de EX
	106	.fi
	107	.in -0.5i
	108	.sp 0.3
	109	..
	110	To get a file for editting,
	111	edit it,
	112	and produce a new delta:
	113	.BX
	114	% sccs get \-e file.c
	115	% ex file.c
	116	% sccs delta file.c
	117	.EX
	118	To get a file from another directory:
	119	.BX
	120	% sccs \-p/usr/src/sccs/s. get cc.c
	121	.EX
	122	or
	123	.BX
	124	% sccs get /usr/src/sccs/s.cc.c
	125	.EX
	126	To make a delta of a large number of files
	127	in the current directory:
	128	.BX
	129	% sccs delta *.c
	130	.EX
	131	In a makefile, to get source files
	132	from an
	133	.SM SCCS
	134	file if it does not already exist:
	135	.BX
	136	SRCS = <list of source files>
	137	OBJS = <list of object files>
	138	.sp 0.4
	139	$(OBJS): $(SRCS)
	140	.sp 0.4
70caf673 EA	141	$(SRCS):
70caf673 EA	142	sccs get $(REL) $@
39ae1365 EA	143	.EX
	144	.SH "SEE ALSO"
	145	admin(SCCS),
	146	chghist(SCCS),
	147	comb(SCCS),
	148	delta(SCCS),
	149	get(SCCS),
	150	help(SCCS),
	151	prt(SCCS),
	152	rmdel(SCCS),
	153	sccsdiff(SCCS),
	154	what(SCCS),
	155	sccsdir(UCB)
	156	.SH AUTHOR
	157	Eric Allman (csvax:eric)
	158	.SH DISCLAIMER
	159	Since it is not yet clear
	160	what this program should do,
	161	it should not be considered
	162	a stable program product.
	163	Please send any
	164	constructive suggestions
	165	to csvax:eric.