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

2015-03-25 Thread Thomas Schneider
Philip Oakley 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 really know C, so I c

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

2015-03-24 Thread Philip Oakley
From: "Michael J Gruber" Junio C Hamano venit, vidit, dixit 20.03.2015 23:38: Stefan Beller 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",

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 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 o

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

2015-03-20 Thread Junio C Hamano
Stefan Beller 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 Philip mentioned

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

2015-03-20 Thread Junio C Hamano
Stefan Beller 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 is fine to r

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 wrote: > Stefan Beller 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

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

2015-03-20 Thread Philip Oakley
From: "Junio C Hamano" Stefan Beller 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

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 : > 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 source to "print" t

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

2015-03-20 Thread Junio C Hamano
Thomas Schneider 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 and friends

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 : > Stefan Beller 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 availa

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

2015-03-20 Thread Junio C Hamano
Stefan Beller 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" is not what

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

2015-03-20 Thread Philip Oakley
From: "Stefan Beller" On Fri, Mar 20, 2015 at 4:23 AM, Thomas Schneider wrote: Signed-off-by: Thomas Schneider --- 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 r

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 wrote: > Signed-off-by: Thomas Schneider > --- > 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 :) Welcome

[PATCH] Documentation: Add target to build PDF manpages

2015-03-20 Thread Thomas Schneider
Signed-off-by: Thomas Schneider --- 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 insertions(+), 1 d