{"thread":{"id":"35606","subject":"[PATCH] Improve user-manual html and pdf formatting","startedAt":"2014-01-04T09:07:51Z","lastAt":"2014-01-06T17:20:33Z","messageCount":7,"participants":["Thomas Ackermann","Jonathan Nieder","Øystein Walle","Andreas Schwab","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"232644","messageId":"352636633.1492236.1388826471175.JavaMail.ngmail@webmail10.arcor-online.net","threadId":"35606","inReplyTo":null,"subject":"[PATCH] Improve user-manual html and pdf formatting","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2014-01-04T09:07:51Z","receivedAt":"2014-01-04T09:07:51Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nUse asciidoc style 'article' instead of 'book' and change asciidoc title level.\nThis removes blank first page and superfluous \"Part I\" page (there is no \"Part II\")\nin pdf output. Also pdf size is decreased by this from 77 to 67 pages.\nIn html output this removes unnecessary sub-tocs and chapter numbering.\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/Makefile | 2 +-\n Documentation/user-manual.txt | 4 ++--\n 2 files changed, 3 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\nindex 91a12c7..36c58fc 100644\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -324,7 +324,7 @@ manpage-base-url.xsl: manpage-base-url.xsl.in\n \n user-manual.xml: user-manual.txt user-manual.conf\n \t$(QUIET_ASCIIDOC)$(RM) $@+ $@ && \\\n-\t$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b docbook -d book -o $@+ $< && \\\n+\t$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b docbook -d article -o $@+ $< && \\\n \tmv $@+ $@\n \n technical/api-index.txt: technical/api-index-skel.txt \\\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex cbb01a1..130c2f4 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -1,5 +1,5 @@\n-Git User Manual\n-_______________\n+Git User Manual\n+===============\n \n Git is a fast distributed revision control system.\n \n-- \n1.8.5.2.msysgit.0\n\n\n---\nThomas\n"},{"id":"232646","messageId":"20140104211834.GC12251@google.com","threadId":"35606","inReplyTo":"352636633.1492236.1388826471175.JavaMail.ngmail@webmail10.arcor-online.net","subject":"Re: [PATCH] Improve user-manual html and pdf formatting","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2014-01-04T21:18:34Z","receivedAt":"2014-01-04T21:18:34Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Hi,\n\nThomas Ackermann wrote:\n\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1,5 +1,5 @@\n> -Git User Manual\n> +Git User Manual\n\nWhy?\n\nPuzzled,\nJonathan\n"},{"id":"232647","messageId":"loom.20140104T223713-502@post.gmane.org","threadId":"35606","inReplyTo":"20140104211834.GC12251@google.com","subject":"Re: [PATCH] Improve user-manual html and pdf formatting","fromName":"Øystein Walle","fromEmail":"oystwa@gmail.com","sentAt":"2014-01-04T21:38:48Z","receivedAt":"2014-01-04T21:38:48Z","isPatch":true,"sender":{"key":"oystwa@gmail.com","avatar":"https://avatars.githubusercontent.com/u/794585?v=4"},"body":"Jonathan Nieder gmail.com> writes:\n\n> \n> Hi,\n> \n> Thomas Ackermann wrote:\n> \n> > --- a/Documentation/user-manual.txt\n> > +++ b/Documentation/user-manual.txt\n> > -1,5 +1,5 \n> > -Git User Manual\n> > +Git User Manual\n> \n> Why?\n> \n> Puzzled,\n> Jonathan\n> \n\nThat's a Unicode Byte Order Mark. In UTF-8 it serves no purpose except\nto indicate that a file is in fact UTF-8. A job which most editors\ndon't need help with.\n\nSee http://en.wikipedia.org/wiki/Byte_order_mark\n\nØsse\n"},{"id":"232648","messageId":"87lhyv5s79.fsf@igel.home","threadId":"35606","inReplyTo":"loom.20140104T223713-502@post.gmane.org","subject":"Re: [PATCH] Improve user-manual html and pdf formatting","fromName":"Andreas Schwab","fromEmail":"schwab@linux-m68k.org","sentAt":"2014-01-04T21:54:02Z","receivedAt":"2014-01-04T21:54:02Z","isPatch":true,"sender":{"key":"schwab@linux-m68k.org","avatar":"https://avatars.githubusercontent.com/u/2175493?v=4"},"body":"Øystein Walle writes:\n\n> Jonathan Nieder gmail.com> writes:\n>\n>> \n>> Hi,\n>> \n>> Thomas Ackermann wrote:\n>> \n>> > --- a/Documentation/user-manual.txt\n>> > +++ b/Documentation/user-manual.txt\n>> > -1,5 +1,5 \n>> > -Git User Manual\n>> > +Git User Manual\n>> \n>> Why?\n>> \n>> Puzzled,\n>> Jonathan\n>> \n>\n> That's a Unicode Byte Order Mark.\n\nNo, its an ampersand, a hash, a number and a semicolon. Definitely not\na BOM.\n\nAndreas.\n\n-- \nAndreas Schwab, schwab@linux-m68k.org\nGPG Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5\n\"And now for something completely different.\"\n"},{"id":"232650","messageId":"loom.20140104T230716-552@post.gmane.org","threadId":"35606","inReplyTo":"87lhyv5s79.fsf@igel.home","subject":"Re: [PATCH] Improve user-manual html and pdf formatting","fromName":"Øystein Walle","fromEmail":"oystwa@gmail.com","sentAt":"2014-01-04T22:12:00Z","receivedAt":"2014-01-04T22:12:00Z","isPatch":true,"sender":{"key":"oystwa@gmail.com","avatar":"https://avatars.githubusercontent.com/u/794585?v=4"},"body":"Andreas Schwab linux-m68k.org> writes:\n\n> > That's a Unicode Byte Order Mark.\n> \n> No, its an ampersand, a hash, a number and a semicolon. Definitely not\n> a BOM.\n> \n> Andreas.\n> \n\nYou're right, of course :) I was a bit hasty.\n\n#65279; is a HTML entity (or at least something like looks like one) for the\ncharacter U+FEFF, which also serves as the Byte Order Mark. I assume the\nentity was added to the file by mistake.\n\nØsse\n"},{"id":"232660","messageId":"1182656556.701681.1388910150664.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"35606","inReplyTo":"20140104211834.GC12251@google.com","subject":"Aw: Re: [PATCH] Improve user-manual html and pdf formatting","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2014-01-05T08:22:30Z","receivedAt":"2014-01-05T08:22:30Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \nThis originally was an UTF8-BOM in user-manual.txt and notepad++ was so clever\nnot to show it in the patch-file :-| Pasting this into my webmail then produced \ncomplete rubbish which I didn't noticed ...\n\n----- Original Nachricht ----\nVon: Jonathan Nieder \nAn: Thomas Ackermann \nDatum: 04.01.2014 22:18\nBetreff: Re: [PATCH] Improve user-manual html and pdf formatting\n\n> Hi,\n> \n> Thomas Ackermann wrote:\n> \n> > --- a/Documentation/user-manual.txt\n> > +++ b/Documentation/user-manual.txt\n> > @@ -1,5 +1,5 @@\n> > -Git User Manual\n> > +Git User Manual\n> \n> Why?\n> \n> Puzzled,\n> Jonathan\n> \n\n---\nThomas\n"},{"id":"232733","messageId":"xmqqd2k5jace.fsf@gitster.dls.corp.google.com","threadId":"35606","inReplyTo":"352636633.1492236.1388826471175.JavaMail.ngmail@webmail10.arcor-online.net","subject":"Re: [PATCH] Improve user-manual html and pdf formatting","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-01-06T17:20:33Z","receivedAt":"2014-01-06T17:20:33Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Use asciidoc style 'article' instead of 'book' and change asciidoc title level.\n> This removes blank first page and superfluous \"Part I\" page (there is no \"Part II\")\n> in pdf output. Also pdf size is decreased by this from 77 to 67 pages.\n> In html output this removes unnecessary sub-tocs and chapter numbering.\n>\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/Makefile | 2 +-\n> Documentation/user-manual.txt | 4 ++--\n> 2 files changed, 3 insertions(+), 3 deletions(-)\n>\n> diff --git a/Documentation/Makefile b/Documentation/Makefile\n> index 91a12c7..36c58fc 100644\n> --- a/Documentation/Makefile\n> +++ b/Documentation/Makefile\n> @@ -324,7 +324,7 @@ manpage-base-url.xsl: manpage-base-url.xsl.in\n> \n> user-manual.xml: user-manual.txt user-manual.conf\n> \t$(QUIET_ASCIIDOC)$(RM) $@+ $@ && \\\n> -\t$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b docbook -d book -o $@+ $< && \\\n> +\t$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b docbook -d article -o $@+ $< && \\\n> \tmv $@+ $@\n> \n> technical/api-index.txt: technical/api-index-skel.txt \\\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index cbb01a1..130c2f4 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1,5 +1,5 @@\n> -Git User Manual\n> -_______________\n> +Git User Manual\n> +===============\n\nWill queue after dropping the extra.\n\nThanks.\n"}]}