Skip to content

Latest commit

 

History

History
40 lines (27 loc) · 1.63 KB

CONTRIBUTING.md

File metadata and controls

40 lines (27 loc) · 1.63 KB

Git configuration for fetching rbenv upstream

In order to continually pull changes from rbenv into nodenv, it is necessary to add rbenv as a git remote. However, this adds some complication because (by default), git tags for nodenv and rbenv will collide. (ie, rbenv's v1.0.0 tag conflicts with nodenv's v1.0.0) Additionally, having rbenv's tags exist locally introduces complications to the release process: git push --follow-tags would push rbenv's tags to nodenv's origin remote.

The following special git configuration avoids these and other headaches while still allowing origin to be pushed using --tags or --follow-tags options—without the risk of pushing rbenv's tags into nodenv's tagspace. The configuration assumes nodenv's remote is origin, and rbenv's remote is rbenv.

  1. Configure rbenv to not fetch tags by default:

     git config remote.rbenv.tagOpt --no-tags

    Beware: the --tags option to fetch et. al. will override this setting.

  2. Fetch rbenv's tags to their own refspec namespace (rbenv-tags, in this case):

     git config --add remote.rbenv.fetch '+refs/tags/*:refs/rbenv-tags/*'

Resulting snippet in .git/config:

[remote "origin"]
	url = [email protected]:nodenv/nodenv.git
	fetch = +refs/heads/*:refs/remotes/origin/*
[remote "rbenv"]
	url = [email protected]:rbenv/rbenv.git
	fetch = +refs/heads/*:refs/remotes/rbenv/*
	fetch = +refs/tags/*:refs/rbenv-tags/*
	tagopt = --no-tags

To reference rbenv's tags, use the fully qualified refspec: refs/rbenv-tags/vX.Y.Z

git show refs/rbenv-tags/v1.1.2
git checkout refs/rbenv-tags/v1.1.2
git merge refs/rbenv-tags/v1.1.2