[PATCH v2] doc: fix asciidoc format compatibility in pretty-formats.adoc
- From
Jean-Noël Avila <jn.avila@free.fr>
- Date
- Aug 20, 2025, 20:26 UTC
- Message-ID
- <20250820203722.31268-2-jn.avila@free.fr>
- In-Reply-To
- <20250820203722.31268-1-jn.avila@free.fr>
Asciidoc.py and Asciidoctor do not parse the '+' verbatim syntax in the same way. For most usages, Asciidoctor requires a double '+'.
Unfortunately, the post-processing of verbatim synopsis in asciidoctor cannot be bypassed and formatting of the parentheses is forced in syntax sign instead of keywords, unless a proper grammar analyzer is used.
Signed-off-by: Jean-Noël Avila <jn.avila@free.fr> --- Documentation/pretty-formats.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/Documentation/pretty-formats.adoc b/Documentation/pretty-formats.adoc index 9ed0417fc8..618ddc4a0c 100644 --- a/Documentation/pretty-formats.adoc +++ b/Documentation/pretty-formats.adoc @@ -233,11 +233,11 @@ colon and zero or more comma-separated options. Option values may contain literal formatting codes. These must be used for commas (`%x2C`) and closing parentheses (`%x29`), due to their role in the option syntax. + -** `prefix=<value>`: Shown before the list of ref names. Defaults to "{nbsp}+(+". +** `prefix=<value>`: Shown before the list of ref names. Defaults to "{nbsp}++(++". ** `suffix=<value>`: Shown after the list of ref names. Defaults to "+)+". ** `separator=<value>`: Shown between ref names. Defaults to "+,+{nbsp}". ** `pointer=<value>`: Shown between HEAD and the branch it points to, if any. - Defaults to "{nbsp}+->+{nbsp}". + Defaults to "{nbsp}++->++{nbsp}". ** `tag=<value>`: Shown before tag names. Defaults to "`tag:`{nbsp}". +
-- 2.51.0