reftable: clarify how empty tables should be written
The format allows for some ambiguity, as a lone footer also starts with a valid file header. However, the current JGit code will barf on this. This commit codifies this behavior into the standard. Signed-off-by: Han-Wen Nienhuys <hanwen@google.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Han-Wen Nienhuys committed
May 20, 2020 at 17:36 UTC
10f007c37031df64a5786f032f52fd1327920e0d
1 file changed
+5
Documentation/technical/reftable.txt
+5
index d652f42cbb..103f65b061 100644
--- a/Documentation/technical/reftable.txt
+++ b/Documentation/technical/reftable.txt
@@ -733,6 +733,12 @@ version)
Once verified, the other fields of the footer can be accessed.
+Empty tables
+++++++++++++
+
+A reftable may be empty. In this case, the file starts with a header
+and is immediately followed by a footer.
+
Binary search
^^^^^^^^^^^^^