bytes.md: document size-only parts

2021-01-04 13:06:08 -05:00 · 2021-01-04 13:06:08 -05:00 · e21691a42b
parent b2983caad4
commit e21691a42b
1 changed files with 3 additions and 0 deletions
--- a/doc/schema/bytes.md
+++ b/doc/schema/bytes.md
@ -27,6 +27,9 @@ a "file" schema blob.
      //                these in a hash tree.  it is an error if both "bytesRef"
      //                and "blobRef" are specified.
      //
+      //    The absence of "blobRef" or "bytesRef" is used to represent a hole in a
+      //    sparse file. Or just zeros.
+      //
      // Optional:
      //    "offset": the number of bytes into blobRef or bytesRef to skip to
      //              get the necessary bytes for the range. usually zero (unspecified)