Annotation of src/usr.bin/rcs/rcsclean.1, Revision 1.22
1.22 ! jmc 1: .\" $OpenBSD: rcsclean.1,v 1.21 2007/05/31 19:20:15 jmc Exp $
1.1 joris 2: .\"
3: .\" Copyright (c) 2005 Joris Vink <joris@openbsd.org>
4: .\" All rights reserved.
5: .\"
6: .\" Permission to use, copy, modify, and distribute this software for any
7: .\" purpose with or without fee is hereby granted, provided that the above
8: .\" copyright notice and this permission notice appear in all copies.
9: .\"
10: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.22 ! jmc 17: .Dd $Mdocdate: May 31 2007 $
1.1 joris 18: .Dt RCSCLEAN 1
19: .Os
20: .Sh NAME
21: .Nm rcsclean
22: .Nd clean up working files
23: .Sh SYNOPSIS
24: .Nm
1.11 xsa 25: .Op Fl TV
1.4 niallo 26: .Op Fl k Ns Ar mode
1.8 xsa 27: .Op Fl n Ns Op Ar rev
28: .Op Fl q Ns Op Ar rev
1.15 jmc 29: .Op Fl r Ns Op Ar rev
1.8 xsa 30: .Op Fl u Ns Op Ar rev
1.9 xsa 31: .Op Fl x Ns Ar suffixes
32: .Op Fl z Ns Ar tz
1.20 xsa 33: .Op Ar
1.1 joris 34: .Sh DESCRIPTION
35: The
36: .Nm
1.15 jmc 37: program is used to clean up (remove) files that are not being worked on.
38: Only checked out files from the current working directory are removed \(en
39: .Nm
40: does not remove files from the RCS repository.
1.20 xsa 41: .Pp
42: If no
43: .Ar file
44: operand is specified,
45: .Nm
46: cleans up all working files in the current directory.
1.14 jmc 47: .Pp
48: .Nm
49: also supports
50: keyword substitution \(en
51: see the
52: .Xr rcs 1
53: man page for more information.
1.1 joris 54: .Pp
55: The following options are supported:
56: .Bl -tag -width Ds
1.5 jmc 57: .It Fl k Ns Ar mode
1.1 joris 58: Specify the keyword substitution mode.
1.8 xsa 59: .It Fl n Ns Op Ar rev
1.2 jmc 60: Dry-run mode.
61: When this option is specified,
1.1 joris 62: .Nm
63: will show you what it would normally do without doing it.
1.8 xsa 64: .It Fl q Ns Op Ar rev
1.1 joris 65: Be quiet about reporting.
1.15 jmc 66: .It Fl r Ns Op Ar rev
67: Remove revision
68: .Ar rev .
69: If
70: .Ar rev
71: does not match the revision of the currently checked out file,
72: .Nm
73: will do nothing.
1.11 xsa 74: .It Fl T
1.12 jmc 75: Preserve the modification time of RCS files.
1.8 xsa 76: .It Fl u Ns Op Ar rev
1.15 jmc 77: Unlock the revision if it's currently locked.
78: This is only possible if no changes have been made to the file
79: since it was checked out.
1.1 joris 80: .It Fl V
81: Print RCS's version number.
1.9 xsa 82: .It Fl x Ns Ar suffixes
83: Specify the suffixes for RCS files.
84: Suffixes should be separated by the
85: .Sq /
86: character.
87: .It Fl z Ns Ar tz
88: Specify the time zone for keyword substitution.
1.1 joris 89: .El
90: .Sh ENVIRONMENT
91: .Bl -tag -width RCSINIT
92: .It Ev RCSINIT
93: If set, this variable should contain a list of space-delimited options that
94: are prepended to the argument list.
95: .El
1.22 ! jmc 96: .Sh EXIT STATUS
! 97: .Ex -std rcsclean
1.10 xsa 98: .Sh EXAMPLES
99: Remove all working files (locked or not) in the current directory that were
100: not changed since last checkout:
101: .Pp
102: .Dl $ rcsclean -u
1.1 joris 103: .Sh SEE ALSO
1.3 xsa 104: .Xr ci 1 ,
1.1 joris 105: .Xr co 1 ,
1.3 xsa 106: .Xr ident 1 ,
1.1 joris 107: .Xr rcs 1 ,
108: .Xr rcsdiff 1 ,
1.6 xsa 109: .Xr rcsmerge 1 ,
1.3 xsa 110: .Xr rlog 1