index-format.txt: clarify what is "invalid"
authorNguyễn Thái Ngọc Duy <pclouds@gmail.com>
Thu, 13 Dec 2012 01:14:47 +0000 (08:14 +0700)
committerJunio C Hamano <gitster@pobox.com>
Thu, 13 Dec 2012 18:12:25 +0000 (10:12 -0800)
commit4a6385fe555f810e8168399df673d00addffb721
tree3a737450f654dbd3c206d1c7f4da500628d91cb3
parentafd7bd22209c53ae4d3c73dd4bc4b225ec55e10a
index-format.txt: clarify what is "invalid"

A cache-tree entry with a negative entry count is considered invalid
by the current Git; it records that we do not know the object name
of a tree that would result by writing the directory covered by the
cache-tree as a tree object.

Clarify that any entry with a negative entry count is invalid, but
the implementations must write -1 there. This way, we can later
decide to allow writers to use negative values other than -1 to
encode optional information on such invalidated entries without
harming interoperability; we do not know what will be encoded and
how, so we keep these other negative values as reserved for now.

Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/technical/index-format.txt