BSD 4_3_Net_2 release

[unix-history] / 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 e186c90..d38f3ce 100644 (file)
--- a/usr/src/usr.bin/sccs/sccs.1
+++ b/usr/src/usr.bin/sccs/sccs.1
@@ -1,24 +1,37 @@
 .\" Copyright (c) 1983, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" Copyright (c) 1983, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"

-.\" Redistribution and use in source and binary forms are permitted provided
-.\" that: (1) source distributions retain this entire copyright notice and
-.\" comment, and (2) distributions including binaries display the following
-.\" acknowledgement:  ``This product includes software developed by the
-.\" University of California, Berkeley and its contributors'' in the
-.\" documentation or other materials provided with the distribution and in
-.\" all advertising materials mentioning features or use of this software.
-.\" Neither the name of the University nor the names of its contributors may
-.\" be used to endorse or promote products derived from this software without
-.\" specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
-.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" 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 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 by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"     @(#)sccs.1     2.8 (Berkeley) 7/24/90
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 THE REGENTS OR CONTRIBUTORS 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.

 .\"
 .\"

-.Dd July 24, 1990
-.Os BSD 4.4
+.\"    @(#)sccs.1      2.10 (Berkeley) 7/24/91
+.\"
+.Dd July 24, 1991

 .Dt SCCS 1
 .Os BSD 4.2
 .Sh NAME
 .Dt SCCS 1
 .Os BSD 4.2
 .Sh NAME


@@ -32,8 +45,8 @@ subsystem
 .Op Fl d Ar path
 .Op Fl p Ar path
 .Ar command
 .Op Fl d Ar path
 .Op Fl p Ar path
 .Ar command

-.Op  flags
-.Ar
+.Op flags
+.Op Ar

 .Sh DESCRIPTION
 .Nm Sccs
 is a front end to the
 .Sh DESCRIPTION
 .Nm Sccs
 is a front end to the


@@ -79,12 +92,12 @@ several
 .Dq pseudo-commands
 can be issued.
 These are:
 .Dq pseudo-commands
 can be issued.
 These are:

-.Tw Fl
-.Tp Ic edit
+.Bl -tag -width deledit
+.It Cm edit

 Equivalent
 to 
 .Dq Li get \-e .
 Equivalent
 to 
 .Dq Li get \-e .

-.Tp Ic delget
+.It Cm delget

 Perform a delta on the named files and
 then get new versions.
 The new versions will have id keywords expanded, and
 Perform a delta on the named files and
 then get new versions.
 The new versions will have id keywords expanded, and


@@ -107,13 +120,10 @@ and the
 .Fl l ,
 .Fl s ,
 .\" anybody who has a bad xterm which is almost anyone
 .Fl l ,
 .Fl s ,
 .\" anybody who has a bad xterm which is almost anyone

-.if n \{\
-.      br
-.\}

 and
 .Fl x
 flags will be passed to get.
 and
 .Fl x
 flags will be passed to get.

-.Tp Ic deledit
+.It Cm deledit

 Equivalent
 to
 .Nm delget
 Equivalent
 to
 .Nm delget


@@ -136,7 +146,7 @@ and
 are
 passed to
 .Nm edit .
 are
 passed to
 .Nm edit .

-.Tp Ic create
+.It Cm create

 Creates
 an
 .Li SCCS
 Creates
 an
 .Li SCCS


@@ -152,7 +162,7 @@ These should be removed when you are convinced that the
 .Li SCCS
 files
 have been created successfully.
 .Li SCCS
 files
 have been created successfully.

-.Tp Ic fix
+.It Cm fix

 Must
 be followed by a
 .Fl r
 Must
 be followed by a
 .Fl r


@@ -162,7 +172,7 @@ 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.
 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.

-.Tp Ic clean
+.It Cm clean

 This routine removes everything from the current directory
 that can be recreated from SCCS files.
 It will not remove any files being edited.
 This routine removes everything from the current directory
 that can be recreated from SCCS files.
 It will not remove any files being edited.


@@ -172,7 +182,7 @@ flag is given, branches are ignored in the determination of
 whether they are being edited; this
 is dangerous if you are keeping the branches in the
 same directory.
 whether they are being edited; this
 is dangerous if you are keeping the branches in the
 same directory.

-.Tp Ic unedit
+.It Cm unedit

 This
 is the opposite of an
 .Nm edit
 This
 is the opposite of an
 .Nm edit


@@ -181,21 +191,19 @@ a
 .Dq Li get \-e .
 It should be used with extreme caution, since
 any changes you made since the get will be irretrievably lost.
 .Dq Li get \-e .
 It should be used with extreme caution, since
 any changes you made since the get will be irretrievably lost.

-.Tp Ic info
+.It Cm info

 Gives a listing of all files being edited.
 If the
 .Fl b
 flag
 is given, branches (i.e.,
 Gives a listing of all files being edited.
 If the
 .Fl b
 flag
 is given, branches (i.e.,

-.Cx Li SID
-.Cx \&\'s
-.Cx
+.Li SID Ns \&\'s 

 with two or fewer components)
 are ignored.  If the
 .Fl u
 flag is given (with an optional argument) then
 only files being edited by you (or the named user) are listed.
 with two or fewer components)
 are ignored.  If the
 .Fl u
 flag is given (with an optional argument) then
 only files being edited by you (or the named user) are listed.

-.Tp Ic check
+.It Cm check

 Like
 .Nm info
 except that nothing is printed if nothing is being edited, and
 Like
 .Nm info
 except that nothing is printed if nothing is being edited, and


@@ -205,7 +213,7 @@ The intent is to have this included in an
 entry in a makefile to insure that everything is included into the
 .Li SCCS
 file before a version is installed.
 entry in a makefile to insure that everything is included into the
 .Li SCCS
 file before a version is installed.

-.Tp Ic tell
+.It Cm tell

 Gives a newline-separated list of the files being edited
 on the standard output.  Takes the
 .Fl b
 Gives a newline-separated list of the files being edited
 on the standard output.  Takes the
 .Fl b


@@ -215,7 +223,7 @@ flags like
 .Nm info
 and
 .Nm check .
 .Nm info
 and
 .Nm check .

-.Tp Ic diffs
+.It Cm diffs

 Gives a
 .Nm diff
 listing between the current version of the
 Gives a
 .Nm diff
 listing between the current version of the


@@ -253,11 +261,11 @@ flag is passed to
 .Nm diff
 as
 .Fl c .
 .Nm diff
 as
 .Fl c .

-.Tp Ic print
+.It Cm print

 This command prints out verbose information
 about the named files.
 .Pp
 This command prints out verbose information
 about the named files.
 .Pp

-.Tp Fl r
+.It Fl r

 Runs
 .Nm sccs
 as the real user rather than as whatever effective user
 Runs
 .Nm sccs
 as the real user rather than as whatever effective user


@@ -265,7 +273,7 @@ as the real user rather than as whatever effective user
 is
 .Dq Li set user id
 to.
 is
 .Dq Li set user id
 to.

-.Tp Fl d
+.It Fl d

 Specifies a root directory for the
 .Li SCCS
 files.
 Specifies a root directory for the
 .Li SCCS
 files.


@@ -276,8 +284,8 @@ is set,
 it will be used to determine the 
 .Fl d
 flag.
 it will be used to determine the 
 .Fl d
 flag.

-.Tp Fl p
-flag defines the pathname of the directory in which the
+.It Fl p
+Defines the pathname of the directory in which the

 .Li SCCS
 files will be found;
 .Dq Li SCCS
 .Li SCCS
 files will be found;
 .Dq Li SCCS


@@ -349,8 +357,8 @@ file if it does not already exist:
 .Dl $(SRCS):
 .Dl \&\tsccs get $(REL) $@
 .Sh ENVIRONMENT
 .Dl $(SRCS):
 .Dl \&\tsccs get $(REL) $@
 .Sh ENVIRONMENT

-.Tw Ar
-.Tp Ev PROJECT
+.Bl -tag -width Ar
+.It Ev PROJECT

 The PROJECT environment variable is checked by the
 .Fl d
 flag.  If
 The PROJECT environment variable is checked by the
 .Fl d
 flag.  If


@@ -361,7 +369,7 @@ examined for a subdirectory
 or
 .Dq Li source .
 If such a directory is found, it is used.
 or
 .Dq Li source .
 If such a directory is found, it is used.

-.Tp
+.El

 .Sh SEE ALSO
 .Xr what 1
 .Xr admin SCCS ,
 .Sh SEE ALSO
 .Xr what 1
 .Xr admin SCCS ,


@@ -373,12 +381,16 @@ If such a directory is found, it is used.
 .Xr prt SCCS ,
 .Xr rmdel SCCS ,
 .Xr sccsdiff SCCS ,
 .Xr prt SCCS ,
 .Xr rmdel SCCS ,
 .Xr sccsdiff SCCS ,

-.br
-Eric Allman,
-.Em An Introduction to the Source Code Control System
+.Rs
+.%A Eric Allman
+.%T "An Introduction to the Source Code Control System"
+.Re

 .Sh HISTORY
 .Sh HISTORY

-.Nm Sccs
-appeared in 4.3 BSD.
+The
+.Nm sccs
+command
+appeared in
+.Bx 4.3 .

 .Sh BUGS
 It should be able to take directory arguments on pseudo-commands
 like the
 .Sh BUGS
 It should be able to take directory arguments on pseudo-commands
 like the