build: Add framework for handling manpages in AsciiDoc format

.gitignore

@@ -22,6 +22,7 @@ src/iwd
 client/iwctl
 monitor/iwmon
 tools/hwsim
+doc/iwmon.1
 unit/test-pbkdf2-sha1
 unit/test-prf-sha1
 unit/*.log

Makefile.am

@@ -76,11 +76,17 @@ unit_test_ie_LDADD = ell/libell-internal.la
 
 TESTS = $(unit_tests)
 
+manual_pages = doc/iwmon.1
+
+dist_man_MANS = $(manual_pages)
+
+EXTRA_DIST = $(manual_pages:.1=.txt)
+
 AM_CFLAGS = -fvisibility=hidden
 
 MAINTAINERCLEANFILES = Makefile.in configure config.h.in aclocal.m4
 
-DISTCLEANFILES = $(BUILT_SOURCES) $(unit_tests)
+DISTCLEANFILES = $(BUILT_SOURCES) $(unit_tests) $(manual_pages)
 
 BUILT_SOURCES = ell/internal
 
@@ -92,5 +98,8 @@ ell/internal: Makefile
 		fi \
 	done > $@
 
+%.1: %.txt
+	$(AM_V_GEN)a2x --doctype manpage --format manpage $(srcdir)/$<
+
 maintainer-clean-local:
 	-rm -rf build-aux ell

doc/iwmon.txt

@@ -0,0 +1,30 @@
+IWMON(1)
+========
+:doctype: manpage
+
+
+NAME
+----
+iwmon - Wireless monitor
+
+
+SYNOPSIS
+--------
+*iwmon* ['OPTIONS']
+
+
+DESCRIPTION
+-----------
+The iwmon(1) command provides access to the wireless subsystem commands,
+responses and events from the nl80211 generic netlink interface.
+
+
+AUTHOR
+------
+iwmon was originally written by Marcel Holtmann.
+
+
+COPYING
+-------
+Free use of this software is granted under ther terms of the GNU Lesser
+General Public Licenses (LGPL).