Asciidoctor's "warnings about indexing" bug

Wrong.adoc

Probably a bug

About this list

1. This list has many items, which are split across several sections.

2. List items in document include index number. That is, they are formatted like:

   1. This list has many items, which are split across several sections.

   not like:

   . This list has many items, which are split across several sections.

Why it is split?

3. There are use cases in which starting from higher number is advocated.

4. For example, when many lists (from AsciiDoctor’s point of view) make sense as a whole (from reader’s point of view).

5. I mean, software installation procedure could be organized in sections like: "Hardware requirements", "Software prerequisites", "Where to download from", "Compiling C++ sources", etc.

6. This bug report is also kinda valid use case.

It renders correctly

7. Actually, this list is rendered correctly.

8. AsciiDoc supports [start=n] annotation which allows to continue list from some higher number.

9. And yes, this technique is used in this very document.

So, what’s wrong with it?

10. Warnings!

11. It says:

    asciidoctor: WARNING: Wrong.adoc: line 21: list item index: expected 1, got 3
    asciidoctor: WARNING: Wrong.adoc: line 22: list item index: expected 2, got 4
    asciidoctor: WARNING: Wrong.adoc: line 23: list item index: expected 3, got 5
    asciidoctor: WARNING: Wrong.adoc: line 24: list item index: expected 4, got 6
    asciidoctor: WARNING: Wrong.adoc: line 29: list item index: expected 1, got 7
    asciidoctor: WARNING: Wrong.adoc: line 30: list item index: expected 2, got 8
    asciidoctor: WARNING: Wrong.adoc: line 31: list item index: expected 3, got 9
    asciidoctor: WARNING: Wrong.adoc: line 36: list item index: expected 1, got 10
    asciidoctor: WARNING: Wrong.adoc: line 37: list item index: expected 2, got 11
    asciidoctor: WARNING: Wrong.adoc: line 52: list item index: expected 3, got 12
    asciidoctor: WARNING: Wrong.adoc: line 57: list item index: expected 1, got 13

12. Which is definitely incorrect.

Are you up to date?

13. Yes, asciidoctor --version prints following:

    Asciidoctor 2.0.6 [https://asciidoctor.org]
    Runtime Environment (ruby 2.6.1p33 (2019-01-30 revision 66950) [x86_64-darwin17]) (lc:UTF-8 fs:UTF-8 in:UTF-8 ex:UTF-8)