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

Peter Hutterer peter.hutterer at who-t.net
Tue Apr 2 22:34:45 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>
---
On Wed, Apr 03, 2013 at 04:54:10AM +0100, Daniel Stone wrote:
> Is there any chance we
> can generate the list of manpages (e.g. by shelling out to doxygen)
> rather than having a static list though?

Something like this?

I suspect we really only want to ship wl_foo.3 man pages anyway, I'm sure
overwriting e.g. accept(3) is a no-no :)

Patch goes on top of the other 4, but can be squashed in if needed.

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

diff --git a/doc/doxygen/Makefile.am b/doc/doxygen/Makefile.am
index e41c790..c98c473 100644
--- a/doc/doxygen/Makefile.am
+++ b/doc/doxygen/Makefile.am
@@ -10,56 +10,7 @@ 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)
+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,8 +35,11 @@ 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/
 	rm -rf man/
+
+EXTRA_DIST = $(man3_MANS)
-- 
1.8.1.4



More information about the wayland-devel mailing list