ident.1 revision 11892
1232950Stheraven.de Id 2232950Stheraven.ds Rv \\$3 3232950Stheraven.ds Dt \\$4 4232950Stheraven.ds iD \\$3 \\$4 \\$5 \\$6 \\$7 5232950Stheraven.. 6232950Stheraven.Id $Id: ident.1,v 5.4 1993/11/09 17:40:15 eggert Exp $ 7232950Stheraven.ds r \&\s-1RCS\s0 8232950Stheraven.ds u \&\s-1UTC\s0 9232950Stheraven.if n .ds - \%-- 10232950Stheraven.if t .ds - \(em 11232950Stheraven.TH IDENT 1 \*(Dt GNU 12232950Stheraven.SH NAME 13232950Stheravenident \- identify RCS keyword strings in files 14232950Stheraven.SH SYNOPSIS 15232950Stheraven.B ident 16232950Stheraven[ 17232950Stheraven.B \-q 18232950Stheraven] [ 19232950Stheraven.B \-V 20232950Stheraven] [ 21232950Stheraven.I file 22232950Stheraven\&.\|.\|. ] 23232950Stheraven.SH DESCRIPTION 24232950Stheraven.B ident 25232950Stheravensearches for all instances of the pattern 26232950Stheraven.BI $ keyword : "\ text\ " $ 27227825Stheravenin the named files or, if no files are named, the standard input. 28227825Stheraven.PP 29227825StheravenThese patterns are normally inserted automatically by the \*r command 30227825Stheraven.BR co (1), 31227825Stheravenbut can also be inserted manually. 32227825StheravenThe option 33227825Stheraven.B \-q 34227825Stheravensuppresses 35227825Stheraventhe warning given if there are no patterns in a file. 36227825StheravenThe option 37227825Stheraven.B \-V 38227825Stheravenprints 39227825Stheraven.BR ident 's 40227825Stheravenversion number. 41227825Stheraven.PP 42227825Stheraven.B ident 43227825Stheravenworks on text files as well as object files and dumps. 44227825StheravenFor example, if the C program in 45227825Stheraven.B f.c 46227825Stheravencontains 47227825Stheraven.IP 48227825Stheraven.ft 3 49227825Stheraven#include <stdio.h> 50227825Stheraven.br 51227825Stheravenstatic char const rcsid[] = 52227825Stheraven.br 53227825Stheraven \&"$\&Id: f.c,v \*(iD $\&"; 54227825Stheraven.br 55227825Stheravenint main() { return printf(\&"%s\en\&", rcsid) == EOF; } 56227825Stheraven.ft P 57227825Stheraven.LP 58227825Stheravenand 59227825Stheraven.B f.c 60227825Stheravenis compiled into 61227825Stheraven.BR f.o , 62227825Stheraventhen the command 63227825Stheraven.IP 64227825Stheraven.B "ident f.c f.o" 65227825Stheraven.LP 66227825Stheravenwill output 67227825Stheraven.nf 68227825Stheraven.IP 69227825Stheraven.ft 3 70227825Stheravenf.c: 71227825Stheraven $\&Id: f.c,v \*(iD $ 72227825Stheravenf.o: 73227825Stheraven $\&Id: f.c,v \*(iD $ 74227825Stheraven.ft 75227825Stheraven.fi 76227825Stheraven.PP 77227825StheravenIf a C program defines a string like 78227825Stheraven.B rcsid 79227825Stheravenabove but does not use it, 80227825Stheraven.BR lint (1) 81227825Stheravenmay complain, and some C compilers will optimize away the string. 82227825StheravenThe most reliable solution is to have the program use the 83227825Stheraven.B rcsid 84227825Stheravenstring, as shown in the example above. 85278724Sdim.PP 86278724Sdim.B ident 87278724Sdimfinds all instances of the 88278724Sdim.BI $ keyword : "\ text\ " $ 89278724Sdimpattern, even if 90278724Sdim.I keyword 91278724Sdimis not actually an \*r-supported keyword. 92278724SdimThis gives you information about nonstandard keywords like 93278724Sdim.BR $\&XConsortium$ . 94278724Sdim.SH KEYWORDS 95278724SdimHere is the list of keywords currently maintained by 96278724Sdim.BR co (1). 97278724SdimAll times are given in Coordinated Universal Time (\*u, 98227825Stheravensometimes called \&\s-1GMT\s0) by default, but if the files 99227825Stheravenwere 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