From bfe43bb0a7f2439dae5408b0ccfb5f9c06d60d86 Mon Sep 17 00:00:00 2001 From: Dan Allen Date: Thu, 6 Jan 2022 23:53:11 -0700 Subject: resolves #4103 clarify that substitutions are not applied to the value of attributes defined via API or CLI --- docs/modules/api/pages/options.adoc | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) (limited to 'docs/modules/api') diff --git a/docs/modules/api/pages/options.adoc b/docs/modules/api/pages/options.adoc index 0a279c77..a91662a1 100644 --- a/docs/modules/api/pages/options.adoc +++ b/docs/modules/api/pages/options.adoc @@ -5,16 +5,19 @@ |Name |Description |Default value |Allowed values |`:attributes` -|Sets document attributes, which override equivalently-named attributes defined in the document unless soft set (`@`). -When using the hash format, a `nil` value unsets the attribute and a `false` value soft unsets the attribute. +|Sets document attributes, which override equivalently-named attributes defined in the document unless soft set. +No substitutions are applied to the value of these attributes. +In the hash format, a `nil` value hard unsets the attribute and a `false` value soft unsets the attribute. |_not set_ -|xref:asciidoc:attributes:document-attributes.adoc[Document attributes] in the following formats: +a|xref:asciidoc:attributes:document-attributes.adoc[Document attributes] in the following formats: -Hash: + -`{'name'\=>'value'}` + -Array: + -`['name=value']` + -String: + +*Hash* + +`{ 'name' \=> 'value' }` + +*Array* + +`[ 'name=value' ]` + +*String* (space separated) + `'name=value'` |`:backend` -- cgit v1.2.3