home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / dev / RevisionControl / HWGRCS / hwgrcs / man / rcsclean.man < prev    next >
Text File  |  1993-01-19  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. RCSCLEAN(1)              USER COMMANDS                RCSCLEAN(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      rcsclean - clean up working files
  10.  
  11. SYNOPSIS
  12.      rcsclean [_o_p_t_i_o_n_s] [ _f_i_l_e ... ]
  13.  
  14. DESCRIPTION
  15.      rcsclean removes working files that  were  checked  out  and
  16.      never  modified.  For each _f_i_l_e given, rcsclean compares the
  17.      working file and a revision in the corresponding  RCS  file.
  18.      If  it  finds  a difference, it does nothing.  Otherwise, it
  19.      first unlocks the revision if the -u option  is  given,  and
  20.      then  removes  the  working  file unless the working file is
  21.      writable and the revision is locked.  It logs its actions by
  22.      outputting  the  corresponding  rcs -u and rm -f commands on
  23.      the standard output.
  24.  
  25.      If no _f_i_l_e is given, all working files in the current direc-
  26.      tory  are  cleaned.  Pathnames matching an RCS suffix denote
  27.      RCS files; all  others  denote  working  files.   Names  are
  28.      paired as explained in ci(1).
  29.  
  30.      The number of the revision to which the working file is com-
  31.      pared  may  be attached to any of the options -n, -q, -r, or
  32.      -u.  If no revision number is  specified,  then  if  the  -u
  33.      option  is  given  and  the  caller has one revision locked,
  34.      rcsclean uses that revision;  otherwise  rcsclean  uses  the
  35.      latest revision on the default branch, normally the root.
  36.  
  37.      rcsclean is useful for clean targets in Makefiles.  See also
  38.      rcsdiff(1),  which  prints  out  the differences, and ci(1),
  39.      which normally asks whether to check in a file if it was not
  40.      changed.
  41.  
  42. OPTIONS
  43.      -k_s_u_b_s_t
  44.           Use _s_u_b_s_t style keyword  substitution  when  retrieving
  45.           the revision for comparison.  See co(1) for details.
  46.  
  47.      -n[_r_e_v]
  48.           Do not actually remove any files or  unlock  any  revi-
  49.           sions.   Using  this option will tell you what rcsclean
  50.           would do without actually doing it.
  51.  
  52.      -q[_r_e_v]
  53.           Do not log the actions taken on standard output.
  54.  
  55.      -r[_r_e_v]
  56.           This option has no effect  other  than  specifying  the
  57.           revision for comparison.
  58.  
  59.      -u[_r_e_v]
  60.  
  61.  
  62.  
  63. GNU                  Last change: 1991/11/03                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCSCLEAN(1)              USER COMMANDS                RCSCLEAN(1)
  71.  
  72.  
  73.  
  74.           Unlock the revision if it is locked and  no  difference
  75.           is found.
  76.  
  77.      -V_n  Emulate RCS version _n.  See co(1) for details.
  78.  
  79.      -x_s_u_f_f_i_x_e_s
  80.           Use _s_u_f_f_i_x_e_s to characterize RCS files.  See ci(1)  for
  81.           details.
  82.  
  83. EXAMPLES
  84.           rcsclean  *.c  *.h
  85.  
  86.      removes all working files ending in .c or .h that  were  not
  87.      changed since their checkout.
  88.  
  89.           rcsclean
  90.  
  91.      removes all working files in the current directory that were
  92.      not changed since their checkout.
  93.  
  94. FILES
  95.      rcsclean accesses files much as ci(1) does.
  96.  
  97. ENVIRONMENT
  98.      RCSINIT
  99.           options prepended to the argument  list,  separated  by
  100.           spaces.   A  backslash escapes spaces within an option.
  101.           The RCSINIT options are prepended to the argument lists
  102.           of  most  RCS commands.  Useful RCSINIT options include
  103.           -q, -V, and -x.
  104.  
  105. DIAGNOSTICS
  106.      The exit status is zero if and only if all  operations  were
  107.      successful.    Missing  working  files  and  RCS  files  are
  108.      silently ignored.
  109.  
  110. IDENTIFICATION
  111.      Author: Walter F. Tichy.
  112.      Revision Number: 1.8; Release Date: 1991/11/03.
  113.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  114.      Copyright c 1990, 1991 by Paul Eggert.
  115.  
  116. SEE ALSO
  117.      ci(1), co(1),  ident(1),  rcs(1),  rcsdiff(1),  rcsintro(1),
  118.      rcsmerge(1), rlog(1), rcsfile(5)
  119.      Walter  F.  Tichy,  RCS--A  System  for   Version   Control,
  120.      _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 15, 7 (July 1985), 637-654.
  121.  
  122. BUGS
  123.      At least one _f_i_l_e must be given in older Unix versions  that
  124.      do not provide the needed directory scanning operations.
  125.  
  126.  
  127.  
  128.  
  129. GNU                  Last change: 1991/11/03                    2
  130.  
  131.  
  132.  
  133.