Pl/FGAddon: Difference between revisions

The git-svn tool is useful for those who are already familiar with using git repositories, or those who wish to have their own private aircraft development playground. Git-svn provides a bridge between the remote FGAddon Subversion repository and a local git repository. For those unfamiliar with git, the git-svn bridge together with the git repository is far more complicated to use than the native [[#Subversion|Subversion tools]]. For more information on using git, see [[Howto:Start using git]]. The following will assume that only a single aircraft will be stored in the local git repository.

==== Set up ====

The git distributed version control system needs to first be [https://git-scm.com/downloads installed].

==== Cloning a single aircraft ====

The first step is to 'clone' a copy of one of the aircraft in the remote Subversion trunk:

For the relevant aircraft URL to use, you must chose one of the [[#Development_scenarios|development scenarios]] and find the URL in that section. The URL depends on your [[#Commit access|FGAddon commit access status]]. The clone command will create a local git repository containing solely the aircraft of interest, and initialise the git-svn bridge.

==== Information and history ====

At any point to see information about the local repository, type:

To see the history of the checked out copy of the repository, type:

==== Daily usage ====

The main git command you will be using is:

This will register the file or directory <code><path></code> within the local repository to allow it to later be 'committed' to the local git repository. To move or rename a file or directory, use:

However note that git history is not as robust as svn history. See the [[#Moving_or_renaming_files|git-svn file moving/renaming deficiency section]] for how to better perform this operation. To remove a file from the local repository, type: