Basic steps are as follows…
-
Get git command line client or the GitHub application for Win/Mac.
-
Find the repo you want to patch up:
https://github.com/libgdx/libgdx
-
Click the “Fork” button in the top right. This will create a libgdx repo under your name.
-
Click “Clone in Desktop” (if you’re using the GUI app) or use the following command:
cd /path/to/projects
git clone https://github.com/libgdx/libgdx.git
Note the first line simply cd’s to the directory where you want to store all your github repos. I keep mine in [icode]/projects[/icode] for quick typing.
- Now you need to run the following to get LibGDX repo up and running:
cd libgdx
ant -f fetch.xml
The first line cd’s into the libgdx repo you just cloned. The second pulls all the JARs and binaries.
-
Run Eclipse and choose File -> Import -> Existing Project into Workspace and open the libgdx folder. You will see a bunch of projects, you can select them all. I’d strongly encourage using Eclipse’s Working Sets (or a different workspace) to avoid cluttering with your own projects.
-
Make some changes and push them back to master with:
git add -A .
git commit -m "your commit message"
git push
(This is done in the libgdx directory you cloned earlier)
- Open your GitHub forked repo:
https://github.com/YOUR-USERNAME/libgdx
And choose “Compare” (above “latest commit” line). From there you can click “Create a pull request”
Seems complicated but once you get the hang of it you’ll find yourself patching up a lot of open source projects. 