f more details

Author: TheBlueMatt

lightning/src/util/ser.rs

@@ -386,7 +386,8 @@ impl Readable for BigSize {
 /// The lightning protocol uses u16s for lengths in most cases. As our serialization framework
 /// primarily targets that, we must as well. However, because we may serialize objects that have
 /// more than 65K entries, we need to be able to store larger values. Thus, we define a variable
-/// length integer here that is backwards-compatible but treats 0xffff as "read eight more bytes".
+/// length integer here that is backwards-compatible for values < 0xffff. We treat 0xffff as
+/// "read eight more bytes".
 ///
 /// To ensure we only have one valid encoding per value, we add 0xffff to values written as eight
 /// bytes. Thus, 0xfffe is serialized as 0xfffe, whereas 0xffff is serialized as