File 0635-Update-ei_encode_long-documentation-to-indicate-vari.patch of Package erlang
From 2d32e9130e5aa747616c1217b5e35b38f3194b0a Mon Sep 17 00:00:00 2001
From: Matthew Pope <mpope9@users.noreply.github.com>
Date: Fri, 16 Feb 2024 12:12:35 -0800
Subject: [PATCH] Update ei_encode_long documentation to indicate variable
length encoding.
---
lib/erl_interface/doc/references/ei.md | 10 ++++++----
1 file changed, 6 insertions(+), 4 deletions(-)
diff --git a/lib/erl_interface/doc/src/ei.xml b/lib/erl_interface/doc/src/ei.xml
index 2f9c4dc9b2..98bb085ea6 100644
--- a/lib/erl_interface/doc/src/ei.xml
+++ b/lib/erl_interface/doc/src/ei.xml
@@ -74,7 +74,10 @@
<p>All encode functions assume that the <c>buf</c> and
<c>index</c> parameters point to a buffer large enough for
- the data. To get the size of an encoded term, without encoding it,
+ the data. Note that the binary term format uses variable-length
+ encoding so different values can require a different amount of space.
+ For example, smaller integer values can be more compact than larger ones.
+ To get the size of an encoded term, without encoding it,
pass <c>NULL</c> instead of a buffer pointer. Parameter
<c>index</c> is incremented, but nothing will be encoded. This
is the way in <c>ei</c> to "preflight" term encoding.</p>
--
2.35.3