1.de Id
2.ds Rv \\$3
3.ds Dt \\$4
4.ds iD \\$3 \\$4 \\$5 \\$6 \\$7
5..
| 1.de Id
2.ds Rv \\$3
3.ds Dt \\$4
4.ds iD \\$3 \\$4 \\$5 \\$6 \\$7
5..
|
6.Id $Id: ident.1,v 5.0 1990/08/22 09:09:36 eggert Exp $
7.ds r \s-1RCS\s0
| 6.Id $Id: ident.1,v 5.4 1993/11/09 17:40:15 eggert Exp $
7.ds r \&\s-1RCS\s0
8.ds u \&\s-1UTC\s0
|
8.if n .ds - \%--
9.if t .ds - \(em
10.TH IDENT 1 \*(Dt GNU
11.SH NAME
| 9.if n .ds - \%--
10.if t .ds - \(em
11.TH IDENT 1 \*(Dt GNU
12.SH NAME
|
12ident \- identify files
| 13ident \- identify RCS keyword strings in files
|
13.SH SYNOPSIS
14.B ident
15[
16.B \-q
17] [
| 14.SH SYNOPSIS
15.B ident
16[
17.B \-q
18] [
|
| 19.B \-V
20] [
|
18.I file
19\&.\|.\|. ]
20.SH DESCRIPTION
21.B ident
| 21.I file
22\&.\|.\|. ]
23.SH DESCRIPTION
24.B ident
|
22searches for all occurrences of the pattern
23.BI $ keyword : .\|.\|. $
24in the named files or, if no file name appears, the standard input.
| 25searches for all instances of the pattern
26.BI $ keyword : "\ text\ " $
27in the named files or, if no files are named, the standard input.
|
25.PP
26These patterns are normally inserted automatically by the \*r command
27.BR co (1),
28but can also be inserted manually.
29The option
30.B \-q
31suppresses
32the warning given if there are no patterns in a file.
| 28.PP
29These patterns are normally inserted automatically by the \*r command
30.BR co (1),
31but can also be inserted manually.
32The option
33.B \-q
34suppresses
35the warning given if there are no patterns in a file.
|
| 36The option
37.B \-V
38prints
39.BR ident 's
40version number.
|
33.PP
34.B ident
35works on text files as well as object files and dumps.
36For example, if the C program in
37.B f.c
38contains
39.IP
| 41.PP
42.B ident
43works on text files as well as object files and dumps.
44For example, if the C program in
45.B f.c
46contains
47.IP
|
40\f3char rcsid[] = \&"$\&Id: f.c,v \*(iD $\&";\fP
| 48.ft 3
49#include <stdio.h>
50.br
51static char const rcsid[] =
52.br
53 \&"$\&Id: f.c,v \*(iD $\&";
54.br
55int main() { return printf(\&"%s\en\&", rcsid) == EOF; }
56.ft P
|
41.LP
42and
43.B f.c
44is compiled into
45.BR f.o ,
46then the command
47.IP
48.B "ident f.c f.o"
49.LP
50will output
51.nf
52.IP
53.ft 3
54f.c:
55 $\&Id: f.c,v \*(iD $
56f.o:
57 $\&Id: f.c,v \*(iD $
58.ft
59.fi
| 57.LP
58and
59.B f.c
60is compiled into
61.BR f.o ,
62then the command
63.IP
64.B "ident f.c f.o"
65.LP
66will output
67.nf
68.IP
69.ft 3
70f.c:
71 $\&Id: f.c,v \*(iD $
72f.o:
73 $\&Id: f.c,v \*(iD $
74.ft
75.fi
|
| 76.PP
77If a C program defines a string like
78.B rcsid
79above but does not use it,
80.BR lint (1)
81may complain, and some C compilers will optimize away the string.
82The most reliable solution is to have the program use the
83.B rcsid
84string, as shown in the example above.
85.PP
86.B ident
87finds all instances of the
88.BI $ keyword : "\ text\ " $
89pattern, even if
90.I keyword
91is not actually an \*r-supported keyword.
92This gives you information about nonstandard keywords like
93.BR $\&XConsortium$ .
94.SH KEYWORDS
95Here is the list of keywords currently maintained by
96.BR co (1).
97All times are given in Coordinated Universal Time (\*u,
98sometimes called \&\s-1GMT\s0) by default, but if the files
99were checked out with
100.BR co 's
101.BI \-z zone
102option, times are given with a numeric time zone indication appended.
103.TP
104.B $\&Author$
105The login name of the user who checked in the revision.
106.TP
107.B $\&Date$
108The date and time the revision was checked in.
109.TP
110.B $\&Header$
111A standard header containing the full pathname of the \*r file, the
112revision number, the date and time, the author, the state,
113and the locker (if locked).
114.TP
115.B $\&Id$
116Same as
117.BR $\&Header$ ,
118except that the \*r filename is without a path.
119.TP
120.B $\&Locker$
121The login name of the user who locked the revision (empty if not locked).
122.TP
123.B $\&Log$
124The log message supplied during checkin.
125For
126.BR ident 's
127purposes, this is equivalent to
128.BR $\&RCSfile$ .
129.TP
130.B $\&Name$
131The symbolic name used to check out the revision, if any.
132.TP
133.B $\&RCSfile$
134The name of the \*r file without a path.
135.TP
136.B $\&Revision$
137The revision number assigned to the revision.
138.TP
139.B $\&Source$
140The full pathname of the \*r file.
141.TP
142.B $\&State$
143The state assigned to the revision with the
144.B \-s
145option of
146.BR rcs (1)
147or
148.BR ci (1).
149.PP
150.BR co (1)
151represents the following characters in keyword values by escape sequences
152to keep keyword strings well-formed.
153.LP
154.RS
155.nf
156.ne 6
157.ta \w'newline 'u
158\f2char escape sequence\fP
159tab \f3\et\fP
160newline \f3\en\fP
161space \f3\e040
162$ \e044
163\e \e\e\fP
164.fi
165.RE
|
60.SH IDENTIFICATION
61Author: Walter F. Tichy.
62.br
| 166.SH IDENTIFICATION
167Author: Walter F. Tichy.
168.br
|
63Revision Number: \*(Rv; Release Date: \*(Dt.
| 169Manual Page Revision: \*(Rv; Release Date: \*(Dt.
|
64.br
| 170.br
|
65Copyright \(co 1982, 1988, 1989 by Walter F. Tichy.
| 171Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
|
66.br
| 172.br
|
67Copyright \(co 1990 by Paul Eggert.
| 173Copyright \(co 1990, 1992, 1993 Paul Eggert.
|
68.SH "SEE ALSO"
69ci(1), co(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1),
70rcsfile(5)
71.br
72Walter F. Tichy,
73\*r\*-A System for Version Control,
74.I "Software\*-Practice & Experience"
75.BR 15 ,
767 (July 1985), 637-654.
| 174.SH "SEE ALSO"
175ci(1), co(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1),
176rcsfile(5)
177.br
178Walter F. Tichy,
179\*r\*-A System for Version Control,
180.I "Software\*-Practice & Experience"
181.BR 15 ,
1827 (July 1985), 637-654.
|