syndicate-lang
/
preserves
mirror of https://gitlab.com/preserves/preserves.git
1
0
Fork 1
Code Releases Activity

Clarify

This commit is contained in:
Tony Garnock-Jones 2022-07-10 13:21:31 +02:00
parent df1d75d181
commit fc8226e868
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
preserves-binary.md
View File

@ -124,13 +124,13 @@ in some arbitrary order.
**Dictionaries.** A `Dictionary` encodes as tag `0xAA` followed by the
length-prefixed keys and values, in an alternating key/value sequence.
There is *no* ordering requirement on the elements of sets or the
key/value pairs of dictionaries.[^no-sorting-rationale] However,
elements of sets and keys in dictionaries *MUST* be pairwise distinct.
In addition, implementations *SHOULD* default to writing set elements
and dictionary key/value pairs in order sorted lexicographically by
their `Repr`s[^not-sorted-semantically], and *MAY* offer the option of
serializing in some other implementation-defined order.
There is *no* ordering requirement on the elements of sets or the key/value pairs of
dictionaries.[^no-sorting-rationale] However, elements of sets and keys in dictionaries *MUST*
be pairwise distinct. In addition, implementations *SHOULD* default to writing set elements in
order sorted lexicographically by their `Repr`s and *SHOULD* default to writing dictionary
key/value pairs in order sorted lexicographically by the `Repr`s of their
keys[^not-sorted-semantically]. Implementations *MAY* offer the option of serializing in some
other implementation-defined order.
[^no-sorting-rationale]: In the BitTorrent encoding format,
[bencoding](http://www.bittorrent.org/beps/bep_0003.html#bencoding),