\" $NetBSD: ident.1,v 1.2 2016/01/14 04:22:39 christos Exp $
\"
de Id
ds Rv \\$3
ds Dt \\$4
ds iD \\$3 \\$4 \\$5 \\$6 \\$7
.
Id Id: ident.1,v 5.4 1993/11/09 17:40:15 eggert Exp
ds r \&\s-1RCS\s0
ds u \&\s-1UTC\s0
if n .ds - \%--
if t .ds - \(em
TH IDENT 1 \*(Dt GNU
SH NAME
ident \- identify RCS keyword strings in files
SH SYNOPSIS
B ident
[
B \-q
] [
B \-V
] [
I file
\&.\|.\|. ]
SH DESCRIPTION
B ident
searches for all instances of the pattern
BI $ keyword : "\ text\ " $
in the named files or, if no files are named, the standard input.
PP
These patterns are normally inserted automatically by the \*r command
BR co (1),
but can also be inserted manually.
The option
B \-q
suppresses
the warning given if there are no patterns in a file.
The option
B \-V
prints
BR ident 's
version number.
PP
B ident
works on text files as well as object files and dumps.
For example, if the C program in
B f.c
contains
IP
ft 3
#include \*[Lt]stdio.h\*[Gt]
br
static char const rcsid[] =
br
\&"$\&Id: f.c,v \*(iD $\&";
br
int main() { return printf(\&"%s\en\&", rcsid) == EOF; }
ft P
LP
and
B f.c
is compiled into
BR f.o ,
then the command
IP
B "ident f.c f.o"
LP
will output
nf
IP
ft 3
f.c:
$\&Id: f.c,v \*(iD $
f.o:
$\&Id: f.c,v \*(iD $
ft
fi
PP
If a C program defines a string like
B rcsid
above but does not use it,
BR lint (1)
may complain, and some C compilers will optimize away the string.
The most reliable solution is to have the program use the
B rcsid
string, as shown in the example above.
PP
B ident
finds all instances of the
BI $ keyword : "\ text\ " $
pattern, even if
I keyword
is not actually an \*r-supported keyword.
This gives you information about nonstandard keywords like
BR $\&XConsortium$ .
SH KEYWORDS
Here is the list of keywords currently maintained by
BR co (1).
All times are given in Coordinated Universal Time (\*u,
sometimes called \&\s-1GMT\s0) by default, but if the files
were checked out with
BR co 's
BI \-z zone
option, times are given with a numeric time zone indication appended.
TP
B $\&Author$
The login name of the user who checked in the revision.
TP
B $\&Date$
The date and time the revision was checked in.
TP
B $\&Header$
A standard header containing the full pathname of the \*r file, the
revision number, the date and time, the author, the state,
and the locker (if locked).
TP
B $\&Id$
Same as
BR $\&Header$ ,
except that the \*r filename is without a path.
TP
B $\&Locker$
The login name of the user who locked the revision (empty if not locked).
TP
B $\&Log$
The log message supplied during checkin.
For
BR ident 's
purposes, this is equivalent to
BR $\&RCSfile$ .
TP
B $\&Name$
The symbolic name used to check out the revision, if any.
TP
B $\&RCSfile$
The name of the \*r file without a path.
TP
B $\&Revision$
The revision number assigned to the revision.
TP
B $\&Source$
The full pathname of the \*r file.
TP
B $\&State$
The state assigned to the revision with the
B \-s
option of
BR rcs (1)
or
BR ci (1).
PP
BR co (1)
represents the following characters in keyword values by escape sequences
to keep keyword strings well-formed.
LP
RS
nf
ne 6
ta \w'newline 'u
\f2char escape sequence\fP
tab \f3\et\fP
newline \f3\en\fP
space \f3\e040
$ \e044
\e \e\e\fP
fi
RE
SH IDENTIFICATION
Author: Walter F. Tichy.
br
Manual Page Revision: \*(Rv; Release Date: \*(Dt.
br
Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
br
Copyright \(co 1990, 1992, 1993 Paul Eggert.
SH "SEE ALSO"
ci(1), co(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1),
rcsfile(5)
br
Walter F. Tichy,
\*r\*-A System for Version Control,
I "Software\*-Practice \*[Am] Experience"
BR 15 ,
7 (July 1985), 637-654.
