• 
      

    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