From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 17 May 2012 16:38:08 GMT
Subject: Re: git rev-parse --git-dir does report yield relative path to git directory, per documentation
Message-ID: <xmqqfwayrcen.fsf@junio.mtv.corp.google.com>
In-Reply-To: <CAH3Anrrb243zdRJJEqDcWrHBVBDdYkGB=sTG7BbjTzsUHvWY-w@mail.gmail.com>

Jon Seymour <jon.seymour@gmail.com> writes:

> Per this advice in git-rev-parse(1):
>
>      Show $GIT_DIR if defined. Otherwise show the path to the .git
> directory, relative to the current directory.
> ...

Unfortunate.  Here is what the commit that wrote the sentence says:

    commit 80d868b068b9e68a4aac91be578a8f097f45d8da
    Author: Jonathan Nieder <jrnieder@gmail.com>
    Date:   Fri Nov 26 22:32:31 2010 +0700

        git-rev-parse.txt: clarify --git-dir

        The current behavior is often to print an absolute path rather than
        a ../../etc string, but callers must be ready to accept a relative
        path, too. The most common output is ".git" (from the toplevel of
        an ordinary work tree).

        Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
        Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
        Signed-off-by: Junio C Hamano <gitster@pobox.com>

I am not sure what we were smoking.  I am guessing that it wanted to say
that the path is something you can feed to chdir(2) to go there, but it
should have done so without promising more than what it does.