Re: What's a "work tree"?

> On Thu, Jan 24, 2008 at 02:09:33PM -0500, Mike wrote:
> 
>> I'm trying to figure out what a "work tree" is.  as in --work-tree. This 
>> is a new command right, the tutorials I've read don't have it. The man 
>> page has the syntax but I don't know what it's for.
> 
> The work tree is the place where your checked out files reside. E.g.,
> in an ordinary repo (made with "git init" or "git clone") everything
> that isn't in the .git directory.
> 
>> $ cd /www/mysitedocroot
>> $ git --git-dir /gitdir/mysitegit/ add .
>> fatal: add must be run in a work tree
> 
> You are using --git-dir to point to a repository directory that isn't
> ".git". That's OK, and it will generally assume that your current
> directory is the work tree. E.g., this works:
> 
>   mkdir repo && cd repo
>   git init
>   mv .git mygitdir
>   touch file
>   git --git-dir=mygitdir add file
> 
> However, there is a config option "core.bare" which indicates that a
> repository is "bare", meaning that it has no work tree (and that is
> presumably what's happening in your example). So you could use
> --work-tree=. to override that in your example (though you might just be
> better off setting config.bare to false).
> 
> The more probable use case for --work-tree is something like
> 
>   $ cd /gitdir/mysitegit
>   $ git --work-tree=/www/mysitedocroot add .
> 
> i.e., you are in the git dir, so you specify the work tree rather than
> the other way around. You could even do this:
> 
>   $ cd /some/other/directory
>   $ git --git-dir=/gitdir/mysitegit --work-tree=/www/mysitedocroot add .
> 
> although I'm not sure it's that useful.
> 
> -Peff