summaryrefslogtreecommitdiffstats
path: root/doc/man7
diff options
context:
space:
mode:
authorPauli <pauli@openssl.org>2021-09-30 11:39:41 +1000
committerPauli <pauli@openssl.org>2021-10-09 23:29:13 +1000
commit78de5a94d8e2b0a27ae026de29c195e944a49c6d (patch)
tree45bb8d60da8642437c655c7ecad276534770c80f /doc/man7
parent747d142318c5c9ecd80de3f061f54d7af4189039 (diff)
doc: document that property names are unique
Both queries and definitions only support each individual name appearing once. It is an error to have a name appear more than once. Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/16716)
Diffstat (limited to 'doc/man7')
-rw-r--r--doc/man7/property.pod4
1 files changed, 3 insertions, 1 deletions
diff --git a/doc/man7/property.pod b/doc/man7/property.pod
index a75f262246..109336ba47 100644
--- a/doc/man7/property.pod
+++ b/doc/man7/property.pod
@@ -41,7 +41,8 @@ property names like
A I<property> is a I<name=value> pair.
A I<property definition> is a sequence of comma separated properties.
-There can be any number of properties in a definition.
+There can be any number of properties in a definition, however each name must
+be unique.
For example: "" defines an empty property definition (i.e., no restriction);
"my.foo=bar" defines a property named I<my.foo> which has a string value I<bar>
and "iteration.count=3" defines a property named I<iteration.count> which
@@ -68,6 +69,7 @@ Matching such clauses is not a requirement, but any additional optional
match counts in favor of the algorithm.
More details about that in the B<Lookups> section.
A I<property query> is a sequence of comma separated property query clauses.
+It is an error if a property name appears in more than one query clause.
The full syntax for property queries appears below, but the available syntactic
features are: