Merge branch 'nd/index-format-doc'
authorJunio C Hamano <gitster@pobox.com>
Fri, 21 Dec 2012 23:18:31 +0000 (15:18 -0800)
committerJunio C Hamano <gitster@pobox.com>
Fri, 21 Dec 2012 23:18:32 +0000 (15:18 -0800)
* nd/index-format-doc:
index-format.txt: clarify what is "invalid"

1  2 
Documentation/technical/index-format.txt
index 57d6f915b143765b9e58b3793f14795ddab71200,ce28a7a6c3cf7ae7429b8317fbf3fdd3cf081817..73241548381fcb0b3c0dbd2cb09f9526a64e637d
@@@ -1,7 -1,7 +1,7 @@@
  GIT index format
  ================
  
 -= The git index file has the following format
 +== The git index file has the following format
  
    All binary numbers are in network byte order. Version 2 is described
    here unless stated otherwise.
      this span of index as a tree.
  
    An entry can be in an invalidated state and is represented by having
-   -1 in the entry_count field. In this case, there is no object name
-   and the next entry starts immediately after the newline.
+   a negative number in the entry_count field. In this case, there is no
+   object name and the next entry starts immediately after the newline.
+   When writing an invalid entry, -1 should always be used as entry_count.
  
    The entries are written out in the top-down, depth-first order.  The
    first entry represents the root level of the repository, followed by the