fonts-conf(5): issues with automatic generation by docbook2man
Seems like docbook2man isn't perfect when it comes to XML. Can't blame it for that, since XML is a mess anyway, but it goes.
Subsections in the CONFIGURATION FILE FORMAT section are wrong. They get uppercased (although subsections are usually lowercase), and converted to groff without proper quoting.
Steps to reproduce
man 5 fonts-conf
- Scroll down.
<include ignore_missing="no" prefix="default">
Rendered man page:
<INCLUDE IGNORE_MISSING= NO" PREFIX="DEFAULT">"
.SS "<INCLUDE IGNORE_MISSING=\&"NO\&" PREFIX=\&"DEFAULT\&">"
The proper way to generate groff source for that is to char-escape double quotes. According to groff_char(7), ASCII double quote can be unambiguously represented as
.SS <include ignore_missing=\&\[dq]no\&\[dq] prefix=\&\[dq]default\&\[dq]>
Also, would be better to highlight attribute values with underline style, which in man pages often stands for user input placeholder. That would require breaking up ` in source *.sgml sources and possibly inventing new elements.