Two-line/setext titles (Title followed by a row of =) are deprecated in Asciidoctor and absent from the modern AsciiDoc language spec we target. They're already off by default (adoc-enable-two-line-title is nil) and now navigation/imenu honor that flag too.
Worth deciding whether to drop them entirely at some point.
For removing: removes a recurring ambiguity (a ----/==== line is both a possible block delimiter and a title underline, which font-lock can't always resolve); simplifies adoc-title-descriptor, the title regexp builders, and promote/demote; aligns with the spec-compatibility goal; outline folding already doesn't support them.
Against: Asciidoctor still parses them, so dropping breaks editing of legacy AsciiDoc.py documents; it's a user-facing feature removal; the opt-in already contains the deprecation.
No rush - filing for future reference.
Two-line/setext titles (
Titlefollowed by a row of=) are deprecated in Asciidoctor and absent from the modern AsciiDoc language spec we target. They're already off by default (adoc-enable-two-line-titleis nil) and now navigation/imenu honor that flag too.Worth deciding whether to drop them entirely at some point.
For removing: removes a recurring ambiguity (a
----/====line is both a possible block delimiter and a title underline, which font-lock can't always resolve); simplifiesadoc-title-descriptor, the title regexp builders, and promote/demote; aligns with the spec-compatibility goal; outline folding already doesn't support them.Against: Asciidoctor still parses them, so dropping breaks editing of legacy AsciiDoc.py documents; it's a user-facing feature removal; the opt-in already contains the deprecation.
No rush - filing for future reference.