git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] git: update documentation for --git-dir

From
Junio C Hamano <gitster@pobox.com>
Date
Jan 23, 2020, 06:21 UTC
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.

Previous: Junio C HamanoNext: Junio C Hamano
Message 5 of 17 in “git: update documentation for --git-dir”
  1. git: update documentation for --git-dirHeba Waly via GitGitGadget, Jan 23, 2020
  2. Heba WalyJan 23, 2020
  3. Emily ShafferJan 23, 2020
  4. Junio C HamanoJan 23, 2020
  5. Junio C HamanoJan 23, 2020
  6. Junio C HamanoJan 23, 2020
  7. Heba WalyJan 27, 2020
  8. git: update documentation for --git-dirHeba Waly via GitGitGadget, Jan 27, 2020
  9. Johannes SixtJan 27, 2020
  10. Heba WalyJan 28, 2020
  11. Jeff KingJan 28, 2020
  12. Heba WalyJan 28, 2020
  13. git: update documentation for --git-dirHeba Waly via GitGitGadget, Jan 28, 2020
  14. Junio C HamanoJan 28, 2020
  15. Heba WalyJan 29, 2020
  16. git: update documentation for --git-dirHeba Waly via GitGitGadget, Jan 30, 2020
  17. Junio C HamanoJan 30, 2020

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.