Fill in missing man pages using help2man

The Debian project requries that all executables have man pages.
Original: 230f6f840109bb0767593e863498f4e54317ac92

gnuscripts/lalsuite_build.m4

 # -*- mode: autoconf; -*-
 # lalsuite_build.m4 - top level build macros
 #
-# serial 127
+# serial 128
 
 # restrict which LALSUITE_... patterns can appearing in output (./configure);
 # useful for debugging problems with unexpanded LALSUITE_... Autoconf macros
@@ -1378,3 +1378,12 @@ AC_DEFUN([LALSUITE_CHECK_PAGER],[
   ])
   # end $0
 ])
+
+AC_DEFUN([LALSUITE_ENABLE_HELP2MAN],[
+  # $0: check for help2man utility
+  AC_PATH_PROG([HELP2MAN], [help2man])
+  AC_SUBST([HELP2MAN], ["${HELP2MAN}"])
+  AS_IF([test -n "${HELP2MAN}"], [help2man=true], [help2man=false])
+  LALSUITE_ENABLE_MODULE([HELP2MAN])
+  # end $0
+])

gnuscripts/lalsuite_help2man.am

+if HELP2MAN
+
+man1_MANS = $(bin_PROGRAMS:=.man)
+if HAVE_PYTHON
+man1_MANS += $(pybin_scripts:=.pyman)
+endif
+
+MOSTLYCLEANFILES += $(man1_MANS)
+
+endif
+
+%.pyman: %.py
+	$(AM_V_GEN)$(HELP2MAN) --no-discard-stderr --no-info --source=$(PACKAGE_NAME) --version-string=$(PACKAGE_VERSION) -o $@ $(builddir)/$*
+
+%.man: %
+	$(AM_V_GEN)$(LIBTOOL) --mode=execute $(LDADD:%=-dlopen %) $(HELP2MAN) --no-discard-stderr --no-info --source=$(PACKAGE_NAME) --version-string=$(PACKAGE_VERSION) -o $@ $(builddir)/$*

lalapps/configure.ac

@@ -119,6 +119,9 @@ LALSUITE_ENABLE_LALSTOCHASTIC
 # enable Doxygen documentation
 LALSUITE_ENABLE_DOXYGEN
 
+# enable help2man documentation
+LALSUITE_ENABLE_HELP2MAN
+
 # define version/configure info
 LALSUITE_VERSION_CONFIGURE_INFO
 
@@ -496,6 +499,7 @@ LALApps has now been successfully configured:
 * CUDA support is $CUDA_ENABLE_VAL
 * OpenMP acceleration is $OPENMP_ENABLE_VAL
 * Doxygen documentation is $DOXYGEN_ENABLE_VAL
+* help2man documentation is $HELP2MAN_ENABLE_VAL
 
 and will be installed under the directory:
 

lalapps/debian/control.in

@@ -2,7 +2,7 @@ Source: lalapps
 Section: science
 Priority: optional
 Maintainer: Steffen Grunewald <steffen.grunewald@aei.mpg.de>
-Build-Depends: debhelper (>= 9), pkg-config, dh-python, python-all-dev, libopenmpi-dev,
+Build-Depends: debhelper (>= 9), help2man, pkg-config, dh-python, python-all-dev, libopenmpi-dev,
   libgsl-dev | libgsl0-dev (>= 1.9), libfftw3-dev, libcfitsio3-dev, zlib1g-dev,
   libframe-dev (>= 8.0), libmetaio-dev (>= 8.2),
   lal-dev (>= @MIN_LAL_VERSION@~),

lalapps/debian/install

@@ -3,3 +3,4 @@ usr/bin/*
 usr/share/lalapps/*
 usr/share/man/man1/*
 usr/lib/python*/*-packages/lalapps/
+usr/share/man/*

lalapps/gnuscripts/lalsuite_help2man.am

+../../gnuscripts/lalsuite_help2man.am
\ No newline at end of file

lalapps/src/calibration/Makefile.am

@@ -3,6 +3,7 @@ include $(top_srcdir)/gnuscripts/lalapps.am
 MOSTLYCLEANFILES =
 EXTRA_DIST =
 include $(top_srcdir)/gnuscripts/lalsuite_python.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 lalapps_ComputeStrainDriver_SOURCES = ComputeStrainDriver.c
 lalapps_ComputeFactors_SOURCES = ComputeFactors.c

lalapps/src/findchirp/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 LALINSPIRALPROGRAMS = \
 	lalapps_InspiralOverlap \

lalapps/src/frametools/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 LALFRAMEPROGRAMS = \
 	lalapps_animate \

lalapps/src/hwinjection/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 progs = lalapps_psinject
 

lalapps/src/inspiral/Makefile.am

@@ -3,6 +3,7 @@ include $(top_srcdir)/gnuscripts/lalapps.am
 MOSTLYCLEANFILES =
 EXTRA_DIST =
 include $(top_srcdir)/gnuscripts/lalsuite_python.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 SUBDIRS = posterior
 

lalapps/src/inspiral/posterior/Makefile.am

@@ -3,6 +3,7 @@ include $(top_srcdir)/gnuscripts/lalapps.am
 MOSTLYCLEANFILES =
 EXTRA_DIST =
 include $(top_srcdir)/gnuscripts/lalsuite_python.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 SUBDIRS = \
 	mpi

lalapps/src/lalapps/Makefile.am

@@ -3,6 +3,7 @@ MOSTLYCLEANFILES =
 EXTRA_DIST =
 include $(top_srcdir)/gnuscripts/lalsuite_vcs_info.am
 include $(top_srcdir)/gnuscripts/lalsuite_python.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 if FRAME
 if LALFRAME

lalapps/src/online/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 DATAFIND_SRCS = online_datafind.c
 

lalapps/src/power/Makefile.am

@@ -3,6 +3,7 @@ include $(top_srcdir)/gnuscripts/lalapps.am
 MOSTLYCLEANFILES =
 EXTRA_DIST =
 include $(top_srcdir)/gnuscripts/lalsuite_python.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 BURSTPROGS = lalapps_binj
 lalapps_binj_SOURCES = binj.c

lalapps/src/pulsar/CreateEphemeris/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 bin_PROGRAMS = lalapps_create_solar_system_ephemeris \
 	       lalapps_create_time_correction_ephemeris

lalapps/src/pulsar/CrossCorr/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 AM_CPPFLAGS += -I$(top_srcdir)/src/pulsar/Fstatistic
 

lalapps/src/pulsar/FITSTools/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 AM_CPPFLAGS += $(PAGER_CPPFLAGS)
 

lalapps/src/pulsar/Fscan/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 # Makefile for fscan
 

lalapps/src/pulsar/Fstatistic/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 bin_PROGRAMS = \
 	lalapps_SemiAnalyticF \