IDENT(1) General Commands Manual IDENT(1)
NAME
ident - identify RCS keyword strings in files
SYNOPSIS
ident [ -q ] [ -V ] [ file ... ]
DESCRIPTION
ident searches for all instances of the pattern $keyword: text $ in the named files or, if no files are named,
the standard input.
These patterns are normally inserted automatically by the RCS command co(1), but can also be inserted manu‐
ally. The option -q suppresses the warning given if there are no patterns in a file. The option -V prints
RCS's version number.
ident works on text files as well as object files and dumps. For example, if the C program in f.c contains
#include <stdio.h>
static char const rcsid[] =
"$Id: f.c,v 5.4 1993/11/09 17:40:15 eggert Exp $";
int main() { return printf("%s\n", rcsid) == EOF; }
and f.c is compiled into f.o, then the command
ident f.c f.o
will output
f.c:
$Id: f.c,v 5.4 1993/11/09 17:40:15 eggert Exp $
f.o:
$Id: f.c,v 5.4 1993/11/09 17:40:15 eggert Exp $
If a C program defines a string like rcsid above but does not use it, lint(1) may complain, and some C compil‐
ers will optimize away the string. The most reliable solution is to have the program use the rcsid string, as
shown in the example above.
ident finds all instances of the $keyword: text $ pattern, even if keyword is not actually an RCS-supported
keyword. This gives you information about nonstandard keywords like $XConsortium$.
The pattern normally requires a colon and a space immediately after the keyword and a space immediately before
the terminating $, but for Subversion 1.2 (and later) compatability, ident will also recognize the pattern
$keyword:: text $ (i.e., two colons and a space) and the pattern $keyword:: text #$ (likewise, with a hash
before the terminating $). These are the fixed-width keyword syntax. To summarize, the three recognized pat‐
terns are:
$keyword: text $
$keyword:: text $
$keyword:: text #$
KEYWORDS
Here is the list of keywords currently maintained by co(1). All times are given in Coordinated Universal Time
(UTC, sometimes called GMT) by default, but if the files were checked out with co's -zzone option, times are
given with a numeric time zone indication appended.
$Author$
The login name of the user who checked in the revision.
$Log$ The log message supplied during checkin. For ident's purposes, this is equivalent to $RCSfile$.
$Name$ The symbolic name used to check out the revision, if any.
$RCSfile$
The RCS file name without directory components.
$Revision$
The revision number assigned to the revision.
$Source$
The full RCS file name.
$State$
The state assigned to the revision with the -s option of rcs(1) or ci(1).
co(1) represents the following characters in keyword values by escape sequences to keep keyword strings well-
formed.
char escape sequence
tab \t
newline \n
space \040
$ \044
\ \\
IDENTIFICATION
Author: Walter F. Tichy.
Manual Page Revision: 5.9.0; Release Date: 2014-06-10.
Copyright © 2010-2013 Thien-Thi Nguyen.
Copyright © 1990, 1992, 1993 Paul Eggert.
Copyright © 1982, 1988, 1989 Walter F. Tichy.
SEE ALSO
ci(1), co(1), rcs(1), rcsdiff(1), rcsmerge(1), rlog(1), rcsfile(5).
Walter F. Tichy, RCS--A System for Version Control, Software--Practice & Experience 15, 7 (July 1985),
637-654.
The full documentation for RCS is maintained as a Texinfo manual. If the info(1) and RCS programs are prop‐
erly installed at your site, the command
info rcs
should give you access to the complete manual. Additionally, the RCS homepage:
http://www.gnu.org/software/rcs/
has news and links to the latest release, development site, etc.
GNU RCS 5.9.0 2014-06-10 IDENT(1)
Back to main site | Back to man page index