source: MondoRescue/branches/stable/mindi-busybox/docs/busybox.net/developer.html @ 821

Last change on this file since 821 was 821, checked in by Bruno Cornec, 14 years ago

Addition of busybox 1.2.1 as a mindi-busybox new package
This should avoid delivering binary files in mindi not built there (Fedora and Debian are quite serious about that)

File size: 3.0 KB
Line 
1<!--#include file="header.html" -->
2
3<h3>Morris Dancing</h3>
4
5<p>Subversion commit access requires an account on Morris.  The server
6behind busybox.net and uclibc.org.  If you want to be able to commit things to
7Subversion, first contribute some stuff to show you are serious, can handle
8some responsibility, and that your patches don't generally need a lot of
9cleanup.  Then, very nicely ask one of us (<a href="mailto:rob@landley.net">Rob
10Landley</a> for BusyBox, or <a href="mailto:andersen@codepoet.org">Erik
11Andersen</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
14preferred contact email address with the username you'd like to use when
15committing changes to SVN, and attach a public ssh key to access your account
16with.</p>
17
18<p>If you don't currently have an ssh version 2 DSA key at least 1024 bits
19long (the default), you can generate a key using the
20command <b>ssh-keygen -t dsa</b> and hitting enter at the prompts.  This
21will create the files <b>~/.ssh/id_dsa</b> and <b>~/.ssh/id_dsa.pub</b>
22You must then send the content of 'id_dsa.pub' to me so I can set up your
23account.  (The content of 'id_dsa' should of course be kept secret, anyone
24who has that can access any account that's installed your public key in
25its <b>.ssh/authorized_keys</b> file.)</p>
26
27<p>Note that if you would prefer to keep your communications with us
28private, 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
31key</a>.</p>
32
33<p>Once you are setup with an account, you will need to use your account to
34checkout 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
41it 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,
44check your changes, diff your changes, revert your changes, and and commit your
45changes using commands such as:</p>
46
47<b><pre>
48svn diff
49svn status
50svn revert
51EDITOR=vi svn commit
52svn log -v -r PREV:HEAD
53svn 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>.
58You might also want to read online or buy a copy of <a
59href="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
63course a shell prompt you can ssh into (as a regular user, root access is
64reserved for Erik and Rob).  But keep in mind an account on Morris is a
65priviledge, not a requirement.  Most contributors to busybox and uClibc
66haven't got one, and accounts are handed out to make the project maintainers'
67lives easier, not because "you deserve it".</p>
68
69<!--#include file="footer.html" -->
Note: See TracBrowser for help on using the repository browser.