From fc8226e868f82bce95561d38c6bf1e93246b96f4 Mon Sep 17 00:00:00 2001 From: Tony Garnock-Jones Date: Sun, 10 Jul 2022 13:21:31 +0200 Subject: [PATCH] Clarify --- preserves-binary.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/preserves-binary.md b/preserves-binary.md index e0209c0..46d048a 100644 --- a/preserves-binary.md +++ b/preserves-binary.md @@ -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),