1sccs-delta(1)                    User Commands                   sccs-delta(1)
2
3
4

NAME

6       sccs-delta, delta - make a delta to an SCCS file
7

SYNOPSIS

9       /usr/ccs/bin/delta [-dnps] [-g sid-list | -gsid-list]
10            [-m mr-list | -mmr-list] [-r sid | -rsid]
11            [-y [comment]]  s.filename...
12
13
14       /usr/xpg4/bin/delta [-dnps] [-g sid-list | -gsid-list]
15            [-m mr-list | -mmr-list] [-r sid | -rsid]
16            [-y [comment]]  s.filename...
17
18

DESCRIPTION

20       The  delta  utility  checks in a record of the line-by-line differences
21       made to a checked-out version of  a  file  under  SCCS  control.  These
22       changes  are  taken  from  the writable working copy that was retrieved
23       using the SCCS get command (see sccs-get(1)). This  working  copy  does
24       not have the `s.' prefix, and is also referred to as a g-file.
25
26
27       If  a  directory  name is used in place of the s.filename argument, the
28       delta command applies to all  s.files  in  that  directory.  Unreadable
29       s.files  produce  an error; processing continues with the next file (if
30       any). The use of `' as the  s.filename  argument  indicates  that  the
31       names  of  files are to be read from the standard input, one s.file per
32       line (requires -y, and in some cases, -m).
33
34
35       delta may issue prompts on  the  standard  output  depending  upon  the
36       options  specified  and the flags that are set in the s.file (see sccs-
37       admin(1), and the -m and -y options below, for details).
38
39   /usr/xpg4/bin/delta
40       The SID of the delta is not echoed to stdout.
41

OPTIONS

43       The following options are supported:
44
45       -d                          Use command diff(1)  instead  of  bdiff(1).
46                                   Returns  exit  status 2 if s.filename argu‐
47                                   ment is not specified.
48
49
50       -n                          Retain the edited g-file, which is normally
51                                   removed at the completion of processing.
52
53
54       -p                          Display    line-by-line   differences   (in
55                                   diff(1) format) on the standard output.
56
57
58       -s                          Silent.  Do not display warning or  confir‐
59                                   mation  messages.   Do  not  suppress error
60                                   messages (which  are  written  to  standard
61                                   error).
62
63
64       -g sid-list | -gsid-list    Specify  a  list of deltas to omit when the
65                                   file is accessed at  the  SCCS  version  ID
66                                   (SID)  created by this delta. sid-list is a
67                                   comma-separated list of SIDs. To specify  a
68                                   range   of  deltas,  use  a  `'  separator
69                                   instead of a comma, between two SIDs in the
70                                   list.
71
72
73       -m mr-list | -mmr-list      If  the  SCCS  file has the v flag set (see
74                                   sccs-admin(1)), you must supply one or more
75                                   Modification  Request  (MR) numbers for the
76                                   new delta. When specifying more than one MR
77                                   number  on  the command line, mr-list takes
78                                   the form of a quoted, space-separated list.
79                                   If -m is not used and the standard input is
80                                   a terminal, delta prompts with MRs? for the
81                                   list (before issuing the comments? prompt).
82                                   If the v flag in the s.file has a value, it
83                                   is  taken  to  be  the name of a program to
84                                   validate the MR numbers. If that validation
85                                   program  returns  a  non-zero  exit status,
86                                   delta terminates without  checking  in  the
87                                   changes.
88
89
90       -r sid | -rsid              When  two or more versions are checked out,
91                                   specify the version to check in.  This  SID
92                                   value  can  be  either the SID specified on
93                                   the get command line, or the SID of the new
94                                   version  to  be  checked  in as reported by
95                                   get. A diagnostic results if the  specified
96                                   SID is ambiguous, or if one is required but
97                                   not supplied.
98
99
100       -y[comment]                 Supply a comment for the delta table  (ver‐
101                                   sion  log). A null comment is accepted, and
102                                   produces an empty commentary in the log. If
103                                   -y  is not specified and the standard input
104                                   is a terminal,  delta  prompts  with  `com‐
105                                   ments?'.  An  unescaped  NEWLINE terminates
106                                   the comment.
107
108

ENVIRONMENT VARIABLES

110       See environ(5) for descriptions of the following environment  variables
111       that affect the execution of delta: LANG, LC_ALL, LC_COLLATE, LC_CTYPE,
112       LC_MESSAGES, and NLSPATH.
113

EXIT STATUS

115       The following exit values are returned:
116
117       0    Successful completion.
118
119
120       1    An error occurred and the -d option had not been specified.
121
122
123       2    An error occurred, the -d  option  had  been  specified,  and  the
124            s.filename argument was not specified.
125
126

FILES

128       d.file    temporary file of differences
129
130
131       p.file    lock file for a checked-out version
132
133
134       q.file    temporary file
135
136
137       s.file    SCCS history file
138
139
140       x.file    temporary copy of the s.file
141
142
143       z.file    temporary file
144
145

ATTRIBUTES

147       See attributes(5) for descriptions of the following attributes:
148
149   /usr/ccs/bin/delta
150       ┌─────────────────────────────┬─────────────────────────────┐
151       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
152       ├─────────────────────────────┼─────────────────────────────┤
153       │Availability                 │SUNWsprot                    │
154       └─────────────────────────────┴─────────────────────────────┘
155
156   /usr/xpg4/bin/delta
157       ┌─────────────────────────────┬─────────────────────────────┐
158       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
159       ├─────────────────────────────┼─────────────────────────────┤
160       │Availability                 │SUNWxcu4t                    │
161       ├─────────────────────────────┼─────────────────────────────┤
162       │Interface Stability          │Standard                     │
163       └─────────────────────────────┴─────────────────────────────┘
164

SEE ALSO

166       bdiff(1),   diff(1),  sccs-admin(1),  sccs-cdc(1),  sccs-get(1),  sccs-
167       help(1),  sccs-prs(1),  sccs-prt(1),  sccs-rmdel(1),  sccs-sccsdiff(1),
168       sccs-unget(1),  sccs(1),  what(1),  sccsfile(4),  attributes(5),  envi‐
169       ron(5), standards(5)
170

DIAGNOSTICS

172       Use the SCCS help command for explanations (see sccs-help(1)).
173

WARNINGS

175       Lines beginning with an ASCII SOH  character  (binary  001)  cannot  be
176       placed  in  the SCCS file unless the SOH is escaped. This character has
177       special meaning to SCCS (see sccsfile(4)) and produces an error.
178
179
180
181SunOS 5.11                        1 Nov 1999                     sccs-delta(1)
Impressum