build: Add support for asciidoc based manual pages

.gitignore

@@ -121,6 +121,8 @@ unit/test-avrcp
 unit/test-*.log
 unit/test-*.trs
 
+doc/btmon.1
+
 android/system-emulator
 android/bluetoothd
 android/mcaptest

Makefile.am

@@ -367,10 +367,16 @@ if LIBRARY
 pkgconfig_DATA = lib/bluez.pc
 endif
 
+manual_pages = doc/btmon.1
+
+dist_man_MANS += $(manual_pages)
+
+EXTRA_DIST += $(manual_pages:.1=.txt)
+
 DISTCHECK_CONFIGURE_FLAGS = --disable-datafiles --enable-library \
 					--disable-systemd --disable-udev
 
-DISTCLEANFILES = $(pkgconfig_DATA)
+DISTCLEANFILES = $(pkgconfig_DATA) $(manual_pages)
 
 MAINTAINERCLEANFILES = Makefile.in \
 	aclocal.m4 configure config.h.in config.sub config.guess \
@@ -383,6 +389,9 @@ SED_PROCESS = $(AM_V_GEN)$(MKDIR_P) $(dir $@) && \
 %.service: %.service.in Makefile
 	$(SED_PROCESS)
 
+%.1: %.txt
+	$(AM_V_GEN)a2x --doctype manpage --format manpage $(srcdir)/$<
+
 src/builtin.h: src/genbuiltin $(builtin_sources)
 	$(AM_V_GEN)$(srcdir)/src/genbuiltin $(builtin_modules) > $@
 

doc/btmon.txt

@@ -0,0 +1,35 @@
+BTMON(1)
+========
+:doctype: manpage
+
+
+NAME
+----
+btmon - Bluetooth monitor
+
+
+SYNOPSIS
+--------
+*btmon* ['OPTIONS']
+
+
+DESCRIPTION
+-----------
+The btmon(1) command provides access to the Bluetooth subsystem monitor
+infrastructure for reading HCI traces.
+
+
+AUTHOR
+------
+btmon was originally written by Marcel Holtmann.
+
+
+RESOURCES
+---------
+See <http://www.bluez.org/>
+
+
+COPYING
+-------
+Free use of this software is granted under ther terms of the GNU Lesser
+General Public Licenses (LGPL).