{"thread":{"id":"31741","subject":"[Patch 0/5] Create single PDF for all HTML files","startedAt":"2012-10-06T15:51:15Z","lastAt":"2012-10-15T20:49:12Z","messageCount":23,"participants":["Thomas Ackermann","Junio C Hamano","Philip Oakley","Jeff King","Michael J Gruber"],"isPatch":true,"patchVersion":1,"patchTotal":5},"messages":[{"id":"200669","messageId":"505841759.269631.1349538675925.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"31741","inReplyTo":null,"subject":"[Patch 0/5] Create single PDF for all HTML files","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-06T15:51:15Z","receivedAt":"2012-10-06T15:51:15Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"Hi,\n\nI wanted to have a single PDF file which contains the complete Git documentation \n(except user-manual) for easier reading on my tablet. The simplest way to do \nthis was by using wkhtmltopdf which can combine a set of HTML files into a sinlge \nPDF file and also apply some reformatting. To this end HTML files for all the missing \nfiles in Documentation/technical and Documentation/howto and also for all the \nrelease notes in Documentation/RelNotes were created. \nThe resulting PDF file \"git-doc.pdf\" is created by a new make target called \"fullpdf\".\n\nHope anybody finds that useful.\n\n\n---\nThomas\n"},{"id":"200670","messageId":"244418682.269701.1349538839518.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"31741","inReplyTo":"505841759.269631.1349538675925.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[Patch 1/5] Fix some asciidoc layout problems","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-06T15:53:59Z","receivedAt":"2012-10-06T15:53:59Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nSigned-off-by: Thomas Ackermann \n---\n Documentation/git-bisect-lk2009.txt | 12 ++++++------\n Documentation/git-fetch-pack.txt | 5 ++++-\n 2 files changed, 10 insertions(+), 7 deletions(-)\n\ndiff --git a/Documentation/git-bisect-lk2009.txt b/Documentation/git-bisect-lk2009.txt\nindex 8a2ba37..99bdb46 100644\n--- a/Documentation/git-bisect-lk2009.txt\n+++ b/Documentation/git-bisect-lk2009.txt\n@@ -248,7 +248,7 @@ Bisecting: 5480 revisions left to test after this (roughly 13 steps)\n And after a few more steps like that, \"git bisect\" will eventually\n find a first bad commit:\n \n--------------\n+------------------------------------------------------------------------------------------------------------\n $ git bisect bad\n 2ddcca36c8bcfa251724fe342c8327451988be0d is the first bad commit\n commit 2ddcca36c8bcfa251724fe342c8327451988be0d\n@@ -257,8 +257,8 @@ Date: Sat May 3 11:59:44 2008 -0700\n \n Linux 2.6.26-rc1\n \n-:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n--------------\n+:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n+------------------------------------------------------------------------------------------------------------\n \n At this point we can see what the commit does, check it out (if it's\n not already checked out) or tinker with it, for example:\n@@ -305,7 +305,7 @@ to launch a script or command at each bisection step to know if the\n current commit is \"good\" or \"bad\". To do that, we use the \"git bisect\n run\" command. For example:\n \n--------------\n+------------------------------------------------------------------------------------------------------------\n $ git bisect start v2.6.27 v2.6.25\n Bisecting: 10928 revisions left to test after this (roughly 14 steps)\n [2ec65f8b89ea003c27ff7723525a2ee335a2b393] x86: clean up using max_low_pfn on 32-bit\n@@ -331,9 +331,9 @@ Date: Sat May 3 11:59:44 2008 -0700\n \n Linux 2.6.26-rc1\n \n-:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n+:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n bisect run success\n--------------\n+------------------------------------------------------------------------------------------------------------\n \n In this example, we passed \"grep '^SUBLEVEL = 25' Makefile\" as\n parameter to \"git bisect run\". This means that at each step, the grep\ndiff --git a/Documentation/git-fetch-pack.txt b/Documentation/git-fetch-pack.txt\nindex 474fa30..12cd8a2 100644\n--- a/Documentation/git-fetch-pack.txt\n+++ b/Documentation/git-fetch-pack.txt\n@@ -9,7 +9,10 @@ git-fetch-pack - Receive missing objects from another repository\n SYNOPSIS\n --------\n [verse]\n-'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] [--upload-pack=] [--depth=] [--no-progress] [-v] [:] [...]\n+'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] \n+\t\t\t\t[--upload-pack=] \n+\t\t\t\t[--depth=] [--no-progress] \n+\t\t\t\t[-v] [:] [...]\n \n DESCRIPTION\n -----------\n-- \n1.7.11.msysgit.1\n"},{"id":"200671","messageId":"652323221.269712.1349538906380.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"31741","inReplyTo":"505841759.269631.1349538675925.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[Patch 2/5] Create html documents for all files in Documentation/technical","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-06T15:55:06Z","receivedAt":"2012-10-06T15:55:06Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"- add missing files\n- fix some asciidoc layout problems\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/Makefile | 12 ++++++++++-\n Documentation/technical/index-format.txt | 2 +-\n Documentation/technical/pack-format.txt | 8 +++----\n Documentation/technical/pack-protocol.txt | 7 +++---\n Documentation/technical/shallow.txt | 8 ++++++-\n Documentation/technical/trivial-merge.txt | 36 +++++++++++++++----------------\n 6 files changed, 45 insertions(+), 28 deletions(-)\n\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\nindex 267dfe1..86594f6 100644\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -25,6 +25,16 @@ SP_ARTICLES += howto/revert-branch-rebase\n SP_ARTICLES += howto/using-merge-subtree\n SP_ARTICLES += howto/using-signed-tag-in-pull-request\n API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt)))\n+API_DOCS += technical/index-format\n+API_DOCS += technical/pack-format\n+API_DOCS += technical/pack-heuristics\n+API_DOCS += technical/pack-protocol\n+API_DOCS += technical/protocol-capabilities\n+API_DOCS += technical/protocol-common\n+API_DOCS += technical/racy-git\n+API_DOCS += technical/send-pack-pipeline\n+API_DOCS += technical/shallow\n+API_DOCS += technical/trivial-merge\n SP_ARTICLES += $(API_DOCS)\n SP_ARTICLES += technical/api-index\n \n@@ -231,7 +241,7 @@ clean:\n \t$(RM) *.texi *.texi+ *.texi++ git.info gitman.info\n \t$(RM) *.pdf\n \t$(RM) howto-index.txt howto/*.html doc.dep\n-\t$(RM) technical/api-*.html technical/api-index.txt\n+\t$(RM) technical/*.html technical/api-index.txt\n \t$(RM) $(cmds_txt) *.made\n \t$(RM) manpage-base-url.xsl\n \ndiff --git a/Documentation/technical/index-format.txt b/Documentation/technical/index-format.txt\nindex 9d25b30..57d6f91 100644\n--- a/Documentation/technical/index-format.txt\n+++ b/Documentation/technical/index-format.txt\n@@ -1,7 +1,7 @@\n GIT index format\n ================\n \n-= The git index file has the following format\n+== The git index file has the following format\n \n All binary numbers are in network byte order. Version 2 is described\n here unless stated otherwise.\ndiff --git a/Documentation/technical/pack-format.txt b/Documentation/technical/pack-format.txt\nindex 1803e64..a7871fb 100644\n--- a/Documentation/technical/pack-format.txt\n+++ b/Documentation/technical/pack-format.txt\n@@ -1,7 +1,7 @@\n GIT pack format\n ===============\n \n-= pack-*.pack files have the following format:\n+== pack-*.pack files have the following format:\n \n - A header appears at the beginning and consists of the following:\n \n@@ -34,7 +34,7 @@ GIT pack format\n \n - The trailer records 20-byte SHA1 checksum of all of the above.\n \n-= Original (version 1) pack-*.idx files have the following format:\n+== Original (version 1) pack-*.idx files have the following format:\n \n - The header consists of 256 4-byte network byte order\n integers. N-th entry of this table records the number of\n@@ -123,8 +123,8 @@ Pack file entry: <+\n \n \n \n-= Version 2 pack-*.idx files support packs larger than 4 GiB, and\n- have some other reorganizations. They have the format:\n+== Version 2 pack-*.idx files support packs larger than 4 GiB, and\n+ have some other reorganizations. They have the format:\n \n - A 4-byte magic number '\\377tOc' which is an unreasonable\n fanout[0] value.\ndiff --git a/Documentation/technical/pack-protocol.txt b/Documentation/technical/pack-protocol.txt\nindex d51e20f..25e1fbe 100644\n--- a/Documentation/technical/pack-protocol.txt\n+++ b/Documentation/technical/pack-protocol.txt\n@@ -117,7 +117,7 @@ A few things to remember here:\n - The repository path is always quoted with single quotes.\n \n Fetching Data From a Server\n-===========================\n+---------------------------\n \n When one Git repository wants to get data that a second repository\n has, the first can 'fetch' from the second. This operation determines\n@@ -134,7 +134,8 @@ with the object name that each reference currently points to.\n \n $ echo -e -n \"0039git-upload-pack /schacon/gitbook.git\\0host=example.com\\0\" |\n nc -v example.com 9418\n- 00887217a7c7e582c46cec22a130adf4b9d7d950fba0 HEAD\\0multi_ack thin-pack side-band side-band-64k ofs-delta shallow no-progress include-tag\n+ 00887217a7c7e582c46cec22a130adf4b9d7d950fba0 HEAD\\0multi_ack thin-pack \n+ side-band side-band-64k ofs-delta shallow no-progress include-tag\n 00441d3fcd5ced445d1abc402225c0b8a1299641f497 refs/heads/integration\n 003f7217a7c7e582c46cec22a130adf4b9d7d950fba0 refs/heads/master\n 003cb88d2441cac0977faf98efc80305012112238d9d refs/tags/v0.9\n@@ -421,7 +422,7 @@ entire packfile without multiplexing.\n \n \n Pushing Data To a Server\n-========================\n+------------------------\n \n Pushing data to a server will invoke the 'receive-pack' process on the\n server, which will allow the client to tell it which references it should\ndiff --git a/Documentation/technical/shallow.txt b/Documentation/technical/shallow.txt\nindex 559263a..0502a54 100644\n--- a/Documentation/technical/shallow.txt\n+++ b/Documentation/technical/shallow.txt\n@@ -1,6 +1,12 @@\n-Def.: Shallow commits do have parents, but not in the shallow\n+Shallow commits\n+===============\n+\n+.Definition\n+*********************************************************\n+Shallow commits do have parents, but not in the shallow\n repo, and therefore grafts are introduced pretending that\n these commits have no parents.\n+*********************************************************\n \n The basic idea is to write the SHA1s of shallow commits into\n $GIT_DIR/shallow, and handle its contents like the contents\ndiff --git a/Documentation/technical/trivial-merge.txt b/Documentation/technical/trivial-merge.txt\nindex 24c8410..c79d4a7 100644\n--- a/Documentation/technical/trivial-merge.txt\n+++ b/Documentation/technical/trivial-merge.txt\n@@ -74,24 +74,24 @@ For multiple ancestors, a '+' means that this case applies even if\n only one ancestor or remote fits; a '^' means all of the ancestors\n must be the same.\n \n-case ancest head remote result\n-----------------------------------------\n-1 (empty)+ (empty) (empty) (empty)\n-2ALT (empty)+ *empty* remote remote\n-2 (empty)^ (empty) remote no merge\n-3ALT (empty)+ head *empty* head\n-3 (empty)^ head (empty) no merge\n-4 (empty)^ head remote no merge\n-5ALT * head head head\n-6 ancest+ (empty) (empty) no merge\n-8 ancest^ (empty) ancest no merge\n-7 ancest+ (empty) remote no merge\n-10 ancest^ ancest (empty) no merge\n-9 ancest+ head (empty) no merge\n-16 anc1/anc2 anc1 anc2 no merge\n-13 ancest+ head ancest head\n-14 ancest+ ancest remote remote\n-11 ancest+ head remote no merge\n+ case ancest head remote result\n+ ----------------------------------------\n+ 1 (empty)+ (empty) (empty) (empty)\n+ 2ALT (empty)+ *empty* remote remote\n+ 2 (empty)^ (empty) remote no merge\n+ 3ALT (empty)+ head *empty* head\n+ 3 (empty)^ head (empty) no merge\n+ 4 (empty)^ head remote no merge\n+ 5ALT * head head head\n+ 6 ancest+ (empty) (empty) no merge\n+ 8 ancest^ (empty) ancest no merge\n+ 7 ancest+ (empty) remote no merge\n+ 10 ancest^ ancest (empty) no merge\n+ 9 ancest+ head (empty) no merge\n+ 16 anc1/anc2 anc1 anc2 no merge\n+ 13 ancest+ head ancest head\n+ 14 ancest+ ancest remote remote\n+ 11 ancest+ head remote no merge\n \n Only #2ALT and #3ALT use *empty*, because these are the only cases\n where there can be conflicts that didn't exist before. Note that we\n-- \n1.7.11.msysgit.1\n"},{"id":"200672","messageId":"343092834.269729.1349538958985.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"31741","inReplyTo":"505841759.269631.1349538675925.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[Patch 3/5] Create html documents for all files in Documentation/RelNotes","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-06T15:55:58Z","receivedAt":"2012-10-06T15:55:58Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"- create html for all release note files\n- fix some asciidoc layout problems\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/Makefile | 2 ++\n Documentation/RelNotes/1.5.2.1.txt | 6 ------\n Documentation/RelNotes/1.6.0.2.txt | 6 ------\n Documentation/RelNotes/1.6.1.3.txt | 4 ----\n Documentation/RelNotes/1.6.1.4.txt | 3 ---\n Documentation/RelNotes/1.6.1.txt | 6 ------\n 6 files changed, 2 insertions(+), 25 deletions(-)\n\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\nindex 86594f6..80eb06d 100644\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -24,6 +24,7 @@ SP_ARTICLES = user-manual\n SP_ARTICLES += howto/revert-branch-rebase\n SP_ARTICLES += howto/using-merge-subtree\n SP_ARTICLES += howto/using-signed-tag-in-pull-request\n+RELNOTES = $(patsubst %.txt,%,$(wildcard RelNotes/*.txt))\n API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt)))\n API_DOCS += technical/index-format\n API_DOCS += technical/pack-format\n@@ -35,6 +36,7 @@ API_DOCS += technical/racy-git\n API_DOCS += technical/send-pack-pipeline\n API_DOCS += technical/shallow\n API_DOCS += technical/trivial-merge\n+API_DOCS += $(RELNOTES)\n SP_ARTICLES += $(API_DOCS)\n SP_ARTICLES += technical/api-index\n \ndiff --git a/Documentation/RelNotes/1.5.2.1.txt b/Documentation/RelNotes/1.5.2.1.txt\nindex ebf20e2..d41984d 100644\n--- a/Documentation/RelNotes/1.5.2.1.txt\n+++ b/Documentation/RelNotes/1.5.2.1.txt\n@@ -45,9 +45,3 @@ Fixes since v1.5.2\n - git-fastimport --import-marks was broken; fixed.\n \n - A lot of documentation updates, clarifications and fixes.\n-\n---\n-exec >/var/tmp/1\n-O=v1.5.2-65-g996e2d6\n-echo O=`git describe refs/heads/maint`\n-git shortlog --no-merges $O..refs/heads/maint\ndiff --git a/Documentation/RelNotes/1.6.0.2.txt b/Documentation/RelNotes/1.6.0.2.txt\nindex e1e24b3..7d8fb85 100644\n--- a/Documentation/RelNotes/1.6.0.2.txt\n+++ b/Documentation/RelNotes/1.6.0.2.txt\n@@ -79,9 +79,3 @@ Fixes since v1.6.0.1\n packfile.\n \n Also contains many documentation updates.\n-\n---\n-exec >/var/tmp/1\n-O=v1.6.0.1-78-g3632cfc\n-echo O=$(git describe maint)\n-git shortlog --no-merges $O..maint\ndiff --git a/Documentation/RelNotes/1.6.1.3.txt b/Documentation/RelNotes/1.6.1.3.txt\nindex 6f0bde1..cd08d81 100644\n--- a/Documentation/RelNotes/1.6.1.3.txt\n+++ b/Documentation/RelNotes/1.6.1.3.txt\n@@ -26,7 +26,3 @@ Fixes since v1.6.1.2\n * RPM binary package installed the html manpages in a wrong place.\n \n Also includes minor documentation fixes and updates.\n-\n-\n---\n-git shortlog --no-merges v1.6.1.2-33-gc789350..\ndiff --git a/Documentation/RelNotes/1.6.1.4.txt b/Documentation/RelNotes/1.6.1.4.txt\nindex 0ce6316..ccbad79 100644\n--- a/Documentation/RelNotes/1.6.1.4.txt\n+++ b/Documentation/RelNotes/1.6.1.4.txt\n@@ -39,6 +39,3 @@ Fixes since v1.6.1.3\n This fix was first merged to 1.6.2.3.\n \n Also includes minor documentation fixes and updates.\n-\n---\n-git shortlog --no-merges v1.6.1.3..\ndiff --git a/Documentation/RelNotes/1.6.1.txt b/Documentation/RelNotes/1.6.1.txt\nindex adb7cca..7b152a6 100644\n--- a/Documentation/RelNotes/1.6.1.txt\n+++ b/Documentation/RelNotes/1.6.1.txt\n@@ -278,9 +278,3 @@ release, unless otherwise noted.\n \n * \"gitweb\" did not mark non-ASCII characters imported from external HTML fragments\n correctly.\n-\n---\n-exec >/var/tmp/1\n-O=v1.6.1-rc3-74-gf66bc5f\n-echo O=$(git describe master)\n-git shortlog --no-merges $O..master ^maint\n-- \n1.7.11.msysgit.1\n"},{"id":"200673","messageId":"459552956.269766.1349539025462.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"31741","inReplyTo":"505841759.269631.1349538675925.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[Patch 4/5] Create html documents for all files in Documentation/howto","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-06T15:57:05Z","receivedAt":"2012-10-06T15:57:05Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"- add missing files\n- fix some asciidoc layout problems\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/Makefile | 10 +++++\n Documentation/howto/maintain-git.txt | 4 ++\n .../howto/rebase-from-internal-branch.txt | 11 ++---\n Documentation/howto/rebuild-from-update-hook.txt | 4 ++\n .../howto/recover-corrupted-blob-object.txt | 10 +++++\n Documentation/howto/revert-a-faulty-merge.txt | 4 ++\n Documentation/howto/separating-topic-branches.txt | 4 ++\n Documentation/howto/setup-git-server-over-http.txt | 4 ++\n Documentation/howto/update-hook-example.txt | 50 +++++++++++-----------\n Documentation/howto/use-git-daemon.txt | 3 ++\n .../howto/using-signed-tag-in-pull-request.txt | 4 +-\n 11 files changed, 76 insertions(+), 32 deletions(-)\n\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\nindex 80eb06d..abd27b5 100644\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -24,6 +24,16 @@ SP_ARTICLES = user-manual\n SP_ARTICLES += howto/revert-branch-rebase\n SP_ARTICLES += howto/using-merge-subtree\n SP_ARTICLES += howto/using-signed-tag-in-pull-request\n+SP_ARTICLES += howto/use-git-daemon\n+SP_ARTICLES += howto/update-hook-example\n+SP_ARTICLES += howto/setup-git-server-over-http\n+SP_ARTICLES += howto/separating-topic-branches\n+SP_ARTICLES += howto/revert-a-faulty-merge\n+SP_ARTICLES += howto/recover-corrupted-blob-object\n+SP_ARTICLES += howto/rebuild-from-update-hook\n+SP_ARTICLES += howto/rebuild-from-update-hook\n+SP_ARTICLES += howto/rebase-from-internal-branch\n+SP_ARTICLES += howto/maintain-git\n RELNOTES = $(patsubst %.txt,%,$(wildcard RelNotes/*.txt))\n API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt)))\n API_DOCS += technical/index-format\ndiff --git a/Documentation/howto/maintain-git.txt b/Documentation/howto/maintain-git.txt\nindex 8823a37..58fd809 100644\n--- a/Documentation/howto/maintain-git.txt\n+++ b/Documentation/howto/maintain-git.txt\n@@ -5,6 +5,10 @@ Abstract: Imagine that git development is racing along as usual, when our friend\n neighborhood maintainer is struck down by a wayward bus. Out of the\n hordes of suckers (loyal developers), you have been tricked (chosen) to\n step up as the new maintainer. This howto will show you \"how to\" do it.\n+Content-type: text/asciidoc\n+\n+Maintain Git\n+============\n \n The maintainer's git time is spent on three activities.\n \ndiff --git a/Documentation/howto/rebase-from-internal-branch.txt b/Documentation/howto/rebase-from-internal-branch.txt\nindex 74a1c0c..577b9a7 100644\n--- a/Documentation/howto/rebase-from-internal-branch.txt\n+++ b/Documentation/howto/rebase-from-internal-branch.txt\n@@ -8,7 +8,12 @@ Abstract: In this article, JC talks about how he rebases the\n the \"master\" branch, and how \"rebase\" works. Also discussed\n is how this applies to individual developers who sends patches\n upstream.\n+Content-type: text/asciidoc\n \n+Rebase from internal branch\n+===========================\n+\n+--------------------------------------\n Petr Baudis writes:\n \n > Dear diary, on Sun, Aug 14, 2005 at 09:57:13AM CEST, I got a letter\n@@ -19,6 +24,7 @@ Petr Baudis writes:\n >> > branch to the real branches.\n >>\n > Actually, wouldn't this be also precisely for what StGIT is intended to?\n+--------------------------------------\n \n Exactly my feeling. I was sort of waiting for Catalin to speak\n up. With its basing philosophical ancestry on quilt, this is\n@@ -156,8 +162,3 @@ you continue on starting from the new \"master\" head, which is\n the #1' commit.\n \n -jc\n-\n--\n-To unsubscribe from this list: send the line \"unsubscribe git\" in\n-the body of a message to majordomo@vger.kernel.org\n-More majordomo info at http://vger.kernel.org/majordomo-info.html\ndiff --git a/Documentation/howto/rebuild-from-update-hook.txt b/Documentation/howto/rebuild-from-update-hook.txt\nindex 48c6756..7aa13ac 100644\n--- a/Documentation/howto/rebuild-from-update-hook.txt\n+++ b/Documentation/howto/rebuild-from-update-hook.txt\n@@ -5,6 +5,10 @@ Date: Fri, 26 Aug 2005 18:19:10 -0700\n Abstract: In this how-to article, JC talks about how he\n uses the post-update hook to automate git documentation page\n shown at http://www.kernel.org/pub/software/scm/git/docs/.\n+Content-type: text/asciidoc\n+\n+Rebuild from update hook\n+========================\n \n The pages under http://www.kernel.org/pub/software/scm/git/docs/\n are built from Documentation/ directory of the git.git project\ndiff --git a/Documentation/howto/recover-corrupted-blob-object.txt b/Documentation/howto/recover-corrupted-blob-object.txt\nindex 323b513..2af4ad7 100644\n--- a/Documentation/howto/recover-corrupted-blob-object.txt\n+++ b/Documentation/howto/recover-corrupted-blob-object.txt\n@@ -3,11 +3,17 @@ From: Linus Torvalds \n Subject: corrupt object on git-gc\n Abstract: Some tricks to reconstruct blob objects in order to fix\n a corrupted repository.\n+Content-type: text/asciidoc\n \n+Recover corrupted blob object\n+=============================\n+\n+-----------------------------------------------------------\n On Fri, 9 Nov 2007, Yossi Leybovich wrote:\n >\n > Did not help still the repository look for this object?\n > Any one know how can I track this object and understand which file is it\n+-----------------------------------------------------------\n \n So exactly *because* the SHA1 hash is cryptographically secure, the hash\n itself doesn't actually tell you anything, in order to fix a corrupt\n@@ -31,19 +37,23 @@ original object, so right now the corrupt object is useless, but it's very\n interesting for the future, in the hope that you can re-create a\n non-corrupt version.\n \n+-----------------------------------------------------------\n So:\n \n > ib]$ mv .git/objects/4b/9458b3786228369c63936db65827de3cc06200 ../\n+-----------------------------------------------------------\n \n This is the right thing to do, although it's usually best to save it under\n it's full SHA1 name (you just dropped the \"4b\" from the result ;).\n \n Let's see what that tells us:\n \n+-----------------------------------------------------------\n > ib]$ git-fsck --full\n > broken link from tree 2d9263c6d23595e7cb2a21e5ebbb53655278dff8\n > to blob 4b9458b3786228369c63936db65827de3cc06200\n > missing blob 4b9458b3786228369c63936db65827de3cc06200\n+-----------------------------------------------------------\n \n Ok, I removed the \"dangling commit\" messages, because they are just\n messages about the fact that you probably have rebased etc, so they're not\ndiff --git a/Documentation/howto/revert-a-faulty-merge.txt b/Documentation/howto/revert-a-faulty-merge.txt\nindex 6fd7119..936c3a9 100644\n--- a/Documentation/howto/revert-a-faulty-merge.txt\n+++ b/Documentation/howto/revert-a-faulty-merge.txt\n@@ -7,6 +7,10 @@ Abstract: Sometimes a branch that was already merged to the mainline\n after the offending branch is fixed.\n Message-ID: <7vocz8a6zk.fsf@gitster.siamese.dyndns.org>\n References: \n+Content-type: text/asciidoc\n+\n+Revert a faulty merge\n+=====================\n \n Alan said:\n \ndiff --git a/Documentation/howto/separating-topic-branches.txt b/Documentation/howto/separating-topic-branches.txt\nindex 6d3eb8e..17c1602 100644\n--- a/Documentation/howto/separating-topic-branches.txt\n+++ b/Documentation/howto/separating-topic-branches.txt\n@@ -1,6 +1,10 @@\n From: Junio C Hamano \n Subject: Separating topic branches\n Abstract: In this article, JC describes how to separate topic branches.\n+Content-type: text/asciidoc\n+\n+Separating topic branches\n+=========================\n \n This text was originally a footnote to a discussion about the\n behaviour of the git diff commands.\ndiff --git a/Documentation/howto/setup-git-server-over-http.txt b/Documentation/howto/setup-git-server-over-http.txt\nindex 622ee5c..69dab4b 100644\n--- a/Documentation/howto/setup-git-server-over-http.txt\n+++ b/Documentation/howto/setup-git-server-over-http.txt\n@@ -1,6 +1,10 @@\n From: Rutger Nijlunsing \n Subject: Setting up a git repository which can be pushed into and pulled from over HTTP(S).\n Date: Thu, 10 Aug 2006 22:00:26 +0200\n+Content-type: text/asciidoc\n+\n+Setup git server over http\n+==========================\n \n Since Apache is one of those packages people like to compile\n themselves while others prefer the bureaucrat's dream Debian, it is\ndiff --git a/Documentation/howto/update-hook-example.txt b/Documentation/howto/update-hook-example.txt\nindex b7f8d41..063d967 100644\n--- a/Documentation/howto/update-hook-example.txt\n+++ b/Documentation/howto/update-hook-example.txt\n@@ -5,6 +5,10 @@ Message-ID: <7vfypumlu3.fsf@assigned-by-dhcp.cox.net>\n Abstract: An example hooks/update script is presented to\n implement repository maintenance policies, such as who can push\n into which branch and who can make a tag.\n+Content-type: text/asciidoc\n+\n+Update hook example\n+===================\n \n When your developer runs git-push into the repository,\n git-receive-pack is run (either locally or over ssh) as that\n@@ -32,8 +36,7 @@ like this as your hooks/update script.\n [jc: editorial note. This is a much improved version by Carl\n since I posted the original outline]\n \n--- >8 -- beginning of script -- >8 --\n-\n+----------------------------------------------------\n #!/bin/bash\n \n umask 002\n@@ -111,12 +114,12 @@ then\n \n info \"Found matching head pattern: '$head_pattern'\"\n for user_pattern in $user_patterns; do\n-\tinfo \"Checking user: '$username' against pattern: '$user_pattern'\"\n-\tmatchlen=$(expr \"$username\" : \"$user_pattern\")\n-\tif test \"$matchlen\" = \"${#username}\"\n-\tthen\n-\t grant \"Allowing user: '$username' with pattern: '$user_pattern'\"\n-\tfi\n+\t info \"Checking user: '$username' against pattern: '$user_pattern'\"\n+\t matchlen=$(expr \"$username\" : \"$user_pattern\")\n+\t if test \"$matchlen\" = \"${#username}\"\n+\t then\n+\t grant \"Allowing user: '$username' with pattern: '$user_pattern'\"\n+\t fi\n done\n deny \"The user is not in the access list for this branch\"\n done\n@@ -149,13 +152,13 @@ then\n \n info \"Found matching head pattern: '$head_pattern'\"\n for group_pattern in $group_patterns; do\n-\tfor groupname in $groups; do\n-\t info \"Checking group: '$groupname' against pattern: '$group_pattern'\"\n-\t matchlen=$(expr \"$groupname\" : \"$group_pattern\")\n-\t if test \"$matchlen\" = \"${#groupname}\"\n-\t then\n-\t grant \"Allowing group: '$groupname' with pattern: '$group_pattern'\"\n-\t fi\n+\t for groupname in $groups; do\n+\t info \"Checking group: '$groupname' against pattern: '$group_pattern'\"\n+\t matchlen=$(expr \"$groupname\" : \"$group_pattern\")\n+\t if test \"$matchlen\" = \"${#groupname}\"\n+\t then\n+\t grant \"Allowing group: '$groupname' with pattern: '$group_pattern'\"\n+\t fi\n done\n done\n deny \"None of the user's groups are in the access list for this branch\"\n@@ -169,24 +172,21 @@ then\n fi\n \n deny >/dev/null \"There are no more rules to check. Denying access\"\n-\n--- >8 -- end of script -- >8 --\n+----------------------------------------------------\n \n This uses two files, $GIT_DIR/info/allowed-users and\n allowed-groups, to describe which heads can be pushed into by\n whom. The format of each file would look like this:\n \n- refs/heads/master\tjunio\n-\t+refs/heads/pu\t\tjunio\n- refs/heads/cogito$\tpasky\n- refs/heads/bw/.*\tlinus\n- refs/heads/tmp/.*\t.*\n- refs/tags/v[0-9].*\tjunio\n+ refs/heads/master junio\n+ +refs/heads/pu junio\n+ refs/heads/cogito$ pasky\n+ refs/heads/bw/.* linus\n+ refs/heads/tmp/.* .*\n+ refs/tags/v[0-9].* junio\n \n With this, Linus can push or create \"bw/penguin\" or \"bw/zebra\"\n or \"bw/panda\" branches, Pasky can do only \"cogito\", and JC can\n do master and pu branches and make versioned tags. And anybody\n can do tmp/blah branches. The '+' sign at the pu record means\n that JC can make non-fast-forward pushes on it.\n-\n-------------\ndiff --git a/Documentation/howto/use-git-daemon.txt b/Documentation/howto/use-git-daemon.txt\nindex 4e2f75c..23cdf35 100644\n--- a/Documentation/howto/use-git-daemon.txt\n+++ b/Documentation/howto/use-git-daemon.txt\n@@ -1,4 +1,7 @@\n+Content-type: text/asciidoc\n+\n How to use git-daemon\n+=====================\n \n Git can be run in inetd mode and in stand alone mode. But all you want is\n let a coworker pull from you, and therefore need to set up a git server\ndiff --git a/Documentation/howto/using-signed-tag-in-pull-request.txt b/Documentation/howto/using-signed-tag-in-pull-request.txt\nindex 98c0033..7670449 100644\n--- a/Documentation/howto/using-signed-tag-in-pull-request.txt\n+++ b/Documentation/howto/using-signed-tag-in-pull-request.txt\n@@ -7,8 +7,8 @@ Abstract: Beginning v1.7.9, a contributor can push a signed tag to her\n later validate it.\n Content-type: text/asciidoc\n \n-Using signed tag in pull requests\n-=================================\n+Using signed tag in pull request\n+================================\n \n A typical distributed workflow using Git is for a contributor to fork a\n project, build on it, publish the result to her public repository, and ask\n-- \n1.7.11.msysgit.1\n"},{"id":"200674","messageId":"1206625172.269796.1349539081024.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"31741","inReplyTo":"505841759.269631.1349538675925.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[Patch 5/5] Create pdf from all html files","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-06T15:58:01Z","receivedAt":"2012-10-06T15:58:01Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"- use wkhtmltopdf to combine all html files into a single pdf file \"git-doc.pdf\"\n- provide make target \"fullpdf\" to create \"git-doc.pdf\"\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/.gitignore | 1 +\n Documentation/Makefile | 9 +++++++++\n Documentation/footerend.txt | 4 ++++\n Documentation/footerstart.txt | 7 +++++++\n Documentation/makedocpdf.sh | 25 +++++++++++++++++++++++++\n Makefile | 6 ++++++\n 6 files changed, 52 insertions(+)\n create mode 100644 Documentation/footerend.txt\n create mode 100644 Documentation/footerstart.txt\n create mode 100644 Documentation/makedocpdf.sh\n\ndiff --git a/Documentation/.gitignore b/Documentation/.gitignore\nindex d62aebd..fba4730 100644\n--- a/Documentation/.gitignore\n+++ b/Documentation/.gitignore\n@@ -10,3 +10,4 @@ howto-index.txt\n doc.dep\n cmds-*.txt\n manpage-base-url.xsl\n+docfiles.txt\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\nindex abd27b5..c4c2a30 100644\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -189,6 +189,9 @@ info: git.info gitman.info\n \n pdf: user-manual.pdf\n \n+fullpdf: pdf all\n+\t./makedocpdf.sh\n+\n install: install-man\n \n install-man: man\n@@ -213,6 +216,10 @@ install-pdf: pdf\n \t$(INSTALL) -d -m 755 $(DESTDIR)$(pdfdir)\n \t$(INSTALL) -m 644 user-manual.pdf $(DESTDIR)$(pdfdir)\n \n+install-fullpdf: fullpdf install-pdf\n+\t$(INSTALL) -d -m 755 $(DESTDIR)$(pdfdir)\n+\t$(INSTALL) -m 644 git-doc.pdf $(DESTDIR)$(pdfdir)\n+\n install-html: html\n \t'$(SHELL_PATH_SQ)' ./install-webdoc.sh $(DESTDIR)$(htmldir)\n \n@@ -252,6 +259,8 @@ clean:\n \t$(RM) *.xml *.xml+ *.html *.html+ *.1 *.5 *.7\n \t$(RM) *.texi *.texi+ *.texi++ git.info gitman.info\n \t$(RM) *.pdf\n+\t$(RM) docfiles.txt\n+\t$(RM) RelNotes/*.html\n \t$(RM) howto-index.txt howto/*.html doc.dep\n \t$(RM) technical/*.html technical/api-index.txt\n \t$(RM) $(cmds_txt) *.made\ndiff --git a/Documentation/footerend.txt b/Documentation/footerend.txt\nnew file mode 100644\nindex 0000000..ed16923\n--- /dev/null\n+++ b/Documentation/footerend.txt\n@@ -0,0 +1,4 @@\n+ \n+ \n+\n+\ndiff --git a/Documentation/footerstart.txt b/Documentation/footerstart.txt\nnew file mode 100644\nindex 0000000..a2746ef\n--- /dev/null\n+++ b/Documentation/footerstart.txt\n@@ -0,0 +1,7 @@\n+\n+\n+\n+\n+ \n+ \n+
\ndiff --git a/Documentation/makedocpdf.sh b/Documentation/makedocpdf.sh\nnew file mode 100644\nindex 0000000..fd9f5bb\n--- /dev/null\n+++ b/Documentation/makedocpdf.sh\n@@ -0,0 +1,25 @@\n+#!/bin/sh\n+\n+rm -f git-doc.pdf\n+\n+cat /dev/null >docfiles.txt\n+\n+ls gittutorial.html >>docfiles.txt\n+ls gittutorial-2.html >>docfiles.txt\n+ls everyday.html >>docfiles.txt\n+ls gitworkflows.html >>docfiles.txt\n+ls git-*.html >>docfiles.txt\n+ls git[acdghikmnr]*.html >>docfiles.txt\n+ls gitweb*.html >>docfiles.txt\n+ls howto-index.html >>docfiles.txt\n+ls howto/*.html >>docfiles.txt\n+ls technical/*.html >>docfiles.txt\n+ls RelNotes/*.html >>docfiles.txt\n+\n+cat /dev/null >footer.html\n+\n+cat footerstart.txt >>footer.html\n+cat ../GIT-VERSION-FILE >>footer.html\n+cat footerend.txt >> footer.html\n+\n+cat docfiles.txt | xargs cat | wkhtmltopdf --book --footer-html footer.html --disable-external-links - git-doc.pdf\ndiff --git a/Makefile b/Makefile\nindex 8413606..2ddb3c9 100644\n--- a/Makefile\n+++ b/Makefile\n@@ -2485,6 +2485,9 @@ info:\n pdf:\n \t$(MAKE) -C Documentation pdf\n \n+fullpdf:\n+\t$(MAKE) -C Documentation fullpdf\n+\n XGETTEXT_FLAGS = \\\n \t--force-po \\\n \t--add-comments \\\n@@ -2796,6 +2799,9 @@ install-info:\n install-pdf:\n \t$(MAKE) -C Documentation install-pdf\n \n+install-fullpdf:\n+\t$(MAKE) -C Documentation install-fullpdf\n+\n quick-install-doc:\n \t$(MAKE) -C Documentation quick-install\n \n-- \n1.7.11.msysgit.1\n"},{"id":"200682","messageId":"7vfw5rqwby.fsf@alter.siamese.dyndns.org","threadId":"31741","inReplyTo":"244418682.269701.1349538839518.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [Patch 1/5] Fix some asciidoc layout problems","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2012-10-06T18:39:13Z","receivedAt":"2012-10-06T18:39:13Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/git-bisect-lk2009.txt | 12 ++++++------\n> Documentation/git-fetch-pack.txt | 5 ++++-\n> 2 files changed, 10 insertions(+), 7 deletions(-)\n\nYou didn't say what \"layout problem\" you are fixing, or what the\napproach you took to \"fix\" it. From the patch, I can guess that the\nlatter is to lengthen the lines that surround the displayed examples,\nbut as far as I know and can tell, the existing ones are long enough\nso I cannot tell why you needed such a change to the source in the\nfirst place.\n\nA better explanation, please?\n\nThe synopsis section of git-fetch-pack manual is a long single line\nwhich is unsightly. A fix to that issue is indeed needed. Please\nmake a separate patch only for that issue. Is git-fetch-pack the\nonly one whose synopsis section is overlong, by the way?\n\nThanks.\n\n>\n> diff --git a/Documentation/git-bisect-lk2009.txt b/Documentation/git-bisect-lk2009.txt\n> index 8a2ba37..99bdb46 100644\n> --- a/Documentation/git-bisect-lk2009.txt\n> +++ b/Documentation/git-bisect-lk2009.txt\n> @@ -248,7 +248,7 @@ Bisecting: 5480 revisions left to test after this (roughly 13 steps)\n> And after a few more steps like that, \"git bisect\" will eventually\n> find a first bad commit:\n> \n> --------------\n> +------------------------------------------------------------------------------------------------------------\n> $ git bisect bad\n> 2ddcca36c8bcfa251724fe342c8327451988be0d is the first bad commit\n> commit 2ddcca36c8bcfa251724fe342c8327451988be0d\n> @@ -257,8 +257,8 @@ Date: Sat May 3 11:59:44 2008 -0700\n> \n> Linux 2.6.26-rc1\n> \n> -:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n> --------------\n> +:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n> +------------------------------------------------------------------------------------------------------------\n> \n> At this point we can see what the commit does, check it out (if it's\n> not already checked out) or tinker with it, for example:\n> @@ -305,7 +305,7 @@ to launch a script or command at each bisection step to know if the\n> current commit is \"good\" or \"bad\". To do that, we use the \"git bisect\n> run\" command. For example:\n> \n> --------------\n> +------------------------------------------------------------------------------------------------------------\n> $ git bisect start v2.6.27 v2.6.25\n> Bisecting: 10928 revisions left to test after this (roughly 14 steps)\n> [2ec65f8b89ea003c27ff7723525a2ee335a2b393] x86: clean up using max_low_pfn on 32-bit\n> @@ -331,9 +331,9 @@ Date: Sat May 3 11:59:44 2008 -0700\n> \n> Linux 2.6.26-rc1\n> \n> -:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n> +:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n> bisect run success\n> --------------\n> +------------------------------------------------------------------------------------------------------------\n> \n> In this example, we passed \"grep '^SUBLEVEL = 25' Makefile\" as\n> parameter to \"git bisect run\". This means that at each step, the grep\n> diff --git a/Documentation/git-fetch-pack.txt b/Documentation/git-fetch-pack.txt\n> index 474fa30..12cd8a2 100644\n> --- a/Documentation/git-fetch-pack.txt\n> +++ b/Documentation/git-fetch-pack.txt\n> @@ -9,7 +9,10 @@ git-fetch-pack - Receive missing objects from another repository\n> SYNOPSIS\n> --------\n> [verse]\n> -'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] [--upload-pack=] [--depth=] [--no-progress] [-v] [:] [...]\n> +'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] \n> +\t\t\t\t[--upload-pack=] \n> +\t\t\t\t[--depth=] [--no-progress] \n> +\t\t\t\t[-v] [:] [...]\n> \n> DESCRIPTION\n> -----------\n"},{"id":"200683","messageId":"3662216A9D714C08B8522340D420AEEA@PhilipOakley","threadId":"31741","inReplyTo":"652323221.269712.1349538906380.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [Patch 2/5] Create html documents for all files in Documentation/technical","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2012-10-06T18:45:11Z","receivedAt":"2012-10-06T18:45:11Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"From: \"Thomas Ackermann\" \n>- add missing files\n> - fix some asciidoc layout problems\n>\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/Makefile | 12 ++++++++++-\n> Documentation/technical/index-format.txt | 2 +-\n> Documentation/technical/pack-format.txt | 8 +++----\n> Documentation/technical/pack-protocol.txt | 7 +++---\n> Documentation/technical/shallow.txt | 8 ++++++-\n> Documentation/technical/trivial-merge.txt | 36 \n> +++++++++++++++----------------\n> 6 files changed, 45 insertions(+), 28 deletions(-)\n>\n> diff --git a/Documentation/Makefile b/Documentation/Makefile\n> index 267dfe1..86594f6 100644\n> --- a/Documentation/Makefile\n> +++ b/Documentation/Makefile\n> @@ -25,6 +25,16 @@ SP_ARTICLES += howto/revert-branch-rebase\n> SP_ARTICLES += howto/using-merge-subtree\n> SP_ARTICLES += howto/using-signed-tag-in-pull-request\n> API_DOCS = $(patsubst %.txt,%,$(filter-out \n> technical/api-index-skel.txt technical/api-index.txt, $(wildcard \n> technical/api-*.txt)))\n> +API_DOCS += technical/index-format\n\nWould it not be better to create a separate TECH_DOCS list, rather than \nconfuse the API_DOCS list?\n\n> +API_DOCS += technical/pack-format\n> +API_DOCS += technical/pack-heuristics\n> +API_DOCS += technical/pack-protocol\n> +API_DOCS += technical/protocol-capabilities\n> +API_DOCS += technical/protocol-common\n> +API_DOCS += technical/racy-git\n> +API_DOCS += technical/send-pack-pipeline\n> +API_DOCS += technical/shallow\n> +API_DOCS += technical/trivial-merge\n> SP_ARTICLES += $(API_DOCS)\n> SP_ARTICLES += technical/api-index\n>\n> @@ -231,7 +241,7 @@ clean:\n> $(RM) *.texi *.texi+ *.texi++ git.info gitman.info\n> $(RM) *.pdf\n> $(RM) howto-index.txt howto/*.html doc.dep\n> - $(RM) technical/api-*.html technical/api-index.txt\n> + $(RM) technical/*.html technical/api-index.txt\n> $(RM) $(cmds_txt) *.made\n> $(RM) manpage-base-url.xsl\n>\n> diff --git a/Documentation/technical/index-format.txt \n> b/Documentation/technical/index-format.txt\n> index 9d25b30..57d6f91 100644\n> --- a/Documentation/technical/index-format.txt\n> +++ b/Documentation/technical/index-format.txt\n> @@ -1,7 +1,7 @@\n> GIT index format\n> ================\n>\n> -= The git index file has the following format\n> +== The git index file has the following format\n>\n \n"},{"id":"200684","messageId":"24F38BF6C67443D5873EEAAD758D03A4@PhilipOakley","threadId":"31741","inReplyTo":"343092834.269729.1349538958985.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [Patch 3/5] Create html documents for all files in Documentation/RelNotes","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2012-10-06T18:48:49Z","receivedAt":"2012-10-06T18:48:49Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"From: \"Thomas Ackermann\" \n>- create html for all release note files\n> - fix some asciidoc layout problems\n>\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/Makefile | 2 ++\n> Documentation/RelNotes/1.5.2.1.txt | 6 ------\n> Documentation/RelNotes/1.6.0.2.txt | 6 ------\n> Documentation/RelNotes/1.6.1.3.txt | 4 ----\n> Documentation/RelNotes/1.6.1.4.txt | 3 ---\n> Documentation/RelNotes/1.6.1.txt | 6 ------\n> 6 files changed, 2 insertions(+), 25 deletions(-)\n>\n> diff --git a/Documentation/Makefile b/Documentation/Makefile\n> index 86594f6..80eb06d 100644\n> --- a/Documentation/Makefile\n> +++ b/Documentation/Makefile\n> @@ -24,6 +24,7 @@ SP_ARTICLES = user-manual\n> SP_ARTICLES += howto/revert-branch-rebase\n> SP_ARTICLES += howto/using-merge-subtree\n> SP_ARTICLES += howto/using-signed-tag-in-pull-request\n> +RELNOTES = $(patsubst %.txt,%,$(wildcard RelNotes/*.txt))\n> API_DOCS = $(patsubst %.txt,%,$(filter-out \n> technical/api-index-skel.txt technical/api-index.txt, $(wildcard \n> technical/api-*.txt)))\n> API_DOCS += technical/index-format\n> API_DOCS += technical/pack-format\n> @@ -35,6 +36,7 @@ API_DOCS += technical/racy-git\n> API_DOCS += technical/send-pack-pipeline\n> API_DOCS += technical/shallow\n> API_DOCS += technical/trivial-merge\n> +API_DOCS += $(RELNOTES)\n\nAgain, is this the right docs list?\n\n> SP_ARTICLES += $(API_DOCS)\n> SP_ARTICLES += technical/api-index\n>\n \n"},{"id":"200686","messageId":"20121006191009.GB3644@sigill.intra.peff.net","threadId":"31741","inReplyTo":"7vfw5rqwby.fsf@alter.siamese.dyndns.org","subject":"Re: [Patch 1/5] Fix some asciidoc layout problems","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2012-10-06T19:10:09Z","receivedAt":"2012-10-06T19:10:09Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Sat, Oct 06, 2012 at 11:39:13AM -0700, Junio C Hamano wrote:\n\n> Thomas Ackermann writes:\n> \n> > Signed-off-by: Thomas Ackermann \n> > ---\n> > Documentation/git-bisect-lk2009.txt | 12 ++++++------\n> > Documentation/git-fetch-pack.txt | 5 ++++-\n> > 2 files changed, 10 insertions(+), 7 deletions(-)\n> \n> You didn't say what \"layout problem\" you are fixing, or what the\n> approach you took to \"fix\" it. From the patch, I can guess that the\n> latter is to lengthen the lines that surround the displayed examples,\n> but as far as I know and can tell, the existing ones are long enough\n> so I cannot tell why you needed such a change to the source in the\n> first place.\n> \n> A better explanation, please?\n\nI had the same question. Also, some of the lines convert tabs in literal\noutput into spaces, which is actively wrong (or maybe they were\nconverted already to spaces in the current code, but they should at\nleast align with 8-space tabstops):\n\n> > -:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n> > +:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n\n-Peff\n"},{"id":"200687","messageId":"20121006191152.GC3644@sigill.intra.peff.net","threadId":"31741","inReplyTo":"1206625172.269796.1349539081024.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [Patch 5/5] Create pdf from all html files","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2012-10-06T19:11:52Z","receivedAt":"2012-10-06T19:11:52Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Sat, Oct 06, 2012 at 05:58:01PM +0200, Thomas Ackermann wrote:\n\n> - use wkhtmltopdf to combine all html files into a single pdf file \"git-doc.pdf\"\n> - provide make target \"fullpdf\" to create \"git-doc.pdf\"\n> \n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/.gitignore | 1 +\n> Documentation/Makefile | 9 +++++++++\n> Documentation/footerend.txt | 4 ++++\n> Documentation/footerstart.txt | 7 +++++++\n> Documentation/makedocpdf.sh | 25 +++++++++++++++++++++++++\n> Makefile | 6 ++++++\n> 6 files changed, 52 insertions(+)\n> create mode 100644 Documentation/footerend.txt\n> create mode 100644 Documentation/footerstart.txt\n> create mode 100644 Documentation/makedocpdf.sh\n\nThe makedocpdf script has no execute bit, but...\n\n> diff --git a/Documentation/Makefile b/Documentation/Makefile\n> index abd27b5..c4c2a30 100644\n> --- a/Documentation/Makefile\n> +++ b/Documentation/Makefile\n> @@ -189,6 +189,9 @@ info: git.info gitman.info\n> \n> pdf: user-manual.pdf\n> \n> +fullpdf: pdf all\n> +\t./makedocpdf.sh\n\nHere we try to run it.\n\n-Peff\n"},{"id":"200688","messageId":"20121006192105.GA17895@sigill.intra.peff.net","threadId":"31741","inReplyTo":"343092834.269729.1349538958985.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [Patch 3/5] Create html documents for all files in Documentation/RelNotes","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2012-10-06T19:21:05Z","receivedAt":"2012-10-06T19:21:05Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Sat, Oct 06, 2012 at 05:55:58PM +0200, Thomas Ackermann wrote:\n\n> - create html for all release note files\n> [...]\n> diff --git a/Documentation/Makefile b/Documentation/Makefile\n> index 86594f6..80eb06d 100644\n> --- a/Documentation/Makefile\n> +++ b/Documentation/Makefile\n> @@ -24,6 +24,7 @@ SP_ARTICLES = user-manual\n> SP_ARTICLES += howto/revert-branch-rebase\n> SP_ARTICLES += howto/using-merge-subtree\n> SP_ARTICLES += howto/using-signed-tag-in-pull-request\n> +RELNOTES = $(patsubst %.txt,%,$(wildcard RelNotes/*.txt))\n> API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt)))\n> API_DOCS += technical/index-format\n> API_DOCS += technical/pack-format\n> @@ -35,6 +36,7 @@ API_DOCS += technical/racy-git\n> API_DOCS += technical/send-pack-pipeline\n> API_DOCS += technical/shallow\n> API_DOCS += technical/trivial-merge\n> +API_DOCS += $(RELNOTES)\n\nYuck. This means that anyone generating the html documentation will have\nto format all of the release notes, too, even though they are much less\nlikely to be useful[1]. If this is only useful for the fullpdf target,\ncan we omit it from the regular html target (and maybe add a \"relnotes\"\ntarget or something for people who really want them formatted)?\n\n-Peff\n\n[1] I would not be surprised if they do not actually format all that\n well. Though they are written in an asciidoc-ish style, they have\n not traditionally been formatted, and I suspect there are many small\n errors (like improper quoting of metacharacters) in them.\n"},{"id":"200691","messageId":"20121006193205.GD3644@sigill.intra.peff.net","threadId":"31741","inReplyTo":"505841759.269631.1349538675925.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [Patch 0/5] Create single PDF for all HTML files","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2012-10-06T19:32:05Z","receivedAt":"2012-10-06T19:32:05Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Sat, Oct 06, 2012 at 05:51:15PM +0200, Thomas Ackermann wrote:\n\n> I wanted to have a single PDF file which contains the complete Git documentation \n> (except user-manual) for easier reading on my tablet. The simplest way to do \n> this was by using wkhtmltopdf which can combine a set of HTML files into a sinlge \n> PDF file and also apply some reformatting. To this end HTML files for all the missing \n> files in Documentation/technical and Documentation/howto and also for all the \n> release notes in Documentation/RelNotes were created. \n\nIt seems like a reasonable goal. I do not have a strong opinion on the\napproach or how the final output looks, but I wasn't able to actually\nget output at all after applying your patches. Running \"make fullpdf\"\n(after installing dblatex) got me:\n\n The switch --book, is not support using unpatched qt, and will be\n ignored.The switch --footer-html, is not support using unpatched qt,\n and will be ignored.The switch --disable-external-links, is not\n support using unpatched qt, and will be ignored.\n\nafter which wkhtmltopdf began pegging my CPU. I let it run for 10\nminutes before giving up.\n\nAnother way of doing this would be to format the individual troff\nmanpages into dvi or postscript, convert that into pdf, and then\nconcatenate that. Something like:\n\n for i in *.[157]; do\n man -Tdvi -l \"$i\" >\"$i.dvi\"\n dvipdfm \"$i\"\n done\n pdftk *.[157].pdf cat output full.pdf\n\nworks for me, though obviously that does not handle some of the non-man\nitems you included. No idea on how the output compares to yours, but\nit's something you may want to look at.\n\n-Peff\n"},{"id":"200695","messageId":"1013292233.101229.1349596860911.JavaMail.ngmail@webmail23.arcor-online.net","threadId":"31741","inReplyTo":"20121006191009.GB3644@sigill.intra.peff.net","subject":"Aw: Re: [Patch 1/5] Fix some asciidoc layout problems","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-07T08:01:00Z","receivedAt":"2012-10-07T08:01:00Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \nMaking the dashed lines longer was unnecessary and I will remove this.\n\nThere were in general the following \"layout problems\" I encountered while trying to create git-doc.pdf:\n\n- Wrong sectioning syntax (e.g. \"===\" instead of \"---\")\n- Left-over shell scripting commands (in some release notes files)\n- Over-long lines which caused very wide right margins in the resulting pdf\n\nThe later is the case here and I tried to fix this by either splitting the offending line in several lines\nor removing as much spaces as possible.\n\nI will be more specific about these things in my commit messages.\n\n\n----- Original Nachricht ----\nVon: Jeff King \nAn: Junio C Hamano \nDatum: 06.10.2012 21:10\nBetreff: Re: [Patch 1/5] Fix some asciidoc layout problems\n\n> On Sat, Oct 06, 2012 at 11:39:13AM -0700, Junio C Hamano wrote:\n> \n> > Thomas Ackermann writes:\n> > \n> > > Signed-off-by: Thomas Ackermann \n> > > ---\n> > > Documentation/git-bisect-lk2009.txt | 12 ++++++------\n> > > Documentation/git-fetch-pack.txt | 5 ++++-\n> > > 2 files changed, 10 insertions(+), 7 deletions(-)\n> > \n> > You didn't say what \"layout problem\" you are fixing, or what the\n> > approach you took to \"fix\" it. From the patch, I can guess that the\n> > latter is to lengthen the lines that surround the displayed examples,\n> > but as far as I know and can tell, the existing ones are long enough\n> > so I cannot tell why you needed such a change to the source in the\n> > first place.\n> > \n> > A better explanation, please?\n> \n> I had the same question. Also, some of the lines convert tabs in literal\n> output into spaces, which is actively wrong (or maybe they were\n> converted already to spaces in the current code, but they should at\n> least align with 8-space tabstops):\n> \n> > > -:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57\n> 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n> > > +:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57\n> 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile\n> \n> -Peff\n> \n\n---\nThomas\n"},{"id":"200696","messageId":"1770841099.101310.1349597668191.JavaMail.ngmail@webmail23.arcor-online.net","threadId":"31741","inReplyTo":"20121006193205.GD3644@sigill.intra.peff.net","subject":"Aw: Re: [Patch 0/5] Create single PDF for all HTML files","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-07T08:14:28Z","receivedAt":"2012-10-07T08:14:28Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nThere are \"patched QT\" and \"unpatched QT\" versions of wkhtmltopdf\n(see http://code.google.com/p/wkhtmltopdf/). I am using V0.9.9 for Windows\nwhich is \"patched QT\".\n\nThere is one drawback with wkhtmltopdf: At least on my Netbook (Win7 64bit,\nPentium 1.5GHz) it is very slow. It takes more than 3 hrs to create git-doc.pdf.\n\nIf you want to have a quick look on the resulting pdf just clone \nhttps://github.com/tacker66/git-docpdf.git. This repo contains\na current version of user.manual.pdf and git-doc.pdf \n\n\n----- Original Nachricht ----\nVon: Jeff King \nAn: Thomas Ackermann \nDatum: 06.10.2012 21:32\nBetreff: Re: [Patch 0/5] Create single PDF for all HTML files\n\n> On Sat, Oct 06, 2012 at 05:51:15PM +0200, Thomas Ackermann wrote:\n> \n> > I wanted to have a single PDF file which contains the complete Git\n> documentation \n> > (except user-manual) for easier reading on my tablet. The simplest way to\n> do \n> > this was by using wkhtmltopdf which can combine a set of HTML files into a\n> sinlge \n> > PDF file and also apply some reformatting. To this end HTML files for all\n> the missing \n> > files in Documentation/technical and Documentation/howto and also for all\n> the \n> > release notes in Documentation/RelNotes were created. \n> \n> It seems like a reasonable goal. I do not have a strong opinion on the\n> approach or how the final output looks, but I wasn't able to actually\n> get output at all after applying your patches. Running \"make fullpdf\"\n> (after installing dblatex) got me:\n> \n> The switch --book, is not support using unpatched qt, and will be\n> ignored.The switch --footer-html, is not support using unpatched qt,\n> and will be ignored.The switch --disable-external-links, is not\n> support using unpatched qt, and will be ignored.\n> \n> after which wkhtmltopdf began pegging my CPU. I let it run for 10\n> minutes before giving up.\n> \n> Another way of doing this would be to format the individual troff\n> manpages into dvi or postscript, convert that into pdf, and then\n> concatenate that. Something like:\n> \n> for i in *.[157]; do\n> man -Tdvi -l \"$i\" >\"$i.dvi\"\n> dvipdfm \"$i\"\n> done\n> pdftk *.[157].pdf cat output full.pdf\n> \n> works for me, though obviously that does not handle some of the non-man\n> items you included. No idea on how the output compares to yours, but\n> it's something you may want to look at.\n> \n> -Peff\n> \n\n---\nThomas\n"},{"id":"200713","messageId":"7vmwzyovg3.fsf@alter.siamese.dyndns.org","threadId":"31741","inReplyTo":"20121006192105.GA17895@sigill.intra.peff.net","subject":"Re: [Patch 3/5] Create html documents for all files in Documentation/RelNotes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2012-10-07T20:53:32Z","receivedAt":"2012-10-07T20:53:32Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jeff King writes:\n\n> [1] I would not be surprised if they do not actually format all that\n> well. Though they are written in an asciidoc-ish style, they have\n> not traditionally been formatted, and I suspect there are many small\n> errors (like improper quoting of metacharacters) in them.\n\nThey aren't even \"errors\". As far as I (who writes the release\nnotes) am concerned, they are straight text without any asciidoc\nor markdown mark-up.\n"},{"id":"200714","messageId":"7vipamoveo.fsf@alter.siamese.dyndns.org","threadId":"31741","inReplyTo":"20121006193205.GD3644@sigill.intra.peff.net","subject":"Re: [Patch 0/5] Create single PDF for all HTML files","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2012-10-07T20:54:23Z","receivedAt":"2012-10-07T20:54:23Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jeff King writes:\n\n> Another way of doing this would be to format the individual troff\n> manpages into dvi or postscript, convert that into pdf, and then\n> concatenate that. Something like:\n>\n> for i in *.[157]; do\n> man -Tdvi -l \"$i\" >\"$i.dvi\"\n> dvipdfm \"$i\"\n> done\n> pdftk *.[157].pdf cat output full.pdf\n>\n> works for me, though obviously that does not handle some of the non-man\n> items you included. No idea on how the output compares to yours, but\n> it's something you may want to look at.\n\nYes, that would be far more straight-forward and less error prone\nway to do this.\n"},{"id":"200728","messageId":"20121007225232.GA3490@sigill.intra.peff.net","threadId":"31741","inReplyTo":"1770841099.101310.1349597668191.JavaMail.ngmail@webmail23.arcor-online.net","subject":"Re: Re: [Patch 0/5] Create single PDF for all HTML files","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2012-10-07T22:52:32Z","receivedAt":"2012-10-07T22:52:32Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Sun, Oct 07, 2012 at 10:14:28AM +0200, Thomas Ackermann wrote:\n\n> There are \"patched QT\" and \"unpatched QT\" versions of wkhtmltopdf\n> (see http://code.google.com/p/wkhtmltopdf/). I am using V0.9.9 for Windows\n> which is \"patched QT\".\n\nThat's a definite compatibility question for taking your patches into\nupstream git.\n\n> There is one drawback with wkhtmltopdf: At least on my Netbook (Win7 64bit,\n> Pentium 1.5GHz) it is very slow. It takes more than 3 hrs to create git-doc.pdf.\n> \n> If you want to have a quick look on the resulting pdf just clone \n> https://github.com/tacker66/git-docpdf.git. This repo contains\n> a current version of user.manual.pdf and git-doc.pdf \n\nIt does look better than the output generated by the \"man -Tdvi\" loop I\nposted. It retains more styling from the HTML and it has a nice table of\ncontents. But 3 hours? Yeesh. Mine took 11 seconds.\n\nI wonder if a more sane route is to drop HTML entirely, convert the\nasciidoc to docbook (which we already do for manpages), and then create\na docbook document that is a collection of all elements, which can then\nbe converted to pdf, epub, or whatever. I would not be surprised if\nsomebody has solved this problem before (but it is not really my itch,\nso I did not look very far).\n\n-Peff\n"},{"id":"200796","messageId":"4F18F2E9D9ED4F8C94701472A190D01E@PhilipOakley","threadId":"31741","inReplyTo":"1770841099.101310.1349597668191.JavaMail.ngmail@webmail23.arcor-online.net","subject":"Re: Re: [Patch 0/5] Create single PDF for all HTML files","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2012-10-08T22:53:18Z","receivedAt":"2012-10-08T22:53:18Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"From: \"Thomas Ackermann\" \n>\n> There are \"patched QT\" and \"unpatched QT\" versions of wkhtmltopdf\n> (see http://code.google.com/p/wkhtmltopdf/). I am using V0.9.9 for \n> Windows\n> which is \"patched QT\".\n>\n> There is one drawback with wkhtmltopdf: At least on my Netbook (Win7 \n> 64bit,\n> Pentium 1.5GHz) it is very slow. It takes more than 3 hrs to create \n> git-doc.pdf.\n>\n> If you want to have a quick look on the resulting pdf just clone\n> https://github.com/tacker66/git-docpdf.git. This repo contains\n> a current version of user.manual.pdf and git-doc.pdf\n>\n\nEven as a 'draft' I found it to be useful to see all the documentation \ncollated together in one place/pdf. All 763 pages!\n\nEven just reading through the contents list (34 pages) showed the scale \nof the git documentation, and areas of documentation I wasn't aware of.\n\nPutting the Tutorials, Everyday GIT and workflows at the beginning \nlooked good.\n\nFor a polished version it would be good if the major breaks (e.g. \nbetween ToC, gittutorial, git-add [should start with git(1)], \ngitattributes, GIT Howto, API, Git Index Format, ReleaseNotes) could \nstart on a new page.\n\nA few minor nits: I wasn't sure if the 'fighting regressions with git \nbisect', and 'a short git tools survey' were in the right place. There \nappear to be two 'git-send-pack' titles, though they are different. And \nthe HowTo section would need some beefed up headings to give them enough \nprominence in the ToC once it all hangs together.\n\n>\n> ----- Original Nachricht ----\n> Von: Jeff King \n> An: Thomas Ackermann \n> Datum: 06.10.2012 21:32\n> Betreff: Re: [Patch 0/5] Create single PDF for all HTML files\n>\n>> On Sat, Oct 06, 2012 at 05:51:15PM +0200, Thomas Ackermann wrote:\n>>\n>> > I wanted to have a single PDF file which contains the complete Git\n>> documentation\n>> > (except user-manual) for easier reading on my tablet. The simplest \n>> > way to\n>> do\n>> > this was by using wkhtmltopdf which can combine a set of HTML files \n>> > into a\n>> sinlge\n>> > PDF file and also apply some reformatting. To this end HTML files \n>> > for all\n>> the missing\n>> > files in Documentation/technical and Documentation/howto and also \n>> > for all\n>> the\n>> > release notes in Documentation/RelNotes were created.\n>>\n>> It seems like a reasonable goal. I do not have a strong opinion on \n>> the\n>> approach or how the final output looks, but I wasn't able to actually\n>> get output at all after applying your patches. Running \"make fullpdf\"\n>> (after installing dblatex) got me:\n>>\n>> The switch --book, is not support using unpatched qt, and will be\n>> ignored.The switch --footer-html, is not support using unpatched \n>> qt,\n>> and will be ignored.The switch --disable-external-links, is not\n>> support using unpatched qt, and will be ignored.\n>>\n>> after which wkhtmltopdf began pegging my CPU. I let it run for 10\n>> minutes before giving up.\n>>\n>> Another way of doing this would be to format the individual troff\n>> manpages into dvi or postscript, convert that into pdf, and then\n>> concatenate that. Something like:\n>>\n>> for i in *.[157]; do\n>> man -Tdvi -l \"$i\" >\"$i.dvi\"\n>> dvipdfm \"$i\"\n>> done\n>> pdftk *.[157].pdf cat output full.pdf\n>>\n>> works for me, though obviously that does not handle some of the \n>> non-man\n>> items you included. No idea on how the output compares to yours, but\n>> it's something you may want to look at.\n>>\n>> -Peff\n>>\n>\n> ---\n> Thomas\n> --\n> To unsubscribe from this list: send the line \"unsubscribe git\" in\n> the body of a message to majordomo@vger.kernel.org\n> More majordomo info at http://vger.kernel.org/majordomo-info.html\n>\n>\n> -----\n> No virus found in this message.\n> Checked by AVG - www.avg.com\n> Version: 2013.0.2677 / Virus Database: 2591/5813 - Release Date: \n> 10/06/12\n> \n"},{"id":"201262","messageId":"507BF806.1030709@drmicha.warpmail.net","threadId":"31741","inReplyTo":"7vmwzyovg3.fsf@alter.siamese.dyndns.org","subject":"Re: [Patch 3/5] Create html documents for all files in Documentation/RelNotes","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2012-10-15T11:48:22Z","receivedAt":"2012-10-15T11:48:22Z","isPatch":true,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"Junio C Hamano venit, vidit, dixit 07.10.2012 22:53:\n> Jeff King writes:\n> \n>> [1] I would not be surprised if they do not actually format all that\n>> well. Though they are written in an asciidoc-ish style, they have\n>> not traditionally been formatted, and I suspect there are many small\n>> errors (like improper quoting of metacharacters) in them.\n> \n> They aren't even \"errors\". As far as I (who writes the release\n> notes) am concerned, they are straight text without any asciidoc\n> or markdown mark-up.\n\nI'm wondering: If it's neither markdown nor markup then what is it:\nmarklevel, markeven or markstraight?\n\nSeriously, if Thomas converts them into asciidoc it's an added benefit\n(and I don't think you'd have to change your writing by much), but\nRelNotes should not be in the standard make target.\n\nOn a different note: Is pdf really the format of choice for mobile\nplatforms? I'd expect something that is \"formatted\" (markup) but can\nreflow text intrinsically, not only by making your pdf reader jump\nthrough hoops. HTML?\n\nMichael\n"},{"id":"201263","messageId":"507BF9C7.1080601@drmicha.warpmail.net","threadId":"31741","inReplyTo":"20121007225232.GA3490@sigill.intra.peff.net","subject":"Re: [Patch 0/5] Create single PDF for all HTML files","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2012-10-15T11:55:51Z","receivedAt":"2012-10-15T11:55:51Z","isPatch":true,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"Jeff King venit, vidit, dixit 08.10.2012 00:52:\n> On Sun, Oct 07, 2012 at 10:14:28AM +0200, Thomas Ackermann wrote:\n> \n>> There are \"patched QT\" and \"unpatched QT\" versions of wkhtmltopdf\n>> (see http://code.google.com/p/wkhtmltopdf/). I am using V0.9.9 for Windows\n>> which is \"patched QT\".\n> \n> That's a definite compatibility question for taking your patches into\n> upstream git.\n> \n>> There is one drawback with wkhtmltopdf: At least on my Netbook (Win7 64bit,\n>> Pentium 1.5GHz) it is very slow. It takes more than 3 hrs to create git-doc.pdf.\n>>\n>> If you want to have a quick look on the resulting pdf just clone \n>> https://github.com/tacker66/git-docpdf.git. This repo contains\n>> a current version of user.manual.pdf and git-doc.pdf \n> \n> It does look better than the output generated by the \"man -Tdvi\" loop I\n> posted. It retains more styling from the HTML and it has a nice table of\n> contents. But 3 hours? Yeesh. Mine took 11 seconds.\n> \n> I wonder if a more sane route is to drop HTML entirely, convert the\n> asciidoc to docbook (which we already do for manpages), and then create\n> a docbook document that is a collection of all elements, which can then\n\nHmm, I think the html output often looks better than the man output\n(tables and such), and it is a formatted, reflowable, interlinked format\nfit for many puposes.\n\n> be converted to pdf, epub, or whatever. I would not be surprised if\n> somebody has solved this problem before (but it is not really my itch,\n> so I did not look very far).\n\nI'd rather ditch docbook and have one toolchain (asciidoc, unless we\nwant to switch to something else) only... We've been hunting asciidoc as\nwell as docbook compatibility (between versions) and interoperability\n(between them) issues again and again.\n\nIn fact, if I remember correctly, that's what has been keeping us from\nusing *real* tables in the doc (but hasn't kept us from using tables ;) ).\n\nMichael\n"},{"id":"201274","messageId":"20121015174243.GA31658@sigill.intra.peff.net","threadId":"31741","inReplyTo":"507BF9C7.1080601@drmicha.warpmail.net","subject":"Re: [Patch 0/5] Create single PDF for all HTML files","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2012-10-15T17:42:43Z","receivedAt":"2012-10-15T17:42:43Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Mon, Oct 15, 2012 at 01:55:51PM +0200, Michael J Gruber wrote:\n\n> > I wonder if a more sane route is to drop HTML entirely, convert the\n> > asciidoc to docbook (which we already do for manpages), and then create\n> > a docbook document that is a collection of all elements, which can then\n> \n> Hmm, I think the html output often looks better than the man output\n> (tables and such), and it is a formatted, reflowable, interlinked format\n> fit for many puposes.\n\nIt does look better, but that is because the docbook->roff step is where\nthings get ugly. In theory, docbook is at least as expressive as HTML,\nand has lots of nice semantic markup that gives us flexibility in what\nthe final product looks like.\n\nThere are docbook->epub converters (I think xmlto will do this out of\nthe box), as well as a host of other formats. But convincing docbook to\ncreate a collection of \"refentry\" (their term for manpage) articles is\nharder than you'd think. I tried a few things when this thread started\nand couldn't get anything simple to work (xml has managed to make the\nsimple act of \"include this document in this other document\" insanely\ncomplex). But I only spent a few minutes on it.\n\n> > be converted to pdf, epub, or whatever. I would not be surprised if\n> > somebody has solved this problem before (but it is not really my itch,\n> > so I did not look very far).\n> \n> I'd rather ditch docbook and have one toolchain (asciidoc, unless we\n> want to switch to something else) only... We've been hunting asciidoc as\n> well as docbook compatibility (between versions) and interoperability\n> (between them) issues again and again.\n\nYeah, I really hate our doc toolchain. It just seems like everything\nelse is even worse. We can ditch docbook, but then how do we make\nmanpages?\n\n-Peff\n"},{"id":"201286","messageId":"7vhapvwjef.fsf@alter.siamese.dyndns.org","threadId":"31741","inReplyTo":"507BF806.1030709@drmicha.warpmail.net","subject":"Re: [Patch 3/5] Create html documents for all files in Documentation/RelNotes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2012-10-15T20:49:12Z","receivedAt":"2012-10-15T20:49:12Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Michael J Gruber writes:\n\n> Junio C Hamano venit, vidit, dixit 07.10.2012 22:53:\n>> Jeff King writes:\n>> \n>>> [1] I would not be surprised if they do not actually format all that\n>>> well. Though they are written in an asciidoc-ish style, they have\n>>> not traditionally been formatted, and I suspect there are many small\n>>> errors (like improper quoting of metacharacters) in them.\n>> \n>> They aren't even \"errors\". As far as I (who writes the release\n>> notes) am concerned, they are straight text without any asciidoc\n>> or markdown mark-up.\n>\n> I'm wondering: If it's neither markdown nor markup then what is it:\n> marklevel, markeven or markstraight?\n\nThey are called plain text.\n\n> On a different note: Is pdf really the format of choice for mobile\n> platforms? I'd expect something that is \"formatted\" (markup) but can\n> reflow text intrinsically, not only by making your pdf reader jump\n> through hoops. HTML?\n\nYeah, I've been wondering if epub or something might be a better\ntarget myself.\n"}]}