Merge branch 'anders/diameter/codec/OTP-14511' into maint

* anders/diameter/codec/OTP-14511: (26 commits)
  Limit SCTP testing in traffic suite
  Increase init_per_group timetrap in traffic suite
  Add diameter_util:eprof/1 for test
  Don't search forms unnecessarily in diameter_exprecs parse transform
  Increase init_per_suite timetrap in traffic suite
  Don't count AVPs unnecessarily at encode
  Test decode_format record_from_map in traffic suite
  Tweak limiting of testcases in traffic suite
  Don't take length of AVP lists unnecessarily at encode
  Tweak map-valued decode
  Rearrange group names in traffic suite
  Randomly wrap answers in diameter_packet in transport suite
  Don't exercise client/server encoding independently in traffic suite
  Add decode_format record_from_map
  Rename record_decode -> decode_format
  Create fewer client connections in traffic suite
  Test record_decode in traffic suite
  Map answers to maps in traffic suite
  Test map encoding in traffic suite
  Let messages and grouped AVPs be decoded to lists
  ...

1 files changed, 29 insertions, 0 deletions

diff --git a/lib/diameter/doc/src/diameter.xml b/lib/diameter/doc/src/diameter.xml
index 2cbe48ecce..43cb3a538c 100644
--- a/lib/diameter/doc/src/diameter.xml
+++ b/lib/diameter/doc/src/diameter.xml
@@ -798,6 +798,35 @@ be matched by corresponding &capability; configuration, of
 </item>
 
 <tag>
+<marker id="decode_format"/>
+<c>{decode_format, record | list | map | false}</c></tag>
+<item>
+<p>
+The format of decoded messages and grouped AVPs in the <c>msg</c> field
+of diameter_packet records and <c>value</c> field of diameter_avp
+records respectively.
+If <c>record</c> then a record whose definition is generated from the
+dictionary file in question.
+If <c>list</c> or <c>map</c> then a <c>[Name | Avps]</c> pair where
+<c>Avps</c> is either a list of AVP name/values pairs or a map keyed on
+AVP names respectively.
+If <c>false</c> then the representation is omitted and <c>msg</c> and
+<c>value</c> fields are set to <c>false</c>.
+See also &codec_message;.</p>
+
+<p>
+Defaults to <c>record</c>.</p>
+
+<note>
+<p>
+AVPs are decoded into a list of diameter_avp records in <c>avps</c>
+field of diameter_packet records independently of
+<c>decode_format</c>.</p>
+</note>
+
+</item>
+
+<tag>
 <marker id="incoming_maxlen"/><c>{incoming_maxlen, 0..16777215}</c></tag>
 <item>
 <p>