Fluff out info on morris accounts.
authorRob Landley <rob@landley.net>
Thu, 18 May 2006 21:53:51 +0000 (21:53 -0000)
committerRob Landley <rob@landley.net>
Thu, 18 May 2006 21:53:51 +0000 (21:53 -0000)
docs/busybox.net/developer.html

index 3d1262da82e9842cdba644370b831c1e3b2cb351..cdb68b78c0bb96b5d3cecae7de20e13b3b87e5a2 100644 (file)
@@ -1,64 +1,69 @@
 <!--#include file="header.html" -->
 
-
-<h3>Subversion Read/Write Access</h3>
-
-If you want to be able to commit things to Subversion, first contribute some
-stuff to show you are serious.  Then, very nicely ask <a
-href="mailto:andersen@codepoet.org">Erik Andersen</a> if he will set you up
-with an commit access to the Subversion repository.  To access Subversion, you
-will want to add the following to set up your environment:
-
-<p>
-
-To obtain commit access, you will need to demonstrate you are serious by
-submitting a few good patches first.  Then, you will need to select a username
-to use when committing changes to SVN, you will need to send me the username
-you have selected, you must send me your preferred contact email address, and
-finally, you must send me an ssh version 2 DSA key with 1024 bits (the default)
-or more.  If you do not currently have an ssh version 2 DSA key, you can
-generate a key using the command<pre>ssh-keygen -t dsa</pre>  This will
-create the files <pre>/home/&lt;USERNAME&gt;/.ssh/id_dsa
-/home/&lt;USERNAME&gt;/.ssh/id_dsa.pub</pre>  You must then send the content
-of 'id_dsa.pub' to me so I can setup your account.  The content of 'id_dsa'
-should of course be kept secret.
-
-<p>
-
-Note that if you would prefer to keep your communications with me
-private, you can encrypt your email using my
-<a href="http://www.codepoet.org/andersen/erik/gpg.asc">public key</a>.
-
-<p>
-
-Once you are setup with an account, you will need to use your account to
-checkout a copy of BusyBox from Subversion:
-
-<pre>
-svn list svn+ssh://username@svn.uclibc.org/svn/trunk/busybox</pre>
-<br>
-It goes without saying you must change <em>username</em> to your own
-username...
-<p>
-
-You can then enter the newly checked out BusyBox directory, make changes, check
-your changes, diff your changes, revert your changes, and and commit your
-changes usine commands such as:
-
-<pre>
+<h3>Morris Dancing</h3>
+
+<p>Subversion commit access requires an account on Morris.  The server
+behind busybox.net and uclibc.org.  If you want to be able to commit things to
+Subversion, first contribute some stuff to show you are serious, can handle
+some responsibility, and that your patches don't generally need a lot of
+cleanup.  Then, very nicely ask one of us (<a href="mailto:rob@landley.net">Rob
+Landley</a> for BusyBox, or <a href="mailto:andersen@codepoet.org">Erik
+Andersen</a> for uClibc) for an account.</p>
+
+<p>If you're approved for an account, you'll need to send an email from your
+preferred contact email address with the username you'd like to use when
+committing changes to SVN, and attach a public ssh key to access your account
+with.</p>
+
+<p>If you don't currently have an ssh version 2 DSA key at least 1024 bits
+long (the default), you can generate a key using the
+command <b>ssh-keygen -t dsa</b> and hitting enter at the prompts.  This
+will create the files <b>~/.ssh/id_dsa</b> and <b>~/.ssh/id_dsa.pub</b>
+You must then send the content of 'id_dsa.pub' to me so I can set up your
+account.  (The content of 'id_dsa' should of course be kept secret, anyone
+who has that can access any account that's installed your public key in
+its <b>.ssh/authorized_keys</b> file.)</p>
+
+<p>Note that if you would prefer to keep your communications with us
+private, you can encrypt your email using
+<a href="http://landley.net/pubkey.gpg">Rob's public key</a> or
+<a href="http://www.codepoet.org/andersen/erik/gpg.asc">Erik's public
+key</a>.</p>
+
+<p>Once you are setup with an account, you will need to use your account to
+checkout a copy of BusyBox from Subversion:</p>
+
+<p><b>svn checkout svn+ssh://username@busybox.net/svn/trunk/busybox</b></p>
+<p>or</p>
+<p><b>svn checkout svn+ssh://username@uclibc.org/svn/trunk/uclibc</b></p>
+
+<p>You must change <em>username</em> to your own username, or omit
+it if it's the same as your local username.</p>
+
+<p>You can then enter the newly checked out project directory, make changes,
+check your changes, diff your changes, revert your changes, and and commit your
+changes using commands such as:</p>
+
+<b><pre>
 svn diff
 svn status
 svn revert
-svn commit</pre>
+EDITOR=vi svn commit
+svn log -v -r PREV:HEAD
+svn help
+</pre></b>
 
-<p>
-
-For additional detail on how to use Subversion, please visit the
+<p>For additional detail on how to use Subversion, please visit the
 <a href="http://subversion.tigris.org/">the Subversion website</a>.
 You might also want to read online or buy a copy of <a
-href="http://svnbook.red-bean.com/">the Subversion Book</a>...
+href="http://svnbook.red-bean.com/">the Subversion Book</a>...</p>
 
+<p>A morris account also gives you a personal web page
+(http://busybox.net/~username comes from ~/public_html on morris), and of
+course a shell prompt you can ssh into (as a regular user, root access is
+reserved for Erik and Rob).  But keep in mind an account on Morris is a
+priviledge, not a requirement.  Most contributors to busybox and uClibc
+haven't got one, and accounts are handed out to make the project maintainers'
+lives easier, not because "you deserve it".</p>
 
 <!--#include file="footer.html" -->
-
-