Git Instructions

Hi, welcome to my minimal git guide for fpdb devs!
You can use a git version just as user as well of course, but as there are generally hardly tested it is not advised.
I'll expand this on request, if you have any questions just send me a mail at steffen(at)sycamoretest.info. There's also a bunch of instructions at http://www.assembla.com/spaces/fpdb/trac_git_tool

0. Getting it

To get git for gentoo just do emerge git -av
To get it for Windows go to http://code.google.com/p/msysgit/downloads/list and install it.

1. Cloning the fpdb git tree

Just create a new directory (lets say ~/fpdb/ ), go into it and type:
git clone git://git.assembla.com/fpdb.git

2. Making your changes

You can use whatever you want to do edit the files. I personally use nedit and occassionally Eclipse.

3. Making a (local) commit

Unlike in svn you don't need to be online to make your commits. First we need to tell git what to commit, so go to the root of your fpdb directory and type:
git-add--interactive
Now press u and enter. It will display a list of all changed files. If you want to commit all files just press * and enter twice to return to the main menu. If you want to commit only certain ones press the number of the file and enter and repeat until you have all the files. Then press enter again to return to the main menu.
If you added any new files press a and Enter, then type the number of your new file and press Enter twice. Press q to leave git-add--interactive.
Now create a file for your commit message (I call it since_last_commit.txt) but don't add this to the repository. In the first line of this file put a summary of your changes. Then give some details of your changes, try to mention anything non-trivial and definitely any user-visible bug fixes.
Then run this:
git-commit -F since_last_commit.txt

4a. Pushing the changes to your own public git tree

Do this OR 4b, not both.
todo

4b. Preparing changeset for emailing/uploading

Do this OR 4a, not both.
todo

5. Pulling updates from the main tree

todo

License

Trademarks of third parties have been used under Fair Use or similar laws.

Copyright 2008 Steffen Jobbagy-Felso
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.2 as published by the Free Software Foundation; with
no Invariant Sections, no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license can be found in fdl-1.2.txt

The program itself is licensed under AGPLv3, see agpl-3.0.txt