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
Windows go to http://code.google.com/p/msysgit/downloads/list and install it.
Ubuntu / debian: sudo apt-get install git-core
1. Cloning the fpdb git tree
Just create a new directory (lets say ~/fpdb/ ), go into it and type:
git clone moc.buhtig|tig#moc.buhtig|tig:ChazDazzle/fpdb-chaz.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-addinteractive
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-addinteractive.
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
Prep work (once only)
git remote add phil moc.buhtig|tig#moc.buhtig|tig:philroberts/FPDB-for-OSX.git
git fetch phil qt-fork
git pull phil qt-fork
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