mirror of
https://github.com/codex-storage/deluge.git
synced 2025-01-09 11:12:06 +00:00
89 lines
3.1 KiB
Plaintext
89 lines
3.1 KiB
Plaintext
= Git Source Code Repository =
|
|
|
|
Deluge's source code is always available through our [http://git.deluge-torrent.org/deluge Git repository].
|
|
|
|
To get a copy of the code, you will need to clone it from the repository then see the [wiki:'Installing/Source' Installation Guide].
|
|
|
|
For more in-depth git usage see GitTips.
|
|
|
|
This guide uses commands which are meant to be typed at a command prompt, but most will be available from a GUI Git client.
|
|
|
|
[http://git-scm.com/downloads Install Git]
|
|
|
|
|
|
|
|
== Deluge Branches ==
|
|
There are multiple branches or tags that you can choose from which contain different stages of the Deluge code.
|
|
|
|
Note that we are currently transitioning to a different [http://nvie.com/posts/a-successful-git-branching-model/ git workflow] with the development of ''1.4'' so picking the correct branch is crucial.
|
|
|
|
The current branches (at time of writing) are:
|
|
|
|
'''`1.3-stable`'''::
|
|
This is the release branch for the 1.3-series and, until 1.4 release, is the recommended stable code. This branch is only for critical bug fixes and no new feature will appear in this branch.
|
|
'''`master`'''::
|
|
'''''This branch is in limbo until 1.4 release''''' This branch contains development code that is now continued in `develop`. When the `develop` code is considered stable, 1.4 will be released and the code will be merged back into `master` code. This mean going forward from 1.4 release this branch will be considered to be the most stable code, replacing the use of *-stable branches.
|
|
'''`develop`'''::
|
|
All development work will be put into this branch and should be considered unstable with risk of data loss and potential incompatibility with other Deluge versions.
|
|
'''`extjs4-port`'''::
|
|
A branch for porting the WebUI code from `Ext JS 3.4` to `Ext JS 4`, still requiring a lot of development work.
|
|
|
|
== Initial Clone ==
|
|
|
|
The first step is to clone our git repos:
|
|
|
|
{{{
|
|
git clone git://deluge-torrent.org/deluge.git
|
|
}}}
|
|
|
|
This will create a ''deluge'' directory with a copy of the repo so if you change into this directory you can start using git commands.
|
|
|
|
|
|
== Select Branch ==
|
|
|
|
List the branches, including remote branches:
|
|
|
|
{{{
|
|
git branch -a
|
|
}}}
|
|
|
|
== Switch Branch ==
|
|
|
|
If you want to use a different branch than the default selected (`master`) then you will need to create a local copy of the remote branch. In this example we create branch '1.3-stable' as a local copy of the remote branch 'origin/1.3-stable' and switch to it:
|
|
|
|
{{{
|
|
git checkout -b 1.3-stable origin/1.3-stable
|
|
}}}
|
|
|
|
To switch between your local branches use the following commands:
|
|
|
|
'''Development:'''
|
|
{{{
|
|
git checkout develop
|
|
}}}
|
|
|
|
'''Stable:'''
|
|
{{{
|
|
git checkout 1.3-stable
|
|
}}}
|
|
|
|
== Show current Branch ==
|
|
Either of these commands will show the current branch you are using:
|
|
|
|
{{{
|
|
git branch
|
|
git status
|
|
}}}
|
|
|
|
|
|
== Updating ==
|
|
|
|
You only need to do a clone once, after that you can simply update the branch by ''pulling'' changes from the repo.
|
|
|
|
Assuming you are in the folder you cloned to:
|
|
{{{
|
|
git pull
|
|
}}}
|
|
|
|
Now your tree is synchronized to the latest revision in our repository!
|