Difference between revisions of "Repository"

From collectd Wiki
Jump to: navigation, search
(Created initial page based on an email to the mailing list.)
 
(Document the repository related templates.)
Line 49: Line 49:
  
 
With the release of [[version 4.8]] the “collectd-4.7” branch became the new “bugfix1” branch and the “collectd-4.6” branch is now obsolete. ''Release 4.6.5'' was created so that the “collectd-4.6” version does not fall into oblivion with unreleased bugfixes still in the appropriate branch.
 
With the release of [[version 4.8]] the “collectd-4.7” branch became the new “bugfix1” branch and the “collectd-4.6” branch is now obsolete. ''Release 4.6.5'' was created so that the “collectd-4.6” version does not fall into oblivion with unreleased bugfixes still in the appropriate branch.
 +
 +
== Wiki templates ==
 +
 +
There are a couple of templates that make it easy to point to stuff in the repository.
 +
 +
* [[Template:GitFile|GitFile]]<br />Adds a link to a file in the repository. For example, <code><nowiki>{{GitFile|README}}</nowiki></code> yields: {{GitFile|README}}
 +
* [[Template:GitBranch|GitBranch]]<br />Adds a link to a Git branch. For example, <code><nowiki>{{GitBranch|master}}</nowiki></code> yields: {{GitBranch|master}}
  
 
[[Category:Development]]
 
[[Category:Development]]

Revision as of 12:24, 25 September 2009

The source code of collectd is organized in a Git repository.

Location

The official repository is available from:

git://git.verplant.org/collectd.org

To clone the repository use:

$ git clone git://git.verplant.org/collectd.org

Github mirror

If you're more comfortable using Github you can use the mirror available there. Its web address is:

http://github.com/octo/collectd

The public clone URL is:

git://github.com/octo/collectd.git

Organization

We maintain three branches: One development branch (named “master”) and two bugfix branches. The first bugfix branch corresponds to the latest release, the second bugfix branch corresponds to the second latest release. Those are the versions we provide bugfixes for. At the time of this writing, those versions were “collectd-4.8” and “collectd-4.7”.

 ◆ ◄──────── master   ⎫
 │╲                   ⎪
 │ ╲                  ⎪
 │  ◆ ◄───── bugfix0  ⎬  branch heads
 │  │╲                ⎪
 │  │ ╲               ⎪
 │  │  ◆ ◄── bugfix1  ⎭
 │  │  │
 │  │  │
 ◇◅─│──│──── bug not released yet / new feature
 │  │  │     (available in “master” only)
 │  │  │
 │  ◇◅─│──── fix for bug introduced in the newest version
 │  │  │     (available in “bugfix0” and “master”)
 │  │  │
 │  │  ◇◅─── fix for bug introduced in an earlier version
 │  │  │     (available in “bugfix1”, “bugfix0” and “master”)
 │  │  │
Error creating thumbnail: /bin/bash: /usr/bin/convert: No such file or directory

Error code: 127
Screenshot of gitk in which the three branches are visible nicely. Also note the now defunct “collectd-4.6” branch near the bottom.

Bugfixes are applied to the earliest branch possible. If a bug existed for a while, this is probably the “bugfix1” branch. If the bug was introduced in the latest release (i. e. “collectd-4.8” currently), then the fix is applied to “bugfix0”. If the commit fixes a bug that has not yet been released or adds a new feature, it is committed to the “master” branch. From time to time, the “bugfix1” branch is merged into the “bugfix0” and the “bugfix0” branch is merged into “master”, so that bugfixes are included in all appropriate branches.

With the release of version 4.8 the “collectd-4.7” branch became the new “bugfix1” branch and the “collectd-4.6” branch is now obsolete. Release 4.6.5 was created so that the “collectd-4.6” version does not fall into oblivion with unreleased bugfixes still in the appropriate branch.

Wiki templates

There are a couple of templates that make it easy to point to stuff in the repository.