man: generate qmicli manpage from --help-all

.gitignore

@@ -76,3 +76,5 @@ docs/reference/libqmi-glib/html
 docs/reference/libqmi-glib/tmpl
 docs/reference/libqmi-glib/xml
 docs/reference/libqmi-glib/.libs
+
+docs/man/qmicli.1

configure.ac

@@ -86,6 +86,9 @@ AC_SUBST(GLIB_MKENUMS)
 dnl Documentation
 GTK_DOC_CHECK(1.0)
 
+dnl Man page
+AC_PATH_PROG(HELP2MAN, help2man, false)
+
 AC_CONFIG_FILES([Makefile
                  data/Makefile
                  data/pkg-config/Makefile
@@ -103,7 +106,8 @@ AC_CONFIG_FILES([Makefile
                  docs/Makefile
                  docs/reference/Makefile
                  docs/reference/libqmi-glib/Makefile
-                 docs/reference/libqmi-glib/version.xml])
+                 docs/reference/libqmi-glib/version.xml
+                 docs/man/Makefile])
 AC_OUTPUT
 
 echo "

docs/Makefile.am

@@ -1 +1 @@
-SUBDIRS = reference
+SUBDIRS = reference man

docs/man/Makefile.am

@@ -0,0 +1,21 @@
+
+dist_man_MANS = qmicli.1
+
+# List of all source files which affect the output of --help-all
+SOURCES_WITH_HELP = \
+	$(top_srcdir)/cli/qmicli.c \
+	$(top_srcdir)/cli/qmicli-dms.c \
+	$(top_srcdir)/cli/qmicli-nas.c \
+	$(top_srcdir)/cli/qmicli-wds.c \
+	$(top_srcdir)/cli/qmicli-pbm.c \
+	$(top_srcdir)/cli/qmicli-uim.c
+
+# Depend only in the source files, not in the actual program, so that the
+# manpage doesn't get rebuilt when building from a tarball
+qmicli.1: $(SOURCES_WITH_HELP)
+	- $(AM_V_GEN) $(HELP2MAN) \
+		--output=$@ \
+		--name='Control QMI devices' \
+		--help-option='--help-all' \
+		--libtool \
+		$(top_builddir)/cli/qmicli