Skip to content

[doc] Use Compressed_Literals_Block in Size_Format bullet for consistency (fixes #4673)#4676

Open
LeSingh1 wants to merge 1 commit into
facebook:devfrom
LeSingh1:fix/literals-block-spec-terminology
Open

[doc] Use Compressed_Literals_Block in Size_Format bullet for consistency (fixes #4673)#4676
LeSingh1 wants to merge 1 commit into
facebook:devfrom
LeSingh1:fix/literals-block-spec-terminology

Conversation

@LeSingh1
Copy link
Copy Markdown

Fixes #4673.

In doc/zstd_compression_format.md, the Size_Format bullet in the Literals_Block_Type section currently reads:

  • For Compressed_Block and Treeless_Literals_Block, it's required to decode both Compressed_Size and Regenerated_Size...

Compressed_Block is the block-level type defined in section 3.1.1.1 (the four-way Raw_Block / RLE_Block / Compressed_Block / Reserved enum on line 357). The value the Literals_Block_Type enum can actually hold here, and the one the parallel bullet for the Raw_Literals_Block / RLE_Literals_Block pair already uses, is Compressed_Literals_Block.

The sub-section that immediately follows ("Size_Format for Compressed_Literals_Block and Treeless_Literals_Block", line 521) already uses Compressed_Literals_Block in its heading, so this is the only remaining occurrence using the wrong term in this section.

This PR changes that one occurrence to Compressed_Literals_Block to match.

…ency

The Size_Format bullet in the Literals_Block_Type section used
`Compressed_Block` when describing which literals block types carry a
`Compressed_Size` field. `Compressed_Block` is the *block-level* type
defined in section 3.1.1.1; the value the Literals_Block_Type enum can
hold (and that the parallel bullet for Raw / RLE block types uses) is
`Compressed_Literals_Block`. The Size_Format sub-section that follows
already uses `Compressed_Literals_Block` in its heading, so this is
the only remaining mismatch.

Fixes facebook#4673.
@meta-cla meta-cla Bot added the CLA Signed label May 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

spec: Compressed_Block used where Compressed_Literals_Block likely intended

1 participant