Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Capitalization and Consistency #4989

Merged
merged 7 commits into from May 12, 2022
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
Prev
If Sign is a field...
  • Loading branch information
MikeBishop committed May 11, 2022
commit 8f847d3f971e8e8a16396887fc5692d45b753957
@@ -879,7 +879,7 @@

Each encoded field section is prefixed with two integers. The Required Insert
Count is encoded as an integer with an 8-bit prefix using the encoding described
in {{ric}}. The Base is encoded as a sign bit ('S') and a Delta Base value
in {{ric}}. The Base is encoded as a Sign bit ('S') and a Delta Base value
with a 7-bit prefix; see {{base}}.

~~~~~~~~~~ ascii-art
@@ -967,16 +967,16 @@
{{relative-indexing}}.

To save space, the Base is encoded relative to the Required Insert Count using a
one-bit sign ('S') and the Delta Base value. A sign bit of 0 indicates that the
Base is greater than or equal to the value of the Required Insert Count; the
decoder adds the value of Delta Base to the Required Insert Count to determine
the value of the Base. A sign bit of 1 indicates that the Base is less than the
Required Insert Count; the decoder subtracts the value of Delta Base from the
Required Insert Count and also subtracts one to determine the value of the Base.
That is:
one-bit Sign ('S' in {{fig-base-index}}) and the Delta Base value. A Sign bit
of 0 indicates that the Base is greater than or equal to the value of the
Required Insert Count; the decoder adds the value of Delta Base to the Required
Insert Count to determine the value of the Base. A Sign bit of 1 indicates that
the Base is less than the Required Insert Count; the decoder subtracts the value
of Delta Base from the Required Insert Count and also subtracts one to determine
the value of the Base. That is:

~~~ pseudocode
if S == 0:
if Sign == 0:
Base = ReqInsertCount + DeltaBase
else:
Base = ReqInsertCount - DeltaBase - 1
@@ -985,27 +985,27 @@
A single-pass encoder determines the Base before encoding a field section. If
the encoder inserted entries in the dynamic table while encoding the field
section and is referencing them, Required Insert Count will be greater than the
Base, so the encoded difference is negative and the sign bit is set to 1. If
Base, so the encoded difference is negative and the Sign bit is set to 1. If
the field section was not encoded using representations that reference the most
recent entry in the table and did not insert any new entries, the Base will be
greater than the Required Insert Count, so the encoded difference will be
positive and the sign bit is set to 0.
positive and the Sign bit is set to 0.

The value of Base MUST NOT be negative. Though the protocol might operate
correctly with a negative Base using post-Base indexing, it is unnecessary and
inefficient. An endpoint MUST treat a field block with a sign bit of 1 as
inefficient. An endpoint MUST treat a field block with a Sign bit of 1 as
invalid if the value of Required Insert Count is less than or equal to the value

Check warning on line 997 in rfc9204.md

In Solidarity / Inclusive Language

Match Found

You might want to consider an alternative to the term "invalid".
Possibilities might include: "not valid", "unenforceable", "not binding", "inoperative", "illegitimate", "incorrect", "improper", "unacceptable", "inapplicable", "revoked", "rescinded".
(This check uses pattern-matching and may therefore be incorrect. To improve the patterns or to make other suggestions, please open an issue or pull-request at https://github.com/ietf/terminology/issues.)
Raw output
/\binvalid\w*\b/gi
of Delta Base.

An encoder that produces table updates before encoding a field section might set
Base to the value of Required Insert Count. In such a case, both the sign bit
Base to the value of Required Insert Count. In such a case, both the Sign bit
and the Delta Base will be set to zero.

A field section that was encoded without references to the dynamic table can use
any value for the Base; setting Delta Base to zero is one of the most efficient
encodings.

For example, with a Required Insert Count of 9, a decoder receives a sign bit
For example, with a Required Insert Count of 9, a decoder receives a Sign bit
of 1 and a Delta Base of 2. This sets the Base to 6 and enables post-Base
indexing for three entries. In this example, a relative index of 1 refers to
the fifth entry that was added to the table; a post-Base index of 1 refers to