From: Junio C Hamano Date: Thu, 02 Aug 2007 07:04:52 GMT Subject: Re: [PATCH 4/4] Clean up work-tree handling Message-ID: <7vsl72zaaz.fsf@assigned-by-dhcp.cox.net> In-Reply-To: Johannes Schindelin writes: >> I do not think the following is exactly what your cleaned-up >> version tries to perform, but I am writing this down primarily >> to demonstrate the style and the level of detail I expect to >> accompany a clean-up patch like this. > > After reading your description I sink into the ground in shame. I really > like the style this has, and agree that something as nice as this should > have been there. Not too late. There always is a room for Documentation/ improvements ;-) Seriously, I think config.txt mentions GIT_WORK_TREE and GIT_DIR and git.txt has separate sections for environment and config, but I do not see a good section that gives a comprehensive view of how they work together to affect your git experience. Perhaps between File/Directory Structure and Terminology sections we would want to have a description of how repository and worktree relate to each other.