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
bobs@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.<name>.active` is set to `true`
+
or
b. if the submodule's path matches the pathspec in `submodule.active`
+
or
c. if `submodule.<name>.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.<name>.active is set to true
or
2. if the submoduleâs path matches the pathspec in submodule.active
or
3. if submodule.<name>.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-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org