From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 06 Jan 2014 17:20:33 GMT
Subject: Re: [PATCH] Improve user-manual html and pdf formatting
Message-ID: <xmqqd2k5jace.fsf@gitster.dls.corp.google.com>
In-Reply-To: <352636633.1492236.1388826471175.JavaMail.ngmail@webmail10.arcor-online.net>

Thomas Ackermann <th.acker@arcor.de> writes:

> 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 <th.acker@arcor.de>
> ---
>  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
> -_______________
> +&#65279;Git User Manual
> +===============

Will queue after dropping the extra.

Thanks.