-
Notifications
You must be signed in to change notification settings - Fork 48
Home
The first step to set up MRROC++ source code for work with Git is to download a Git software.
- If you are using recent Linux distribution, just ask your package manager to do this job.
- For Windows there are some GUI based Gits out there, but this tutorial will only explain howto work with command line tools. Probably the right one is the msysGit (you have to download a
Git-x.x.x.x-*.exefile) - If you are brave enough to use Git under your Eclipse editor, please check this tutorial.
In order introduce yourself to Git as well as to other developers just do:
$ git config --global user.name "Tekkub"
$ git config --global user.email "[email protected]"
As long as GitHub is the best code hosting service in the world we will use it.
- Just try to login and follow instructions to get a free Open Source plan account.
- Next you have to setup a SSH keys to authenticate against GitHub service. Simply follow these steps.
Just visit the “mainstream” MRROC++ project and press a fork button to create your own development branch. Now it is time to actually pull down a code. Follow steps “Forking a project” and “Setting up” screenshots from here. Just to compare:
|. SVN |. Git |
| svn checkout | git clone |
| svn up | git pull |
h2. Start your work!
Hack, hack, hack… In the meantime you should read any Git tutorial, which will get you familiar with commit, add, status commands (which are the basic one) and a lots of more (which you learn later).
GitHub is willing to help you with a list of tutorials, screencasts and an every day commands list.
Finally open the same page as previously and this time read the “Pushing your changes” section. Please fell the difference:
|. SVN |. Git |
| svn commit | git commit -a (this one works locally) |
| svn commit | git push (and this one actually pushes a bunch of commits to GitHub) |
h2. When you wish to share your work
Now, as your really big improvement is completed, please share it with the rest of community. It is as easy as 1-2-3 (which I mean a three first steps from this page). All the remaining work will be done by a main project developer after making sure, that your code is good enaught to fill the high standards of robotic software framework.