Steps to create a patch

How to create a patch for Rakudo via git if you aren’t a committer

1) make your own fork on github.com

• go to github.com
• create a new account for yourself
  – follow their instructions to add your SSH key
• go to http://github.com/rakudo/rakudo/
• click “fork”
• at your command line, make a checkout:
  git clone git@github.com:[username]/rakudo.git
  and replace “[username]” with your github.com user name
• git remote add upstream git://github.com/rakudo/rakudo.git

2) make a brach of your fork

• git branch [branch-name]
• git checkout [branch-name]

3) do work and commit

• hack, hack, hack
• git status
• git diff
• git add [name-of-file(s) you changed]
• git commit

4) run git rebase -i and squash into one commit

5) push the new branch to github.com

• git push origin [branch-name]:[remote-branch-name]
  where you probably want the remote branch name to be the same
  as the local branch name
• after that, you can just “git push” subsequent commits
• On http://github.com/[username]/rakudo find “all branches” and select your branch name to see what you pushed up

6) Go to your branch that you pushed up and click “pull request” at the top and choose rakudo

7) At least until the rakudo team gets everything working together, patches also need to be submitted to RT.

• git format-patch -M b3a2ea5df54d0b6ec978b63892be8bfdbf749fd5
  • This creates a file like 0001-spectest-progress.csv-update-374-files-10467-passi.patch
• git send-email —from=japh@example.com —to=rakudobug@perl.org *.patch