* [Patch v2 0/8] Create single PDF for all HTML files
@ 2012-10-11 17:13 Thomas Ackermann
2012-10-11 17:16 ` [Patch v2 1/8] Split over-long synopsis in git-fetch-pack.txt into several lines Thomas Ackermann
` (8 more replies)
0 siblings, 9 replies; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:13 UTC (permalink / raw)
To: git; +Cc: philipoakley, peff, gitster, th.acker66
Hi,
here is my reworked patch series for creating a single PDF for all
git documentation files.
Thanks to Junio Hamano, Philip Oakley and Jeff King for your comments!
In general, the following problems had to be fixed in doc files in order to create
HTML by using asciidoc and afterwards create a nice looking PDF using wkhtmltopdf:
- Wrong sectioning syntax (e.g. "===" instead of "---")
- Left-over shell scripting commands (in some release notes files)
- Over-long lines which caused very wide right margins in the resulting PDF
- Wrong formatting for email quotes, quoted script code, tables
Also some of the headlines in the documents where changed or even created
initially in order to give a more consistent structure in the resulting PDF.
If you want to have a quick look on the resulting PDF just clone
https://github.com/tacker66/git-docpdf.git. This repo contains
a current version of user.manual.pdf and git-doc.pdf
---
Thomas
^ permalink raw reply [flat|nested] 12+ messages in thread
* [Patch v2 1/8] Split over-long synopsis in git-fetch-pack.txt into several lines
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
@ 2012-10-11 17:16 ` Thomas Ackermann
2012-10-11 17:18 ` [Patch v2 2/8] Shorten two over-long lines in git-bisect-lk2009.txt by removing some white-space Thomas Ackermann
` (7 subsequent siblings)
8 siblings, 0 replies; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:16 UTC (permalink / raw)
To: th.acker66, git; +Cc: philipoakley, peff, gitster, th.acker66
>From 27b3105a374158fb8cb008c808a1ef94487a48f7 Mon Sep 17 00:00:00 2001
From: Thomas Ackermann <th.acker@arcor.de>
Date: Thu, 4 Oct 2012 19:11:43 +0200
Subject: [PATCH] Split over-long synopsis in git-fetch-pack.txt into several
lines
Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
Documentation/git-fetch-pack.txt | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/Documentation/git-fetch-pack.txt b/Documentation/git-fetch-pack.txt
index 474fa30..12cd8a2 100644
--- a/Documentation/git-fetch-pack.txt
+++ b/Documentation/git-fetch-pack.txt
@@ -9,7 +9,10 @@ git-fetch-pack - Receive missing objects from another repository
SYNOPSIS
--------
[verse]
-'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] [--upload-pack=<git-upload-pack>] [--depth=<n>] [--no-progress] [-v] [<host>:]<directory> [<refs>...]
+'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag]
+ [--upload-pack=<git-upload-pack>]
+ [--depth=<n>] [--no-progress]
+ [-v] [<host>:]<directory> [<refs>...]
DESCRIPTION
-----------
--
1.7.11.msysgit.1
---
Thomas
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [Patch v2 2/8] Shorten two over-long lines in git-bisect-lk2009.txt by removing some white-space
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
2012-10-11 17:16 ` [Patch v2 1/8] Split over-long synopsis in git-fetch-pack.txt into several lines Thomas Ackermann
@ 2012-10-11 17:18 ` Thomas Ackermann
2012-10-11 19:07 ` Junio C Hamano
2012-10-11 17:19 ` [Patch v2 3/8] Change headline of technical/send-pack-pipeline.txt to not confuse its content with content from git-send-pack.txt Thomas Ackermann
` (6 subsequent siblings)
8 siblings, 1 reply; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:18 UTC (permalink / raw)
To: th.acker66, git; +Cc: philipoakley, peff, gitster, th.acker66
>From e7c97695b676e1ebe66491b3ed256051b9a3b4f1 Mon Sep 17 00:00:00 2001
From: Thomas Ackermann <th.acker@arcor.de>
Date: Thu, 4 Oct 2012 19:11:43 +0200
Subject: [PATCH] Shorten two over-long lines in git-bisect-lk2009.txt by
removing some white-space
Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
Documentation/git-bisect-lk2009.txt | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-bisect-lk2009.txt b/Documentation/git-bisect-lk2009.txt
index 8a2ba37..80745d7 100644
--- a/Documentation/git-bisect-lk2009.txt
+++ b/Documentation/git-bisect-lk2009.txt
@@ -257,7 +257,7 @@ Date: Sat May 3 11:59:44 2008 -0700
Linux 2.6.26-rc1
-:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile
+:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile
-------------
At this point we can see what the commit does, check it out (if it's
@@ -331,7 +331,7 @@ Date: Sat May 3 11:59:44 2008 -0700
Linux 2.6.26-rc1
-:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile
+:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile
bisect run success
-------------
--
1.7.11.msysgit.1
---
Thomas
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [Patch v2 3/8] Change headline of technical/send-pack-pipeline.txt to not confuse its content with content from git-send-pack.txt
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
2012-10-11 17:16 ` [Patch v2 1/8] Split over-long synopsis in git-fetch-pack.txt into several lines Thomas Ackermann
2012-10-11 17:18 ` [Patch v2 2/8] Shorten two over-long lines in git-bisect-lk2009.txt by removing some white-space Thomas Ackermann
@ 2012-10-11 17:19 ` Thomas Ackermann
2012-10-11 17:21 ` [Patch v2 4/8] Prerequisites for creating nice html for all files in Documentation/technical Thomas Ackermann
` (5 subsequent siblings)
8 siblings, 0 replies; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:19 UTC (permalink / raw)
To: th.acker66, git; +Cc: philipoakley, peff, gitster, th.acker66
>From af1f0dc8e02ef178fc89f5fa3893a997a4a9b2eb Mon Sep 17 00:00:00 2001
From: Thomas Ackermann <th.acker@arcor.de>
Date: Tue, 9 Oct 2012 20:19:34 +0200
Subject: [PATCH] Change headline of technical/send-pack-pipeline.txt to not
confuse its content with content from git-send-pack.txt
Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
Documentation/technical/send-pack-pipeline.txt | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/Documentation/technical/send-pack-pipeline.txt b/Documentation/technical/send-pack-pipeline.txt
index 681efe4..9b5a0bc 100644
--- a/Documentation/technical/send-pack-pipeline.txt
+++ b/Documentation/technical/send-pack-pipeline.txt
@@ -1,5 +1,5 @@
-git-send-pack
-=============
+Git-send-pack internals
+=======================
Overall operation
-----------------
--
1.7.11.msysgit.1
---
Thomas
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [Patch v2 4/8] Prerequisites for creating nice html for all files in Documentation/technical
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
` (2 preceding siblings ...)
2012-10-11 17:19 ` [Patch v2 3/8] Change headline of technical/send-pack-pipeline.txt to not confuse its content with content from git-send-pack.txt Thomas Ackermann
@ 2012-10-11 17:21 ` Thomas Ackermann
2012-10-11 17:22 ` [Patch v2 5/8] Prerequisites for creating nice html for all files in Documentation/howto Thomas Ackermann
` (4 subsequent siblings)
8 siblings, 0 replies; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:21 UTC (permalink / raw)
To: th.acker66, git; +Cc: philipoakley, peff, gitster, th.acker66
>From 23b5272cbb27dca7e292f33c79cf3d8e21298b78 Mon Sep 17 00:00:00 2001
From: Thomas Ackermann <th.acker@arcor.de>
Date: Sat, 29 Sep 2012 10:00:00 +0200
Subject: [PATCH] Prerequisites for creating nice html for all files in
Documentation/technical
- fix wrong asciidoc sectioning markup in index-format.txt, pack-format.txt and pack-protocol.txt
- split an over-long line in pack-protocol.txt into several lines
- add a markup box for definition part in shallow.txt
- fix table markup in trivial-merge.txt
Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
Documentation/technical/index-format.txt | 2 +-
Documentation/technical/pack-format.txt | 8 +++----
Documentation/technical/pack-protocol.txt | 7 +++---
Documentation/technical/shallow.txt | 8 ++++++-
Documentation/technical/trivial-merge.txt | 36 +++++++++++++++----------------
5 files changed, 34 insertions(+), 27 deletions(-)
diff --git a/Documentation/technical/index-format.txt b/Documentation/technical/index-format.txt
index 9d25b30..57d6f91 100644
--- a/Documentation/technical/index-format.txt
+++ b/Documentation/technical/index-format.txt
@@ -1,7 +1,7 @@
GIT index format
================
-= The git index file has the following format
+== The git index file has the following format
All binary numbers are in network byte order. Version 2 is described
here unless stated otherwise.
diff --git a/Documentation/technical/pack-format.txt b/Documentation/technical/pack-format.txt
index 1803e64..a7871fb 100644
--- a/Documentation/technical/pack-format.txt
+++ b/Documentation/technical/pack-format.txt
@@ -1,7 +1,7 @@
GIT pack format
===============
-= pack-*.pack files have the following format:
+== pack-*.pack files have the following format:
- A header appears at the beginning and consists of the following:
@@ -34,7 +34,7 @@ GIT pack format
- The trailer records 20-byte SHA1 checksum of all of the above.
-= Original (version 1) pack-*.idx files have the following format:
+== Original (version 1) pack-*.idx files have the following format:
- The header consists of 256 4-byte network byte order
integers. N-th entry of this table records the number of
@@ -123,8 +123,8 @@ Pack file entry: <+
-= Version 2 pack-*.idx files support packs larger than 4 GiB, and
- have some other reorganizations. They have the format:
+== Version 2 pack-*.idx files support packs larger than 4 GiB, and
+ have some other reorganizations. They have the format:
- A 4-byte magic number '\377tOc' which is an unreasonable
fanout[0] value.
diff --git a/Documentation/technical/pack-protocol.txt b/Documentation/technical/pack-protocol.txt
index d51e20f..25e1fbe 100644
--- a/Documentation/technical/pack-protocol.txt
+++ b/Documentation/technical/pack-protocol.txt
@@ -117,7 +117,7 @@ A few things to remember here:
- The repository path is always quoted with single quotes.
Fetching Data From a Server
-===========================
+---------------------------
When one Git repository wants to get data that a second repository
has, the first can 'fetch' from the second. This operation determines
@@ -134,7 +134,8 @@ with the object name that each reference currently points to.
$ echo -e -n "0039git-upload-pack /schacon/gitbook.git\0host=example.com\0" |
nc -v example.com 9418
- 00887217a7c7e582c46cec22a130adf4b9d7d950fba0 HEAD\0multi_ack thin-pack side-band side-band-64k ofs-delta shallow no-progress include-tag
+ 00887217a7c7e582c46cec22a130adf4b9d7d950fba0 HEAD\0multi_ack thin-pack
+ side-band side-band-64k ofs-delta shallow no-progress include-tag
00441d3fcd5ced445d1abc402225c0b8a1299641f497 refs/heads/integration
003f7217a7c7e582c46cec22a130adf4b9d7d950fba0 refs/heads/master
003cb88d2441cac0977faf98efc80305012112238d9d refs/tags/v0.9
@@ -421,7 +422,7 @@ entire packfile without multiplexing.
Pushing Data To a Server
-========================
+------------------------
Pushing data to a server will invoke the 'receive-pack' process on the
server, which will allow the client to tell it which references it should
diff --git a/Documentation/technical/shallow.txt b/Documentation/technical/shallow.txt
index 559263a..0502a54 100644
--- a/Documentation/technical/shallow.txt
+++ b/Documentation/technical/shallow.txt
@@ -1,6 +1,12 @@
-Def.: Shallow commits do have parents, but not in the shallow
+Shallow commits
+===============
+
+.Definition
+*********************************************************
+Shallow commits do have parents, but not in the shallow
repo, and therefore grafts are introduced pretending that
these commits have no parents.
+*********************************************************
The basic idea is to write the SHA1s of shallow commits into
$GIT_DIR/shallow, and handle its contents like the contents
diff --git a/Documentation/technical/trivial-merge.txt b/Documentation/technical/trivial-merge.txt
index 24c8410..c79d4a7 100644
--- a/Documentation/technical/trivial-merge.txt
+++ b/Documentation/technical/trivial-merge.txt
@@ -74,24 +74,24 @@ For multiple ancestors, a '+' means that this case applies even if
only one ancestor or remote fits; a '^' means all of the ancestors
must be the same.
-case ancest head remote result
-----------------------------------------
-1 (empty)+ (empty) (empty) (empty)
-2ALT (empty)+ *empty* remote remote
-2 (empty)^ (empty) remote no merge
-3ALT (empty)+ head *empty* head
-3 (empty)^ head (empty) no merge
-4 (empty)^ head remote no merge
-5ALT * head head head
-6 ancest+ (empty) (empty) no merge
-8 ancest^ (empty) ancest no merge
-7 ancest+ (empty) remote no merge
-10 ancest^ ancest (empty) no merge
-9 ancest+ head (empty) no merge
-16 anc1/anc2 anc1 anc2 no merge
-13 ancest+ head ancest head
-14 ancest+ ancest remote remote
-11 ancest+ head remote no merge
+ case ancest head remote result
+ ----------------------------------------
+ 1 (empty)+ (empty) (empty) (empty)
+ 2ALT (empty)+ *empty* remote remote
+ 2 (empty)^ (empty) remote no merge
+ 3ALT (empty)+ head *empty* head
+ 3 (empty)^ head (empty) no merge
+ 4 (empty)^ head remote no merge
+ 5ALT * head head head
+ 6 ancest+ (empty) (empty) no merge
+ 8 ancest^ (empty) ancest no merge
+ 7 ancest+ (empty) remote no merge
+ 10 ancest^ ancest (empty) no merge
+ 9 ancest+ head (empty) no merge
+ 16 anc1/anc2 anc1 anc2 no merge
+ 13 ancest+ head ancest head
+ 14 ancest+ ancest remote remote
+ 11 ancest+ head remote no merge
Only #2ALT and #3ALT use *empty*, because these are the only cases
where there can be conflicts that didn't exist before. Note that we
--
1.7.11.msysgit.1
---
Thomas
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [Patch v2 5/8] Prerequisites for creating nice html for all files in Documentation/howto
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
` (3 preceding siblings ...)
2012-10-11 17:21 ` [Patch v2 4/8] Prerequisites for creating nice html for all files in Documentation/technical Thomas Ackermann
@ 2012-10-11 17:22 ` Thomas Ackermann
2012-10-11 19:06 ` Junio C Hamano
2012-10-11 17:23 ` [Patch v2 6/8] Prerequisites for creating nice html for all files in Documentation/RelNotes Thomas Ackermann
` (3 subsequent siblings)
8 siblings, 1 reply; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:22 UTC (permalink / raw)
To: th.acker66, git; +Cc: philipoakley, peff, gitster, th.acker66
>From 2b9538990e30ae0911117c8e3d8b6891c9de31cf Mon Sep 17 00:00:00 2001
From: Thomas Ackermann <th.acker@arcor.de>
Date: Sat, 29 Sep 2012 17:28:54 +0200
Subject: [PATCH] Prerequisites for creating nice html for all files in
Documentation/howto
- create headlines with asciidoc markup
- asciidoc box markup for mail replies in recover-corrupted-blob-object.txt
- pretty-print shell script in update-hook-example.txt
- correct indendation for allowed-users example in update-hook-example.txt
- headline of every howto document starts with "How to ..."
- add "Content-type: text/asciidoc" in new files (used in howto-index.sh)
Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
Documentation/howto/maintain-git.txt | 4 ++
.../howto/rebase-from-internal-branch.txt | 11 ++---
Documentation/howto/rebuild-from-update-hook.txt | 4 ++
.../howto/recover-corrupted-blob-object.txt | 10 +++++
Documentation/howto/revert-a-faulty-merge.txt | 4 ++
Documentation/howto/revert-branch-rebase.txt | 4 +-
Documentation/howto/separating-topic-branches.txt | 4 ++
Documentation/howto/setup-git-server-over-http.txt | 4 ++
Documentation/howto/update-hook-example.txt | 50 +++++++++++-----------
Documentation/howto/use-git-daemon.txt | 3 ++
.../howto/using-signed-tag-in-pull-request.txt | 4 +-
11 files changed, 68 insertions(+), 34 deletions(-)
diff --git a/Documentation/howto/maintain-git.txt b/Documentation/howto/maintain-git.txt
index 8823a37..ea6e4a5 100644
--- a/Documentation/howto/maintain-git.txt
+++ b/Documentation/howto/maintain-git.txt
@@ -5,6 +5,10 @@ Abstract: Imagine that git development is racing along as usual, when our friend
neighborhood maintainer is struck down by a wayward bus. Out of the
hordes of suckers (loyal developers), you have been tricked (chosen) to
step up as the new maintainer. This howto will show you "how to" do it.
+Content-type: text/asciidoc
+
+How to maintain Git
+===================
The maintainer's git time is spent on three activities.
diff --git a/Documentation/howto/rebase-from-internal-branch.txt b/Documentation/howto/rebase-from-internal-branch.txt
index 74a1c0c..4627ee4 100644
--- a/Documentation/howto/rebase-from-internal-branch.txt
+++ b/Documentation/howto/rebase-from-internal-branch.txt
@@ -8,7 +8,12 @@ Abstract: In this article, JC talks about how he rebases the
the "master" branch, and how "rebase" works. Also discussed
is how this applies to individual developers who sends patches
upstream.
+Content-type: text/asciidoc
+How to rebase from an internal branch
+=====================================
+
+--------------------------------------
Petr Baudis <pasky@suse.cz> writes:
> Dear diary, on Sun, Aug 14, 2005 at 09:57:13AM CEST, I got a letter
@@ -19,6 +24,7 @@ Petr Baudis <pasky@suse.cz> writes:
>> > branch to the real branches.
>>
> Actually, wouldn't this be also precisely for what StGIT is intended to?
+--------------------------------------
Exactly my feeling. I was sort of waiting for Catalin to speak
up. With its basing philosophical ancestry on quilt, this is
@@ -156,8 +162,3 @@ you continue on starting from the new "master" head, which is
the #1' commit.
-jc
-
--
-To unsubscribe from this list: send the line "unsubscribe git" in
-the body of a message to majordomo@vger.kernel.org
-More majordomo info at http://vger.kernel.org/majordomo-info.html
diff --git a/Documentation/howto/rebuild-from-update-hook.txt b/Documentation/howto/rebuild-from-update-hook.txt
index 48c6756..00c1b45 100644
--- a/Documentation/howto/rebuild-from-update-hook.txt
+++ b/Documentation/howto/rebuild-from-update-hook.txt
@@ -5,6 +5,10 @@ Date: Fri, 26 Aug 2005 18:19:10 -0700
Abstract: In this how-to article, JC talks about how he
uses the post-update hook to automate git documentation page
shown at http://www.kernel.org/pub/software/scm/git/docs/.
+Content-type: text/asciidoc
+
+How to rebuild from update hook
+===============================
The pages under http://www.kernel.org/pub/software/scm/git/docs/
are built from Documentation/ directory of the git.git project
diff --git a/Documentation/howto/recover-corrupted-blob-object.txt b/Documentation/howto/recover-corrupted-blob-object.txt
index 323b513..7484735 100644
--- a/Documentation/howto/recover-corrupted-blob-object.txt
+++ b/Documentation/howto/recover-corrupted-blob-object.txt
@@ -3,11 +3,17 @@ From: Linus Torvalds <torvalds@linux-foundation.org>
Subject: corrupt object on git-gc
Abstract: Some tricks to reconstruct blob objects in order to fix
a corrupted repository.
+Content-type: text/asciidoc
+How to recover a corrupted blob object
+======================================
+
+-----------------------------------------------------------
On Fri, 9 Nov 2007, Yossi Leybovich wrote:
>
> Did not help still the repository look for this object?
> Any one know how can I track this object and understand which file is it
+-----------------------------------------------------------
So exactly *because* the SHA1 hash is cryptographically secure, the hash
itself doesn't actually tell you anything, in order to fix a corrupt
@@ -31,19 +37,23 @@ original object, so right now the corrupt object is useless, but it's very
interesting for the future, in the hope that you can re-create a
non-corrupt version.
+-----------------------------------------------------------
So:
> ib]$ mv .git/objects/4b/9458b3786228369c63936db65827de3cc06200 ../
+-----------------------------------------------------------
This is the right thing to do, although it's usually best to save it under
it's full SHA1 name (you just dropped the "4b" from the result ;).
Let's see what that tells us:
+-----------------------------------------------------------
> ib]$ git-fsck --full
> broken link from tree 2d9263c6d23595e7cb2a21e5ebbb53655278dff8
> to blob 4b9458b3786228369c63936db65827de3cc06200
> missing blob 4b9458b3786228369c63936db65827de3cc06200
+-----------------------------------------------------------
Ok, I removed the "dangling commit" messages, because they are just
messages about the fact that you probably have rebased etc, so they're not
diff --git a/Documentation/howto/revert-a-faulty-merge.txt b/Documentation/howto/revert-a-faulty-merge.txt
index 6fd7119..8a68548 100644
--- a/Documentation/howto/revert-a-faulty-merge.txt
+++ b/Documentation/howto/revert-a-faulty-merge.txt
@@ -7,6 +7,10 @@ Abstract: Sometimes a branch that was already merged to the mainline
after the offending branch is fixed.
Message-ID: <7vocz8a6zk.fsf@gitster.siamese.dyndns.org>
References: <alpine.LFD.2.00.0812181949450.14014@localhost.localdomain>
+Content-type: text/asciidoc
+
+How to revert a faulty merge
+============================
Alan <alan@clueserver.org> said:
diff --git a/Documentation/howto/revert-branch-rebase.txt b/Documentation/howto/revert-branch-rebase.txt
index 093c656..a59ced8 100644
--- a/Documentation/howto/revert-branch-rebase.txt
+++ b/Documentation/howto/revert-branch-rebase.txt
@@ -8,8 +8,8 @@ Date: Mon, 29 Aug 2005 21:39:02 -0700
Content-type: text/asciidoc
Message-ID: <7voe7g3uop.fsf@assigned-by-dhcp.cox.net>
-Reverting an existing commit
-============================
+How to revert an existing commit
+================================
One of the changes I pulled into the 'master' branch turns out to
break building GIT with GCC 2.95. While they were well intentioned
diff --git a/Documentation/howto/separating-topic-branches.txt b/Documentation/howto/separating-topic-branches.txt
index 6d3eb8e..bd10274 100644
--- a/Documentation/howto/separating-topic-branches.txt
+++ b/Documentation/howto/separating-topic-branches.txt
@@ -1,6 +1,10 @@
From: Junio C Hamano <gitster@pobox.com>
Subject: Separating topic branches
Abstract: In this article, JC describes how to separate topic branches.
+Content-type: text/asciidoc
+
+How to separate topic branches
+==============================
This text was originally a footnote to a discussion about the
behaviour of the git diff commands.
diff --git a/Documentation/howto/setup-git-server-over-http.txt b/Documentation/howto/setup-git-server-over-http.txt
index 622ee5c..a695f01 100644
--- a/Documentation/howto/setup-git-server-over-http.txt
+++ b/Documentation/howto/setup-git-server-over-http.txt
@@ -1,6 +1,10 @@
From: Rutger Nijlunsing <rutger@nospam.com>
Subject: Setting up a git repository which can be pushed into and pulled from over HTTP(S).
Date: Thu, 10 Aug 2006 22:00:26 +0200
+Content-type: text/asciidoc
+
+How to setup git server over http
+=================================
Since Apache is one of those packages people like to compile
themselves while others prefer the bureaucrat's dream Debian, it is
diff --git a/Documentation/howto/update-hook-example.txt b/Documentation/howto/update-hook-example.txt
index b7f8d41..2b472f7 100644
--- a/Documentation/howto/update-hook-example.txt
+++ b/Documentation/howto/update-hook-example.txt
@@ -5,6 +5,10 @@ Message-ID: <7vfypumlu3.fsf@assigned-by-dhcp.cox.net>
Abstract: An example hooks/update script is presented to
implement repository maintenance policies, such as who can push
into which branch and who can make a tag.
+Content-type: text/asciidoc
+
+How to use the update hook
+==========================
When your developer runs git-push into the repository,
git-receive-pack is run (either locally or over ssh) as that
@@ -32,8 +36,7 @@ like this as your hooks/update script.
[jc: editorial note. This is a much improved version by Carl
since I posted the original outline]
--- >8 -- beginning of script -- >8 --
-
+----------------------------------------------------
#!/bin/bash
umask 002
@@ -111,12 +114,12 @@ then
info "Found matching head pattern: '$head_pattern'"
for user_pattern in $user_patterns; do
- info "Checking user: '$username' against pattern: '$user_pattern'"
- matchlen=$(expr "$username" : "$user_pattern")
- if test "$matchlen" = "${#username}"
- then
- grant "Allowing user: '$username' with pattern: '$user_pattern'"
- fi
+ info "Checking user: '$username' against pattern: '$user_pattern'"
+ matchlen=$(expr "$username" : "$user_pattern")
+ if test "$matchlen" = "${#username}"
+ then
+ grant "Allowing user: '$username' with pattern: '$user_pattern'"
+ fi
done
deny "The user is not in the access list for this branch"
done
@@ -149,13 +152,13 @@ then
info "Found matching head pattern: '$head_pattern'"
for group_pattern in $group_patterns; do
- for groupname in $groups; do
- info "Checking group: '$groupname' against pattern: '$group_pattern'"
- matchlen=$(expr "$groupname" : "$group_pattern")
- if test "$matchlen" = "${#groupname}"
- then
- grant "Allowing group: '$groupname' with pattern: '$group_pattern'"
- fi
+ for groupname in $groups; do
+ info "Checking group: '$groupname' against pattern: '$group_pattern'"
+ matchlen=$(expr "$groupname" : "$group_pattern")
+ if test "$matchlen" = "${#groupname}"
+ then
+ grant "Allowing group: '$groupname' with pattern: '$group_pattern'"
+ fi
done
done
deny "None of the user's groups are in the access list for this branch"
@@ -169,24 +172,21 @@ then
fi
deny >/dev/null "There are no more rules to check. Denying access"
-
--- >8 -- end of script -- >8 --
+----------------------------------------------------
This uses two files, $GIT_DIR/info/allowed-users and
allowed-groups, to describe which heads can be pushed into by
whom. The format of each file would look like this:
- refs/heads/master junio
- +refs/heads/pu junio
- refs/heads/cogito$ pasky
- refs/heads/bw/.* linus
- refs/heads/tmp/.* .*
- refs/tags/v[0-9].* junio
+ refs/heads/master junio
+ +refs/heads/pu junio
+ refs/heads/cogito$ pasky
+ refs/heads/bw/.* linus
+ refs/heads/tmp/.* .*
+ refs/tags/v[0-9].* junio
With this, Linus can push or create "bw/penguin" or "bw/zebra"
or "bw/panda" branches, Pasky can do only "cogito", and JC can
do master and pu branches and make versioned tags. And anybody
can do tmp/blah branches. The '+' sign at the pu record means
that JC can make non-fast-forward pushes on it.
-
-------------
diff --git a/Documentation/howto/use-git-daemon.txt b/Documentation/howto/use-git-daemon.txt
index 4e2f75c..23cdf35 100644
--- a/Documentation/howto/use-git-daemon.txt
+++ b/Documentation/howto/use-git-daemon.txt
@@ -1,4 +1,7 @@
+Content-type: text/asciidoc
+
How to use git-daemon
+=====================
Git can be run in inetd mode and in stand alone mode. But all you want is
let a coworker pull from you, and therefore need to set up a git server
diff --git a/Documentation/howto/using-signed-tag-in-pull-request.txt b/Documentation/howto/using-signed-tag-in-pull-request.txt
index 98c0033..00f693b 100644
--- a/Documentation/howto/using-signed-tag-in-pull-request.txt
+++ b/Documentation/howto/using-signed-tag-in-pull-request.txt
@@ -7,8 +7,8 @@ Abstract: Beginning v1.7.9, a contributor can push a signed tag to her
later validate it.
Content-type: text/asciidoc
-Using signed tag in pull requests
-=================================
+How to use a signed tag in pull requests
+========================================
A typical distributed workflow using Git is for a contributor to fork a
project, build on it, publish the result to her public repository, and ask
--
1.7.11.msysgit.1
---
Thomas
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [Patch v2 6/8] Prerequisites for creating nice html for all files in Documentation/RelNotes
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
` (4 preceding siblings ...)
2012-10-11 17:22 ` [Patch v2 5/8] Prerequisites for creating nice html for all files in Documentation/howto Thomas Ackermann
@ 2012-10-11 17:23 ` Thomas Ackermann
2012-10-11 17:24 ` [Patch v2 7/8] Create pdf from all html files Thomas Ackermann
` (2 subsequent siblings)
8 siblings, 0 replies; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:23 UTC (permalink / raw)
To: th.acker66, git; +Cc: philipoakley, peff, gitster, th.acker66
>From cd7a26f5e7ba8cc42bf81e1b78f800460510b71f Mon Sep 17 00:00:00 2001
From: Thomas Ackermann <th.acker@arcor.de>
Date: Sat, 29 Sep 2012 11:00:00 +0200
Subject: [PATCH] Prerequisites for creating nice html for all files in
Documentation/RelNotes
- remove left-over shell-script fragments from some files
Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
Documentation/RelNotes/1.5.2.1.txt | 6 ------
Documentation/RelNotes/1.6.0.2.txt | 6 ------
Documentation/RelNotes/1.6.1.3.txt | 4 ----
Documentation/RelNotes/1.6.1.4.txt | 3 ---
Documentation/RelNotes/1.6.1.txt | 6 ------
5 files changed, 25 deletions(-)
diff --git a/Documentation/RelNotes/1.5.2.1.txt b/Documentation/RelNotes/1.5.2.1.txt
index ebf20e2..d41984d 100644
--- a/Documentation/RelNotes/1.5.2.1.txt
+++ b/Documentation/RelNotes/1.5.2.1.txt
@@ -45,9 +45,3 @@ Fixes since v1.5.2
- git-fastimport --import-marks was broken; fixed.
- A lot of documentation updates, clarifications and fixes.
-
---
-exec >/var/tmp/1
-O=v1.5.2-65-g996e2d6
-echo O=`git describe refs/heads/maint`
-git shortlog --no-merges $O..refs/heads/maint
diff --git a/Documentation/RelNotes/1.6.0.2.txt b/Documentation/RelNotes/1.6.0.2.txt
index e1e24b3..7d8fb85 100644
--- a/Documentation/RelNotes/1.6.0.2.txt
+++ b/Documentation/RelNotes/1.6.0.2.txt
@@ -79,9 +79,3 @@ Fixes since v1.6.0.1
packfile.
Also contains many documentation updates.
-
---
-exec >/var/tmp/1
-O=v1.6.0.1-78-g3632cfc
-echo O=$(git describe maint)
-git shortlog --no-merges $O..maint
diff --git a/Documentation/RelNotes/1.6.1.3.txt b/Documentation/RelNotes/1.6.1.3.txt
index 6f0bde1..cd08d81 100644
--- a/Documentation/RelNotes/1.6.1.3.txt
+++ b/Documentation/RelNotes/1.6.1.3.txt
@@ -26,7 +26,3 @@ Fixes since v1.6.1.2
* RPM binary package installed the html manpages in a wrong place.
Also includes minor documentation fixes and updates.
-
-
---
-git shortlog --no-merges v1.6.1.2-33-gc789350..
diff --git a/Documentation/RelNotes/1.6.1.4.txt b/Documentation/RelNotes/1.6.1.4.txt
index 0ce6316..ccbad79 100644
--- a/Documentation/RelNotes/1.6.1.4.txt
+++ b/Documentation/RelNotes/1.6.1.4.txt
@@ -39,6 +39,3 @@ Fixes since v1.6.1.3
This fix was first merged to 1.6.2.3.
Also includes minor documentation fixes and updates.
-
---
-git shortlog --no-merges v1.6.1.3..
diff --git a/Documentation/RelNotes/1.6.1.txt b/Documentation/RelNotes/1.6.1.txt
index adb7cca..7b152a6 100644
--- a/Documentation/RelNotes/1.6.1.txt
+++ b/Documentation/RelNotes/1.6.1.txt
@@ -278,9 +278,3 @@ release, unless otherwise noted.
* "gitweb" did not mark non-ASCII characters imported from external HTML fragments
correctly.
-
---
-exec >/var/tmp/1
-O=v1.6.1-rc3-74-gf66bc5f
-echo O=$(git describe master)
-git shortlog --no-merges $O..master ^maint
--
1.7.11.msysgit.1
---
Thomas
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [Patch v2 7/8] Create pdf from all html files
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
` (5 preceding siblings ...)
2012-10-11 17:23 ` [Patch v2 6/8] Prerequisites for creating nice html for all files in Documentation/RelNotes Thomas Ackermann
@ 2012-10-11 17:24 ` Thomas Ackermann
2012-10-11 17:26 ` [Patch v2 8/8] Wire everything into Makefile and Documentation/Makefile Thomas Ackermann
2012-10-11 19:30 ` [Patch v2 0/8] Create single PDF for all HTML files Junio C Hamano
8 siblings, 0 replies; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:24 UTC (permalink / raw)
To: th.acker66, git; +Cc: philipoakley, peff, gitster, th.acker66
>From 31f86526e0a0bd00be57db3275c860913f668fb8 Mon Sep 17 00:00:00 2001
From: Thomas Ackermann <th.acker@arcor.de>
Date: Mon, 1 Oct 2012 20:06:48 +0200
Subject: [PATCH] Create pdf from all html files
- use wkhtmltopdf ("patched QT" version) to combine all html files into a single pdf file "git-doc.pdf"
- insert page breaks to separate major sections
Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
Documentation/.gitignore | 1 +
| 4 ++++
| 7 ++++++
Documentation/makedocpdf.sh | 53 +++++++++++++++++++++++++++++++++++++++++++
Documentation/pagebreak.txt | 1 +
5 files changed, 66 insertions(+)
create mode 100644 Documentation/footerend.txt
create mode 100644 Documentation/footerstart.txt
create mode 100755 Documentation/makedocpdf.sh
create mode 100644 Documentation/pagebreak.txt
diff --git a/Documentation/.gitignore b/Documentation/.gitignore
index d62aebd..fba4730 100644
--- a/Documentation/.gitignore
+++ b/Documentation/.gitignore
@@ -10,3 +10,4 @@ howto-index.txt
doc.dep
cmds-*.txt
manpage-base-url.xsl
+docfiles.txt
--git a/Documentation/footerend.txt b/Documentation/footerend.txt
new file mode 100644
index 0000000..ed16923
--- /dev/null
+++ b/Documentation/footerend.txt
@@ -0,0 +1,4 @@
+ </td>
+ </tr>
+</table>
+</body></html>
--git a/Documentation/footerstart.txt b/Documentation/footerstart.txt
new file mode 100644
index 0000000..a2746ef
--- /dev/null
+++ b/Documentation/footerstart.txt
@@ -0,0 +1,7 @@
+<html>
+<head></head>
+<body style="border:0; margin: 0;" onload="subst()">
+<table style="border-top: 1px solid black; width: 100%">
+ <tr>
+ <td class="section"></td>
+ <td style="text-align:center">
diff --git a/Documentation/makedocpdf.sh b/Documentation/makedocpdf.sh
new file mode 100755
index 0000000..5f1a2c1
--- /dev/null
+++ b/Documentation/makedocpdf.sh
@@ -0,0 +1,53 @@
+#!/bin/sh
+
+rm -f git-doc.pdf
+
+cat pagebreak.txt >pagebreak.html
+
+cat /dev/null >docfiles.txt
+
+ls gittutorial.html >>docfiles.txt
+ls gittutorial-2.html >>docfiles.txt
+ls everyday.html >>docfiles.txt
+ls gitworkflows.html >>docfiles.txt
+
+ls pagebreak.html >>docfiles.txt
+ls git.html >>docfiles.txt
+ls git-a*.html >>docfiles.txt
+ls git-bisect.html >>docfiles.txt
+ls git-b[j-z]*.html >>docfiles.txt
+ls git-[c-s]*.html >>docfiles.txt
+ls git-ta*.html >>docfiles.txt
+ls gitk.html >>docfiles.txt
+ls git-[u-z]*.html >>docfiles.txt
+
+ls pagebreak.html >>docfiles.txt
+ls gita*.html >>docfiles.txt
+ls git-bisect-lk2009.html >>docfiles.txt
+ls git[cdghimnr]*.html >>docfiles.txt
+ls git-tools.html >>docfiles.txt
+ls gitweb*.html >>docfiles.txt
+
+ls pagebreak.html >>docfiles.txt
+ls howto-index.html >>docfiles.txt
+ls howto/*.html >>docfiles.txt
+
+ls pagebreak.html >>docfiles.txt
+ls technical/[b-z]*.html >>docfiles.txt
+
+ls pagebreak.html >>docfiles.txt
+ls technical/api-index.html >>docfiles.txt
+ls technical/api-[a-h]*.html >>docfiles.txt
+ls technical/api-in-*.html >>docfiles.txt
+ls technical/api-[j-z]*.html >>docfiles.txt
+
+ls pagebreak.html >>docfiles.txt
+ls RelNotes/*.html >>docfiles.txt
+
+cat /dev/null >footer.html
+
+cat footerstart.txt >>footer.html
+cat ../GIT-VERSION-FILE >>footer.html
+cat footerend.txt >>footer.html
+
+cat docfiles.txt | xargs cat | wkhtmltopdf --book --footer-html footer.html --disable-external-links - git-doc.pdf
diff --git a/Documentation/pagebreak.txt b/Documentation/pagebreak.txt
new file mode 100644
index 0000000..fdaffd1
--- /dev/null
+++ b/Documentation/pagebreak.txt
@@ -0,0 +1 @@
+</p style="page-break-after: always">
--
1.7.11.msysgit.1
---
Thomas
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [Patch v2 8/8] Wire everything into Makefile and Documentation/Makefile
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
` (6 preceding siblings ...)
2012-10-11 17:24 ` [Patch v2 7/8] Create pdf from all html files Thomas Ackermann
@ 2012-10-11 17:26 ` Thomas Ackermann
2012-10-11 19:30 ` [Patch v2 0/8] Create single PDF for all HTML files Junio C Hamano
8 siblings, 0 replies; 12+ messages in thread
From: Thomas Ackermann @ 2012-10-11 17:26 UTC (permalink / raw)
To: th.acker66, git; +Cc: philipoakley, peff, gitster, th.acker66
>From ac7de86bd58c5849c12e2b05e7b7f68704d9093e Mon Sep 17 00:00:00 2001
From: Thomas Ackermann <th.acker@arcor.de>
Date: Wed, 10 Oct 2012 19:30:55 +0200
Subject: [PATCH] Wire everything into Makefile and Documentation/Makefile
- target "html" creates html for all files in Documentation/howto and Documentation/technical
- new target "relnoteshtml" creates html for all release notes
- new target "fullpdf" creates "git-doc.pdf" and uses targets "html", "relnoteshtml" and "pdf"
- "html" does not use "relnoteshtml"
Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
Documentation/Makefile | 43 +++++++++++++++++++++++++++++++++++++++++--
Makefile | 9 +++++++++
2 files changed, 50 insertions(+), 2 deletions(-)
diff --git a/Documentation/Makefile b/Documentation/Makefile
index 267dfe1..6710325 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -15,6 +15,9 @@ MAN_HTML=$(patsubst %.txt,%.html,$(MAN_TXT))
DOC_HTML=$(MAN_HTML)
+RELNOTES_TXT = $(wildcard RelNotes/*.txt)
+RELNOTES_HTML= $(patsubst %.txt,%.html,$(RELNOTES_TXT))
+
ARTICLES = howto-index
ARTICLES += everyday
ARTICLES += git-tools
@@ -24,8 +27,30 @@ SP_ARTICLES = user-manual
SP_ARTICLES += howto/revert-branch-rebase
SP_ARTICLES += howto/using-merge-subtree
SP_ARTICLES += howto/using-signed-tag-in-pull-request
+SP_ARTICLES += howto/use-git-daemon
+SP_ARTICLES += howto/update-hook-example
+SP_ARTICLES += howto/setup-git-server-over-http
+SP_ARTICLES += howto/separating-topic-branches
+SP_ARTICLES += howto/revert-a-faulty-merge
+SP_ARTICLES += howto/recover-corrupted-blob-object
+SP_ARTICLES += howto/rebuild-from-update-hook
+SP_ARTICLES += howto/rebuild-from-update-hook
+SP_ARTICLES += howto/rebase-from-internal-branch
+SP_ARTICLES += howto/maintain-git
API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt)))
SP_ARTICLES += $(API_DOCS)
+
+TECH_DOCS += technical/index-format
+TECH_DOCS += technical/pack-format
+TECH_DOCS += technical/pack-heuristics
+TECH_DOCS += technical/pack-protocol
+TECH_DOCS += technical/protocol-capabilities
+TECH_DOCS += technical/protocol-common
+TECH_DOCS += technical/racy-git
+TECH_DOCS += technical/send-pack-pipeline
+TECH_DOCS += technical/shallow
+TECH_DOCS += technical/trivial-merge
+SP_ARTICLES += $(TECH_DOCS)
SP_ARTICLES += technical/api-index
DOC_HTML += $(patsubst %,%.html,$(ARTICLES) $(SP_ARTICLES))
@@ -156,6 +181,8 @@ all: html man
html: $(DOC_HTML)
+relnoteshtml: $(RELNOTES_HTML)
+
$(DOC_HTML) $(DOC_MAN1) $(DOC_MAN5) $(DOC_MAN7): asciidoc.conf
man: man1 man5 man7
@@ -167,6 +194,9 @@ info: git.info gitman.info
pdf: user-manual.pdf
+fullpdf: pdf relnoteshtml html
+ ./makedocpdf.sh
+
install: install-man
install-man: man
@@ -191,6 +221,10 @@ install-pdf: pdf
$(INSTALL) -d -m 755 $(DESTDIR)$(pdfdir)
$(INSTALL) -m 644 user-manual.pdf $(DESTDIR)$(pdfdir)
+install-fullpdf: fullpdf install-pdf
+ $(INSTALL) -d -m 755 $(DESTDIR)$(pdfdir)
+ $(INSTALL) -m 644 git-doc.pdf $(DESTDIR)$(pdfdir)
+
install-html: html
'$(SHELL_PATH_SQ)' ./install-webdoc.sh $(DESTDIR)$(htmldir)
@@ -230,8 +264,10 @@ clean:
$(RM) *.xml *.xml+ *.html *.html+ *.1 *.5 *.7
$(RM) *.texi *.texi+ *.texi++ git.info gitman.info
$(RM) *.pdf
+ $(RM) docfiles.txt
+ $(RM) RelNotes/*.html
$(RM) howto-index.txt howto/*.html doc.dep
- $(RM) technical/api-*.html technical/api-index.txt
+ $(RM) technical/*.html technical/api-index.txt
$(RM) $(cmds_txt) *.made
$(RM) manpage-base-url.xsl
@@ -241,6 +277,9 @@ $(MAN_HTML): %.html : %.txt
$(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) -o $@+ $< && \
mv $@+ $@
+$(RELNOTES_HTML): %.html : %.txt
+ $(QUIET_ASCIIDOC)$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b xhtml11 $*.txt
+
manpage-base-url.xsl: manpage-base-url.xsl.in
sed "s|@@MAN_BASE_URL@@|$(MAN_BASE_URL)|" $< > $@
@@ -264,7 +303,7 @@ technical/api-index.txt: technical/api-index-skel.txt \
$(QUIET_GEN)cd technical && '$(SHELL_PATH_SQ)' ./api-index.sh
technical/%.html: ASCIIDOC_EXTRA += -a git-relative-html-prefix=../
-$(patsubst %,%.html,$(API_DOCS) technical/api-index): %.html : %.txt
+$(patsubst %,%.html,$(API_DOCS) technical/api-index $(TECH_DOCS)): %.html : %.txt
$(QUIET_ASCIIDOC)$(ASCIIDOC) -b xhtml11 -f asciidoc.conf \
$(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) $*.txt
diff --git a/Makefile b/Makefile
index 8413606..0392782 100644
--- a/Makefile
+++ b/Makefile
@@ -2479,12 +2479,18 @@ man:
html:
$(MAKE) -C Documentation html
+relnoteshtml:
+ $(MAKE) -C Documentation relnoteshtml
+
info:
$(MAKE) -C Documentation info
pdf:
$(MAKE) -C Documentation pdf
+fullpdf:
+ $(MAKE) -C Documentation fullpdf
+
XGETTEXT_FLAGS = \
--force-po \
--add-comments \
@@ -2796,6 +2802,9 @@ install-info:
install-pdf:
$(MAKE) -C Documentation install-pdf
+install-fullpdf:
+ $(MAKE) -C Documentation install-fullpdf
+
quick-install-doc:
$(MAKE) -C Documentation quick-install
--
1.7.11.msysgit.1
---
Thomas
^ permalink raw reply related [flat|nested] 12+ messages in thread
* Re: [Patch v2 5/8] Prerequisites for creating nice html for all files in Documentation/howto
2012-10-11 17:22 ` [Patch v2 5/8] Prerequisites for creating nice html for all files in Documentation/howto Thomas Ackermann
@ 2012-10-11 19:06 ` Junio C Hamano
0 siblings, 0 replies; 12+ messages in thread
From: Junio C Hamano @ 2012-10-11 19:06 UTC (permalink / raw)
To: Thomas Ackermann; +Cc: git, philipoakley, peff
Thomas Ackermann <th.acker66@arcor.de> writes:
>>From 2b9538990e30ae0911117c8e3d8b6891c9de31cf Mon Sep 17 00:00:00 2001
> From: Thomas Ackermann <th.acker@arcor.de>
> Date: Sat, 29 Sep 2012 17:28:54 +0200
> Subject: [PATCH] Prerequisites for creating nice html for all files in
> Documentation/howto
These four lines are not needed; please remove them from all the patches.
> @@ -149,13 +152,13 @@ then
>
> info "Found matching head pattern: '$head_pattern'"
> for group_pattern in $group_patterns; do
> - for groupname in $groups; do
> - info "Checking group: '$groupname' against pattern: '$group_pattern'"
> - matchlen=$(expr "$groupname" : "$group_pattern")
> - if test "$matchlen" = "${#groupname}"
> - then
> - grant "Allowing group: '$groupname' with pattern: '$group_pattern'"
> - fi
> + for groupname in $groups; do
> + info "Checking group: '$groupname' against pattern: '$group_pattern'"
> + matchlen=$(expr "$groupname" : "$group_pattern")
> + if test "$matchlen" = "${#groupname}"
> + then
> + grant "Allowing group: '$groupname' with pattern: '$group_pattern'"
> + fi
> done
> done
The inner "done" does not seem to align with the "for ...; do" it
corresponds to, does it?
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [Patch v2 2/8] Shorten two over-long lines in git-bisect-lk2009.txt by removing some white-space
2012-10-11 17:18 ` [Patch v2 2/8] Shorten two over-long lines in git-bisect-lk2009.txt by removing some white-space Thomas Ackermann
@ 2012-10-11 19:07 ` Junio C Hamano
0 siblings, 0 replies; 12+ messages in thread
From: Junio C Hamano @ 2012-10-11 19:07 UTC (permalink / raw)
To: Thomas Ackermann; +Cc: git, philipoakley, peff
Thomas Ackermann <th.acker66@arcor.de> writes:
> @@ -331,7 +331,7 @@ Date: Sat May 3 11:59:44 2008 -0700
>
> Linux 2.6.26-rc1
>
> -:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile
> +:100644 100644 5cf8258195331a4dbdddff08b8d68642638eea57 4492984efc09ab72ff6219a7bc21fb6a957c4cd5 M Makefile
> bisect run success
> -------------
If you are redoing this as "more like a printed book for easier
reading", it might make more sense to shorten it like this:
:100644 100644 5cf82581... 4492984e... M Makefile
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [Patch v2 0/8] Create single PDF for all HTML files
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
` (7 preceding siblings ...)
2012-10-11 17:26 ` [Patch v2 8/8] Wire everything into Makefile and Documentation/Makefile Thomas Ackermann
@ 2012-10-11 19:30 ` Junio C Hamano
8 siblings, 0 replies; 12+ messages in thread
From: Junio C Hamano @ 2012-10-11 19:30 UTC (permalink / raw)
To: Thomas Ackermann; +Cc: git, philipoakley, peff
Thomas Ackermann <th.acker66@arcor.de> writes:
> In general, the following problems had to be fixed in doc files in order to create
> HTML by using asciidoc and afterwards create a nice looking PDF using wkhtmltopdf:
>
> - Wrong sectioning syntax (e.g. "===" instead of "---")
> - Left-over shell scripting commands (in some release notes files)
> - Over-long lines which caused very wide right margins in the resulting PDF
> - Wrong formatting for email quotes, quoted script code, tables
>
> Also some of the headlines in the documents where changed or even created
> initially in order to give a more consistent structure in the resulting PDF.
It is kind of surprising to see that these documents already are so
close to be kosher asciidoc. That were never meant to be used with
asciidoc as we wrote them.
^ permalink raw reply [flat|nested] 12+ messages in thread
end of thread, other threads:[~2012-10-11 19:31 UTC | newest]
Thread overview: 12+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-10-11 17:13 [Patch v2 0/8] Create single PDF for all HTML files Thomas Ackermann
2012-10-11 17:16 ` [Patch v2 1/8] Split over-long synopsis in git-fetch-pack.txt into several lines Thomas Ackermann
2012-10-11 17:18 ` [Patch v2 2/8] Shorten two over-long lines in git-bisect-lk2009.txt by removing some white-space Thomas Ackermann
2012-10-11 19:07 ` Junio C Hamano
2012-10-11 17:19 ` [Patch v2 3/8] Change headline of technical/send-pack-pipeline.txt to not confuse its content with content from git-send-pack.txt Thomas Ackermann
2012-10-11 17:21 ` [Patch v2 4/8] Prerequisites for creating nice html for all files in Documentation/technical Thomas Ackermann
2012-10-11 17:22 ` [Patch v2 5/8] Prerequisites for creating nice html for all files in Documentation/howto Thomas Ackermann
2012-10-11 19:06 ` Junio C Hamano
2012-10-11 17:23 ` [Patch v2 6/8] Prerequisites for creating nice html for all files in Documentation/RelNotes Thomas Ackermann
2012-10-11 17:24 ` [Patch v2 7/8] Create pdf from all html files Thomas Ackermann
2012-10-11 17:26 ` [Patch v2 8/8] Wire everything into Makefile and Documentation/Makefile Thomas Ackermann
2012-10-11 19:30 ` [Patch v2 0/8] Create single PDF for all HTML files Junio C Hamano
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).