vcs.maemo.org Git - busybox4maemo/blob - docs/busybox.net/developer.html

   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" -->