1.de Id
2.ds Rv \\$3
3.ds Dt \\$4
4.ds iD \\$3 \\$4 \\$5 \\$6 \\$7
5..
6.Id $FreeBSD: releng/10.2/gnu/usr.bin/rcs/ident/ident.1 50472 1999-08-27 23:37:10Z peter $
7.ds r \&\s-1RCS\s0
8.ds u \&\s-1UTC\s0
9.if n .ds - \%--
10.if t .ds - \(em
11.TH IDENT 1 \*(Dt GNU
12.SH NAME
13ident \- identify RCS keyword strings in files
14.SH SYNOPSIS
15.B ident
16[
17.B \-q
18] [
19.B \-V
20] [
21.I file
22\&.\|.\|. ]
23.SH DESCRIPTION
24.B ident
25searches for all instances of the pattern
26.BI $ keyword : "\ text\ " $
27in the named files or, if no files are named, the standard input.
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.
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
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
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
166.SH IDENTIFICATION
167Author: Walter F. Tichy.
168.br
169Manual Page Revision: \*(Rv; Release Date: \*(Dt.
170.br
171Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
172.br
173Copyright \(co 1990, 1992, 1993 Paul Eggert.
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.
183