docs/Makefile.am

   1 MAIN_MANS = pdns_server.1 \
   2         pdns_control.1 \
   3         pdnsutil.1 \
   4         zone2json.1 \
   5         zone2ldap.1 \
   6         zone2sql.1
   7
   8 MANPAGES_INSTALL = $(MAIN_MANS)
   9 MANPAGES_DIST = $(MAIN_MANS)
  10
  11 MANPAGES_TARGET_TOOLS = calidns.1 \
  12         dnsgram.1 \
  13         dnsreplay.1 \
  14         dnsscan.1 \
  15         dnsscope.1 \
  16         dnswasher.1 \
  17         dumresp.1 \
  18         ixplore.1 \
  19         nproxy.1 \
  20         nsec3dig.1 \
  21         pdns_notify.1 \
  22         saxfr.1 \
  23         sdig.1
  24
  25 MANPAGES_DIST += $(MANPAGES_TARGET_TOOLS) \
  26         dnsbulktest.1 \
  27         dnstcpbench.1 \
  28         dnspcap2protobuf.1
  29
  30 if HAVE_BOOST_GE_148
  31 MANPAGES_INSTALL += dnsbulktest.1 \
  32         dnstcpbench.1
  33 endif
  34
  35 if HAVE_PROTOBUF
  36 if HAVE_PROTOC
  37 MANPAGES_INSTALL += dnspcap2protobuf.1
  38 endif
  39 endif
  40
  41 if TOOLS
  42 MANPAGES_INSTALL += $(MANPAGES_TARGET_TOOLS)
  43 endif
  44
  45 man_MANS = $(MANPAGES_INSTALL)
  46
  47 EXTRA_DIST = $(MANPAGES_DIST)
  48
  49 if HAVE_VIRTUALENV
  50 if !HAVE_MANPAGES
  51 $(MANPAGES_DIST): %: manpages/%.rst .venv
  52         .venv/bin/python -msphinx -b man . mans $<
  53         mv mans/$@ $@
  54 endif # if !HAVE_MANPAGES
  55
  56 .venv: requirements.txt
  57         virtualenv .venv
  58         .venv/bin/pip install -U pip setuptools setuptools-git
  59         .venv/bin/pip install -r requirements.txt
  60
  61 html-docs: common/** manpages/** .venv *.rst
  62         .venv/bin/python -msphinx -b html . html-docs
  63
  64 latex/PowerDNS-Authoritative.pdf: common/** manpages/** .venv *.rst
  65         .venv/bin/python -msphinx -M latexpdf . .
  66
  67 PowerDNS-Authoritative.pdf: latex/PowerDNS-Authoritative.pdf
  68         mv $< $@
  69
  70 html-docs.tar.bz2: html-docs
  71         tar cjf $@ $<
  72
  73 all-docs: PowerDNS-Authoritative.pdf html-docs html-docs.tar.bz2
  74
  75 upload-docs: all-docs
  76         rsync -crv --delete --no-p --chmod=g=rwX --exclude '*~' ./html-docs/ web1.powerdns.com:/srv/www/doc.powerdns.com/authoritative/
  77         rsync -crv --no-p --chmod=g=rwX --exclude '*~' ./html-docs.tar.bz2 web1.powerdns.com:/srv/www/doc.powerdns.com/authoritative/
  78         rsync -crv --no-p --chmod=g=rwX --exclude '*~' ./PowerDNS-Authoritative.pdf web1.powerdns.com:/srv/www/doc.powerdns.com/authoritative/
  79
  80 else # if HAVE_VIRTUALENV
  81 $(MANPAGES_DIST):
  82         echo "You need virtualenv to generate the manpages"
  83         exit 1
  84
  85 PowerDNS-Authoritative.pdf:
  86         echo "You need virtualenv to generate the PDF"
  87         exit 1
  88
  89 html-docs:
  90         echo "You need virtualenv to generate the HTML docs"
  91         exit 1
  92 endif
  93
  94