asciidoctor: fix user-manual to be built by `asciidoctor`
The `user-manual.txt` is designed as a `book` but the `Makefile` wants to build it as an `article`. This seems to be a problem when building the documentation with `asciidoctor`. Furthermore the parts *Git Glossary* and *Appendix B* had no subsections which is not allowed when building with `asciidoctor`. So lets add a *dummy* section. Signed-off-by: 마누엘 <nalla@hamal.uberspace.de> Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de> Signed-off-by: Junio C Hamano <gitster@pobox.com>
마누엘 committed
Jan 2, 2017 at 17:03 UTC
03920ac69b62db6e95a7bb4914cf01d932421555
2 files changed
+9
-1
Documentation/Makefile
+1
-1
@@ -337,7 +337,7 @@ manpage-base-url.xsl: manpage-base-url.xsl.in
337
338
user-manual.xml: user-manual.txt user-manual.conf
339
$(QUIET_ASCIIDOC)$(RM) $@+ $@ && \
340
- $(TXT_TO_XML) -d article -o $@+ $< && \
340
+ $(TXT_TO_XML) -d book -o $@+ $< && \
341
mv $@+ $@
342
343
technical/api-index.txt: technical/api-index-skel.txt \
Documentation/user-manual.txt
+8
@@ -4395,6 +4395,10 @@ itself!
4395
Git Glossary
4396
============
4397
4398
+[[git-explained]]
4399
+Git explained
4400
+-------------
4401
+
4402
include::glossary-content.txt[]
4403
4404
[[git-quick-start]]
@@ -4636,6 +4640,10 @@ $ git gc
4640
Appendix B: Notes and todo list for this manual
4641
===============================================
4642
4643
+[[todo-list]]
4644
+Todo list
4645
+---------
4646
+
4647
This is a work in progress.
4648
4649
The basic requirements: