* [PATCH] Improve user-manual html and pdf formatting
@ 2014-01-04 9:07 Thomas Ackermann
2014-01-04 21:18 ` Jonathan Nieder
` (2 more replies)
0 siblings, 3 replies; 7+ messages in thread
From: Thomas Ackermann @ 2014-01-04 9:07 UTC (permalink / raw)
To: git; +Cc: gitster
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
-_______________
+Git User Manual
+===============
Git is a fast distributed revision control system.
--
1.8.5.2.msysgit.0
---
Thomas
^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [PATCH] Improve user-manual html and pdf formatting
2014-01-04 9:07 [PATCH] Improve user-manual html and pdf formatting Thomas Ackermann
@ 2014-01-04 21:18 ` Jonathan Nieder
2014-01-04 21:38 ` Øystein Walle
2014-01-05 8:22 ` Aw: " Thomas Ackermann
2014-01-06 17:20 ` Junio C Hamano
2 siblings, 1 reply; 7+ messages in thread
From: Jonathan Nieder @ 2014-01-04 21:18 UTC (permalink / raw)
To: Thomas Ackermann; +Cc: git, gitster
Hi,
Thomas Ackermann wrote:
> --- a/Documentation/user-manual.txt
> +++ b/Documentation/user-manual.txt
> @@ -1,5 +1,5 @@
> -Git User Manual
> +Git User Manual
Why?
Puzzled,
Jonathan
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH] Improve user-manual html and pdf formatting
2014-01-04 21:18 ` Jonathan Nieder
@ 2014-01-04 21:38 ` Øystein Walle
2014-01-04 21:54 ` Andreas Schwab
0 siblings, 1 reply; 7+ messages in thread
From: Øystein Walle @ 2014-01-04 21:38 UTC (permalink / raw)
To: git
Jonathan Nieder <jrnieder <at> gmail.com> writes:
>
> Hi,
>
> Thomas Ackermann wrote:
>
> > --- a/Documentation/user-manual.txt
> > +++ b/Documentation/user-manual.txt
> > <at> <at> -1,5 +1,5 <at> <at>
> > -Git User Manual
> > +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
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH] Improve user-manual html and pdf formatting
2014-01-04 21:38 ` Øystein Walle
@ 2014-01-04 21:54 ` Andreas Schwab
2014-01-04 22:12 ` Øystein Walle
0 siblings, 1 reply; 7+ messages in thread
From: Andreas Schwab @ 2014-01-04 21:54 UTC (permalink / raw)
To: Øystein Walle; +Cc: git
Øystein Walle <oystwa@gmail.com> writes:
> Jonathan Nieder <jrnieder <at> gmail.com> writes:
>
>>
>> Hi,
>>
>> Thomas Ackermann wrote:
>>
>> > --- a/Documentation/user-manual.txt
>> > +++ b/Documentation/user-manual.txt
>> > <at> <at> -1,5 +1,5 <at> <at>
>> > -Git User Manual
>> > +Git User Manual
>>
>> Why?
>>
>> Puzzled,
>> Jonathan
>>
>
> That's a Unicode Byte Order Mark.
No, its an ampersand, a hash, a number and a semicolon. Definitely not
a BOM.
Andreas.
--
Andreas Schwab, schwab@linux-m68k.org
GPG Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5
"And now for something completely different."
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH] Improve user-manual html and pdf formatting
2014-01-04 21:54 ` Andreas Schwab
@ 2014-01-04 22:12 ` Øystein Walle
0 siblings, 0 replies; 7+ messages in thread
From: Øystein Walle @ 2014-01-04 22:12 UTC (permalink / raw)
To: git
Andreas Schwab <schwab <at> linux-m68k.org> writes:
> > That's a Unicode Byte Order Mark.
>
> No, its an ampersand, a hash, a number and a semicolon. Definitely not
> a BOM.
>
> Andreas.
>
You're right, of course :) I was a bit hasty.
#65279; is a HTML entity (or at least something like looks like one) for the
character U+FEFF, which also serves as the Byte Order Mark. I assume the
entity was added to the file by mistake.
Øsse
^ permalink raw reply [flat|nested] 7+ messages in thread
* Aw: Re: [PATCH] Improve user-manual html and pdf formatting
2014-01-04 9:07 [PATCH] Improve user-manual html and pdf formatting Thomas Ackermann
2014-01-04 21:18 ` Jonathan Nieder
@ 2014-01-05 8:22 ` Thomas Ackermann
2014-01-06 17:20 ` Junio C Hamano
2 siblings, 0 replies; 7+ messages in thread
From: Thomas Ackermann @ 2014-01-05 8:22 UTC (permalink / raw)
To: jrnieder, th.acker; +Cc: git, gitster
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 <jrnieder@gmail.com>
An: Thomas Ackermann <th.acker@arcor.de>
Datum: 04.01.2014 22:18
Betreff: Re: [PATCH] Improve user-manual html and pdf formatting
> Hi,
>
> Thomas Ackermann wrote:
>
> > --- a/Documentation/user-manual.txt
> > +++ b/Documentation/user-manual.txt
> > @@ -1,5 +1,5 @@
> > -Git User Manual
> > +Git User Manual
>
> Why?
>
> Puzzled,
> Jonathan
>
---
Thomas
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH] Improve user-manual html and pdf formatting
2014-01-04 9:07 [PATCH] Improve user-manual html and pdf formatting Thomas Ackermann
2014-01-04 21:18 ` Jonathan Nieder
2014-01-05 8:22 ` Aw: " Thomas Ackermann
@ 2014-01-06 17:20 ` Junio C Hamano
2 siblings, 0 replies; 7+ messages in thread
From: Junio C Hamano @ 2014-01-06 17:20 UTC (permalink / raw)
To: Thomas Ackermann; +Cc: git
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
> -_______________
> +Git User Manual
> +===============
Will queue after dropping the extra.
Thanks.
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2014-01-06 17:20 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-01-04 9:07 [PATCH] Improve user-manual html and pdf formatting Thomas Ackermann
2014-01-04 21:18 ` Jonathan Nieder
2014-01-04 21:38 ` Øystein Walle
2014-01-04 21:54 ` Andreas Schwab
2014-01-04 22:12 ` Øystein Walle
2014-01-05 8:22 ` Aw: " Thomas Ackermann
2014-01-06 17:20 ` Junio C Hamano
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.