[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Xen-devel] [PATCH 1 of 7] docs: report when we don't build docs due to a missing tool



# HG changeset patch
# User Ian Campbell <ian.campbell@xxxxxxxxxx>
# Date 1320678727 0
# Node ID 7a126dbf62d76d45a10ea55be9c354b1bd4f4bf1
# Parent  c0702424afc5f7b972c26c6110f6489305844635
docs: report when we don't build docs due to a missing tool

It's useful if you are wondering why there are no docs..

Signed-off-by: Ian Campbell <ian.campbell@xxxxxxxxxx>

diff -r c0702424afc5 -r 7a126dbf62d7 docs/Makefile
--- a/docs/Makefile     Mon Nov 07 10:29:14 2011 +0100
+++ b/docs/Makefile     Mon Nov 07 15:12:07 2011 +0000
@@ -58,7 +58,8 @@ python-dev-docs:
 .PHONY: man-pages
 man-pages:
        @if which $(POD2MAN) 1>/dev/null 2>/dev/null; then \
-       $(MAKE) $(DOC_MAN1) $(DOC_MAN5); fi
+       $(MAKE) $(DOC_MAN1) $(DOC_MAN5); else              \
+       echo "pod2man not installed; skipping man-pages."; fi
 
 man1/%.1: man/%.pod.1 Makefile
        $(INSTALL_DIR) $(@D)
@@ -120,14 +121,16 @@ html/%/index.html: src/%.tex
         echo "Running latex2html to generate $*/index.html ... "; \
        $(LATEX2HTML) -split 0 -show_section_numbers -toc_depth 3 -nonavigation 
\
        -numbered_footnotes -local_icons -noinfo -math -dir $(@D) \
-       $< 1>/dev/null 2>/dev/null ;fi
+       $< 1>/dev/null 2>/dev/null ; else \
+       echo "latex2html not installed; skipping $*."; fi
 
 html/%.html: %.markdown
        @$(INSTALL_DIR) $(@D)
        @set -e ; if which $(MARKDOWN) 1>/dev/null 2>/dev/null; then \
        echo "Running markdown to generate $*.html ... "; \
        $(MARKDOWN) $< > $@.tmp ; \
-       $(call move-if-changed,$@.tmp,$@) ; fi
+       $(call move-if-changed,$@.tmp,$@) ; else \
+       echo "markdown not installed; skipping $*.html."; fi
 
 txt/%.txt: %.txt
        $(INSTALL_DIR) $(@D)

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel


 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.