1 | <!--#include file="header.html" -->
|
---|
2 |
|
---|
3 | <h3>Morris Dancing</h3>
|
---|
4 |
|
---|
5 | <p>Subversion commit access requires an account on Morris. The server
|
---|
6 | behind busybox.net and uclibc.org. If you want to be able to commit things to
|
---|
7 | Subversion, first contribute some stuff to show you are serious, can handle
|
---|
8 | some responsibility, and that your patches don't generally need a lot of
|
---|
9 | cleanup. Then, very nicely ask one of us (<a href="mailto:rob@landley.net">Rob
|
---|
10 | Landley</a> for BusyBox, or <a href="mailto:andersen@codepoet.org">Erik
|
---|
11 | Andersen</a> for uClibc) for an account.</p>
|
---|
12 |
|
---|
13 | <p>If you're approved for an account, you'll need to send an email from your
|
---|
14 | preferred contact email address with the username you'd like to use when
|
---|
15 | committing changes to SVN, and attach a public ssh key to access your account
|
---|
16 | with.</p>
|
---|
17 |
|
---|
18 | <p>If you don't currently have an ssh version 2 DSA key at least 1024 bits
|
---|
19 | long (the default), you can generate a key using the
|
---|
20 | command <b>ssh-keygen -t dsa</b> and hitting enter at the prompts. This
|
---|
21 | will create the files <b>~/.ssh/id_dsa</b> and <b>~/.ssh/id_dsa.pub</b>
|
---|
22 | You must then send the content of 'id_dsa.pub' to me so I can set up your
|
---|
23 | account. (The content of 'id_dsa' should of course be kept secret, anyone
|
---|
24 | who has that can access any account that's installed your public key in
|
---|
25 | its <b>.ssh/authorized_keys</b> file.)</p>
|
---|
26 |
|
---|
27 | <p>Note that if you would prefer to keep your communications with us
|
---|
28 | private, you can encrypt your email using
|
---|
29 | <a href="http://landley.net/pubkey.gpg">Rob's public key</a> or
|
---|
30 | <a href="http://www.codepoet.org/andersen/erik/gpg.asc">Erik's public
|
---|
31 | key</a>.</p>
|
---|
32 |
|
---|
33 | <p>Once you are setup with an account, you will need to use your account to
|
---|
34 | checkout a copy of BusyBox from Subversion:</p>
|
---|
35 |
|
---|
36 | <p><b>svn checkout svn+ssh://username@busybox.net/svn/trunk/busybox</b></p>
|
---|
37 | <p>or</p>
|
---|
38 | <p><b>svn checkout svn+ssh://username@uclibc.org/svn/trunk/uclibc</b></p>
|
---|
39 |
|
---|
40 | <p>You must change <em>username</em> to your own username, or omit
|
---|
41 | it if it's the same as your local username.</p>
|
---|
42 |
|
---|
43 | <p>You can then enter the newly checked out project directory, make changes,
|
---|
44 | check your changes, diff your changes, revert your changes, and and commit your
|
---|
45 | changes using commands such as:</p>
|
---|
46 |
|
---|
47 | <b><pre>
|
---|
48 | svn diff
|
---|
49 | svn status
|
---|
50 | svn revert
|
---|
51 | EDITOR=vi svn commit
|
---|
52 | svn log -v -r PREV:HEAD
|
---|
53 | svn help
|
---|
54 | </pre></b>
|
---|
55 |
|
---|
56 | <p>For additional detail on how to use Subversion, please visit the
|
---|
57 | <a href="http://subversion.tigris.org/">the Subversion website</a>.
|
---|
58 | You might also want to read online or buy a copy of <a
|
---|
59 | href="http://svnbook.red-bean.com/">the Subversion Book</a>...</p>
|
---|
60 |
|
---|
61 | <p>A morris account also gives you a personal web page
|
---|
62 | (http://busybox.net/~username comes from ~/public_html on morris), and of
|
---|
63 | course a shell prompt you can ssh into (as a regular user, root access is
|
---|
64 | reserved for Erik and Rob). But keep in mind an account on Morris is a
|
---|
65 | priviledge, not a requirement. Most contributors to busybox and uClibc
|
---|
66 | haven't got one, and accounts are handed out to make the project maintainers'
|
---|
67 | lives easier, not because "you deserve it".</p>
|
---|
68 |
|
---|
69 | <!--#include file="footer.html" -->
|
---|