Add a section on DiffX encoding rules.

Review Request #11693 — Created June 30, 2021 and submitted

Information

DiffX
master

Reviewers

This adds a top-level section on all the encoding rules for a DiffX
file. This covers how encodings work, how sections inherit or specify
their encodings, and what assumptions a parser can or cannot make based
on the presence of encodings on any given section.

Some other sections that previously discussed encodings now refer to
this new section, except where it's still deemed important to highlight
important information.

One big change is that section header lines are no longer encoded using
the parent section's encoding. Instead, they're encoded using plain
ASCII. This aids in parsing, allowing a parser to skip to any given
section (jumping from section to section based on each section's length
option) without having to keep track of an encoding hierarchy and having
section-specific logic for decoding that given line.

Built the docs. Checked the new Encodings section for typos and bad
links. Checked each section referencing encodings for bad links.

Summary ID
Add a section on encoding rules.
This adds a top-level section on all the encoding rules for a DiffX file. This covers how encodings work, how sections inherit or specify their encodings, and what assumptions a parser can or cannot make based on the presence of encodings on any given section. Some other sections that previously discussed encodings now refer to this new section, except where it's still deemed important to highlight important information. One big change is that section header lines are no longer encoded using the parent section's encoding. Instead, they're encoded using plain ASCII. This aids in parsing, allowing a parser to skip to any given section (jumping from section to section based on each section's length option) without having to keep track of an encoding hierarchy and having section-specific logic for decoding that given line.
227586bf300e66d90dd4c480ca3805b395844096
david
  1. Ship It!
  2. 
      
chipx86
Review request changed
Status:
Completed