libzmq/doc/Makefile.am

#
# documentation
#
MAN3 = \
    zmq_bind.3 zmq_unbind.3 zmq_connect.3 zmq_connect_peer.3 zmq_disconnect.3 zmq_close.3 \
    zmq_ctx_new.3 zmq_ctx_term.3 zmq_ctx_get.3 zmq_ctx_set.3 zmq_ctx_shutdown.3 \
    zmq_msg_init.3 zmq_msg_init_data.3 zmq_msg_init_size.3 zmq_msg_init_buffer.3 \
    zmq_msg_move.3 zmq_msg_copy.3 zmq_msg_size.3 zmq_msg_data.3 zmq_msg_close.3 \
    zmq_msg_send.3 zmq_msg_recv.3 \
    zmq_msg_routing_id.3 zmq_msg_set_routing_id.3 \
    zmq_send.3 zmq_recv.3 zmq_send_const.3 \
    zmq_msg_get.3 zmq_msg_set.3 zmq_msg_more.3 zmq_msg_gets.3 \
    zmq_getsockopt.3 zmq_setsockopt.3 \
    zmq_socket.3 zmq_socket_monitor.3 zmq_poll.3 zmq_ppoll.3 \
    zmq_socket_monitor_versioned.3 \
    zmq_errno.3 zmq_strerror.3 zmq_version.3 \
    zmq_sendmsg.3 zmq_recvmsg.3 \
    zmq_proxy.3 zmq_proxy_steerable.3 \
    zmq_z85_encode.3 zmq_z85_decode.3 zmq_curve_keypair.3 zmq_curve_public.3 \
    zmq_has.3 \
    zmq_timers.3 zmq_poller.3 \
    zmq_atomic_counter_new.3 zmq_atomic_counter_set.3 \
    zmq_atomic_counter_inc.3 zmq_atomic_counter_dec.3 \
    zmq_atomic_counter_value.3 zmq_atomic_counter_destroy.3

MAN7 = \
    zmq.7 zmq_tcp.7 zmq_pgm.7 zmq_inproc.7 zmq_ipc.7 \
    zmq_null.7 zmq_plain.7 zmq_curve.7 zmq_tipc.7 zmq_vmci.7 zmq_udp.7 \
    zmq_gssapi.7

# ASCIIDOC_DOC_WITHOUT_INDEX contains all the Asciidoc files checked into the git repo, except for index.adoc
ASCIIDOC_DOC_WITHOUT_INDEX = $(MAN3:%.3=%.adoc) $(MAN7:%.7=%.adoc)

# MAN_DOC contains all the MANPAGE documentation (generated from asciidoc files)
MAN_DOC = $(MAN3) $(MAN7) 

# HTML_DOC contains all the HTML documentation (generated from asciidoc files)
HTML_DOC = index.html $(ASCIIDOC_DOC_WITHOUT_INDEX:%.adoc=%.html)

MAINTAINERCLEANFILES =
EXTRA_DIST = $(ASCIIDOC_DOC_WITHOUT_INDEX)


#
# BUILD_DOC is set when Asciidoctor has been found
# Declare here all the rules to produce documentation from .adoc files
#
if BUILD_DOC

EXTRA_DIST += $(HTML_DOC) $(MAN_DOC)
MAINTAINERCLEANFILES += $(HTML_DOC) $(MAN_DOC)
SUFFIXES=.html .adoc .3 .7

.adoc.html:
	asciidoctor -b html -azmq_version=@PACKAGE_VERSION@  $<
.adoc.3:
	asciidoctor -b manpage -azmq_version=@PACKAGE_VERSION@  $<
.adoc.7:
	asciidoctor -b manpage -azmq_version=@PACKAGE_VERSION@  $<

dist-hook : $(MAN_DOC) $(HTML_DOC)

# the following Bash snippet is used to automatically generate an alphabetical list included by index.adoc:
$(builddir)/__pagelist:
	echo >$@
	for adocfile in $(ASCIIDOC_DOC_WITHOUT_INDEX); do \
		noext=$${adocfile//.adoc/}; \
		echo "* xref:$${adocfile}[$${noext}]" >> $@; \
	done

# there are a number of constraints in auto-generating files for Asciidoctor:
# - out-of-tree builds
# - read-only source tree
# - target being invoked into RPM buildroot
# etc, so we have special rules to build the index.html page, which requires auto-generated list of doc pages
index.html:
	$(MAKE) $(builddir)/__pagelist
	asciidoctor -b html -azmq_version=@PACKAGE_VERSION@ -azmq_pagelist_dir=$(abs_builddir) $(srcdir)/index.adoc

all-local : $(MAN_DOC) $(HTML_DOC)

clean-local :
	rm -f $(MAN_DOC) $(HTML_DOC) $(builddir)/__pagelist

endif



#
# INSTALL_MAN is set when BUILD_DOC was set and additionally the manpages need to be installed
#
if INSTALL_MAN
dist_man_MANS = $(MAN_DOC)
endif