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