Add some basic cvs usage info
[oweals/busybox.git] / docs / busybox.net / cvs_anon.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd"> 
2
3 <HTML>
4 <HEAD>
5 <title>BusyBox Anonymous CVS Instructions</title>
6 </HEAD>
7
8 <body text="#000000" alink="#660000" link="#660000" bgcolor="#dee2de" vlink="#660000">
9
10 <basefont face="lucida, helvetica, arial" size="3">
11
12
13 <H3>Accessing the Busybox CVS Repository</H3>
14
15 <CENTER>
16       <TABLE BORDER=0 CELLSPACING=1 CELLPADDING=2>
17             <TR>
18                 <td bgcolor="#000000">
19                   <FONT FACE="lucida, helvetica" COLOR="#ccccc0">
20                       <B>B&nbsp;u&nbsp;s&nbsp;y&nbsp;B&nbsp;o&nbsp;x</B>
21                   </FONT>
22                 </TD>
23             </TR>
24       </TABLE>
25       <a href="/"><IMG SRC="images/busybox2.jpg" alt="BusyBox" border="0" width="360" height="230"></a><BR>
26
27
28 </CENTER>
29
30 <TABLE WIDTH="95%" CELLSPACING=1 CELLPADDING=4 BORDER=1>
31 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
32     <A NAME="intro"> <BIG><B>
33     Anonymous CVS
34     </B></BIG></A>
35 </TD></TR>
36 <TR><TD BGCOLOR="#eeeee0">
37
38 We allow anonymous (read-only) CVS access to everyone.  The first command you
39 need to run for anonymous CVS access is:
40 <pre>
41 cvs -d:pserver:anonymous@busybox.net:/var/cvs login</pre>
42 <p>
43 CVS will prompt you for a password. Just press the Enter key (there is no
44 password for anonymous access).  This step only needs to be done once, the first
45 time you attempt to access CVS.
46 <p>
47 Once the login is complete, you can then check the list of available
48 CVS modules by running the following command (all on one line):
49 <pre>
50 cvs -z3 -d:pserver:anonymous@busybox.net:/var/cvs co -c </pre>
51
52 <p>
53 If you wish, you can then check out a local copy of any of the 
54 available modules.  The following is an example of how to grab 
55 a copy of busybox and tinylogin:
56 <pre>
57     cvs -z3 -d:pserver:anonymous@busybox.net:/var/cvs co -P busybox tinylogin</pre>
58 This will create a directory called <b>busybox</b> and a directory called
59 <b>tinylogin</b> in the current directory.  These directories contain the
60 latest and greatest source code for busybox and tinylogin.
61
62 <p>
63 I usually create a ~/.cvsrc file with the following things in it, and I
64 recommend you should use the same:
65 <pre>
66     -z3
67     update -dP
68     rdiff -u
69     diff -ubBwpN
70     checkout -P</pre>
71
72 <p> 
73 Once you've checked out a copy of the source tree, you can update your
74 source tree at any time so it is in sync with the latest and greatest by
75 running the command:
76 <pre>
77 cvs update</pre>
78
79 Because you've only been granted anonymous access to the tree, you won't be
80 able to commit any changes. Changes can be submitted for inclusion by posting
81 them to the appropriate <a href="http://busybox.net/mailman/listinfo">mailing list</a>.
82
83
84 <!-- End of Table -->
85
86 </TD></TR>
87 </TABLE>
88
89
90
91 <TABLE WIDTH="95%" CELLSPACING=1 CELLPADDING=4 BORDER=1>
92 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
93     <A NAME="howto"> <BIG><B>
94     How to use CVS
95     </B></BIG></A>
96 </TD></TR>
97 <TR><TD BGCOLOR="#eeeee0">
98
99
100 If you want to know all the gory details, you will want to visit
101 <a href="http://www.cvshome.org/">the CVS main web page</a>.<p>
102 For the impatient, the following is probably about all you need to know:
103 <p>
104
105 <dl>
106     <dt><pre>cvs checkout -c</pre>
107     <dd>Will list the modules available for checkout
108     <dt><pre>cvs checkout &lt module name &gt</pre> 
109     <dd>Will checkout the named module
110     <dt><pre>cvs co &lt module name &gt</pre> 
111     <dd>Same thing
112     <dt><pre>cvs update</pre>
113
114     <dd>Updates your local archive so it is in sync with the repository 
115     -- your local updates are left intact.  Tries to merge upstream updates 
116     into your local updates.  You will see the following tags when it is
117     updating your local repository: C means conflict, U means update, 
118     P means patched, and M means modified.
119     <dt><pre>cvs up</pre>
120     <dd>Same thing
121     <dt><pre>cvs update &lt file name &gt</pre>
122     <dd>Same thing but for just the named file(s)/directory(s).
123     <dt><pre>cvs commit</pre>
124     <dd>Will check in all your work.
125     <dt><pre>cvs add &lt file name &gt</pre>
126
127     <dd>Adds the named file/directory into CVS
128     <dt><pre>cvs remove &lt file name &gt</pre>
129     <dd>Removes the named file/directory from the upstream repository.
130     <dt><pre>cvs rm &lt file name &gt</pre>
131     <dd>Same thing
132     <dt><pre>cvs log &lt file name &gt</pre>
133
134 <!-- End of Table -->
135
136 </TD></TR>
137 </TABLE>
138
139
140
141 <!-- Footer -->
142 <HR>
143 <TABLE WIDTH="100%">
144     <TR>
145         <TD>
146             <font size="-1" face="arial, helvetica, sans-serif">
147             Mail all comments, insults, suggestions and bribes to 
148             <a href="mailto:andersen@codepoet.org">Erik Andersen</a><BR>
149             The Busybox logo is copyright 1999-2003, Erik Andersen.
150             </font>
151         </TD>
152
153         <TD>
154             <a href="http://www.vim.org"><img border=0 width=90 height=36
155             src="images/written.in.vi.png" 
156             alt="This site created with the vi editor"></a>
157         </TD>
158
159         <TD>
160             <a href="http://www.gimp.org/"><img border=0 width=90 height=36
161             src="images/gfx_by_gimp.png" alt="Graphics by GIMP"></a>
162         </TD>
163
164         <TD>
165             <a href="http://www.linuxtoday.com"><img width=90 height=36
166             src="images/ltbutton2.png" alt="Linux Today"></a>
167         </TD>
168
169         <TD>
170             <p><a href="http://slashdot.org"><img width=90 height=36
171             src="images/sdsmall.png" alt="Slashdot"></a>
172         </TD>
173
174         <TD>
175             <a href="http://freshmeat.net"><img width=90 height=36
176             src="images/fm.mini.png" alt="Freshmeat"></a>
177         </TD>
178
179     </TR>
180 </TABLE>
181
182
183 </BODY>
184 </HTML>
185
186