[PATCH v2 5/5] doc: use a dynamic list of man pages

Peter Hutterer peter.hutterer at who-t.net
Wed Apr 3 18:29:01 PDT 2013


This requires that doxygen is run before the man target so find can actually
find the man pages.

Signed-off-by: Peter Hutterer <peter.hutterer at who-t.net>
---
Changes to v1:
- use dist_MAN3_MANS
- add comment how it works and why we use all-local

 doc/doxygen/Makefile.am | 57 ++++++-------------------------------------------
 1 file changed, 6 insertions(+), 51 deletions(-)

diff --git a/doc/doxygen/Makefile.am b/doc/doxygen/Makefile.am
index e41c790..ec43519 100644
--- a/doc/doxygen/Makefile.am
+++ b/doc/doxygen/Makefile.am
@@ -10,56 +10,10 @@ scanned_src_files_server = 				\
 	$(top_srcdir)/src/wayland-server.c	\
 	$(top_srcdir)/src/wayland-server.h
 
-client_MANPAGES = \
-	man/man3/wl_display.3 \
-	man/man3/wl_display_connect.3 \
-	man/man3/wl_display_connect_to_fd.3 \
-	man/man3/wl_display_create_queue.3 \
-	man/man3/wl_display_disconnect.3 \
-	man/man3/wl_display_dispatch.3 \
-	man/man3/wl_display_dispatch_pending.3 \
-	man/man3/wl_display_dispatch_queue.3 \
-	man/man3/wl_display_dispatch_queue_pending.3 \
-	man/man3/wl_display_flush.3 \
-	man/man3/wl_display_get_error.3 \
-	man/man3/wl_display_get_fd.3 \
-	man/man3/wl_display_roundtrip.3 \
-	man/man3/wl_event_queue.3 \
-	man/man3/wl_event_queue_destroy.3 \
-	man/man3/wl_proxy.3 \
-	man/man3/wl_proxy_add_listener.3 \
-	man/man3/wl_proxy_create.3 \
-	man/man3/wl_proxy_destroy.3 \
-	man/man3/wl_proxy_get_class.3 \
-	man/man3/wl_proxy_get_id.3 \
-	man/man3/wl_proxy_get_user_data.3 \
-	man/man3/wl_proxy_marshal.3 \
-	man/man3/wl_proxy_set_queue.3 \
-	man/man3/wl_proxy_set_user_data.3
-
-server_MANPAGES = \
-	man/man3/wl_buffer.3 \
-	man/man3/wl_client.3 \
-	man/man3/wl_data_offer.3 \
-	man/man3/wl_data_source.3 \
-	man/man3/wl_global.3 \
-	man/man3/wl_keyboard.3 \
-	man/man3/wl_keyboard_grab.3 \
-	man/man3/wl_keyboard_grab_interface.3 \
-	man/man3/wl_listener.3 \
-	man/man3/wl_pointer.3 \
-	man/man3/wl_pointer_grab.3 \
-	man/man3/wl_pointer_grab_interface.3 \
-	man/man3/wl_resource.3 \
-	man/man3/wl_seat.3 \
-	man/man3/wl_signal.3 \
-	man/man3/wl_socket.3 \
-	man/man3/wl_surface.3 \
-	man/man3/wl_touch.3 \
-	man/man3/wl_touch_grab.3 \
-	man/man3/wl_touch_grab_interface.3
-
-man3_MANS= $(client_MANPAGES) $(server_MANPAGES)
+# find all man/man3/wl_foo.3 pages
+# for this to work, we need to create them before the man target (hence
+# all-local below)
+dist_man3_MANS= $(shell find man/man3/ -name "wl_*.3" -printf "man/man3/%P\n")
 
 xml/client/index.xml: $(scanned_src_files_client) wayland.doxygen
 	$(AM_V_GEN)$(MKDIR_P) xml/client
@@ -84,7 +38,8 @@ doxygen.man: $(scanned_src_files_client) $(scanned_src_files_server)
           echo "INPUT= $^"; \
           ) | doxygen -
 
-$(client_MANPAGES) $(server_MANPAGES): doxygen.man
+# there is no man-local
+all-local: doxygen.man
 
 clean-local:
 	rm -rf xml/
-- 
1.8.1.4



More information about the wayland-devel mailing list