From: Richard Levitte <levitte@openssl.org>
Date: Sat, 31 Aug 2019 07:30:43 +0000 (+0200)
Subject: doc/man3/OSSL_PARAM.pod: add details about multiple elements with same key
X-Git-Tag: openssl-3.0.0-alpha1~1379
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=45211c563fb12aca50771b3400b833da4095c6de;p=oweals%2Fopenssl.git

doc/man3/OSSL_PARAM.pod: add details about multiple elements with same key

Usually, each element in an OSSL_PARAM array will have a unique key.
However, there may be some rare cases when a responder will handle
multiple elements with the same key.  This adds a short passage
explaining this case.

Reviewed-by: Paul Dale <paul.dale@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/9741)
---

diff --git a/doc/man3/OSSL_PARAM.pod b/doc/man3/OSSL_PARAM.pod
index d0725e063e..361028fa00 100644
--- a/doc/man3/OSSL_PARAM.pod
+++ b/doc/man3/OSSL_PARAM.pod
@@ -60,6 +60,10 @@ I<responder>.
 
 =back
 
+Normally, the order of the an B<OSSL_PARAM> array is not relevant.
+However, if the I<responder> can handle multiple elements with the
+same key, those elements must be handled in the order they are in.
+
 =head2 B<OSSL_PARAM> fields
 
 =over 4