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