From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 23 Jan 2020 06:21:01 GMT
Subject: Re: [PATCH] git: update documentation for --git-dir
Message-ID: <xmqq7e1i66cy.fsf@gitster-ct.c.googlers.com>
In-Reply-To: <pull.537.git.1579745811615.gitgitgadget@gmail.com>

"Heba Waly via GitGitGadget" <gitgitgadget@gmail.com> writes:

> For example, if the user runs `git --git-dir=<path> status`, git
> will not be able to figure out the work tree path on its own 

It is not "not be able to figure out".  Specifying GIT_DIR (either
with environment or the --git-dir option) tells Git that the $cwd is
the top of the working tree unless otherwise specified (e.g. with
GIT_WORK_TREE environment).  If you have to say something, saying
"When GIT_DIR is specified, the usual repository discovery is
skipped and the current directory is taken as the top level of the
working tree unless otherwise speciffied" is probably OK.