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

Re: [PATCH 2/2] worktree: provide better prefix to go back to original cwd

From
Junio C Hamano <gitster@pobox.com>
Date
Oct 7, 2010, 05:54 UTC
Message-ID
<7veic2y2c5.fsf@alter.siamese.dyndns.org>
In-Reply-To
<4cad50da.0e958e0a.40e3.5efd@mx.google.com>
pclouds@gmail.com writes:
Show 6 quoted lines
> From: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
>
> When both GIT_DIR and GIT_WORK_TREE are set, if cwd is outside
> worktree, prefix (the one passed to every builtin commands) will be
> set to NULL, which means "user stays at worktree topdir", but cwd is
> not moved to worktree topdir.

Well, NULL traditionally meant "_if_ the cwd is inside the working tree, it is at the top", not "stays at worktree topdir" if you started from elsewhere.

And when cwd is inside the working tree, we do want to feed paths given from the command line after adding the prefix, so that we will see the paths relative to the cwd after we do cd-to-topdir.

Obviously when you run git command that requires you to be in a working tree from outside the working tree, relative or full paths would not make any difference. The command should simply fail.

I suspect that you are introducing a new semantics on top of that traditional semantics; if so, you may want to state it more clearly.

For example:
    When you run git command that requires you to be in a working tree
    from outside the working tree, the command should simply fail.
    When GIT_WORK_TREE is in use, however, it could be argued that we do
    not necessarily have to be in anywhere in the working tree to perform
    a whole-tree operation.  Instead, we could just say the operation
    always runs as if the command was started at the root level of the
    working tree.
    To support this new mode of operation, however, prefix needs to be
    adjusted to allow the program, after running chdir(2) to the root of
    the working tree, to refer to non-absolute paths originally given from
    the command line as relative to the original cwd.  This patch adds a
    mechanism to support that.

I have a queasy feeling about the idea of the second paragraph above, though.

If the original cwd is inside GIT_WORK_TREE, limiting ourselves inside prefix naturally limits the operation to the subdirectory we started from (if the original cwd is at GIT_WORK_TREE, that would make it a whole-tree operation). A natural extension of this idea to limit the operation to the part of the subtree of the working tree we started from is to refuse to work in the case where the original cwd is outside GIT_WORK_TREE (the current implementation of GIT_WORK_TREE may or may not correctly implement it, though---I never use it myself).

Futzing with the prefix that is not a prefix to reach into the working tree from sideways may make the relative paths given from the command line mean something to the current implementation, but it doesn't change the fundamental fact that you are introducing a funny special case where your cwd does _not_ mean anything with respect to which part of the working tree should be affected.

> Some commands may want "path in repository" and "path in file system"
> to be identical. Moreover, output from commands in such situations are
> relative to worktree topdir (because prefix is NULL), not what users
> expect. It's just confusing.

My gut feeling is that this is probably made more confusing, not less, with the change. Perhaps we should instead make sure this fails?

    $ cd /srv/git/git.git
    $ export GIT_DIR=$(pwd)/.git GIT_WORK_TREE=$(pwd)
    $ cd /var/tmp ;# no git stuff there
    $ git status
Previous: Nguyen Thai Ngoc DuyNext: Nguyen Thai Ngoc Duy
Message 28 of 98 in “Close a forgotten reference to the HEAD ref.”
  1. 1/2 Close a forgotten reference to the HEAD ref.Robin Rosenberg, Dec 2, 2008
  2. 2/2 Improve closing of files in error situations.Robin Rosenberg, Dec 2, 2008
  3. 2/2 Improve closing of files in error situations.Robin Rosenberg, Dec 2, 2008
  4. 0/3 Ref log readerRobin Rosenberg, Jun 7, 2009
  5. 1/3 Assert the name and origName properties of Ref objectsRobin Rosenberg, Jun 7, 2009
  6. 2/3 Add methods to RawParseUtils for scanning backwards.Robin Rosenberg, Jun 7, 2009
  7. 3/3 Add a ref log reader classRobin Rosenberg, Jun 7, 2009
  8. Shawn O. PearceJun 7, 2009
  9. Robin RosenbergJun 7, 2009
  10. Shawn O. PearceJun 7, 2009
  11. 1/2 Add methods to RawParseUtils for scanning backwards.Robin Rosenberg, Jun 8, 2009
  12. 2/2 Add a ref log reader classRobin Rosenberg, Jun 8, 2009
  13. Shawn O. PearceJun 12, 2009
  14. 1/2 Use a UTC relative time zone for PersonIdentRobin Rosenberg, Jun 15, 2009
  15. 2/2 Add a ref log reader classRobin Rosenberg, Jun 15, 2009
  16. Robin RosenbergJun 15, 2009
  17. [BUG] apply: test for trailing whitespace & no new line bugy@vger.kernel.org, Jun 22, 2009
  18. [BUG] apply: test for trailing whitespace & no new line bugy@vger.kernel.org, Jun 22, 2009
  19. diff.c: fix a graph output bugstruggleyb.nku@gmail.com, Jul 8, 2010
  20. Junio C HamanoJul 9, 2010
  21. Junio C HamanoJul 9, 2010
  22. Nazri RamliyJul 9, 2010
  23. Junio C HamanoJul 9, 2010
  24. Bo YangJul 11, 2010
  25. 1/2 setup.c: add enter_work_tree()pclouds@gmail.com, Oct 7, 2010
  26. 2/2 worktree: provide better prefix to go back to original cwdpclouds@gmail.com, Oct 7, 2010
  27. Nguyen Thai Ngoc DuyOct 7, 2010
  28. Junio C HamanoOct 7, 2010
  29. Nguyen Thai Ngoc DuyOct 7, 2010
  30. Junio C HamanoOct 7, 2010
  31. Nguyen Thai Ngoc DuyOct 7, 2010
  32. Corrected cmitmode set in the right lower window when initiating a diff.Michał Pomorski, Nov 23, 2010
  33. git-p4: replace each tab with 8 spaces for consistencyAndrew Garber, Apr 7, 2011
  34. Junio C HamanoApr 7, 2011
  35. Phil HordApr 7, 2011
  36. Junio C HamanoApr 7, 2011
  37. git-p4: replace each tab with 8 spaces for consistencyAndrew Garber, Apr 7, 2011
  38. file import functionality for git-remote-mwPavel Volek, Jun 4, 2012
  39. Matthieu MoyJun 4, 2012
  40. Export file attachements in git-remote-mediawikiNGUYEN Kim Thuat, Jun 4, 2012
  41. Matthieu MoyJun 4, 2012
  42. nguyenkiJun 5, 2012
  43. Matthieu MoyJun 5, 2012
  44. nguyenkiJun 6, 2012
  45. nguyenkiJun 5, 2012
  46. [PATCHv1] Export file in git-remote-mediawikiKim Thuat NGUYEN, Jun 8, 2012
  47. Matthieu MoyJun 8, 2012
  48. nguyenkiJun 8, 2012
  49. Matthieu MoyJun 10, 2012
  50. [PATCHv2] git-remote-mediawiki: export File: attachmentsKim Thuat NGUYEN, Jun 12, 2012
  51. Matthieu MoyJun 12, 2012
  52. nguyenkiJun 12, 2012
  53. Max HornJun 12, 2012
  54. [PATCHv3] git-remote-mediawiki: export File: attachmentskim-thuat.nguyen@ensimag.imag.fr, Jun 13, 2012
  55. Matthieu MoyJun 13, 2012
  56. git send-email should not allow 'y' for in-reply-toEric Blake, Jan 11, 2013
  57. Jeff KingJan 11, 2013
  58. Eric BlakeJan 11, 2013
  59. Hilco WijbengaJan 11, 2013
  60. Jeff KingJan 11, 2013
  61. Junio C HamanoFeb 24, 2013
  62. v3 [PATCH 1/2] status: introduce status.short to enable --short by defaulty@ensimag.imag.fr, Jun 10, 2013
  63. v3 [PATCH 1/2] status: introduce status.short to enable --short by defaulty@ensimag.imag.fr, Jun 10, 2013
  64. v3 [PATCH 2/2] status:introduce status.branch to enable --branch by defaulty@ensimag.imag.fr, Jun 10, 2013
  65. v3 [PATCH 2/2] status:introduce status.branch to enable --branch by defaulty@ensimag.imag.fr, Jun 10, 2013
  66. Matthieu MoyJun 10, 2013
  67. Junio C HamanoJun 10, 2013
  68. 3/3 builtin/blame.c: reduce scope of variablesElia Pinto, Jan 29, 2014
  69. use strchrnul() in place of strchr() and strlen()Rohit Mani, Mar 5, 2014
  70. Junio C HamanoMar 6, 2014
  71. [GSoC][PATCH v2] use strchrnul() in place of strchr() and strlen()Rohit Mani, Mar 8, 2014
  72. Junio C HamanoMar 10, 2014
  73. [GSOC2014]TamerTas, Mar 10, 2014
  74. [GSOC2014] changed logical chain in branch.c to lookup tablesTamerTas, Mar 10, 2014
  75. Stefan BellerMar 10, 2014
  76. Eric SunshineMar 10, 2014
  77. Tamer TASMar 10, 2014
  78. Eric SunshineMar 10, 2014
  79. Tamer TASMar 11, 2014
  80. Eric SunshineMar 11, 2014
  81. [GSOC2014] add: Rewrite run_add_interactive to use struct argv_arrayMovchan Pavel, Mar 18, 2014
  82. Junio C HamanoMar 18, 2014
  83. Use "working tree" instead of "working directory" for git statusLars Vogel, Jun 9, 2016
  84. Eric SunshineJun 9, 2016
  85. Lars VogelJun 9, 2016
  86. 1/1 git-stash.txt: correct "git stash" behavior with no argumentsTakahito Ogawa, Oct 11, 2017
  87. Junio C HamanoOct 12, 2017
  88. 小川恭史Oct 12, 2017
  89. 小川恭史Oct 12, 2017
  90. Junio C HamanoOct 12, 2017
  91. Allow usage of --gpg-sign flag in commit-tree builtin.Brandon Richardson, Jan 17, 2019
  92. Martin ÅgrenJan 17, 2019
  93. commit-tree: add missing --gpg-sign flagBrandon Richardson, Jan 18, 2019
  94. Martin ÅgrenJan 18, 2019
  95. Brandon RichardsonJan 18, 2019
  96. Junio C HamanoJan 18, 2019
  97. [L10N] Kickoff for Git 2.22.0 round #1Jiang Xin, May 14, 2019
  98. [L10N] Kickoff for Git 2.49.0Jiang Xin, Feb 27, 2025

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.