This is an automated email from the ASF dual-hosted git repository.

chaokunyang pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/fory-site.git


The following commit(s) were added to refs/heads/main by this push:
     new 70d9bb9fc0 🔄 synced local 'docs/specification/' with remote 
'docs/specification/'
70d9bb9fc0 is described below

commit 70d9bb9fc04d367211998e73fca59e25149461f8
Author: chaokunyang <[email protected]>
AuthorDate: Tue Jan 27 03:48:14 2026 +0000

    🔄 synced local 'docs/specification/' with remote 'docs/specification/'
---
 docs/specification/java_serialization_spec.md  |  5 +++--
 docs/specification/xlang_serialization_spec.md | 11 ++++++-----
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/docs/specification/java_serialization_spec.md 
b/docs/specification/java_serialization_spec.md
index f7f2a13866..e3093f2b9d 100644
--- a/docs/specification/java_serialization_spec.md
+++ b/docs/specification/java_serialization_spec.md
@@ -232,12 +232,13 @@ when shared meta is enabled, or referenced by index when 
already seen.
 Header layout (lower bits on the right):
 
 ```
-| 50-bit hash | 1 bit compress | 1 bit has_fields_meta | 12-bit size |
+| 50-bit hash | 4 bits reserved | 1 bit compress | 1 bit has_fields_meta | 
8-bit size |
 ```
 
-- size: lower 12 bits. If size equals the mask (0xFFF), write extra size as 
varuint32 and add it.
+- size: lower 8 bits. If size equals the mask (0xFF), write extra size as 
varuint32 and add it.
 - compress: set when payload is compressed.
 - has_fields_meta: set when field metadata is present.
+- reserved: bits 10-13 are reserved for future use and must be zero.
 - hash: 50-bit hash of the payload and flags.
 
 ### Class meta bytes
diff --git a/docs/specification/xlang_serialization_spec.md 
b/docs/specification/xlang_serialization_spec.md
index 362d2784c4..1256ccb08b 100644
--- a/docs/specification/xlang_serialization_spec.md
+++ b/docs/specification/xlang_serialization_spec.md
@@ -489,11 +489,12 @@ resolution. It is encoded as:
 
 The 8-byte header is a little-endian uint64:
 
-- Low 12 bits: meta size (number of bytes in the TypeDef body).
-  - If meta size >= 0xFFF, the low 12 bits are set to 0xFFF and an extra
-    `varuint32(meta_size - 0xFFF)` follows immediately after the header.
-- Bit 12: `HAS_FIELDS_META` (1 = fields metadata present).
-- Bit 13: `COMPRESS_META` (1 = body is compressed; decompress before parsing).
+- Low 8 bits: meta size (number of bytes in the TypeDef body).
+  - If meta size >= 0xFF, the low 8 bits are set to 0xFF and an extra
+    `varuint32(meta_size - 0xFF)` follows immediately after the header.
+- Bit 8: `HAS_FIELDS_META` (1 = fields metadata present).
+- Bit 9: `COMPRESS_META` (1 = body is compressed; decompress before parsing).
+- Bits 10-13: reserved for future extension (must be zero).
 - High 50 bits: hash of the TypeDef body.
 
 #### TypeDef body


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to