Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-25 Thread Thomas Schneider
Philip Oakley philipoak...@iee.org wrote: I'd expect 'git help --pdf git' to simply feed the path of git.pdf (probably in the same directory as the .html versions) to the web browser and let it determine the users prefered reader. Yes, this is what I would do as well. Unfortunately I don’t

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-24 Thread Philip Oakley
From: Michael J Gruber g...@drmicha.warpmail.net Junio C Hamano venit, vidit, dixit 20.03.2015 23:38: Stefan Beller sbel...@google.com writes: Thomas referencing reading the man page offline, made me wonder why you wouldn't read the man pages itself as they can also be carried around offline.

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-23 Thread Michael J Gruber
Junio C Hamano venit, vidit, dixit 20.03.2015 23:38: Stefan Beller sbel...@google.com writes: Thomas referencing reading the man page offline, made me wonder why you wouldn't read the man pages itself as they can also be carried around offline. But the striking point is on an iPad, which

[PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Thomas Schneider
Signed-off-by: Thomas Schneider thosc...@gmail.com --- dblatex does print some warnings, but they seem to be irrelevant. Besides, first patch I submit to git or even to any project using a mailing list … let’s hope I did everything right :) Documentation/Makefile | 9 - 1 file changed, 8

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Stefan Beller
On Fri, Mar 20, 2015 at 4:23 AM, Thomas Schneider thosc...@gmail.com wrote: Signed-off-by: Thomas Schneider thosc...@gmail.com --- dblatex does print some warnings, but they seem to be irrelevant. Besides, first patch I submit to git or even to any project using a mailing list … let’s hope I

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Philip Oakley
From: Stefan Beller sbel...@google.com On Fri, Mar 20, 2015 at 4:23 AM, Thomas Schneider thosc...@gmail.com wrote: Signed-off-by: Thomas Schneider thosc...@gmail.com --- dblatex does print some warnings, but they seem to be irrelevant. Besides, first patch I submit to git or even to any project

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Junio C Hamano
Stefan Beller sbel...@google.com writes: ... though how would I read man pages in pdf format? I tried searching the web and all I can find is how to convert the a man page to pdf. So is there a conveniant way to tell `man` to prefer opening pdfs when available? I presume that man -Tpdf git.1

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Junio C Hamano
Thomas Schneider thosc...@gmail.com writes: Personally, I honestly am not quite sure why anybody wants to generate manpages in the PDF format like this patch does, unless they are planning to print them on paper, in which case the existing manpages (git.1 and friends) or html pages (git.html

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Thomas Schneider
2015-03-20 22:28 GMT+01:00 Junio C Hamano gits...@pobox.com: I think you misunderstood me. I am not dismissing the need for PDF; I am just saying that there is no need to directly generate them from asciidoc sources, especially when there are already manpages and html pages available as

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Thomas Schneider
2015-03-20 21:21 GMT+01:00 Junio C Hamano gits...@pobox.com: Stefan Beller sbel...@google.com writes: ... though how would I read man pages in pdf format? I tried searching the web and all I can find is how to convert the a man page to pdf. So is there a conveniant way to tell `man` to

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Philip Oakley
From: Junio C Hamano gits...@pobox.com Stefan Beller sbel...@google.com writes: ... though how would I read man pages in pdf format? I tried searching the web and all I can find is how to convert the a man page to pdf. So is there a conveniant way to tell `man` to prefer opening pdfs when

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Stefan Beller
On Fri, Mar 20, 2015 at 1:21 PM, Junio C Hamano gits...@pobox.com wrote: Stefan Beller sbel...@google.com writes: ... though how would I read man pages in pdf format? I tried searching the web and all I can find is how to convert the a man page to pdf. So is there a conveniant way to tell

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Junio C Hamano
Stefan Beller sbel...@google.com writes: Thomas referencing reading the man page offline, made me wonder why you wouldn't read the man pages itself as they can also be carried around offline. But the striking point is on an iPad, which doesn't offer you the convenience of a shell etc, but pdf

Re: [PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Junio C Hamano
Stefan Beller sbel...@google.com writes: ... I'd rather be looking for man_or_pdf_when_possible git add and I could alias man_or_pdf_when_possible to a short name. The help framework can choose the backend and the format and it wouldn't be too outlandish to do git help --pdf add as