From: Tilman Sauerbeck <tilman@code-monkey•de>
To: git@vger•kernel.org
Subject: Re: Shipping man pages?
Date: Thu, 18 May 2006 12:57:04 +0200 [thread overview]
Message-ID: <20060518105703.GA29482@code-monkey.de> (raw)
In-Reply-To: <7vac9f69la.fsf@assigned-by-dhcp.cox.net>
[-- Attachment #1.1: Type: text/plain, Size: 1049 bytes --]
Junio C Hamano [2006-05-18 01:06]:
> Tilman Sauerbeck <tilman@code-monkey•de> writes:
>
> [snip]
>
> Why does this have to come up so often, and everybody who asks
> for them never supplies the patch to do so?
If it comes up that often it would indicate that this is actually a
concern to many people o_O
Also, I prefer to ask whether a patch would even be accepted so I don't
waste 3 hours of my life trying to figure out how to set up asciidoc and
docbook.
> > Or maybe offer them in a separate tarball?
>
> Things that are buildable from the source do not belong in the
> source tarball. If somebody wants to do this as a patch, I can
> be talked into accepting it, but the build procedure should
> build a separate tarball (or two; one for man and another for
> woman^Whtml).
I attached a patch.
Regards,
Tilman
--
A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: Top-posting.
Q: What is the most annoying thing on usenet and in e-mail?
[-- Attachment #1.2: git-doc-dist.patch --]
[-- Type: text/plain, Size: 1555 bytes --]
Created a dist target for Documentation/Makefile that tars up the man pages and html files.
Signed-off-by: Tilman Sauerbeck <tilman@code-monkey•de>
---
Documentation/Makefile | 16 +++++++++++++++-
1 files changed, 15 insertions(+), 1 deletions(-)
f8b6b70c89364418724899ab5ca28aaaf3eee7dc
diff --git a/Documentation/Makefile b/Documentation/Makefile
index c1af22c..271d9e4 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -31,6 +31,7 @@ man7=$(mandir)/man7
# DESTDIR=
INSTALL?=install
+TAR?=tar
#
# Please note that there is a minor bug in asciidoc.
@@ -55,6 +56,18 @@ install: man
$(INSTALL) $(DOC_MAN1) $(DESTDIR)/$(man1)
$(INSTALL) $(DOC_MAN7) $(DESTDIR)/$(man7)
+-include ../GIT-VERSION-FILE
+
+dist: html man
+ @mkdir -p git-doc-{html,man}-$(GIT_VERSION)
+ @cp $(DOC_HTML) git-doc-html-$(GIT_VERSION)
+ @cp $(DOC_MAN1) $(DOC_MAN7) git-doc-man-$(GIT_VERSION)
+
+ @for d in html man; do \
+ $(TAR) cf git-doc-$$d-$(GIT_VERSION).tar git-doc-$$d-$(GIT_VERSION) && \
+ rm -rf git-doc-$$d-$(GIT_VERSION) && \
+ gzip -f -9 git-doc-$$d-$(GIT_VERSION).tar \
+ ; done
#
# Determine "include::" file references in asciidoc files.
@@ -73,7 +86,8 @@ README: ../README
clean:
- rm -f *.xml *.html *.1 *.7 howto-index.txt howto/*.html doc.dep README
+ rm -f *.xml *.html *.1 *.7 howto-index.txt howto/*.html doc.dep README \
+ git-doc-{html,man}-$(GIT_VERSION).tar.gz
%.html : %.txt
asciidoc -b xhtml11 -d manpage -f asciidoc.conf $<
--
1.3.3
[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]
next prev parent reply other threads:[~2006-05-18 10:57 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2006-05-18 7:46 Shipping man pages? Tilman Sauerbeck
2006-05-18 8:06 ` Junio C Hamano
2006-05-18 9:41 ` Mark Rosenstand
2006-05-18 18:33 ` Junio C Hamano
2006-05-18 18:49 ` Linus Torvalds
2006-05-18 10:57 ` Tilman Sauerbeck [this message]
2006-05-18 8:10 ` Fernando J. Pereda
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20060518105703.GA29482@code-monkey.de \
--to=tilman@code-monkey$(echo .)de \
--cc=git@vger$(echo .)kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox