home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs57pc1.zip / doc / ident.man < prev    next >
Text File  |  1996-02-13  |  5KB  |  199 lines

  1.  
  2.  
  3.  
  4. IDENT(1)                                                 IDENT(1)
  5.  
  6.  
  7. NAME
  8.        ident - identify RCS keyword strings in files
  9.  
  10. SYNOPSIS
  11.        ident [ -q ] [ -V ] [ file ... ]
  12.  
  13. DESCRIPTION
  14.        ident   searches   for   all   instances  of  the  pattern
  15.        $keyword: text $ in the named files or, if  no  files  are
  16.        named, the standard input.
  17.  
  18.        These  patterns are normally inserted automatically by the
  19.        RCS command co(1), but can also be inserted manually.  The
  20.        option  -q  suppresses  the  warning given if there are no
  21.        patterns in a file.  The option -V prints ident's  version
  22.        number.
  23.  
  24.        ident  works  on  text  files  as well as object files and
  25.        dumps.  For example, if the C program in f.c contains
  26.  
  27.               #include <stdio.h>
  28.               static char const rcsid[] =
  29.                 "$Id: f.c,v 5.4 1993/11/09  17:40:15  eggert  Exp
  30.               $";
  31.               int main() { return printf("%s\n", rcsid) == EOF; }
  32.  
  33.        and f.c is compiled into f.o, then the command
  34.  
  35.               ident  f.c  f.o
  36.  
  37.        will output
  38.  
  39.               f.c:
  40.                   $Id: f.c,v 5.4 1993/11/09 17:40:15 eggert Exp $
  41.               f.o:
  42.                   $Id: f.c,v 5.4 1993/11/09 17:40:15 eggert Exp $
  43.  
  44.        If a C program defines a string like rcsid above but  does
  45.        not  use  it,  lint(1)  may complain, and some C compilers
  46.        will optimize away the string.  The most reliable solution
  47.        is  to  have the program use the rcsid string, as shown in
  48.        the example above.
  49.  
  50.        ident finds all instances of the $keyword: text $ pattern,
  51.        even  if keyword is not actually an RCS-supported keyword.
  52.        This gives you information about nonstandard keywords like
  53.        $XConsortium$.
  54.  
  55. KEYWORDS
  56.        Here  is  the  list  of  keywords  currently maintained by
  57.        co(1).  All times are given in Coordinated Universal  Time
  58.        (UTC,  sometimes  called GMT) by default, but if the files
  59.        were checked out with co's -zzone option, times are  given
  60.        with a numeric time zone indication appended.
  61.  
  62.  
  63.  
  64. GNU                         1993/11/09                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IDENT(1)                                                 IDENT(1)
  71.  
  72.  
  73.        $Author$
  74.               The login name of the user who checked in the revi-
  75.               sion.
  76.  
  77.        $Date$ The date and time the revision was checked in.
  78.  
  79.        $Header$
  80.               A standard header containing the full  pathname  of
  81.               the  RCS  file,  the  revision number, the date and
  82.               time, the author, the state,  and  the  locker  (if
  83.               locked).
  84.  
  85.        $Id$   Same  as  $Header$, except that the RCS filename is
  86.               without a path.
  87.  
  88.        $Locker$
  89.               The login name of the user who locked the  revision
  90.               (empty if not locked).
  91.  
  92.        $Log$  The  log  message  supplied  during  checkin.   For
  93.               ident's purposes, this is equivalent to  $RCSfile$.
  94.  
  95.        $Name$ The  symbolic  name used to check out the revision,
  96.               if any.
  97.  
  98.        $RCSfile$
  99.               The name of the RCS file without a path.
  100.  
  101.        $Revision$
  102.               The revision number assigned to the revision.
  103.  
  104.        $Source$
  105.               The full pathname of the RCS file.
  106.  
  107.        $State$
  108.               The state assigned to  the  revision  with  the  -s
  109.               option of rcs(1) or ci(1).
  110.  
  111.        co(1)  represents the following characters in keyword val-
  112.        ues by escape sequences  to  keep  keyword  strings  well-
  113.        formed.
  114.  
  115.               char     escape sequence
  116.               tab      \t
  117.               newline  \n
  118.               space    \040
  119.               $        \044
  120.               \        \\
  121.  
  122. IDENTIFICATION
  123.        Author: Walter F. Tichy.
  124.        Manual Page Revision: 5.4; Release Date: 1993/11/09.
  125.        Copyright (C) 1982, 1988, 1989 Walter F. Tichy.
  126.        Copyright (C) 1990, 1992, 1993 Paul Eggert.
  127.  
  128.  
  129.  
  130. GNU                         1993/11/09                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IDENT(1)                                                 IDENT(1)
  137.  
  138.  
  139. SEE ALSO
  140.        ci(1),    co(1),    rcs(1),    rcsdiff(1),    rcsintro(1),
  141.        rcsmerge(1), rlog(1), rcsfile(5)
  142.        Walter  F.  Tichy,  RCS--A  System  for  Version  Control,
  143.        Software--Practice   &   Experience  15,  7  (July  1985),
  144.        637-654.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. GNU                         1993/11/09                          3
  197.  
  198.  
  199.