docs: conditionally install wrapper compiler man pages

Only install the C++, Fortran, and/or Java wrapper compiler pages if
configure determines that we're actually building bindings for the
corresponding language.

Ensure to *always* include all the wrapper compiler pages in the
tarball, though.

Thanks to Orion Poplawski for identifying the problem and suggesting
an initial fix.

Signed-off-by: Jeff Squyres <jsquyres@cisco.com>

Author: jsquyres

config/ompi_setup_mpi_fortran.m4

@@ -887,4 +887,9 @@ end type test_mpi_handle],
     AC_DEFINE_UNQUOTED(OMPI_BUILD_FORTRAN_BINDINGS,
                        $OMPI_BUILD_FORTRAN_BINDINGS,
                        [The level of fortran bindings to be built])
+
+    # This is an overall "are we building any Fortran MPI bindings"
+    # conditional
+    AM_CONDITIONAL([OMPI_BUILD_ANY_FORTRAN_BINDINGS],
+                   [test $OMPI_BUILD_FORTRAN_BINDINGS -gt 0])
 ])

docs/Makefile.am

@@ -796,29 +796,41 @@ EXTRA_DIST += \
 ###########################################################################
 
 # These files are not generated by Sphinx (they are redirects to
-# Sphinx-generated man pages).
-OMPI_MAN1_REDIRECTS = \
-        man-openmpi/man1/mpicc.1 \
+# Sphinx-generated man pages) -- they exist directly in Git.  We
+# *always* want these files to be in EXTRA_DIST (so that they're in
+# distribution tarballs).  We'll decide later whether we install each
+# of these (e.g., if configure disabled the Java bindings, we won't
+# install mpijavac.1).
+OMPI_MAN1_C_REDIRECTS = man-openmpi/man1/mpicc.1
+OMPI_MAN1_CXX_REDIRECTS = \
         man-openmpi/man1/mpicxx.1 \
-        man-openmpi/man1/mpic++.1 \
+        man-openmpi/man1/mpic++.1
+OMPI_MAN1_FORTRAN_REDIRECTS = \
         man-openmpi/man1/mpifort.1 \
         man-openmpi/man1/mpif77.1 \
-        man-openmpi/man1/mpif90.1 \
-        man-openmpi/man1/mpijavac.1
+        man-openmpi/man1/mpif90.1
+OMPI_MAN1_JAVA_REDIRECTS = man-openmpi/man1/mpijavac.1
 
-OSHMEM_MAN1_REDIRECTS = \
+OSHMEM_MAN1_C_REDIRECTS = \
         man-openshmem/man1/oshcc.1 \
+        man-openshmem/man1/shmemcc.1
+OSHMEM_MAN1_CXX_REDIRECTS = \
         man-openshmem/man1/oshcxx.1 \
         man-openshmem/man1/oshc++.1 \
-        man-openshmem/man1/oshfort.1 \
-        man-openshmem/man1/shmemcc.1 \
         man-openshmem/man1/shmemcxx.1 \
-        man-openshmem/man1/shmemc++.1 \
+        man-openshmem/man1/shmemc++.1
+OSHMEM_MAN1_FORTRAN_REDIRECTS = \
+        man-openshmem/man1/oshfort.1 \
         man-openshmem/man1/shmemfort.1
 
 EXTRA_DIST += \
-        $(OMPI_MAN1_REDIRECTS) \
-        $(OSHMEM_MAN1_REDIRECTS)
+        $(OMPI_MAN1_C_REDIRECTS) \
+        $(OMPI_MAN1_CXX_REDIRECTS) \
+        $(OMPI_MAN1_FORTRAN_REDIRECTS) \
+        $(OMPI_MAN1_JAVA_REDIRECTS) \
+        $(OSHMEM_MAN1_C_REDIRECTS) \
+        $(OSHMEM_MAN1_CXX_REDIRECTS) \
+        $(OSHMEM_MAN1_FORTRAN_REDIRECTS)
 
 ###########################################################################
 if OPAL_BUILD_DOCS
@@ -877,15 +889,32 @@ if OPAL_INSTALL_DOCS
 
 man1_MANS = \
         $(OMPI_MAN1_BUILT) \
-        $(OMPI_MAN1_REDIRECTS)
+        $(OMPI_MAN1_C_REDIRECTS)
+if OMPI_HAVE_CXX_COMPILER
+man1_MANS += $(OMPI_MAN1_CXX_REDIRECTS)
+endif
+if OMPI_BUILD_ANY_FORTRAN_BINDINGS
+man1_MANS += $(OMPI_MAN1_FORTRAN_REDIRECTS)
+endif
+if OMPI_WANT_JAVA_BINDINGS
+man1_MANS += $(OMPI_MAN1_JAVA_REDIRECTS)
+endif
 
 man3_MANS = $(OMPI_MAN3_BUILT)
 man5_MANS = $(OMPI_MAN5_BUILT)
 
 if PROJECT_OSHMEM
 man1_MANS += \
         $(OSHMEM_MAN1_BUILT) \
-        $(OSHMEM_MAN1_REDIRECTS)
+        $(OSHMEM_MAN1_C_REDIRECTS)
+# There is no OSHMEM equivalent of this conditional; just use the OMPI
+# conditional.
+if OMPI_HAVE_CXX_COMPILER
+man1_MANS += $(OSHMEM_MAN1_CXX_REDIRECTS)
+endif
+if OSHMEM_BUILD_FORTRAN_BINDINGS
+man1_MANS += $(OSHMEM_MAN1_FORTRAN_REDIRECTS)
+endif
 
 man3_MANS += $(OSHMEM_MAN3_BUILT)
 endif