docs/Makefile

   1 #!/usr/bin/make
   2
   3 MAN1S = \
   4         gbp               \
   5         gbp-buildpackage  \
   6         gbp-clone         \
   7         gbp-config        \
   8         gbp-create-remote-repo \
   9         gbp-dch           \
  10         gbp-export-orig   \
  11         gbp-import-dsc    \
  12         gbp-import-dscs   \
  13         gbp-import-orig   \
  14         gbp-pq            \
  15         gbp-pristine-tar  \
  16         gbp-pull          \
  17         gbp-push          \
  18         gbp-tag           \
  19         gbp-buildpackage-rpm \
  20         gbp-import-srpm   \
  21         gbp-pq-rpm        \
  22         gbp-rpm-ch        \
  23         $(NULL)
  24
  25 MAN5S = \
  26         gbp.conf \
  27         $(NULL)
  28
  29 MANUAL=manual-html
  30 XML_MANPAGES=$(patsubst %,%.1,$(MAN1S)) $(patsubst %,%.5,$(MAN5S))
  31 POD_MANPAGES=git-pbuilder.1
  32 MANPAGES=$(XML_MANPAGES) $(POD_MANPAGES)
  33 VERSION_ENT=version.ent
  34 GBP_VERSION=../gbp/version.py
  35 DEB_VERSION=$(shell sed -ne 's/^gbp_version\s\+=\s\+"\([.a-z0-9~-]\+\)"/\1/p' $(GBP_VERSION))
  36 CHANGELOG=../debian/changelog
  37 MAN_DATE=$(shell dpkg-parsechangelog -l ../debian/changelog -SDate | TZ=UTC LC_ALL=C date -f- +'%d %B %Y')
  38 IMAGES=$(wildcard images/*png)
  39 DEST_IMAGES=$(subst images/,$(MANUAL)/images/,$(IMAGES))
  40
  41 # Select docbook-to-man tool
  42 ifeq ($(shell which docbook2x-man), )
  43         DOCBOOK_TO_MAN=docbook-to-man
  44 else
  45         DOCBOOK_TO_MAN=docbook2x-man
  46 endif
  47
  48 all: manual $(MANPAGES)
  49
  50 manual: $(MANUAL)/index.html $(DEST_IMAGES) css
  51
  52 $(MANUAL)/index.html: manual.xml chapters/*.xml manpages/*.xml common.ent $(VERSION_ENT)
  53         mkdir -p $(MANUAL)
  54         xsltproc -o $(MANUAL)/ /usr/share/gtk-doc/data/gtk-doc.xsl $<
  55         cp /usr/share/gtk-doc/data/*.png \
  56            /usr/share/gtk-doc/data/*.css \
  57            $(MANUAL)
  58
  59 $(MANUAL)/gbp.pdf: manual.xml chapters/*.xml manpages/*.xml common.ent $(VERSION_ENT)
  60         xsltproc -o $(MANUAL)/ /usr/share/gtk-doc/data/gtk-doc.xsl $<
  61
  62 css: $(MANUAL)/gbp.css $(MANUAL)/gbp.svg
  63 $(MANUAL)/gbp.css $(MANUAL)/gbp.svg: gbp.css gbp.svg
  64         cp gbp.css gbp.svg $(MANUAL)/
  65
  66 html_images: $(DEST_IMAGES)
  67 $(MANUAL)/images/%.png: images/%.png
  68         mkdir -p $(basename $@)
  69         install $< $@
  70
  71 %.1 %.5: man.gbp.xml manpages/%.xml
  72         $(DOCBOOK_TO_MAN) -o . $<
  73
  74 git-pbuilder.1: ../bin/git-pbuilder
  75         pod2man $< $@
  76
  77 manual.xml: $(VERSION_ENT)
  78
  79 $(GBP_VERSION): ../debian/changelog
  80         cd .. && python setup.py build --help >/dev/null
  81
  82 $(VERSION_ENT): $(GBP_VERSION)
  83         echo '<!ENTITY gbp-version "$(DEB_VERSION)">' > $(VERSION_ENT)
  84
  85 clean:
  86         -rm -r $(MANUAL)
  87         -rm *.1 *.5 $(VERSION_ENT)