[PATCH] Improve user-manual html and pdf formatting

Use asciidoc style 'article' instead of 'book' and change asciidoc title level.
This removes blank first page and superfluous "Part I" page (there is no "Part II")
in pdf output. Also pdf size is decreased by this from 77 to 67 pages.
In html output this removes unnecessary sub-tocs and chapter numbering.

Signed-off-by: Thomas Ackermann <redacted>
---
 Documentation/Makefile        | 2 +-
 Documentation/user-manual.txt | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/Makefile b/Documentation/Makefile
index 91a12c7..36c58fc 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile

@@ -324,7 +324,7 @@ manpage-base-url.xsl: manpage-base-url.xsl.in
 
 user-manual.xml: user-manual.txt user-manual.conf
 	$(QUIET_ASCIIDOC)$(RM) $@+ $@ && \
-	$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b docbook -d book -o $@+ $< && \
+	$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b docbook -d article -o $@+ $< && \
 	mv $@+ $@
 
 technical/api-index.txt: technical/api-index-skel.txt \

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index cbb01a1..130c2f4 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt

@@ -1,5 +1,5 @@
-Git User Manual
-_______________
+Git User Manual
+===============
 
 Git is a fast distributed revision control system.
 

-- 
1.8.5.2.msysgit.0


---
Thomas

Hi,

Thomas Ackermann wrote:

Why?

Puzzled,
Jonathan

Jonathan Nieder <jrnieder <at> gmail.com> writes:

Hi,

Thomas Ackermann wrote:

quoted

--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
 <at>  <at>  -1,5 +1,5  <at>  <at> 
-Git User Manual
+&#65279;Git User Manual

Why?

Puzzled,
Jonathan

That's a Unicode Byte Order Mark. In UTF-8 it serves no purpose except
to indicate that a file is in fact UTF-8. A job which most editors
don't need help with.

See http://en.wikipedia.org/wiki/Byte_order_mark

Øsse

 
This originally was an UTF8-BOM in user-manual.txt and notepad++ was so clever
not to show it in the patch-file :-| Pasting this into my webmail then produced 
complete rubbish which I didn't noticed ...

----- Original Nachricht ----
Von:     Jonathan Nieder [off-list ref]
An:      Thomas Ackermann [off-list ref]
Datum:   04.01.2014 22:18
Betreff: Re: [PATCH] Improve user-manual html and pdf formatting

Hi,

Thomas Ackermann wrote:

quoted

--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt

@@ -1,5 +1,5 @@
-Git User Manual
+Git User Manual

Why?

Puzzled,
Jonathan

---
Thomas