all: implement inline macro for passthrough ("pass:")

The inline passthrough "pass:" can be used to control the substitutions
applied to a run of text.

Ref: https://docs.asciidoctor.org/asciidoc/latest/pass/pass-macro/

1 files changed, 34 insertions, 0 deletions

diff --git a/_doc/SPECS.adoc b/_doc/SPECS.adoc
index 14e971f..6a5244f 100644
--- a/_doc/SPECS.adoc
+++ b/_doc/SPECS.adoc
@@ -476,6 +476,8 @@ exist, otherwise it would be considered as normal text.
 
 ==  Passthrough
 
+{url_ref}/pass/[Reference^]
+
 ----
 PASSTHROUGH_SINGLE = FORMAT_BEGIN "+" TEXT "+" FORMAT_END
 
@@ -484,8 +486,40 @@ PASSTHROUGH_DOUBLE = "++" TEXT "++"
 PASSTHROUGH_TRIPLE = "+++" TEXT "+++"
 
 PASSTHROUGH_BLOCK  = "++++" LF 1*LINE "++++" LF
+
+PASSTHROUGH_MACRO  = "pass:" *(PASSMACRO_SUB) "[" TEXT "]"
+
+PASSMACRO_SUB      = PASSMACRO_CHAR *("," PASSMACRO_CHAR)
+
+PASSMACRO_CHAR     = "c" / "q" / "a" / "r" / "m" / "p"
+                   / PASSMACRO_GROUP_NORMAL
+                   / PASSMACRO_GROUP_VERBATIM
+
+PASSMACRO_GROUP_NORMAL   = "n" ; equal to "c,q,r,m,p"
+
+PASSMACRO_GROUP_VERBATIM = "v" ; equal to "c"
 ----
 
+The "c" allow
+{url_ref}/subs/special-characters/[special character substitutions].
+
+The "q" allow
+{url_ref}/subs/quotes/[quotes substitutions].
+
+The "a" allow
+{url_ref}/subs/attributes/[attributes references substitutions].
+
+The "r" allow
+{url_ref}/subs/replacements/[character replacement substitutions].
+
+The "m" allow
+{url_ref}/subs/macros/[macro substitutions].
+
+The "p" allow
+{url_ref}/subs/post-replacements/[post-replacement substitutions].
+
+The substitutions are applied in above order.
+
 
 ==  URLs