home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs567x.zip / doc / rcsclean.man < prev    next >
Text File  |  1994-03-22  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. RCSCLEAN(1)                                           RCSCLEAN(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        rcsclean - clean up working files
  9.  
  10. SSYYNNOOPPSSIISS
  11.        rrccsscclleeaann [_o_p_t_i_o_n_s] [ _f_i_l_e ... ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        rrccsscclleeaann  removes  files  that  are  not  being worked on.
  15.        rrccsscclleeaann --uu also unlocks and removes files that are  being
  16.        worked on but have not changed.
  17.  
  18.        For  each  _f_i_l_e  given, rrccsscclleeaann compares the working file
  19.        and a revision in the corresponding RCS file.  If it finds
  20.        a  difference,  it  does  nothing.   Otherwise,  it  first
  21.        unlocks the revision if the --uu option is given,  and  then
  22.        removes  the  working  file  unless  the  working  file is
  23.        writable and the revision is locked.  It logs its  actions
  24.        by  outputting the corresponding rrccss --uu and rrmm --ff commands
  25.        on the standard output.
  26.  
  27.        Files are paired as explained in ccii(1).   If  no  _f_i_l_e  is
  28.        given,  all  working  files  in  the current directory are
  29.        cleaned.  Pathnames matching  an  RCS  suffix  denote  RCS
  30.        files; all others denote working files.
  31.  
  32.        The  number  of  the revision to which the working file is
  33.        compared may be attached to any of the options --nn, --qq, --rr,
  34.        or --uu.  If no revision number is specified, then if the --uu
  35.        option is given and the caller has  one  revision  locked,
  36.        rrccsscclleeaann  uses  that revision; otherwise rrccsscclleeaann uses the
  37.        latest revision on the default branch, normally the  root.
  38.  
  39.        rrccsscclleeaann  is  useful  for cclleeaann targets in makefiles.  See
  40.        also rrccssddiiffff(1), which prints  out  the  differences,  and
  41.        ccii(1),  which normally reverts to the previous revision if
  42.        a file was not changed.
  43.  
  44. OOPPTTIIOONNSS
  45.        --kk_s_u_b_s_t
  46.               Use _s_u_b_s_t style keyword substitution when  retriev-
  47.               ing  the  revision  for  comparison.  See ccoo(1) for
  48.               details.
  49.  
  50.        --nn[_r_e_v]
  51.               Do not actually remove  any  files  or  unlock  any
  52.               revisions.   Using  this  option will tell you what
  53.               rrccsscclleeaann would do without actually doing it.
  54.  
  55.        --qq[_r_e_v]
  56.               Do not log the actions taken on standard output.
  57.  
  58.        --rr[_r_e_v]
  59.               This option has no effect other than specifying the
  60.               revision for comparison.
  61.  
  62.  
  63.  
  64. GNU                         1993/11/03                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCSCLEAN(1)                                           RCSCLEAN(1)
  71.  
  72.  
  73.        --TT     Preserve the modification time on the RCS file even
  74.               if the RCS file changes because a lock is  removed.
  75.               This  option  can  suppress extensive recompilation
  76.               caused by a mmaakkee(1) dependency of some  other  copy
  77.               of  the  working  file  on  the RCS file.  Use this
  78.               option with care;  it  can  suppress  recompilation
  79.               even  when it is needed, i.e. when the lock removal
  80.               would mean a change to keyword strings in the other
  81.               working file.
  82.  
  83.        --uu[_r_e_v]
  84.               Unlock  the revision if it is locked and no differ-
  85.               ence is found.
  86.  
  87.        --VV     Print RCS's version number.
  88.  
  89.        --VV_n    Emulate RCS version _n.  See ccoo(1) for details.
  90.  
  91.        --xx_s_u_f_f_i_x_e_s
  92.               Use _s_u_f_f_i_x_e_s to characterize RCS files.  See  ccii(1)
  93.               for details.
  94.  
  95.        --zz_z_o_n_e Use _z_o_n_e as the time zone for keyword substitution;
  96.               see ccoo(1) for details.
  97.  
  98. EEXXAAMMPPLLEESS
  99.               rrccsscclleeaann  **..cc  **..hh
  100.  
  101.        removes all working files ending in ..cc or ..hh that were not
  102.        changed since their checkout.
  103.  
  104.               rrccsscclleeaann
  105.  
  106.        removes  all  working  files in the current directory that
  107.        were not changed since their checkout.
  108.  
  109. FFIILLEESS
  110.        rrccsscclleeaann accesses files much as ccii(1) does.
  111.  
  112. EENNVVIIRROONNMMEENNTT
  113.        RRCCSSIINNIITT
  114.               options prepended to the argument  list,  separated
  115.               by  spaces.   A  backslash escapes spaces within an
  116.               option.  The RRCCSSIINNIITT options are prepended  to  the
  117.               argument   lists  of  most  RCS  commands.   Useful
  118.               RRCCSSIINNIITT options include --qq, --VV, --xx, and --zz.
  119.  
  120. DDIIAAGGNNOOSSTTIICCSS
  121.        The exit status is zero if and only if all operations were
  122.        successful.   Missing  working  files  and  RCS  files are
  123.        silently ignored.
  124.  
  125. IIDDEENNTTIIFFIICCAATTIIOONN
  126.        Author: Walter F. Tichy.
  127.  
  128.  
  129.  
  130. GNU                         1993/11/03                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RCSCLEAN(1)                                           RCSCLEAN(1)
  137.  
  138.  
  139.        Manual Page Revision: 1.12; Release Date: 1993/11/03.
  140.        Copyright (C) 1982, 1988, 1989 Walter F. Tichy.
  141.        Copyright (C) 1990, 1991, 1992, 1993 Paul Eggert.
  142.  
  143. SSEEEE AALLSSOO
  144.        ci(1), co(1), ident(1), rcs(1),  rcsdiff(1),  rcsintro(1),
  145.        rcsmerge(1), rlog(1), rcsfile(5)
  146.        Walter  F.  Tichy,  RCS--A  System  for  Version  Control,
  147.        _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),
  148.        637-654.
  149.  
  150. BBUUGGSS
  151.        At  least  one  _f_i_l_e  must be given in older Unix versions
  152.        that do not provide the needed directory  scanning  opera-
  153.        tions.
  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/03                          3
  197.  
  198.  
  199.