Re: [PATCH 4/4] Clean up work-tree handling

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 2, 2007, 07:04 UTC
Message-ID: <7vsl72zaaz.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <Pine.LNX.4.64.0708011239090.14781@racer.site>

Johannes Schindelin <Johannes.Schindelin@gmx.de> writes:

Show 8 quoted lines

>> 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.