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