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 \

lalapps/src/pulsar/GCT/Makefile.am

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

lalapps/src/pulsar/HeterodyneSearch/Makefile.am

@@ -2,6 +2,7 @@ include $(top_srcdir)/gnuscripts/lalapps.am
 MOSTLYCLEANFILES =
 EXTRA_DIST =
 include $(top_srcdir)/gnuscripts/lalsuite_python.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 # Makefile for HeterodyneSearch
 

lalapps/src/pulsar/Hough/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/HoughFstat/Makefile.am

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

lalapps/src/pulsar/Injections/Makefile.am

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

lalapps/src/pulsar/MakeSFTs/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 if FRAME
 frameprogs = lalapps_MakeSFTs

lalapps/src/pulsar/SFTTools/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 SFTReferenceLibrary = SFTReferenceLibrary.c SFTReferenceLibrary.h
 

lalapps/src/pulsar/SidebandSearch/Makefile.am

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

lalapps/src/pulsar/Tools/Makefile.am

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

lalapps/src/pulsar/TwoSpect/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 bin_PROGRAMS = lalapps_TwoSpect lalapps_TwoSpectTemplateBank
 

lalapps/src/pulsar/Xray/Makefile.am

+MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalapps.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 bin_PROGRAMS = lalapps_SemiCoherentBinary_v2 lalapps_binary2sfts lalapps_Intermittent
 

lalapps/src/ring/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
 
 RINGPROG = \
 	lalapps_ring \

lalapps/src/stochastic/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
 
 ## sources
 STOCH_SRCS       = data_input.c data_input.h \

lalapps/src/string/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
 
 bin_PROGRAMS = lalapps_StringSearch lalapps_StringAddFrame 
 lalapps_StringSearch_SOURCES = StringSearch.c

lalapps/src/tracksearch/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
 
 bin_PROGRAMS = \
 	lalapps_tracksearch \

laldetchar/configure.ac

@@ -88,6 +88,9 @@ LALSUITE_ENABLE_LALFRAME
 # enable Doxygen documentation
 LALSUITE_ENABLE_DOXYGEN
 
+# enable help2man documentation
+LALSUITE_ENABLE_HELP2MAN
+
 # define version/configure info
 LALSUITE_VERSION_CONFIGURE_INFO
 
@@ -182,6 +185,7 @@ LALDetChar has now been successfully configured:
 * SWIG bindings for Octave are $SWIG_BUILD_OCTAVE_ENABLE_VAL
 * SWIG bindings for Python are $SWIG_BUILD_PYTHON_ENABLE_VAL
 * Doxygen documentation is $DOXYGEN_ENABLE_VAL
+* help2man documentation is $HELP2MAN_ENABLE_VAL
 
 and will be installed under the directory:
 

laldetchar/debian/control.in

@@ -2,7 +2,7 @@ Source: laldetchar
 Section: science
 Priority: optional
 Maintainer: Adam Mercer <adam.mercer@ligo.org>
-Build-Depends: debhelper (>= 9), pkg-config, dh-python, python-all-dev,
+Build-Depends: debhelper (>= 9), help2man, pkg-config, dh-python, python-all-dev,
   libgsl-dev | libgsl0-dev (>= 1.9), libglib2.0-dev, swig (>= 3.0.7),
   liboctave-dev,
   lal-dev (>= @MIN_LAL_VERSION@~),

laldetchar/debian/laldetchar.install

 etc/*
 usr/lib/*/*.so.*
+usr/share/man/*

laldetchar/gnuscripts/lalsuite_help2man.am

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

laldetchar/python/Makefile.am

@@ -2,6 +2,7 @@ BUILT_SOURCES =
 MOSTLYCLEANFILES =
 EXTRA_DIST =
 include $(top_srcdir)/gnuscripts/lalsuite_python.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 SUBDIRS = laldetchar
 

lalinference/configure.ac

@@ -105,6 +105,9 @@ LALSUITE_ENABLE_SWIG
 # enable Doxygen documentation
 LALSUITE_ENABLE_DOXYGEN
 
+# enable help2man documentation
+LALSUITE_ENABLE_HELP2MAN
+
 # define version/configure info
 LALSUITE_VERSION_CONFIGURE_INFO
 
@@ -306,6 +309,7 @@ LALInference has now been successfully configured:
 * HEALPix is $HEALPIX_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:
 

lalinference/debian/control.in

@@ -2,7 +2,7 @@ Source: lalinference
 Section: science
 Priority: optional
 Maintainer: Adam Mercer <adam.mercer@ligo.org>
-Build-Depends: debhelper (>= 9), pkg-config, dh-python, python-all-dev,
+Build-Depends: debhelper (>= 9), help2man, pkg-config, dh-python, python-all-dev,
   libchealpix-dev,
   zlib1g-dev, libgsl0-dev (>= 1.15), libmetaio-dev (>= 8.2), python-healpy (>= 1.9.1), python-h5py,
   swig (>= 3.0.7), liboctave-dev, python-numpy, python-scipy,

lalinference/debian/lalinference.install

@@ -5,3 +5,4 @@ usr/bin/lalinference_datadump
 usr/bin/lalinference_bench
 usr/lib/*/*.so.*
 usr/share/lalinference/*.csv
+usr/share/man/*

lalinference/gnuscripts/lalsuite_help2man.am

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

lalinference/python/Makefile.am

@@ -2,6 +2,7 @@ BUILT_SOURCES =
 MOSTLYCLEANFILES =
 EXTRA_DIST =
 include $(top_srcdir)/gnuscripts/lalsuite_python.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 SUBDIRS = lalinference
 

lalinference/src/Makefile.am

@@ -2,6 +2,7 @@ BUILT_SOURCES =
 MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalsuite_header_links.am
 include $(top_srcdir)/gnuscripts/lalsuite_vcs_info.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 LDADD = liblalinference.la
 

lalsimulation/configure.ac

@@ -77,6 +77,9 @@ LALSUITE_ENABLE_SWIG
 # enable Doxygen documentation
 LALSUITE_ENABLE_DOXYGEN
 
+# enable help2man documentation
+LALSUITE_ENABLE_HELP2MAN
+
 # define version/configure info
 LALSUITE_VERSION_CONFIGURE_INFO
 
@@ -192,6 +195,7 @@ LALSimulation has now been successfully configured:
 * SWIG bindings for Python are $SWIG_BUILD_PYTHON_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:
 

lalsimulation/debian/lalsimulation.install

@@ -4,3 +4,4 @@ usr/lib/*/*.so.*
 usr/share/lalsimulation/LALSimNeutronStarEOS_*
 usr/share/lalsimulation/LIGO-P1200087-v18*
 usr/share/lalsimulation/LIGO-T0900288*
+usr/share/man/*

lalsimulation/gnuscripts/lalsuite_help2man.am

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

lalsimulation/src/Makefile.am

@@ -2,6 +2,7 @@ BUILT_SOURCES =
 MOSTLYCLEANFILES =
 include $(top_srcdir)/gnuscripts/lalsuite_header_links.am
 include $(top_srcdir)/gnuscripts/lalsuite_vcs_info.am
+include $(top_srcdir)/gnuscripts/lalsuite_help2man.am
 
 SUBDIRS = \
 	mathematica_codes \