X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/2de7ab2b182bf0b6e2989d8de0d92e0a1b62a407..10973e2e500f094b19046c71a5083ccac39fec28:/usr/src/usr.bin/sccs/sccs.1

diff --git a/usr/src/usr.bin/sccs/sccs.1 b/usr/src/usr.bin/sccs/sccs.1
index 915cf98c96..76a731a4fb 100644
--- a/usr/src/usr.bin/sccs/sccs.1
+++ b/usr/src/usr.bin/sccs/sccs.1
@@ -1,4 +1,5 @@
-.TH SCCS 1
+.TH SCCS LOCAL
+.UC
 .SH NAME
 sccs \- front end for the
 .SM SCCS
@@ -8,6 +9,8 @@ subsystem
 [
 .B \-r
 ] [
+.BI \-d path
+] [
 .BI \-p path
 ] command [ flags ] [ args ]
 .SH DESCRIPTION
@@ -32,11 +35,8 @@ 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.
+is normally modified to be prepended
+with ``SCCS/s.''.
 .PP
 Flags to be interpreted by the
 .I sccs
@@ -52,6 +52,75 @@ argument.
 These flags are specific to the command
 and are discussed in the documentation for that command.
 .PP
+Besides the usual
+.SM SCCS
+commands,
+several ``pseudo-commands'' can be issued.
+These are:
+.IP edit 1i
+Equivalent to ``get \-e''.
+.IP delget
+Perform a delta on the named files
+and then get new versions.
+The new versions will have id keywords expanded,
+and will not be editable.
+The \-m, \-p, \-r, \-s, and \-y flags
+will be passed to delta,
+and the \-b, \-c, \-e, \-i, \-k, \-l, \-s, and \-x flags
+will be passed to get.
+.IP deledit
+Equivalent to ``delget'' except that the
+``get'' phase includes the ``\-e'' flag.
+This option is useful for making a ``checkpoint''
+of your current editing phase.
+The same flags will be passed to delta
+as described above,
+and all the flags listed for ``get''
+above except \-e and \-k
+are passed to ``edit''.
+.IP fix
+Must be followed by a
+.B \-r
+flag.
+This command essentially removes the named delta,
+but leaves you with a copy of the delta
+with the changes that were in it.
+It is useful for fixing small compiler bugs, etc.
+Since it doesn't leave audit trails,
+it should be used carefully.
+.IP clean
+Takes no arguments.
+This routine removes everything from the current directory
+that can be recreated from SCCS files.
+It will not remove any files being edited.
+.IP unedit
+This is the opposite of an ``edit''
+or a ``get \-e''.
+It should be used with extreme caution,
+since any changes you made since the get
+will be irretrievably lost.
+.IP info
+Gives a listing of all files being edited.
+.IP check
+Like ``info''
+except that nothing is printed if nothing is being edited,
+and a non-zero exit status is returned if anything
+is being edited.
+The intent is to have this included in an ``install''
+entry in a makefile
+to insure that everything is included into the
+.SM SCCS
+file
+before a version is installed.
+.IP diffs
+Gives a ``diff'' listing between the current version of the
+program(s) you have out for editing and the versions
+in
+.SM SCCS
+format.
+The arguments look exactly like the arguments to a get,
+which specify the version to diff against.
+.PP
 The
 .B \-r
 flag runs
@@ -61,12 +130,37 @@ rather than as whatever effective user
 .I sccs
 is ``set user id'' to.
 The
+.B \-d
+flag gives a root directory for the
+.SM SCCS
+files.
+The default is the current directory.
+The
 .B \-p
 flag defines the pathname of the directory
-in which
+in which the
 .SM SCCS
-will be found;
+files will be found;
 ``SCCS'' is the default.
+The
+.B \-p
+flag differs from the
+.B \-d
+flag in that the
+.B \-d
+argument is prepended to the entire pathname
+and the
+.B \-p
+argument is inserted before the final component of the
+pathname.
+For example,
+``sccs -d/x -py get a/b''
+will convert to
+``get /x/a/y/s.b''.
+The intent here is to create aliases such as
+``alias syssccs sccs -d/usr/src''
+which will be used as
+``syssccs get cmd/who.c''.
 .PP
 Certain commands (such as
 .IR admin )
@@ -75,16 +169,15 @@ since this would allow anyone to change the authorizations.
 These commands are always run as the real user.
 .SH EXAMPLES
 .de BX
+.PP
 .nf
 .in +0.5i
-.sp 0.3
 ..
 .de EX
 .fi
-.in -0.5i
-.sp 0.3
+.PP
 ..
-To get a file for editting,
+To get a file for editing,
 edit it,
 and produce a new delta:
 .BX
@@ -111,10 +204,6 @@ from an
 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
@@ -128,14 +217,21 @@ help(SCCS),
 prt(SCCS),
 rmdel(SCCS),
 sccsdiff(SCCS),
-what(SCCS),
-.SH AUTHOR
-Eric Allman (ingres:eric)
+what(SCCS)
+.br
+Eric Allman,
+.ul
+An Introduction to the Source Code Control System
+.SH BUGS
+It should be able to take directory arguments on pseudo-commands
+like the
+.SM SCCS
+commands do.
 .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 ingres:eric.
+comments & suggestions
+to csvax:eric.