54
edits
Changes
From Gramps
SSH isn't required; link to Git's download instructions; minor re-wording
{{man tip|The development source code of Gramps is stored in the Git repository at GitHub.|https://github.com/gramps-project/gramps/}}
The Gramps project uses the [https://en.wikipedia.org/wiki/Git Git program] version control system to help synchronize changes to source code from various developers, tracking changes, managing releases, etc. You are probably here because you want to do one of two things with Git; either:
* Download the latest maintenance source version or the development version, or else
* [[Brief_introduction_to_Git#Send_your_contribution_without_rights_to_push|Submit a Pull Request (PR)]] with the changes (if you don't have write access) or upload your changes (if you have write access to the repository).
== Install Git on your system ==
===Linux===
* Debian/Ubuntu: <code>sudo apt-get install git</code>
* '''Mac OS X (Intel)''': Download git from here https://git-scm.com/download/mac
* '''Mac OS X (PPC)''': Although the git download is called '<code>[https://sourceforge.net/projects/git-osx-installer/files/ git-2.xx.x-intel-universal-mavericks.dmg]</code>', implying that this is a universal binary, in fact only the installer is universal, the binary to be installed in actually intel only. On a PPC you will need to build git manually. Follow the instructions here: http://jnorthr.wordpress.com/2013/03/29/building-a-git-client-1-8-2-on-apple-imac-ppc-osx-10-5-8/. I think you will also need some additional tools like 'msgfmt'. I don't think this is installed by the Apple development tool Xcode, but fortunately I have it either via fink which I installed some time ago, or via MacPorts which I installed more recently.
: Mac OS X (PPC) Eclipse. If you are using Eclipse on a PPC, then there may be missing components for installing the latest version of EGit, depending on your version of Eclipse. If you have the Helios version of Eclipse, then you will not be able to install the latest EGit because you will get ''requires 'org.eclipse.team.core 3.6.100' but it could not be found''. Installing EGit version 2.0 from http://download.eclipse.org/egit/updates-2.0 should work if you uncheck the EGit Import Support feature when selecting what to install. You will obviously lose the Import Support feature. See [http://stackoverflow.com/questions/15281273/dependency-fail-installing-egit-on-eclipse-indigo here]. You will probably need to do ''git config core.filemode false'' to get round [https://bugs.eclipse.org/bugs/show_bug.cgi?id=307560 this bug] as suggested [http://stackoverflow.com/questions/1257592/how-do-i-remove-files-saying-old-mode-100755-new-mode-100644-from-unstaged-cha here].
git config --global core.autocrlf input # Linux/Mac
Git can invoke your favorite editor for commit messages, rebasing etc.
git config --global core.editor "'C:\Program Files (x86)\Notepad++\notepad++.exe' -multiInst -notabbar -nosession -noPlugin" # Windows
git config --global core.editor "vim" # Linux
The description below is for a single working folder at <code>~/Gramps</code>. If you are working on a plugin, the folder name should be <code>addons-source</code> at the <nowiki>https://github.com/gramps-project/addons-source.git</nowiki>
===Without a GitHub accountUsing HTTPS Protocol===To obtain a copy of the Gramps repository, type the following in the command line if you '''don(doesn't have require a GitHub account'''):
git clone <nowiki>https://github.com/gramps-project/gramps.git</nowiki> Gramps
You should see the downloading progress reported in your terminal.
===With a GitHub accountUsing SSH Protocol===If you have a GitHub account, use you can ssh insteadif you wish, or continue to use HTTPS protocol with your GitHub credentials or a Personal Access Token:
git clone <nowiki>[email protected]:gramps-project/gramps.git</nowiki> Gramps
