Changes between Version 7 and Version 8 of LeaveTheNest

Timestamp:

01/18/09 12:06:29 (13 years ago)

Author:

barney

Comment:

m4 leaves the nest

LeaveTheNest

@@ -30 +30 @@
 
 
-= Moving to github.com: How Eclectus did it =
+= Moving to github.com: How Parrot m4 did it =
 
-http://github.com is another option for where to fly to after leaving the nest. That's what I, barney, did for Eclectus.
+http://github.com is another option for where to fly to after leaving the nest. That's what I, barney, did for Parrot m4.
 
 == Create your local git repository ==
@@ -38 +38 @@
 Mark Glines is maintaining a readonly mirror of the trunk of Parrot's svn repository. 
 This means that the commit history of trunk, but not the branches, is available.
-Relax, the bulk of the work is already done.
+So you can relax, the bulk of the work is already done.
 
 {{{
@@ -46 +46 @@
 git clone git://squawk.glines.org/parrot-trunk
 cd parrot-trunk
-git filter-branch --subdirectory-filter languages/eclectus/
+git filter-branch --subdirectory-filter languages/m4/
 }}}
 
-== Create an empty repository on github.com ==
+This leaves you with a git repository containing the content and history of 'languages/m4'.
 
-For using the public plan you need to supply an username, your Email-adress and a public SSH-key.
-After that I followed the instructions and created an empty repository called 'eclectus'.
+== Create an account on github.com, if you don't have one yet ==
+
+github.com offers a public plan with 100 MB diskspace.
+For creating an account you need to supply an username, your Email-adress and a public SSH-key.
+
+== Create an empty repository ==
+
+In your github startpage there is a link labelled 'Create a Repository'.
+Click that and follow the instructions for creating an empty repository called 'm4'.
+Don't worry too much about the name, you can always change it later.
 
 == Push your local repository onto github ==
+
+github offers instruction for starting am empty initial repository.
+We already have code and history, so we need to do things a little bit differently.
 
 Pushing the project onto github can then be done with:
 
 {{{
+cd ~/git/parrot-trunk
 git remote rm origin
-git remote add origin git@github.com:bschmalhofer/eclectus.git
+git remote add origin git@github.com:bschmalhofer/m4.git
 git remote show origin
 git status
@@ -66 +78 @@
 }}}
 
-See the result on http://github.com/bschmalhofer/eclectus/tree/master.
+See the result on http://github.com/bschmalhofer/m4/tree/master.
 
 == Licensing ==
 
-As license I choose to stay with Artistic 2.0.
+Usually one would want to stick with Artistic License 2.0.
+Parrot m4 is different. It uses the GPL, as it is based on GPLed code.
 
 == Copyright ==
@@ -78 +91 @@
 == Removal from the SVN repository ==
 
-Remove the language from svn by doing 'ack-grep -ial eclectus' and remove the references to the language.
-The language directory can be deleted with 'svn del languages/eclectus'.
+For removing the language from SVN, I recommend to work on a svn-checkout of the repository.
+Remove the language from svn by doing 'ack-grep -ial m4' and remove the references to the language.
+Having an unique language name helps here.
+The language directory can be deleted with 'svn del languages/m4'.
 I left the occurences of 'eclectus' in 'ports/cygwin' intact, as I didn't want to break patch files.
-Also I edited the svn:ignore list: 'svn pe svn:ignore languages', as eclectus will be checked out into 'languages'.
+Also I edited the svn:ignore list: 'svn pe svn:ignore languages', as m4 will be checked out into 'languages'.
+Make sure that you have run 'perl tools/dev/mk_manifest_and_skip.pl' before submitting the changes.
 
 == Tell the world about it ==