docs/developer.html

   1 <!--#include file="header.html" -->
   2
   3
   4 <h3>Subversion Read/Write Access</h3>
   5
   6 If you want to be able to commit things to Subversion, first contribute some
   7 stuff to show you are serious.  Then, very nicely ask <a
   8 href="mailto:andersen@codepoet.org">Erik Andersen</a> if he will set you up
   9 with an commit access to the Subversion repository.  To access Subversion, you
  10 will want to add the following to set up your environment:
  11
  12 <p>
  13
  14 To obtain commit access, you will need to demonstrate you are serious by
  15 submitting a few good patches first.  Then, you will need to select a username
  16 to use when committing changes to SVN, you will need to send me the username
  17 you have selected, you must send me your preferred contact email address, and
  18 finally, you must send me an ssh version 2 DSA key with 1024 bits (the default)
  19 or more.  If you do not currently have an ssh version 2 DSA key, you can
  20 generate a key using the command<pre>ssh-keygen -t dsa</pre>  This will
  21 create the files <pre>/home/&lt;USERNAME&gt;/ssh/id_dsa
  22 /home/&lt;USERNAME&gt;/.ssh/id_dsa.pub</pre>
  23 It is recommended that you generate a key with a "passphrase" for security reasons.
  24
  25 <p>
  26 Make the file known to the system by running
  27
  28 <pre>ssh-add ~/.ssh/id_dsa</pre>
  29
  30 You must then send the content of 'id_dsa.pub' to me so I can setup your account.
  31 The content of 'id_dsa' should of course be kept secret.
  32
  33 <p>
  34
  35 Note that if you would prefer to keep your communications with me
  36 private, you can encrypt your email using my
  37 <a href="http://www.codepoet.org/andersen/erik/gpg.asc">public key</a>.
  38
  39 <p>
  40
  41 Once you are setup with an account, you will need to use your account to
  42 checkout a copy of buildroot from Subversion:
  43
  44 <pre>
  45 svn list svn+ssh://username@svn.uclibc.org/svn/trunk/buildroot</pre>
  46 <br>
  47 It goes without saying you must change <em>username</em> to your own
  48 username...
  49 <p>
  50
  51 You can then enter the newly checked out buildroot directory, make changes, check
  52 your changes, diff your changes, revert your changes, and and commit your
  53 changes usine commands such as:
  54
  55 <pre>
  56 svn diff
  57 svn status
  58 svn revert
  59 svn commit</pre>
  60
  61 <p>
  62
  63 For additional detail on how to use Subversion, please visit the
  64 <a href="http://subversion.tigris.org/">the Subversion website</a>.
  65 You might also want to read online or buy a copy of <a
  66 href="http://svnbook.red-bean.com/">the Subversion Book</a>...
  67
  68
  69 <!--#include file="footer.html" -->
  70
  71