Hi Emily,
I checked and the DocBook XSL stylesheet used on the backend of Asciidoc
to render man pages does not support the numeration attribute on
orderedlist elements (assuming Asciidoc outputs that attribute when it
generates the intermediate DocBook file). It's the numeration attribute
that specifies the number format for such a list. I'll file a bug
report, but I can't say when it will get fixed.
Bob Stayton
Sagehill Enterprises
b...@sagehill.net
On 5/7/2019 3:16 PM, Emily Shaffer wrote:
Hiya,
I've run into an issue where we are seeing output from AsciiDoc->nroff
producing the wrong type of numerated list. Specifically, when the
AsciiDoc uses a lettered list like so:
```
A submodule is considered active,
a. if `submodule..active` is set to `true`
+
or
b. if the submodule's path matches the pathspec in `submodule.active`
+
or
c. if `submodule..url` is set.
and these are evaluated in this order.
```
The formatted nroff, opened with `man`, looks like so:
```
A submodule is considered active,
1. if submodule..active is set to true
or
2. if the submodule’s path matches the pathspec in submodule.active
or
3. if submodule..url is set.
and these are evaluated in this order.
```
(Bold excluded from above due to plaintext email mode)
However, HTML generated from the same source AsciiDoc gives a lettered
list as expected.
You can see examples of the disparity in the document this bug is
based on, by examining https://gitirc.eu/gitsubmodules.html or by
running `man gitsubmodules` if your copy of Git is version 2.19.2 or
newer.
My version of asciidoc is 8.7.10; I'm not sure where I would find
which schema version we're using elsewhere but I'm happy to look it
up.
Thank you!
Emily Shaffer
-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
