home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / rcs / ident.man < prev    next >
Text File  |  1992-02-19  |  2KB  |  59 lines
  1. NAME
  2.      ident - identify files
  3.  
  4. SYNOPSIS
  5.      ident [ -q ] [ file ... ]
  6.  
  7. DESCRIPTION
  8.      ident searches for all occurrences of the pattern
  9.      $keyword:...$ in the named files or, if no file name
  10.      appears, the standard input.
  11.  
  12.      These patterns are normally inserted automatically by the
  13.      RCS command co(1), but can also be inserted manually.  The
  14.      option -q suppresses the warning given if there are no
  15.      patterns in a file.
  16.  
  17.      ident works on text files as well as object files and dumps.
  18.      For example, if the C program in f.c contains
  19.  
  20.           #include <stdio.h>
  21.           static char const rcsid[] =
  22.             "$Id: f.c,v 5.1 1992/02/17 23:02:02 eggert Exp $";
  23.           int main() { return printf("%s\n", rcsid) == EOF; }
  24.  
  25.      and f.c is compiled into f.o, then the command
  26.  
  27.           ident  f.c  f.o
  28.  
  29.      will output
  30.  
  31.           f.c:
  32.               $Id: f.c,v 5.1 1992/02/17 23:02:02 eggert Exp $
  33.           f.o:
  34.               $Id: f.c,v 5.1 1992/02/17 23:02:02 eggert Exp $
  35.  
  36.      See co(1) for the list of keywords that it maintains.  ident
  37.      finds all instances of patterns that look like keyword
  38.      strings, even if they are not actually keywords.  This gives
  39.      you information about nonstandard keywords like
  40.      $XConsortium$.
  41.  
  42.      If a C program defines a string like rcsid above but does
  43.      not use it, lint(1) may complain, and some C compilers will
  44.      optimize away the string.  The most reliable solution is to
  45.      have the program use the rcsid string, as shown in the
  46.      example above.
  47.  
  48. IDENTIFICATION
  49.      Author: Walter F. Tichy.
  50.      Revision Number: 5.1; Release Date: 1992/02/17.
  51.      Copyright 1982, 1988, 1989 by Walter F. Tichy.
  52.      Copyright 1990, 1992 by Paul Eggert.
  53.  
  54. SEE ALSO
  55.      ci(1), co(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1),
  56.      rlog(1), rcsfile(5)
  57.      Walter F. Tichy, RCS--A System for Version Control,
  58.      Software--Practice & Experience 15, 7 (July 1985), 637-654.
  59.