remove now-useless RCS IDs from CVS
[alioth/cvs.git] / debian / cvs-switchroot.1
1 .Dd June 10, 2011
2 .Dt CVS\-SWITCHROOT 1
3 .Os
4 .Sh NAME
5 .Nm cvs\-switchroot
6 .Nd change repository or tag in a cvs working copy
7 .Sh SYNOPSIS
8 .Nm
9 .Op Fl T
10 .Ar newroot
11 .Op Ar
12 .Pp
13 .Nm
14 .Op Fl T
15 \-\&
16 .Ar srcpath
17 .Op Ar
18 .Sh DESCRIPTION
19 The
20 .Nm
21 utility manipulates a CVS working copy directly,
22 modifying the information stored in the administrative
23 subdirectory and saving space by hardlinking if possible.
24 .Pp
25 If the
26 .Fl T
27 option is given, the sticky tag is operated on,
28 otherwise, the repository path
29 .Pq Ev CVSROOT .
30 .Pp
31 The information (Tag or Root) is set to the same as in
32 .Ar srcpath
33 if the first non-option argument
34 .Ar newroot
35 is a sole dash
36 .Pq Sq \-\& ,
37 the literal value
38 .Ar newroot
39 otherwise.
40 .Sh EXAMPLES
41 Change all
42 .Pa Root
43 information in the current sandbox to 
44 .Pa /cvs :
45 .Bd -literal -offset ident
46 $ cvs-switchroot /cvs .
47 .Ed
48 .Pp
49 Set all roots in the current working directory and all
50 its subdirectories to the
51 .Pa Root
52 of the parent directory:
53 .Bd -literal -offset ident
54 $ cvs-switchroot \- .. .
55 .Ed
56 .Pp
57 Hardlink the
58 .Pa Tag
59 information in the current working directory, for example
60 .Pa /usr/src ,
61 and
62 .Pa /usr/ports
63 with each other:
64 .Bd -literal -offset ident
65 $ cvs-switchroot \-T \- . . /usr/ports
66 .Ed
67 .Sh SEE ALSO
68 .Xr cvs 1
69 .Sh HISTORY
70 .Nm
71 has existed in the MirBSD source tree since 2005.
72 It was added to Debian's cvs package in 2011.
73 .Sh CAVEATS
74 .Nm
75 depends on
76 .Nm mksh .