home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs567x.zip / doc / ident.man < prev    next >
Text File  |  1994-03-22  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. IDENT(1)                                                 IDENT(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        ident - identify RCS keyword strings in files
  9.  
  10. SSYYNNOOPPSSIISS
  11.        iiddeenntt [ --qq ] [ --VV ] [ _f_i_l_e ... ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        iiddeenntt   searches   for   all   instances  of  the  pattern
  15.        $$_k_e_y_w_o_r_d:: _t_e_x_t $$ 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 ccoo(1), but can also be inserted manually.  The
  20.        option  --qq  suppresses  the  warning given if there are no
  21.        patterns in a file.  The option --VV prints iiddeenntt's  version
  22.        number.
  23.  
  24.        iiddeenntt  works  on  text  files  as well as object files and
  25.        dumps.  For example, if the C program in ff..cc contains
  26.  
  27.               ##iinncclluuddee <<ssttddiioo..hh>>
  28.               ssttaattiicc cchhaarr ccoonnsstt rrccssiidd[[]] ==
  29.                 ""$$IIdd:: ff..cc,,vv 55..44 11999933//1111//0099  1177::4400::1155  eeggggeerrtt  EExxpp
  30.               $$"";;
  31.               iinntt mmaaiinn(()) {{ rreettuurrnn pprriinnttff((""%%ss\\nn"",, rrccssiidd)) ==== EEOOFF;; }}
  32.  
  33.        and ff..cc is compiled into ff..oo, then the command
  34.  
  35.               iiddeenntt  ff..cc  ff..oo
  36.  
  37.        will output
  38.  
  39.               ff..cc::
  40.                   $$IIdd:: ff..cc,,vv 55..44 11999933//1111//0099 1177::4400::1155 eeggggeerrtt EExxpp $$
  41.               ff..oo::
  42.                   $$IIdd:: ff..cc,,vv 55..44 11999933//1111//0099 1177::4400::1155 eeggggeerrtt EExxpp $$
  43.  
  44.        If a C program defines a string like rrccssiidd above but  does
  45.        not  use  it,  lliinntt(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 rrccssiidd string, as shown in
  48.        the example above.
  49.  
  50.        iiddeenntt finds all instances of the $$_k_e_y_w_o_r_d:: _t_e_x_t $$ pattern,
  51.        even  if _k_e_y_w_o_r_d is not actually an RCS-supported keyword.
  52.        This gives you information about nonstandard keywords like
  53.        $$XXCCoonnssoorrttiiuumm$$.
  54.  
  55. KKEEYYWWOORRDDSS
  56.        Here  is  the  list  of  keywords  currently maintained by
  57.        ccoo(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 ccoo's --zz_z_o_n_e 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.        $$AAuutthhoorr$$
  74.               The login name of the user who checked in the revi-
  75.               sion.
  76.  
  77.        $$DDaattee$$ The date and time the revision was checked in.
  78.  
  79.        $$HHeeaaddeerr$$
  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.        $$IIdd$$   Same  as  $$HHeeaaddeerr$$, except that the RCS filename is
  86.               without a path.
  87.  
  88.        $$LLoocckkeerr$$
  89.               The login name of the user who locked the  revision
  90.               (empty if not locked).
  91.  
  92.        $$LLoogg$$  The  log  message  supplied  during  checkin.   For
  93.               iiddeenntt's purposes, this is equivalent to  $$RRCCSSffiillee$$.
  94.  
  95.        $$NNaammee$$ The  symbolic  name used to check out the revision,
  96.               if any.
  97.  
  98.        $$RRCCSSffiillee$$
  99.               The name of the RCS file without a path.
  100.  
  101.        $$RReevviissiioonn$$
  102.               The revision number assigned to the revision.
  103.  
  104.        $$SSoouurrccee$$
  105.               The full pathname of the RCS file.
  106.  
  107.        $$SSttaattee$$
  108.               The state assigned to  the  revision  with  the  --ss
  109.               option of rrccss(1) or ccii(1).
  110.  
  111.        ccoo(1)  represents the following characters in keyword val-
  112.        ues by escape sequences  to  keep  keyword  strings  well-
  113.        formed.
  114.  
  115.               _c_h_a_r     _e_s_c_a_p_e _s_e_q_u_e_n_c_e
  116.               tab      \\tt
  117.               newline  \\nn
  118.               space    \\004400
  119.               $$        \\004444
  120.               \\        \\\\
  121.  
  122. IIDDEENNTTIIFFIICCAATTIIOONN
  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. SSEEEE AALLSSOO
  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.        _S_o_f_t_w_a_r_e_-_-_P_r_a_c_t_i_c_e   _&   _E_x_p_e_r_i_e_n_c_e  1155,  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.