Description Thomas Hallgren 2011-08-07 06:59:48 EDT

Here is some additional information (originally from bug 324441) that should be added to the documentation for the git reader type:

1. Checking out a tag will normally create a detached head. Buckminster will
therefore automatically create a branch with the name 'tag-branch_' + tagName
when this happens.

2. Checking out remote branches is considered very bad practice (it also
results in a detached head). Buckminster will therefore create a local branch
with the same name as the remote and track the remote branch. This is
essentially the same as git checkout --track -b <branch> origin/<branch>

3. branches like remotes/origin/<branchName> or origin/<branchName> will
automatically be stripped down to just <branchName> to avoid checkouts of the
remote branch. In essence, such name should not be used, but if they are,
Buckminster "fixes" that.