Annotation of src/usr.bin/rcs/ident.1, Revision 1.12
1.12 ! jmc 1: .\" $OpenBSD: ident.1,v 1.11 2011/04/19 21:17:30 jmc Exp $
1.1 xsa 2: .\"
3: .\" Copyright (c) 2005 Xavier Santolaria <xsa@openbsd.org>
4: .\" All rights reserved.
5: .\"
6: .\" Permission to use, copy, modify, and distribute this software for any
7: .\" purpose with or without fee is hereby granted, provided that the above
8: .\" copyright notice and this permission notice appear in all copies.
9: .\"
10: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.12 ! jmc 17: .Dd $Mdocdate: April 19 2011 $
1.1 xsa 18: .Dt IDENT 1
19: .Os
20: .Sh NAME
21: .Nm ident
22: .Nd identify RCS keyword strings in files
23: .Sh SYNOPSIS
24: .Nm
25: .Op Fl qV
1.9 sobrado 26: .Op Ar
1.1 xsa 27: .Sh DESCRIPTION
28: The
29: .Nm
1.11 jmc 30: program searches for the pattern $keyword:... $ from the
1.9 sobrado 31: .Ar files
32: specified as argument (or standard input if none are given).
1.12 ! jmc 33: See the KEYWORD SUBSTITUTION section of
1.4 jmc 34: .Xr rcs 1
1.1 xsa 35: for more information.
36: .Pp
37: The following options are supported:
38: .Bl -tag -width "XXX"
39: .It Fl q
1.6 jmc 40: Quiet mode: suppress warnings if no pattern found.
1.1 xsa 41: .It Fl V
42: Display version information and exit.
43: .El
1.10 jmc 44: .Sh EXIT STATUS
1.7 xsa 45: .Ex -std ident
1.3 xsa 46: .Sh EXAMPLES
47: Given the following source code in file
48: .Pa foo.c :
49: .Bd -literal -offset indent
1.5 jmc 50: #include \*(Ltstdio.h\*(Gt
1.3 xsa 51:
52: static char const rcsid[] =
53: "$\&Id: foo.c,v 1.2 2005/11/18 09:34:51 xsa Exp $";
54:
55: int
56: main(void) {
57: printf("%s\en", rcsid);
58: return (0);
59: }
60: .Ed
61: .Pp
62: Compile it and run
63: .Nm :
64: .Bd -literal -offset indent
65: $ ident foo.c foo.o
66: foo.c:
67: $\&Id: foo.c,v 1.2 2005/11/18 09:34:51 xsa Exp $
68: foo.o:
69: $\&Id: foo.c,v 1.2 2005/11/18 09:34:51 xsa Exp $
70: .Ed
1.1 xsa 71: .Sh SEE ALSO
72: .Xr ci 1 ,
73: .Xr co 1 ,
74: .Xr cvs 1 ,
75: .Xr rcs 1 ,
76: .Xr rcsclean 1 ,
77: .Xr rcsdiff 1 ,
1.2 xsa 78: .Xr rcsmerge 1 ,
1.1 xsa 79: .Xr rlog 1