Items not covered by repository-layout.txt

Items not covered by repository-layout.txt

[Jakub Narebski]

I have noticed few files in .git/ directory which currently are not covered
(and neither is their format) by Documentation/repository-layout.txt

* COMMIT_EDITMSG (temporary file, when I decided during writing commit
  message that I should change something before commit)
* FETCH_HEAD (format?)
* HEAD, ORIG_HEAD and probably some other *_HEAD
* .tmp-vtag (I'm not sure what have left that, probably git-verify-tag
  broken due to lack of signing PGP keys)
* description file

I know they are fairly obvious, but having everything that one could fing in
his/her git-core managed .git repository would be nice... 
-- 
Jakub Narebski
Warsaw, Poland
ShadeHawk on #git

Re: Items not covered by repository-layout.txt

[Junio C Hamano]

Jakub Narebski <jnareb@gmail.com> writes:

> I have noticed few files in .git/ directory which currently are not covered
> (and neither is their format) by Documentation/repository-layout.txt
>
> * COMMIT_EDITMSG (temporary file, when I decided during writing commit
>   message that I should change something before commit)
> * FETCH_HEAD (format?)
> * HEAD, ORIG_HEAD and probably some other *_HEAD
> * .tmp-vtag (I'm not sure what have left that, probably git-verify-tag
>   broken due to lack of signing PGP keys)
> * description file
>
> I know they are fairly obvious, but having everything that one could fing in
> his/her git-core managed .git repository would be nice... 

Yup, please make it so.

Re: Items not covered by repository-layout.txt

[Jakub Narebski]

Junio C Hamano wrote:

> Jakub Narebski <jnareb@gmail.com> writes:
> 
>> I have noticed few files in .git/ directory which currently are not covered
>> (and neither is their format) by Documentation/repository-layout.txt
>>
>> * COMMIT_EDITMSG (temporary file, when I decided during writing commit
>>   message that I should change something before commit)
>> * FETCH_HEAD (format?)
>> * HEAD, ORIG_HEAD and probably some other *_HEAD
>> * .tmp-vtag (I'm not sure what have left that, probably git-verify-tag
>>   broken due to lack of signing PGP keys)
>> * description file
>>
>> I know they are fairly obvious, but having everything that one could fing in
>> his/her git-core managed .git repository would be nice... 

I have just noticed that _config_ file (!)is not covered by repository-layout.txt
 
> Yup, please make it so.

Could you then tell me what is the format of FETCH_HEAD and what other *_HEADs 
can be seen in $GIT_DIR (MERGE_HEAD?)?

-- 
Jakub Narebski
Warsaw, Poland
ShadeHawk on #git

Re: Items not covered by repository-layout.txt

[Junio C Hamano]

Jakub Narebski <jnareb@gmail.com> writes:

> Could you then tell me what is the format of FETCH_HEAD and what other *_HEADs 
> can be seen in $GIT_DIR (MERGE_HEAD?)?

Which essentially is that you are telling me to do that, but I
am a bit busy this week.

If you can use the source to figure them out, that would be
great; otherwise this can wait or others can chime in.

For FETCH_HEAD fmt-merge-msg and git-pull would be helpful.
The general format is, one entry per line:

	object name <TAB> merge-marker <TAB> notes

where merge-marker is either empty (for commits to be merged by
git-pull that called git-fetch) or not-for-merge, and notes is a
human readable comment that describes where that object came
from.  Note that this is read both by humans _AND_ machine;
fmt-merge-msg relies on how it is stated.

Others "git grep -e _HEAD -- '*.sh'" perhaps.

	ORIG_HEAD - used to keep the value of HEAD before we do
                    anything we might regret

	MERGE_HEAD - one or more commit object names that are
                    being merged into the current branch during
                    a merge.

	MERGE_MSG - generated message for an automerge.