On Sun, 16 Dec 2018 at 11:51, Jeff King <peff@xxxxxxxx> wrote: > > On Sat, Dec 15, 2018 at 12:27:39PM +0100, Martin Ågren wrote: > > > We have too few dashes under "Examples", which causes Asciidoctor to not > > pick it up as a section header, but to instead just render the dashes > > literally. This also seems to confuse Asciidoctor about dashes in > > general around here. It misinterprets the listing blocks in this > > section, again rendering the dashes literally. > > > > Make sure we have as many dashes as we have characters in "Examples". > > This fixes the section-issue and, somehow, makes the listing blocks > > render correctly. > > The "somehow" here is that the mismatched dashes appear to be the start > of a code listing block, making the whole example section into one big > listing (which isn't properly closed, generating a warning). Of course. Thanks for pointing it out. I now realize that when I wrote "render the dashes literally", I was wrong. This should be improved in v2. Martin