Re: [PATCH] Documentation: Add target to build PDF manpages
- From
Philip Oakley <philipoakley@iee.org>
- Date
- Mar 20, 2015, 19:28 UTC
- Message-ID
- <E4A75513C64F43B5A03A05B043426F55@PhilipOakley>
- In-Reply-To
- <CAGZ79ka7tPA17Y-vPPp5W_4-0UMnHMfM9+eQ8jc4eu23FpM2ug@mail.gmail.com>
From: "Stefan Beller" <sbeller@google.com>
Show 15 quoted lines
> On Fri, Mar 20, 2015 at 4:23 AM, Thomas Schneider <thosch97@gmail.com> > wrote: >> Signed-off-by: Thomas Schneider <thosch97@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 :) > > Welcome to the git community! > > The patch itself applies cleanly and the generated pdfs look > really great, 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?
My remembering of the help code (from when I added help's ability to list the guides), there isn't currently a mechanism to fire up a pdf reader of whatever hue. The MsysGit version encodes --web (html) as it's preferred reader.
So if anyone wants to have a go it shouldn't be that hard to add a --pdf option ;-)
Show 59 quoted lines
>> >> Documentation/Makefile | 9 ++++++++- >> 1 file changed, 8 insertions(+), 1 deletion(-) >> >> diff --git a/Documentation/Makefile b/Documentation/Makefile >> index 3e39e28..158cbd9 100644 >> --- a/Documentation/Makefile >> +++ b/Documentation/Makefile >> @@ -38,6 +38,7 @@ MAN7_TXT += gitworkflows.txt >> MAN_TXT = $(MAN1_TXT) $(MAN5_TXT) $(MAN7_TXT) >> MAN_XML = $(patsubst %.txt,%.xml,$(MAN_TXT)) >> MAN_HTML = $(patsubst %.txt,%.html,$(MAN_TXT)) >> +MAN_PDF = $(patsubst %.txt,%.pdf,$(MAN_TXT)) >> >> OBSOLETE_HTML += everyday.html >> OBSOLETE_HTML += git-remote-helpers.html >> @@ -223,7 +224,7 @@ man7: $(DOC_MAN7) >> >> info: git.info gitman.info >> >> -pdf: user-manual.pdf >> +pdf: user-manual.pdf $(MAN_PDF) >> >> install: install-man >> >> @@ -248,6 +249,7 @@ install-info: info >> install-pdf: pdf >> $(INSTALL) -d -m 755 $(DESTDIR)$(pdfdir) >> $(INSTALL) -m 644 user-manual.pdf $(DESTDIR)$(pdfdir) >> + $(INSTALL) -m 644 $(MAN_PDF) $(DESTDIR)$(pdfdir) >> >> install-html: html >> '$(SHELL_PATH_SQ)' ./install-webdoc.sh $(DESTDIR)$(htmldir) >> @@ -328,6 +330,11 @@ manpage-base-url.xsl: manpage-base-url.xsl.in >> $(QUIET_XMLTO)$(RM) $@ && \ >> $(XMLTO) -m $(MANPAGE_XSL) $(XMLTO_EXTRA) man $< >> >> +%.pdf: %.xml >> + $(QUIET_DBLATEX)$(RM) $@+ $@ && \ >> + $(DBLATEX) -o $@+ -p >> $(ASCIIDOC_DBLATEX_DIR)/asciidoc-dblatex.xsl -s >> $(ASCIIDOC_DBLATEX_DIR)/asciidoc-dblatex.sty $< && \ >> + mv $@+ $@ >> + >> %.xml : %.txt asciidoc.conf >> $(QUIET_ASCIIDOC)$(RM) $@+ $@ && \ >> $(TXT_TO_XML) -d manpage -o $@+ $< && \ >> -- >> 2.1.0 >> >> -- >> 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 > -- > 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 >