merge current assockit from CVS, not yet enough
[shellsnippets/shellsnippets.git] / mksh / cvs-switchroot.1
1 .\" $MirOS: contrib/hosted/tg/deb/cvs/debian/cvs-switchroot.1,v 1.2 2011/06/24 16:16:06 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.
75 .Sh CAVEATS
76 .Nm
77 depends on
78 .Nm mksh .