Thread (295 messages) 295 messages, 13 authors, 2020-07-31
STALE2173d

[PATCH v12 07/12] reftable: clarify how empty tables should be written

From: Han-Wen Nienhuys via GitGitGadget <hidden>
Date: 2020-05-07 09:59:59
Subsystem: documentation, the rest · Maintainers: Jonathan Corbet, Linus Torvalds

From: Han-Wen Nienhuys <redacted>

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 <redacted>
---
 Documentation/technical/reftable.txt | 7 +++++++
 1 file changed, 7 insertions(+)
diff --git a/Documentation/technical/reftable.txt b/Documentation/technical/reftable.txt
index ee3f36ea851..df5cb5f11b8 100644
--- a/Documentation/technical/reftable.txt
+++ b/Documentation/technical/reftable.txt
@@ -731,6 +731,13 @@ 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.
+
+
 Varint encoding
 ^^^^^^^^^^^^^^^
 
-- 
gitgitgadget
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help