Re: [PATCH] Documentation: Add target to build PDF manpages
- From
Stefan Beller <sbeller@google.com>
- Date
- Mar 20, 2015, 17:19 UTC
- Message-ID
- <CAGZ79ka7tPA17Y-vPPp5W_4-0UMnHMfM9+eQ8jc4eu23FpM2ug@mail.gmail.com>
- In-Reply-To
- <1426850584-9951-1-git-send-email-thosch97@gmail.com>
On Fri, Mar 20, 2015 at 4:23 AM, Thomas Schneider <thosch97@gmail.com> wrote:
Show 5 quoted lines
> 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?
Show 52 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