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

Johannes Schindelin [off-list ref] writes:

quoted

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.