summaryrefslogtreecommitdiffstats
path: root/doc/man3/X509_NAME_add_entry_by_txt.pod
diff options
context:
space:
mode:
authorDr. David von Oheimb <David.von.Oheimb@siemens.com>2020-09-04 18:31:46 +0200
committerDr. David von Oheimb <David.von.Oheimb@siemens.com>2020-09-10 12:07:33 +0200
commita8e2a9f569c60dbbc180672b0fce16ab7dd6ca72 (patch)
tree53eb212a0a354b52ec5883c3705e975d95c83361 /doc/man3/X509_NAME_add_entry_by_txt.pod
parentX509_NAME_cmp: restrict normal return values to {-1,0,1} to avoid confusion w... (diff)
downloadopenssl-a8e2a9f569c60dbbc180672b0fce16ab7dd6ca72.tar.xz
openssl-a8e2a9f569c60dbbc180672b0fce16ab7dd6ca72.zip
X509_NAME_add_entry_by_txt.pod: Improve documentation w.r.t. multi-valued RDNs (containing sets of AVAs)
Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org> (Merged from https://github.com/openssl/openssl/pull/12769)
Diffstat (limited to 'doc/man3/X509_NAME_add_entry_by_txt.pod')
-rw-r--r--doc/man3/X509_NAME_add_entry_by_txt.pod12
1 files changed, 6 insertions, 6 deletions
diff --git a/doc/man3/X509_NAME_add_entry_by_txt.pod b/doc/man3/X509_NAME_add_entry_by_txt.pod
index ce8bf3ef29..8b17a016de 100644
--- a/doc/man3/X509_NAME_add_entry_by_txt.pod
+++ b/doc/man3/X509_NAME_add_entry_by_txt.pod
@@ -66,13 +66,13 @@ RelativeDistinguishedName (RDN).
B<loc> actually determines the index where the new entry is inserted:
if it is -1 it is appended.
-B<set> determines how the new type is added. If it is zero a
-new RDN is created.
+B<set> determines how the new type is added.
+If it is zero a new RDN is created.
-If B<set> is -1 or 1 it is added to the previous or next RDN
-structure respectively. This will then be a multivalued RDN:
-since multivalues RDNs are very seldom used B<set> is almost
-always set to zero.
+If B<set> is -1 or 1 it is added as a new set member
+to the previous or next RDN structure, respectively.
+This will then become part of a multi-valued RDN (containing a set of AVAs).
+Since multi-valued RDNs are very rarely used B<set> typically will be zero.
=head1 RETURN VALUES