{"thread":{"id":"31837","subject":"[Patch v3 0/8] Create single PDF for all HTML files","startedAt":"2012-10-16T17:17:45Z","lastAt":"2012-12-17T09:43:52Z","messageCount":17,"participants":["Thomas Ackermann","Junio C Hamano","Andreas Schwab"],"isPatch":true,"patchVersion":3,"patchTotal":8},"messages":[{"id":"201358","messageId":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":null,"subject":"[Patch v3 0/8] Create single PDF for all HTML files","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:17:45Z","receivedAt":"2012-10-16T17:17:45Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"Hi,\n\nthis is v3 of my patch series for creating a single PDF for all\ngit documentation files.\n\nThere are only 2 changes since v2 (thanks to Junio for pointing me at these issues) :\n- The over-long lines in git-bisect-lk2009.txt where shortened by abbreviating the SHA1s.\n- Pretty-printing the shell script in update-hook-example.txt was fixed.\n\nTo sum up, this patch series provides the following new \"features\":\n- Make target \"html\" now creates HTML for ALL files in ./Documentation/howto and ./Documentation/technical\n- New make target \"fullpdf\" first creates HTML for all files in ./Documentation/RelNotes and then collates all HTML \nfiles in ./Documentation and its subdirs (except user-manual.html) in one single PDF file.\n\nThis approach is of course not an optimal one but by using wkhtmltopdf\nit could be carried out easily. A more perfect approach would be to \nrework/redesign the whole doc tool chain and so perhaps arrive at additional\noutput formats like e.g. epub. But this is the topic of a patch series yet to come ...\n\nA current version of git-doc.pdf is available in\nhttps://github.com/tacker66/git-docpdf.git. \n\n\n---\nThomas\n"},{"id":"201359","messageId":"1405742472.154104.1350408010912.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch v3 1/8] Split over-long synopsis in git-fetch-pack.txt into several lines","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:20:10Z","receivedAt":"2012-10-16T17:20:10Z","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-fetch-pack.txt | 5 ++++-\n 1 file changed, 4 insertions(+), 1 deletion(-)\n\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\n\n---\nThomas\n"},{"id":"201361","messageId":"1739299099.154164.1350408117758.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch v3 2/8] Shorten two over-long lines in git-bisect-lk2009.txt by abbreviating some sha1","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:21:57Z","receivedAt":"2012-10-16T17:21:57Z","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 | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-bisect-lk2009.txt b/Documentation/git-bisect-lk2009.txt\nindex 8a2ba37..ec4497e 100644\n--- a/Documentation/git-bisect-lk2009.txt\n+++ b/Documentation/git-bisect-lk2009.txt\n@@ -257,7 +257,7 @@ 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 5cf82581... 4492984e... M Makefile\n -------------\n \n At this point we can see what the commit does, check it out (if it's\n@@ -331,7 +331,7 @@ 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 5cf82581... 4492984e... M Makefile\n bisect run success\n -------------\n \n-- \n1.7.11.msysgit.1\n\n\n---\nThomas\n"},{"id":"201364","messageId":"2041665885.154187.1350408188331.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch v3 3/8] Change headline of technical/send-pack-pipeline.txt to not confuse its content with content from git-send-pack.txt","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:23:08Z","receivedAt":"2012-10-16T17:23:08Z","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/technical/send-pack-pipeline.txt | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/technical/send-pack-pipeline.txt b/Documentation/technical/send-pack-pipeline.txt\nindex 681efe4..9b5a0bc 100644\n--- a/Documentation/technical/send-pack-pipeline.txt\n+++ b/Documentation/technical/send-pack-pipeline.txt\n@@ -1,5 +1,5 @@\n-git-send-pack\n-=============\n+Git-send-pack internals\n+=======================\n \n Overall operation\n -----------------\n-- \n1.7.11.msysgit.1\n\n\n---\nThomas\n"},{"id":"201365","messageId":"1003664697.154216.1350408256439.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch v3 4/8] Prerequisites for creating nice html for all files in Documentation/technical","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:24:16Z","receivedAt":"2012-10-16T17:24:16Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\n- fix wrong asciidoc sectioning markup in index-format.txt, pack-format.txt and pack-protocol.txt\n- split an over-long line in pack-protocol.txt into several lines\n- add a markup box for definition part in shallow.txt\n- fix table markup in trivial-merge.txt\n\nSigned-off-by: Thomas Ackermann \n---\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 5 files changed, 34 insertions(+), 27 deletions(-)\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\n\n---\nThomas\n"},{"id":"201367","messageId":"1286564693.154237.1350408329609.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch v3 5/8] Prerequisites for creating nice html for all files in Documentation/howto","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:25:29Z","receivedAt":"2012-10-16T17:25:29Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\n- create headlines with asciidoc markup\n- asciidoc box markup for mail replies in recover-corrupted-blob-object.txt\n- pretty-print shell script in update-hook-example.txt\n- correct indendation for allowed-users example in update-hook-example.txt\n- headline of every howto document starts with \"How to ...\"\n- add \"Content-type: text/asciidoc\" in new files (used in howto-index.sh)\n\nSigned-off-by: Thomas Ackermann \n---\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/revert-branch-rebase.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, 68 insertions(+), 34 deletions(-)\n\ndiff --git a/Documentation/howto/maintain-git.txt b/Documentation/howto/maintain-git.txt\nindex 8823a37..ea6e4a5 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+How to 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..4627ee4 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+How to rebase from an 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..00c1b45 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+How to 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..7484735 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+How to recover a 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..8a68548 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+How to revert a faulty merge\n+============================\n \n Alan said:\n \ndiff --git a/Documentation/howto/revert-branch-rebase.txt b/Documentation/howto/revert-branch-rebase.txt\nindex 093c656..a59ced8 100644\n--- a/Documentation/howto/revert-branch-rebase.txt\n+++ b/Documentation/howto/revert-branch-rebase.txt\n@@ -8,8 +8,8 @@ Date: Mon, 29 Aug 2005 21:39:02 -0700\n Content-type: text/asciidoc\n Message-ID: <7voe7g3uop.fsf@assigned-by-dhcp.cox.net>\n \n-Reverting an existing commit\n-============================\n+How to revert an existing commit\n+================================\n \n One of the changes I pulled into the 'master' branch turns out to\n break building GIT with GCC 2.95. While they were well intentioned\ndiff --git a/Documentation/howto/separating-topic-branches.txt b/Documentation/howto/separating-topic-branches.txt\nindex 6d3eb8e..bd10274 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+How to separate 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..a695f01 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+How to 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..a5193b1 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+How to use the update hook\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+ info \"Checking user: '$username' against pattern: '$user_pattern'\"\n+ matchlen=$(expr \"$username\" : \"$user_pattern\")\n+ if test \"$matchlen\" = \"${#username}\"\n+ then\n+ grant \"Allowing user: '$username' with pattern: '$user_pattern'\"\n+ 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+ for groupname in $groups; do\n+ info \"Checking group: '$groupname' against pattern: '$group_pattern'\"\n+ matchlen=$(expr \"$groupname\" : \"$group_pattern\")\n+ if test \"$matchlen\" = \"${#groupname}\"\n+ then\n+ grant \"Allowing group: '$groupname' with pattern: '$group_pattern'\"\n+ 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..00f693b 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+How to use a signed tag in pull requests\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\n\n---\nThomas\n"},{"id":"201368","messageId":"580942178.154247.1350408383667.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch v3 6/8] Prerequisites for creating nice html for all files in Documentation/RelNotes","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:26:23Z","receivedAt":"2012-10-16T17:26:23Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\n- remove left-over shell-script fragments from some files\n\nSigned-off-by: Thomas Ackermann \n---\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 5 files changed, 25 deletions(-)\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\n\n---\nThomas\n"},{"id":"201370","messageId":"814705718.154269.1350408445020.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch v3 7/8] Create pdf from all html files","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:27:25Z","receivedAt":"2012-10-16T17:27:25Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\n- use wkhtmltopdf (\"patched QT\" version) to combine all html files into a single pdf file \"git-doc.pdf\"\n- insert page breaks to separate major sections\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/.gitignore | 1 +\n Documentation/footerend.txt | 4 ++++\n Documentation/footerstart.txt | 7 ++++++\n Documentation/makedocpdf.sh | 53 +++++++++++++++++++++++++++++++++++++++++++\n Documentation/pagebreak.txt | 1 +\n 5 files changed, 66 insertions(+)\n create mode 100644 Documentation/footerend.txt\n create mode 100644 Documentation/footerstart.txt\n create mode 100755 Documentation/makedocpdf.sh\n create mode 100644 Documentation/pagebreak.txt\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/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 100755\nindex 0000000..5f1a2c1\n--- /dev/null\n+++ b/Documentation/makedocpdf.sh\n@@ -0,0 +1,53 @@\n+#!/bin/sh\n+\n+rm -f git-doc.pdf\n+\n+cat pagebreak.txt >pagebreak.html\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+\n+ls pagebreak.html >>docfiles.txt\n+ls git.html >>docfiles.txt\n+ls git-a*.html >>docfiles.txt\n+ls git-bisect.html >>docfiles.txt\n+ls git-b[j-z]*.html >>docfiles.txt\n+ls git-[c-s]*.html >>docfiles.txt\n+ls git-ta*.html >>docfiles.txt\n+ls gitk.html >>docfiles.txt\n+ls git-[u-z]*.html >>docfiles.txt\n+\n+ls pagebreak.html >>docfiles.txt\n+ls gita*.html >>docfiles.txt\n+ls git-bisect-lk2009.html >>docfiles.txt\n+ls git[cdghimnr]*.html >>docfiles.txt\n+ls git-tools.html >>docfiles.txt\n+ls gitweb*.html >>docfiles.txt\n+\n+ls pagebreak.html >>docfiles.txt\n+ls howto-index.html >>docfiles.txt\n+ls howto/*.html >>docfiles.txt\n+\n+ls pagebreak.html >>docfiles.txt\n+ls technical/[b-z]*.html >>docfiles.txt\n+\n+ls pagebreak.html >>docfiles.txt\n+ls technical/api-index.html >>docfiles.txt\n+ls technical/api-[a-h]*.html >>docfiles.txt\n+ls technical/api-in-*.html >>docfiles.txt\n+ls technical/api-[j-z]*.html >>docfiles.txt\n+\n+ls pagebreak.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/Documentation/pagebreak.txt b/Documentation/pagebreak.txt\nnew file mode 100644\nindex 0000000..fdaffd1\n--- /dev/null\n+++ b/Documentation/pagebreak.txt\n@@ -0,0 +1 @@\n+

\n-- \n1.7.11.msysgit.1\n\n\n---\nThomas\n"},{"id":"201371","messageId":"284960987.154283.1350408513131.JavaMail.ngmail@webmail15.arcor-online.net","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch v3 8/8] Wire everything into Makefile and Documentation/Makefile","fromName":"Thomas Ackermann","fromEmail":"th.acker66@arcor.de","sentAt":"2012-10-16T17:28:33Z","receivedAt":"2012-10-16T17:28:33Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\n- target \"html\" creates html for all files in Documentation/howto and Documentation/technical\n- new target \"relnoteshtml\" creates html for all release notes\n- new target \"fullpdf\" creates \"git-doc.pdf\" and uses targets \"html\", \"relnoteshtml\" and \"pdf\"\n- \"html\" does not use \"relnoteshtml\"\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/Makefile | 43 +++++++++++++++++++++++++++++++++++++++++--\n Makefile | 9 +++++++++\n 2 files changed, 50 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\nindex 267dfe1..6710325 100644\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -15,6 +15,9 @@ MAN_HTML=$(patsubst %.txt,%.html,$(MAN_TXT))\n \n DOC_HTML=$(MAN_HTML)\n \n+RELNOTES_TXT = $(wildcard RelNotes/*.txt)\n+RELNOTES_HTML= $(patsubst %.txt,%.html,$(RELNOTES_TXT))\n+ \n ARTICLES = howto-index\n ARTICLES += everyday\n ARTICLES += git-tools\n@@ -24,8 +27,30 @@ 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 API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt)))\n SP_ARTICLES += $(API_DOCS)\n+\n+TECH_DOCS += technical/index-format\n+TECH_DOCS += technical/pack-format\n+TECH_DOCS += technical/pack-heuristics\n+TECH_DOCS += technical/pack-protocol\n+TECH_DOCS += technical/protocol-capabilities\n+TECH_DOCS += technical/protocol-common\n+TECH_DOCS += technical/racy-git\n+TECH_DOCS += technical/send-pack-pipeline\n+TECH_DOCS += technical/shallow\n+TECH_DOCS += technical/trivial-merge\n+SP_ARTICLES += $(TECH_DOCS)\n SP_ARTICLES += technical/api-index\n \n DOC_HTML += $(patsubst %,%.html,$(ARTICLES) $(SP_ARTICLES))\n@@ -156,6 +181,8 @@ all: html man\n \n html: $(DOC_HTML)\n \n+relnoteshtml: $(RELNOTES_HTML)\n+\n $(DOC_HTML) $(DOC_MAN1) $(DOC_MAN5) $(DOC_MAN7): asciidoc.conf\n \n man: man1 man5 man7\n@@ -167,6 +194,9 @@ info: git.info gitman.info\n \n pdf: user-manual.pdf\n \n+fullpdf: pdf relnoteshtml html\n+\t./makedocpdf.sh\n+\n install: install-man\n \n install-man: man\n@@ -191,6 +221,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@@ -230,8 +264,10 @@ 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/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 \n@@ -241,6 +277,9 @@ $(MAN_HTML): %.html : %.txt\n \t\t$(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) -o $@+ $< && \\\n \tmv $@+ $@\n \n+$(RELNOTES_HTML): %.html : %.txt\n+\t$(QUIET_ASCIIDOC)$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b xhtml11 $*.txt\n+\n manpage-base-url.xsl: manpage-base-url.xsl.in\n \tsed \"s|@@MAN_BASE_URL@@|$(MAN_BASE_URL)|\" $< > $@\n \n@@ -264,7 +303,7 @@ technical/api-index.txt: technical/api-index-skel.txt \\\n \t$(QUIET_GEN)cd technical && '$(SHELL_PATH_SQ)' ./api-index.sh\n \n technical/%.html: ASCIIDOC_EXTRA += -a git-relative-html-prefix=../\n-$(patsubst %,%.html,$(API_DOCS) technical/api-index): %.html : %.txt\n+$(patsubst %,%.html,$(API_DOCS) technical/api-index $(TECH_DOCS)): %.html : %.txt\n \t$(QUIET_ASCIIDOC)$(ASCIIDOC) -b xhtml11 -f asciidoc.conf \\\n \t\t$(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) $*.txt\n \ndiff --git a/Makefile b/Makefile\nindex f69979e..075e98c 100644\n--- a/Makefile\n+++ b/Makefile\n@@ -2479,12 +2479,18 @@ man:\n html:\n \t$(MAKE) -C Documentation html\n \n+relnoteshtml:\n+\t$(MAKE) -C Documentation relnoteshtml\n+\n info:\n \t$(MAKE) -C Documentation info\n \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@@ -2797,6 +2803,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\n\n---\nThomas\n"},{"id":"201392","messageId":"7vd30iqd7w.fsf@alter.siamese.dyndns.org","threadId":"31837","inReplyTo":"1213313884.154031.1350407865830.JavaMail.ngmail@webmail15.arcor-online.net","subject":"Re: [Patch v3 0/8] Create single PDF for all HTML files","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2012-10-16T22:11:31Z","receivedAt":"2012-10-16T22:11:31Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> this is v3 of my patch series for creating a single PDF for all\n> git documentation files.\n>\n> There are only 2 changes since v2 (thanks to Junio for pointing me at these issues) :\n> - The over-long lines in git-bisect-lk2009.txt where shortened by abbreviating the SHA1s.\n> - Pretty-printing the shell script in update-hook-example.txt was fixed.\n>\n> To sum up, this patch series provides the following new \"features\":\n> - Make target \"html\" now creates HTML for ALL files in ./Documentation/howto and ./Documentation/technical\n> - New make target \"fullpdf\" first creates HTML for all files in ./Documentation/RelNotes and then collates all HTML \n> files in ./Documentation and its subdirs (except user-manual.html) in one single PDF file.\n>\n> This approach is of course not an optimal one but by using wkhtmltopdf\n> it could be carried out easily.\n\nI am not interested in adding a build target that requires (a\npatched version of) wkhtmltopdf at all, but the earlier parts of\nthis series do look like good clean-ups and useful conversions to\nasciidoc, regardless of which tool we end up deciding to use to\nproduce the final output. Thanks for working on this.\n\nI (and other people who wrote documentation, I suspect, as well)\nfeel somewhat offended by the word \"fix\" here and there in the\nmessage in commits that turn files that so far have been plain text\ninto asciidoc, though ;-).\n"},{"id":"204899","messageId":"683281078.296628.1355560147606.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"31837","inReplyTo":"1479174763.154268.1350408444997.JavaMail.ngmail@webmail15.arcor-online.net","subject":"[Patch] Renumber list in api-command.txt","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2012-12-15T08:29:07Z","receivedAt":"2012-12-15T08:29:07Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\n- Start list with 1 instead of 0 because ASCIIDOC will renumber it anyway\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/technical/api-command.txt | 14 +++++++-------\n 1 file changed, 7 insertions(+), 7 deletions(-)\n\ndiff --git a/Documentation/technical/api-command.txt b/Documentation/technical/api-command.txt\nindex ea9b2ed..d3b9781 100644\n--- a/Documentation/technical/api-command.txt\n+++ b/Documentation/technical/api-command.txt\n@@ -71,28 +71,28 @@ Integrating a command\n Here are the things you need to do when you want to merge a new\n subcommand into the git tree.\n \n-0. Don't forget to sign off your patch!\n+1. Don't forget to sign off your patch!\n \n-1. Append your command name to one of the variables BUILTIN_OBJS,\n+2. Append your command name to one of the variables BUILTIN_OBJS,\n EXTRA_PROGRAMS, SCRIPT_SH, SCRIPT_PERL or SCRIPT_PYTHON.\n \n-2. Drop its test in the t directory.\n+3. Drop its test in the t directory.\n \n-3. If your command is implemented in an interpreted language with a\n+4. If your command is implemented in an interpreted language with a\n p-code intermediate form, make sure .gitignore in the main directory\n includes a pattern entry that ignores such files. Python .pyc and\n .pyo files will already be covered.\n \n-4. If your command has any dependency on a particular version of\n+5. If your command has any dependency on a particular version of\n your language, document it in the INSTALL file.\n \n-5. There is a file command-list.txt in the distribution main directory\n+6. There is a file command-list.txt in the distribution main directory\n that categorizes commands by type, so they can be listed in appropriate\n subsections in the documentation's summary command list. Add an entry\n for yours. To understand the categories, look at git-cmmands.txt\n in the main directory.\n \n-6. Give the maintainer one paragraph to include in the RelNotes file\n+7. Give the maintainer one paragraph to include in the RelNotes file\n to describe the new feature; a good place to do so is in the cover\n letter [PATCH 0/n].\n \n-- \n1.8.0.msysgit.0\n\n\n---\nThomas\n"},{"id":"204961","messageId":"38388978.118261.1355647369577.JavaMail.ngmail@webmail21.arcor-online.net","threadId":"31837","inReplyTo":"1582223824.296627.1355560147565.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH] Remove misleading date form api-index-skel.txt","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2012-12-16T08:42:49Z","receivedAt":"2012-12-16T08:42:49Z","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/technical/api-index-skel.txt | 2 --\n 1 file changed, 2 deletions(-)\n\ndiff --git a/Documentation/technical/api-index-skel.txt b/Documentation/technical/api-index-skel.txt\nindex af7cc2e..730cfac 100644\n--- a/Documentation/technical/api-index-skel.txt\n+++ b/Documentation/technical/api-index-skel.txt\n@@ -11,5 +11,3 @@ documents them.\n ////////////////////////////////////////////////////////////////\n // table of contents end\n ////////////////////////////////////////////////////////////////\n-\n-2007-11-24\n-- \n1.8.0.msysgit.0\n\n\n---\nThomas\n"},{"id":"204962","messageId":"m2ip828jtx.fsf@linux-m68k.org","threadId":"31837","inReplyTo":"38388978.118261.1355647369577.JavaMail.ngmail@webmail21.arcor-online.net","subject":"Re: [PATCH] Remove misleading date form api-index-skel.txt","fromName":"Andreas Schwab","fromEmail":"schwab@linux-m68k.org","sentAt":"2012-12-16T08:47:22Z","receivedAt":"2012-12-16T08:47:22Z","isPatch":true,"sender":{"key":"schwab@linux-m68k.org","avatar":"https://avatars.githubusercontent.com/u/2175493?v=4"},"body":"s/form/from/\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":"204966","messageId":"1702872710.62174.1355660592713.JavaMail.ngmail@webmail12.arcor-online.net","threadId":"31837","inReplyTo":"1582223824.296627.1355560147565.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH] Move api-command.txt to the end of API list in api-index.txt","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2012-12-16T12:23:12Z","receivedAt":"2012-12-16T12:23:12Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\n- because it describes a different form of API than the other api-* documents\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/technical/api-index.sh | 6 +++++-\n 1 file changed, 5 insertions(+), 1 deletion(-)\n\ndiff --git a/Documentation/technical/api-index.sh b/Documentation/technical/api-index.sh\nindex 9c3f413..c2c68ed 100755\n--- a/Documentation/technical/api-index.sh\n+++ b/Documentation/technical/api-index.sh\n@@ -10,12 +10,16 @@\n \twhile read filename\n \tdo\n \t\tcase \"$filename\" in\n-\t\tapi-index-skel.txt | api-index.txt) continue ;;\n+\t\tapi-index-skel.txt | api-index.txt | api-command.txt) continue ;;\n \t\tesac\n \t\ttitle=$(sed -e 1q \"$filename\")\n \t\thtml=${filename%.txt}.html\n \t\techo \"* link:$html[$title]\"\n \tdone\n+\tfilename=api-command.txt\n+\ttitle=$(sed -e 1q \"$filename\")\n+\thtml=${filename%.txt}.html\n+\techo \"* link:$html[$title]\"\n \techo \"$c\"\n \tsed -n -e '/^\\/\\/ table of contents end/,$p' \"$skel\"\n ) >api-index.txt+\n-- \n1.8.0.msysgit.0\n\n\n---\nThomas\n"},{"id":"204986","messageId":"7v1ueprcod.fsf@alter.siamese.dyndns.org","threadId":"31837","inReplyTo":"m2ip828jtx.fsf@linux-m68k.org","subject":"Re: [PATCH] Remove misleading date form api-index-skel.txt","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2012-12-16T19:59:14Z","receivedAt":"2012-12-16T19:59:14Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Andreas Schwab writes:\n\n> s/form/from/\n>\n> Andreas.\n\nThanks; will apply.\n"},{"id":"204987","messageId":"7vwqwhpy0a.fsf@alter.siamese.dyndns.org","threadId":"31837","inReplyTo":"1702872710.62174.1355660592713.JavaMail.ngmail@webmail12.arcor-online.net","subject":"Re: [PATCH] Move api-command.txt to the end of API list in api-index.txt","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2012-12-16T20:01:25Z","receivedAt":"2012-12-16T20:01:25Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> - because it describes a different form of API than the other api-* documents\n\nDrop that \"- \"; it is not like you are enumerating many reasons.\n\nIt makes me wonder if a more correct \"fix\" is to move this document\nto the ../howto/ hierarchy.\n\n>\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/technical/api-index.sh | 6 +++++-\n> 1 file changed, 5 insertions(+), 1 deletion(-)\n>\n> diff --git a/Documentation/technical/api-index.sh b/Documentation/technical/api-index.sh\n> index 9c3f413..c2c68ed 100755\n> --- a/Documentation/technical/api-index.sh\n> +++ b/Documentation/technical/api-index.sh\n> @@ -10,12 +10,16 @@\n> \twhile read filename\n> \tdo\n> \t\tcase \"$filename\" in\n> -\t\tapi-index-skel.txt | api-index.txt) continue ;;\n> +\t\tapi-index-skel.txt | api-index.txt | api-command.txt) continue ;;\n> \t\tesac\n> \t\ttitle=$(sed -e 1q \"$filename\")\n> \t\thtml=${filename%.txt}.html\n> \t\techo \"* link:$html[$title]\"\n> \tdone\n> +\tfilename=api-command.txt\n> +\ttitle=$(sed -e 1q \"$filename\")\n> +\thtml=${filename%.txt}.html\n> +\techo \"* link:$html[$title]\"\n> \techo \"$c\"\n> \tsed -n -e '/^\\/\\/ table of contents end/,$p' \"$skel\"\n> ) >api-index.txt+\n"},{"id":"205040","messageId":"1944303.2385893.1355737432979.JavaMail.ngmail@webmail11.arcor-online.net","threadId":"31837","inReplyTo":"7vwqwhpy0a.fsf@alter.siamese.dyndns.org","subject":"Aw: Re: [PATCH] Move api-command.txt to the end of API list in api-index.txt","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2012-12-17T09:43:52Z","receivedAt":"2012-12-17T09:43:52Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \nOK; I would also prefer to have it in ./howto.\nSo please drop this patch; I will provide a new one.\n\n----- Original Nachricht ----\nVon: Junio C Hamano \nAn: Thomas Ackermann \nDatum: 16.12.2012 21:01\nBetreff: Re: [PATCH] Move api-command.txt to the end of API list in\n api-index.txt\n\n> Thomas Ackermann writes:\n> \n> > - because it describes a different form of API than the other api-*\n> documents\n> \n> It makes me wonder if a more correct \"fix\" is to move this document\n> to the ../howto/ hierarchy.\n> \n\n\n---\nThomas\n"}]}