Documentation/automake.mk

   1 DOC_SOURCE = \
   2         Documentation/group-selection-method-property.txt \
   3         Documentation/_static/logo.png \
   4         Documentation/_static/overview.png \
   5         Documentation/conf.py \
   6         Documentation/index.rst \
   7         Documentation/contents.rst \
   8         Documentation/intro/index.rst \
   9         Documentation/intro/what-is-ovs.rst \
  10         Documentation/intro/why-ovs.rst \
  11         Documentation/intro/install/index.rst \
  12         Documentation/intro/install/bash-completion.rst \
  13         Documentation/intro/install/debian.rst \
  14         Documentation/intro/install/documentation.rst \
  15         Documentation/intro/install/distributions.rst \
  16         Documentation/intro/install/dpdk.rst \
  17         Documentation/intro/install/fedora.rst \
  18         Documentation/intro/install/general.rst \
  19         Documentation/intro/install/netbsd.rst \
  20         Documentation/intro/install/ovn-upgrades.rst \
  21         Documentation/intro/install/rhel.rst \
  22         Documentation/intro/install/userspace.rst \
  23         Documentation/intro/install/windows.rst \
  24         Documentation/intro/install/xenserver.rst \
  25         Documentation/tutorials/index.rst \
  26         Documentation/tutorials/ovs-advanced.rst \
  27         Documentation/tutorials/ovn-openstack.rst \
  28         Documentation/tutorials/ovn-sandbox.rst \
  29         Documentation/topics/index.rst \
  30         Documentation/topics/bonding.rst \
  31         Documentation/topics/idl-compound-indexes.rst \
  32         Documentation/topics/datapath.rst \
  33         Documentation/topics/design.rst \
  34         Documentation/topics/dpdk/index.rst \
  35         Documentation/topics/dpdk/ring.rst \
  36         Documentation/topics/dpdk/vhost-user.rst \
  37         Documentation/topics/testing.rst \
  38         Documentation/topics/high-availability.rst \
  39         Documentation/topics/integration.rst \
  40         Documentation/topics/language-bindings.rst \
  41         Documentation/topics/openflow.rst \
  42         Documentation/topics/ovsdb-replication.rst \
  43         Documentation/topics/porting.rst \
  44         Documentation/topics/tracing.rst \
  45         Documentation/topics/windows.rst \
  46         Documentation/howto/index.rst \
  47         Documentation/howto/docker.rst \
  48         Documentation/howto/dpdk.rst \
  49         Documentation/howto/kvm.rst \
  50         Documentation/howto/libvirt.rst \
  51         Documentation/howto/selinux.rst \
  52         Documentation/howto/ssl.rst \
  53         Documentation/howto/lisp.rst \
  54         Documentation/howto/openstack-containers.rst \
  55         Documentation/howto/qos.png \
  56         Documentation/howto/qos.rst \
  57         Documentation/howto/sflow.png \
  58         Documentation/howto/sflow.rst \
  59         Documentation/howto/tunneling.png \
  60         Documentation/howto/tunneling.rst \
  61         Documentation/howto/userspace-tunneling.rst \
  62         Documentation/howto/vlan.png \
  63         Documentation/howto/vlan.rst \
  64         Documentation/howto/vtep.rst \
  65         Documentation/ref/index.rst \
  66         Documentation/faq/index.rst \
  67         Documentation/faq/configuration.rst \
  68         Documentation/faq/contributing.rst \
  69         Documentation/faq/design.rst \
  70         Documentation/faq/general.rst \
  71         Documentation/faq/issues.rst \
  72         Documentation/faq/openflow.rst \
  73         Documentation/faq/qos.rst \
  74         Documentation/faq/releases.rst \
  75         Documentation/faq/terminology.rst \
  76         Documentation/faq/vlan.rst \
  77         Documentation/faq/vxlan.rst \
  78         Documentation/internals/index.rst \
  79         Documentation/internals/authors.rst \
  80         Documentation/internals/bugs.rst \
  81         Documentation/internals/committer-grant-revocation.rst \
  82         Documentation/internals/committer-responsibilities.rst \
  83         Documentation/internals/documentation.rst \
  84         Documentation/internals/mailing-lists.rst \
  85         Documentation/internals/maintainers.rst \
  86         Documentation/internals/patchwork.rst \
  87         Documentation/internals/release-process.rst \
  88         Documentation/internals/security.rst \
  89         Documentation/internals/contributing/index.rst \
  90         Documentation/internals/contributing/backporting-patches.rst \
  91         Documentation/internals/contributing/coding-style.rst \
  92         Documentation/internals/contributing/coding-style-windows.rst \
  93         Documentation/internals/contributing/documentation-style.rst \
  94         Documentation/internals/contributing/libopenvswitch-abi.rst \
  95         Documentation/internals/contributing/submitting-patches.rst \
  96         Documentation/requirements.txt \
  97         $(addprefix Documentation/ref/,$(RST_MANPAGES))
  98 FLAKE8_PYFILES += Documentation/conf.py
  99 EXTRA_DIST += $(DOC_SOURCE)
 100
 101 # You can set these variables from the command line.
 102 SPHINXOPTS =
 103 SPHINXBUILD = sphinx-build
 104 SPHINXSRCDIR = $(srcdir)/Documentation
 105 SPHINXBUILDDIR = $(builddir)/Documentation/_build
 106
 107 # Internal variables.
 108 ALLSPHINXOPTS = -W -n -d $(SPHINXBUILDDIR)/doctrees $(SPHINXOPTS) $(SPHINXSRCDIR)
 109
 110 sphinx_verbose = $(sphinx_verbose_@AM_V@)
 111 sphinx_verbose_ = $(sphinx_verbose_@AM_DEFAULT_V@)
 112 sphinx_verbose_0 = -q
 113
 114 if HAVE_SPHINX
 115 docs-check: $(DOC_SOURCE)
 116         $(AM_V_GEN)$(SPHINXBUILD) $(sphinx_verbose) -b html $(ALLSPHINXOPTS) $(SPHINXBUILDDIR)/html && touch $@
 117         $(AM_V_GEN)$(SPHINXBUILD) $(sphinx_verbose) -b man $(ALLSPHINXOPTS) $(SPHINXBUILDDIR)/man && touch $@
 118 ALL_LOCAL += docs-check
 119 CLEANFILES += docs-check
 120
 121 check-docs:
 122         $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(SPHINXBUILDDIR)/linkcheck
 123
 124 clean-docs:
 125         rm -rf $(SPHINXBUILDDIR)
 126         rm -f docs-check
 127 CLEAN_LOCAL += clean-docs
 128 endif
 129 .PHONY: check-docs
 130 .PHONY: clean-docs
 131 \f
 132 # Installing manpages based on rST.
 133 #
 134 # The docs-check target converts the rST files listed in RST_MANPAGES
 135 # into nroff manpages in Documentation/_build/man.  The easiest way to
 136 # get these installed by "make install" is to write our own helper
 137 # rules.
 138
 139 # rST formatted manpages under Documentation/ref.
 140 RST_MANPAGES = \
 141         ovs-test.8.rst \
 142         ovs-vlan-test.8.rst
 143
 144 # The GNU standards say that these variables should control
 145 # installation directories for manpages in each section.  Automake
 146 # will define them for us only if it sees that a manpage in the
 147 # appropriate section is to be installed through its built-in feature.
 148 # Since we're working independently, for best safety, we need to
 149 # define them ourselves.
 150 man1dir = $(mandir)/man1
 151 man2dir = $(mandir)/man2
 152 man3dir = $(mandir)/man3
 153 man4dir = $(mandir)/man4
 154 man5dir = $(mandir)/man5
 155 man6dir = $(mandir)/man6
 156 man7dir = $(mandir)/man7
 157 man8dir = $(mandir)/man8
 158 man9dir = $(mandir)/man9
 159
 160 # Set a shell variable for each manpage directory.
 161 set_mandirs = \
 162         man1dir='$(man1dir)' \
 163         man2dir='$(man2dir)' \
 164         man3dir='$(man3dir)' \
 165         man4dir='$(man4dir)' \
 166         man5dir='$(man5dir)' \
 167         man6dir='$(man6dir)' \
 168         man7dir='$(man7dir)' \
 169         man8dir='$(man8dir)' \
 170         man9dir='$(man9dir)'
 171
 172 # Given an $rst of "ovs-vlan-test.8.rst", sets $stem to
 173 # "ovs-vlan-test", $section to "8", and $mandir to $man8dir.
 174 extract_stem_and_section = \
 175         stem=`echo "$$rst" | sed -n 's/^\(.*\)\.\([0-9]\).rst$$/\1/p'`; \
 176         section=`echo "$$rst" | sed -n 's/^\(.*\)\.\([0-9]\).rst$$/\2/p'`; \
 177         test -n "$$section" || { echo "$$rst: cannot infer manpage section from filename" 2>&1; continue; }; \
 178         eval "mandir=\$$man$${section}dir"; \
 179         test -n "$$mandir" || { echo "unknown directory for manpage section $$section"; continue; }
 180
 181 if HAVE_SPHINX
 182 INSTALL_DATA_LOCAL += install-man-rst
 183 install-man-rst: docs-check
 184         @$(set_mandirs); \
 185         for rst in $(RST_MANPAGES); do \
 186             $(extract_stem_and_section); \
 187             echo " $(MKDIR_P) '$(DESTDIR)'\"$$mandir\""; \
 188             $(MKDIR_P) '$(DESTDIR)'"$$mandir"; \
 189             echo " $(INSTALL_DATA) $(SPHINXBUILDDIR)/man/$$stem.$$section '$(DESTDIR)'\"$$mandir/$$stem.$$section\""; \
 190             $(INSTALL_DATA) $(SPHINXBUILDDIR)/man/$$stem.$$section '$(DESTDIR)'"$$mandir/$$stem.$$section"; \
 191         done
 192 endif
 193
 194 UNINSTALL_LOCAL += uninstall-man-rst
 195 uninstall-man-rst:
 196         @$(set_mandirs); \
 197         for rst in $(RST_MANPAGES); do \
 198             $(extract_stem_and_section); \
 199             echo "rm -f '$(DESTDIR)'\"$$mandir/$$stem.$$section\""; \
 200             rm -f '$(DESTDIR)'"$$mandir/$$stem.$$section"; \
 201         done