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