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]