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