diff options
Diffstat (limited to 'doc/Makefile.am')
-rw-r--r-- | doc/Makefile.am | 83 |
1 files changed, 72 insertions, 11 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am index c091ce0..1e4fcde 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -5,27 +5,88 @@ # packet encryption, packet authentication, and # packet compression. # -# Copyright (C) 2002-2018 OpenVPN Inc <sales@openvpn.net> +# Copyright (C) 2002-2021 OpenVPN Inc <sales@openvpn.net> # Copyright (C) 2006-2012 Alon Bar-Lev <alon.barlev@gmail.com> # -MAINTAINERCLEANFILES = \ - $(srcdir)/Makefile.in +SUBDIRS = doxygen -CLEANFILES = openvpn.8.html +# +# List of man and HTML pages we build when rst2man/rst2html is available +# +# NOTE: Remember to add source .rst files to $(dist_noinst_DATA) below +# This could be automated with GNU Make, but we need BSD Make support +# +build_man_pages = openvpn.8 openvpn-examples.5 +build_html_pages = openvpn.8.html openvpn-examples.5.html dist_doc_DATA = \ - management-notes.txt + management-notes.txt gui-notes.txt dist_noinst_DATA = \ - README.plugins interactive-service-notes.rst + README.plugins interactive-service-notes.rst \ + openvpn.8.rst \ + openvpn-examples.5.rst \ + man-sections/advanced-options.rst \ + man-sections/client-options.rst \ + man-sections/connection-profiles.rst \ + man-sections/encryption-options.rst \ + man-sections/examples.rst \ + man-sections/generic-options.rst \ + man-sections/inline-files.rst \ + man-sections/link-options.rst \ + man-sections/log-options.rst \ + man-sections/management-options.rst \ + man-sections/network-config.rst \ + man-sections/pkcs11-options.rst \ + man-sections/plugin-options.rst \ + man-sections/protocol-options.rst \ + man-sections/proxy-options.rst \ + man-sections/renegotiation.rst \ + man-sections/signals.rst \ + man-sections/script-options.rst \ + man-sections/server-options.rst \ + man-sections/tls-options.rst \ + man-sections/unsupported-options.rst \ + man-sections/virtual-routing-and-forwarding.rst \ + man-sections/vpn-network-options.rst \ + man-sections/windows-options.rst + + +###### GENERIC RULES ########## + +SUFFIXES = .8.rst .8 .8.html .5.rst .5 .5.html + +MAINTAINERCLEANFILES = \ + $(srcdir)/Makefile.in + +.8.rst.8 .5.rst.5 : +if HAVE_PYDOCUTILS + $(RST2MAN) $< > $@ +else + @echo "Missing python-docutils - skipping man page generation ($@)" +endif + +.8.rst.8.html .5.rst.5.html : +if HAVE_PYDOCUTILS + $(RST2HTML) $< > $@ +else + @echo "Missing python-docutils - skipping html page generation ($@)" +endif + + +if HAVE_PYDOCUTILS +dist_noinst_DATA += $(build_man_pages) +dist_html_DATA = $(build_html_pages) + +# Failsafe - do not delete these files unless we can recreate them +CLEANFILES = $(build_man_pages) $(build_html_pages) + +endif if WIN32 -dist_noinst_DATA += openvpn.8 -nodist_html_DATA = openvpn.8.html -openvpn.8.html: $(srcdir)/openvpn.8 - $(MAN2HTML) < $(srcdir)/openvpn.8 > openvpn.8.html else -dist_man_MANS = openvpn.8 +dist_man_MANS = $(build_man_pages) endif +dist-hook : $(build_man_pages) $(build_html_pages) |