Commit | Line | Data |
---|---|---|
a2a3f7d9 | 1 | .TH SCCS LOCAL |
797b9789 | 2 | .UC |
39ae1365 EA |
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 | ] [ | |
e5b52011 | 12 | .BI \-d path |
c3a8e591 EA |
13 | ] [ |
14 | .BI \-p path | |
39ae1365 EA |
15 | ] command [ flags ] [ args ] |
16 | .SH DESCRIPTION | |
17 | .I Sccs | |
18 | is a front end | |
2de7ab2b EA |
19 | to the |
20 | .SM SCCS | |
21 | programs | |
22 | that help them mesh more cleanly | |
39ae1365 | 23 | with the rest of UNIX. |
af83554c EA |
24 | It also includes the capability to run |
25 | ``set user id'' to another user | |
26 | to provide additional protection. | |
39ae1365 EA |
27 | .PP |
28 | Basically, | |
29 | .I sccs | |
30 | runs the | |
31 | .I command | |
32 | with the specified | |
33 | .I flags | |
34 | and | |
35 | .I args. | |
36 | Each | |
37 | argument | |
c3a8e591 EA |
38 | is normally modified to be prepended |
39 | with ``SCCS/s.''. | |
39ae1365 EA |
40 | .PP |
41 | Flags to be interpreted by the | |
42 | .I sccs | |
43 | program must be before the | |
44 | .I command | |
45 | argument. | |
46 | Flags to be passed to the actual | |
47 | .SM SCCS | |
48 | program | |
49 | must come after the | |
50 | .I command | |
51 | argument. | |
52 | These flags are specific to the command | |
53 | and are discussed in the documentation for that command. | |
54 | .PP | |
9e6171bb EA |
55 | Besides the usual |
56 | .SM SCCS | |
57 | commands, | |
58 | several ``pseudo-commands'' can be issued. | |
59 | These are: | |
94d25808 EA |
60 | .IP edit 1i |
61 | Equivalent to ``get \-e''. | |
62 | .IP delget | |
9e6171bb EA |
63 | Perform a delta on the named files |
64 | and then get new versions. | |
65 | The new versions will have id keywords expanded, | |
66 | and will not be editable. | |
1087bf95 EA |
67 | The \-m, \-p, \-r, \-s, and \-y flags |
68 | will be passed to delta, | |
69 | and the \-b, \-c, \-e, \-i, \-k, \-l, \-s, and \-x flags | |
70 | will be passed to get. | |
b7991d06 | 71 | .IP deledit |
94d25808 EA |
72 | Equivalent to ``delget'' except that the |
73 | ``get'' phase includes the ``\-e'' flag. | |
74 | This option is useful for making a ``checkpoint'' | |
c3a8e591 | 75 | of your current editing phase. |
1087bf95 EA |
76 | The same flags will be passed to delta |
77 | as described above, | |
78 | and all the flags listed for ``get'' | |
79 | above except \-e and \-k | |
80 | are passed to ``edit''. | |
9e6171bb EA |
81 | .IP fix |
82 | Must be followed by a | |
83 | .B \-r | |
84 | flag. | |
85 | This command essentially removes the named delta, | |
86 | but leaves you with a copy of the delta | |
87 | with the changes that were in it. | |
88 | It is useful for fixing small compiler bugs, etc. | |
89 | Since it doesn't leave audit trails, | |
90 | it should be used carefully. | |
91 | .IP clean | |
92 | Takes no arguments. | |
93 | This routine removes everything from the current directory | |
94 | that can be recreated from SCCS files. | |
c3a8e591 | 95 | It will not remove any files being edited. |
9ef9beda EA |
96 | .IP unedit |
97 | This is the opposite of an ``edit'' | |
98 | or a ``get \-e''. | |
99 | It should be used with extreme caution, | |
100 | since any changes you made since the get | |
101 | will be irretrievably lost. | |
94d25808 | 102 | .IP info |
c3a8e591 | 103 | Gives a listing of all files being edited. |
a2a3f7d9 EA |
104 | .IP check |
105 | Like ``info'' | |
106 | except that nothing is printed if nothing is being edited, | |
107 | and a non-zero exit status is returned if anything | |
108 | is being edited. | |
109 | The intent is to have this included in an ``install'' | |
110 | entry in a makefile | |
111 | to insure that everything is included into the | |
112 | .SM SCCS | |
113 | file | |
114 | before a version is installed. | |
aad1cfb4 EA |
115 | .IP tell |
116 | Gives a newline-separated list | |
117 | of the files being edited | |
118 | on the standard output. | |
ecf8b19b EA |
119 | .IP diffs |
120 | Gives a ``diff'' listing between the current version of the | |
121 | program(s) you have out for editing and the versions | |
122 | in | |
123 | .SM SCCS | |
124 | format. | |
125 | The arguments look exactly like the arguments to a get, | |
126 | which specify the version to diff against. | |
9e6171bb | 127 | .PP |
39ae1365 EA |
128 | The |
129 | .B \-r | |
130 | flag runs | |
131 | .I sccs | |
132 | as the real user | |
af83554c EA |
133 | rather than as whatever effective user |
134 | .I sccs | |
135 | is ``set user id'' to. | |
39ae1365 | 136 | The |
c3a8e591 EA |
137 | .B \-d |
138 | flag gives a root directory for the | |
139 | .SM SCCS | |
140 | files. | |
141 | The default is the current directory. | |
142 | The | |
39ae1365 | 143 | .B \-p |
70caf673 | 144 | flag defines the pathname of the directory |
c3a8e591 | 145 | in which the |
39ae1365 | 146 | .SM SCCS |
c3a8e591 | 147 | files will be found; |
70caf673 | 148 | ``SCCS'' is the default. |
e5b52011 | 149 | The |
e5b52011 | 150 | .B \-p |
c3a8e591 EA |
151 | flag differs from the |
152 | .B \-d | |
153 | flag in that the | |
e5b52011 EA |
154 | .B \-d |
155 | argument is prepended to the entire pathname | |
156 | and the | |
157 | .B \-p | |
158 | argument is inserted before the final component of the | |
159 | pathname. | |
160 | For example, | |
161 | ``sccs -d/x -py get a/b'' | |
162 | will convert to | |
163 | ``get /x/a/y/s.b''. | |
164 | The intent here is to create aliases such as | |
165 | ``alias syssccs sccs -d/usr/src'' | |
166 | which will be used as | |
167 | ``syssccs get cmd/who.c''. | |
70caf673 EA |
168 | .PP |
169 | Certain commands (such as | |
170 | .IR admin ) | |
af83554c EA |
171 | cannot be run ``set user id'' by all users, |
172 | since this would allow anyone to change the authorizations. | |
173 | These commands are always run as the real user. | |
39ae1365 EA |
174 | .SH EXAMPLES |
175 | .de BX | |
813d780e | 176 | .PP |
39ae1365 EA |
177 | .nf |
178 | .in +0.5i | |
39ae1365 EA |
179 | .. |
180 | .de EX | |
181 | .fi | |
813d780e | 182 | .PP |
39ae1365 | 183 | .. |
c3a8e591 | 184 | To get a file for editing, |
39ae1365 EA |
185 | edit it, |
186 | and produce a new delta: | |
187 | .BX | |
2de7ab2b EA |
188 | sccs get \-e file.c |
189 | ex file.c | |
190 | sccs delta file.c | |
39ae1365 EA |
191 | .EX |
192 | To get a file from another directory: | |
193 | .BX | |
2de7ab2b | 194 | sccs \-p/usr/src/sccs/s. get cc.c |
39ae1365 EA |
195 | .EX |
196 | or | |
197 | .BX | |
2de7ab2b | 198 | sccs get /usr/src/sccs/s.cc.c |
39ae1365 EA |
199 | .EX |
200 | To make a delta of a large number of files | |
201 | in the current directory: | |
202 | .BX | |
2de7ab2b | 203 | sccs delta *.c |
39ae1365 EA |
204 | .EX |
205 | In a makefile, to get source files | |
206 | from an | |
207 | .SM SCCS | |
208 | file if it does not already exist: | |
209 | .BX | |
210 | SRCS = <list of source files> | |
70caf673 EA |
211 | $(SRCS): |
212 | sccs get $(REL) $@ | |
39ae1365 EA |
213 | .EX |
214 | .SH "SEE ALSO" | |
215 | admin(SCCS), | |
216 | chghist(SCCS), | |
217 | comb(SCCS), | |
218 | delta(SCCS), | |
219 | get(SCCS), | |
220 | help(SCCS), | |
221 | prt(SCCS), | |
222 | rmdel(SCCS), | |
223 | sccsdiff(SCCS), | |
813d780e EA |
224 | what(SCCS) |
225 | .br | |
226 | Eric Allman, | |
227 | .ul | |
228 | An Introduction to the Source Code Control System | |
d35f5db1 EA |
229 | .SH BUGS |
230 | It should be able to take directory arguments on pseudo-commands | |
231 | like the | |
232 | .SM SCCS | |
233 | commands do. | |
39ae1365 EA |
234 | .SH DISCLAIMER |
235 | Since it is not yet clear | |
236 | what this program should do, | |
237 | it should not be considered | |
238 | a stable program product. | |
239 | Please send any | |
c3a8e591 EA |
240 | comments & suggestions |
241 | to csvax:eric. |