Matthias Lederhofer [off-list ref] writes:
Lars Hjemli [off-list ref] wrote:
quoted
+SYNOPSIS
+--------
+.gitmodules
My asciidoc (7.1.2 and 8.2.1) generates an empty refsynopsisdiv from
this. xmlto refuses to convert this into anything else:
...
This breaks the build process for the documentation. I could not find
out how to fix this. Probably just needs the right quoting for the
dot at the beginning of the line.
Sorry, I should have caught this much earlier, as already knew
about this issue when I did gitattributes(5).
As it seems to be customary not to even say 'dot' at the
beginning for man(5) section (existing examples I found are
netrc, postgresrc, procmailrc, ...), I think the best fix is
just to do s/\.gitmodules/gitmodules/ there.
Asciidoc treats a line starting with a period followed by a title as a
blocktitle element. My introduction of gitmodules(5) unfortunatly broke
the documentation build process due to this processing, since it made
asciidoc generate an illegal (empty) synopsis element. Removing the leading
period fixes the problem and also makes gitmodules(5) use the same synopsis
notation as gitattributes(5).
Noticed-by: Matthias Lederhofer [off-list ref]
Signed-off-by: Lars Hjemli <redacted>
---
Sorry for the breakage, I'll try to get asciidoc working before submitting
any more patches to Documentation/.
Documentation/gitmodules.txt | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)
diff --git a/Documentation/gitmodules.txt b/Documentation/gitmodules.txt
index 7814b6a..035294e 100644
--- a/Documentation/gitmodules.txt
+++ b/Documentation/gitmodules.txt
@@ -7,7 +7,7 @@ gitmodules - defining submodule properties
SYNOPSIS
--------
-.gitmodules
+gitmodules
DESCRIPTION
--
1.5.2.1.914.gbd3a7