From 524ada7f2356a4f6cba31f07a75896681be105bc Mon Sep 17 00:00:00 2001 From: Quentin Young Date: Wed, 2 May 2018 14:42:28 -0400 Subject: doc: support VPATH builds Documentation was not fully using Automake / Autoconf and therefore needs modifications to support black magic VPATH builds. * Convert Makefile's to Autoconf-controlled Makefile.in's * Tweak loading of pygments lexer to handle runtime paths * Update .gitignore's as necessary Signed-off-by: Quentin Young --- doc/manpages/.gitignore | 2 +- doc/manpages/Makefile | 48 ------------------------------------------ doc/manpages/Makefile.in | 55 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 56 insertions(+), 49 deletions(-) delete mode 100644 doc/manpages/Makefile create mode 100644 doc/manpages/Makefile.in (limited to 'doc/manpages') diff --git a/doc/manpages/.gitignore b/doc/manpages/.gitignore index 0505537159..2e7d8573f1 100644 --- a/doc/manpages/.gitignore +++ b/doc/manpages/.gitignore @@ -1,3 +1,3 @@ /_templates /_build -!/Makefile +!/Makefile.in diff --git a/doc/manpages/Makefile b/doc/manpages/Makefile deleted file mode 100644 index ebbbc31009..0000000000 --- a/doc/manpages/Makefile +++ /dev/null @@ -1,48 +0,0 @@ -include ../frr-sphinx.mk - -# ----------------------------------------------------------------------------- -# Automake requires that 3rd-party Makefiles recognize these targets. -# ----------------------------------------------------------------------------- -# install -# install-data -# install-exec -# uninstall -# install-dvi -# install-html -# install-info -# install-ps -# install-pdf -# installdirs -# check -# installcheck -# mostlyclean -# clean -# distclean -# maintainer-clean -# dvi -# pdf -# ps -# info -# html -# tags -# ctags - -# ignore these targets -EMPTY_AUTOMAKE_TARGETS = dvi pdf ps tags ctags distdir installdirs check installcheck install-dvi install-ps install-html install-pdf install-info install-exec -.PHONY: $(EMPTY_AUTOMAKE_TARGETS) -$(EMPTY_AUTOMAKE_TARGETS): - -# These targets are automatically generated by Sphinx but conflict with -# implicitly defined Automake rules, so we manually override them to nothing. -# The other option is deleting the Sphinx-generated rules, which suppresses the -# warning but kinda screws up the symmetry between Makefiles. -info: ; -html: ; - -all: man - -install-data: man - -install: install-data - -mostlyclean distclean maintainer-clean: clean diff --git a/doc/manpages/Makefile.in b/doc/manpages/Makefile.in new file mode 100644 index 0000000000..f28746cee6 --- /dev/null +++ b/doc/manpages/Makefile.in @@ -0,0 +1,55 @@ +# This is necessary to support VPATH builds. +srcdir = @srcdir@ +VPATH = @srcdir@ + +# This variable is used as the documentation source location in frr-sphinx.mk +SOURCESDIR = @srcdir@ + +include @srcdir@/../frr-sphinx.mk + +# ----------------------------------------------------------------------------- +# Automake requires that 3rd-party Makefiles recognize these targets. +# ----------------------------------------------------------------------------- +# install +# install-data +# install-exec +# uninstall +# install-dvi +# install-html +# install-info +# install-ps +# install-pdf +# installdirs +# check +# installcheck +# mostlyclean +# clean +# distclean +# maintainer-clean +# dvi +# pdf +# ps +# info +# html +# tags +# ctags + +# ignore these targets +EMPTY_AUTOMAKE_TARGETS = dvi pdf ps tags ctags distdir installdirs check installcheck install-dvi install-ps install-html install-pdf install-info install-exec +.PHONY: $(EMPTY_AUTOMAKE_TARGETS) +$(EMPTY_AUTOMAKE_TARGETS): + +# These targets are automatically generated by Sphinx but conflict with +# implicitly defined Automake rules, so we manually override them to nothing. +# The other option is deleting the Sphinx-generated rules, which suppresses the +# warning but kinda screws up the symmetry between Makefiles. +info: ; +html: ; + +all: man + +install-data: man + +install: install-data + +mostlyclean distclean maintainer-clean: clean -- cgit v1.2.3