Skip to content

Commit 5c752ff

Browse files
tmzullingergitster
authored andcommitted
gitfaq: avoid validation error with older asciidoc
When building with asciidoc-8.4.5 (as found on CentOS/Red Hat 6), the period in the "[[files-in-.gitignore-are-tracked]]" anchor is not properly parsed as a section: WARNING: gitfaq.txt: line 245: missing [[files-in-.gitignore-are-tracked]] section The resulting XML file fails to validate with xmlto: xmlto: /git/Documentation/gitfaq.xml does not validate (status 3) xmlto: Fix document syntax or use --skip-validation option /git/Documentation/gitfaq.xml:3: element refentry: validity error : Element refentry content does not follow the DTD, expecting (beginpage? , indexterm* , refentryinfo? , refmeta? , (remark | link | olink | ulink)* , refnamediv+ , refsynopsisdiv? , (refsect1+ | refsection+)), got (refmeta refnamediv refsynopsisdiv refsect1 refsect1 refsect1 refsect1 variablelist refsect1 refsect1 ) Document /git/Documentation/gitfaq.xml does not validate Let's avoid breaking users of platforms which ship an old version of asciidoc, since the cost to do so is quite low. Reported-by: Son Luong Ngoc <[email protected]> Signed-off-by: Todd Zullinger <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 60e5236 commit 5c752ff

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

Documentation/gitfaq.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -223,7 +223,7 @@ a file checked into the repository which is a template or set of defaults which
223223
can then be copied alongside and modified as appropriate. This second, modified
224224
file is usually ignored to prevent accidentally committing it.
225225

226-
[[files-in-.gitignore-are-tracked]]
226+
[[files-in-gitignore-are-tracked]]
227227
I asked Git to ignore various files, yet they are still tracked::
228228
A `gitignore` file ensures that certain file(s) which are not
229229
tracked by Git remain untracked. However, sometimes particular

0 commit comments

Comments
 (0)