Antora emits warning for pages that declare the manpage doctype
Having something like:
// This is a generated documentation file based on picocli
// To change it update the picocli code or the genrator
// tag::picocli-generated-full-manpage[]
// tag::picocli-generated-man-section-header[]
:doctype: manpage
:revnumber:
:manmanual: Jbang Manual
:mansource:
:man-linkstyle: pass:[blue R < >]
= jbang-alias-add(1)
// end::picocli-generated-man-section-header[]
// tag::picocli-generated-man-section-name[]
== Name
jbang-alias-add - Add alias for script reference.
results in errors like this to be printed using antora (but no errors using plain asciidoc)
asciidoctor: ERROR: jbang-jdk-default.adoc: line 11: name section expected
asciidoctor: ERROR: jbang-jdk-home.adoc: line 11: name section expected
asciidoctor: ERROR: jbang-jdk-install.adoc: line 11: name section expected
asciidoctor: ERROR: jbang-jdk-java-env.adoc: line 11: name section expected
From chat "Aha! This is coming from the header parser in Antora. It only reads the header in order to stash the doctitle. But when it cuts the document, it confuses the manpage parsing logic. What we need to do is force the doctype to article when we are parsing the header only. We don't care about anything else in the document, so we only want to be in article parsing mode. "
Edited by Dan Allen