Encode help-*.txt file contents into C source code

.gitignore

@@ -313,7 +313,7 @@ opal/tools/wrappers/opalCC-wrapper-data.txt
 opal/tools/wrappers/opal_wrapper
 opal/tools/wrappers/opal.pc
 
-opal/util/show_help_lex.c
+opal/util/show_help_content.c
 opal/util/keyval/keyval_lex.c
 
 test/monitoring/aggregate_profile.pl

ompi/Makefile.am

@@ -21,6 +21,7 @@
 # Copyright (c) 2018      FUJITSU LIMITED.  All rights reserved.
 # Copyright (c) 2021      Amazon.com, Inc. or its affiliates.  All Rights
 #                         reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -153,7 +154,7 @@ lib@OMPI_LIBMPI_NAME@_la_LDFLAGS = \
 headers =
 noinst_LTLIBRARIES =
 include_HEADERS =
-dist_ompidata_DATA =
+EXTRA_DIST =
 lib@OMPI_LIBMPI_NAME@_la_SOURCES += $(headers)
 
 # Conditionally install the header files

ompi/communicator/Makefile.am

@@ -15,6 +15,7 @@
 # Copyright (c) 2014      Research Organization for Information Science
 #                         and Technology (RIST). All rights reserved.
 # Copyright (c) 2016      IBM Corporation.  All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -39,4 +40,4 @@ lib@OMPI_LIBMPI_NAME@_la_SOURCES += \
 	communicator/ft/comm_ft.c communicator/ft/comm_ft_reliable_bcast.c communicator/ft/comm_ft_propagator.c communicator/ft/comm_ft_detector.c communicator/ft/comm_ft_revoke.c
 endif # WANT_FT_MPI
 
-dist_ompidata_DATA += communicator/help-comm.txt
+EXTRA_DIST += communicator/help-comm.txt

ompi/dpm/Makefile.am

@@ -2,6 +2,7 @@
 #
 # Copyright (c) 2015-2020 Intel, Inc.  All rights reserved.
 # Copyright (c) 2016      IBM Corporation.  All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -11,11 +12,10 @@
 
 # This makefile.am does not stand on its own - it is included from ompi/Makefile.am
 
-dist_ompidata_DATA += dpm/help-dpm.txt
+EXTRA_DIST += dpm/help-dpm.txt
 
 headers += \
         dpm/dpm.h
 
 lib@OMPI_LIBMPI_NAME@_la_SOURCES += \
         dpm/dpm.c
-

ompi/errhandler/Makefile.am

@@ -12,6 +12,7 @@
 #                         All rights reserved.
 # Copyright (c) 2008      Cisco Systems, Inc.  All rights reserved.
 # Copyright (c) 2016      IBM Corporation.  All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -21,7 +22,7 @@
 
 # This makefile.am does not stand on its own - it is included from ompi/Makefile.am
 
-dist_ompidata_DATA += errhandler/help-mpi-errors.txt
+EXTRA_DIST += errhandler/help-mpi-errors.txt
 
 headers += \
         errhandler/errcode.h \

ompi/mca/bml/r2/Makefile.am

@@ -9,6 +9,7 @@
 #						 All rights reserved.
 # Copyright (c) 2010      Cisco Systems, Inc.  All rights reserved.
 # Copyright (c) 2017      IBM Corporation.  All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -21,7 +22,7 @@ r2_sources  = \
 	bml_r2.h \
 	bml_r2_component.c
 
-dist_ompidata_DATA = help-mca-bml-r2.txt
+EXTRA_DIST = help-mca-bml-r2.txt
 
 if MCA_BUILD_ompi_bml_r2_DSO
 component_noinst =

ompi/mca/coll/base/Makefile.am

@@ -9,14 +9,15 @@
 #                         University of Stuttgart.  All rights reserved.
 # Copyright (c) 2004-2005 The Regents of the University of California.
 #                         All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-dist_ompidata_DATA = base/help-mca-coll-base.txt
+EXTRA_DIST = base/help-mca-coll-base.txt
 
 headers += \
         base/base.h \
@@ -51,4 +52,3 @@ if WANT_FT_MPI
 libmca_coll_la_SOURCES += \
         base/coll_base_agree_noft.c
 endif # WANT_FT_MPI
-

ompi/mca/coll/xhc/Makefile.am

@@ -1,14 +1,15 @@
 #
 # Copyright (c) 2021-2024 Computer Architecture and VLSI Systems (CARV)
 #                         Laboratory, ICS Forth. All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-dist_opaldata_DATA = help-coll-xhc.txt
+EXTRA_DIST = help-coll-xhc.txt
 
 sources = \
     coll_xhc.h \

ompi/mca/hook/base/Makefile.am

@@ -1,13 +1,14 @@
 #
 # Copyright (c) 2017      IBM Corporation.  All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-dist_ompidata_DATA = base/help-mca-hook-base.txt
+EXTRA_DIST = base/help-mca-hook-base.txt
 
 headers += \
         base/base.h

ompi/mca/mtl/ofi/Makefile.am

@@ -10,6 +10,7 @@
 # Copyright (c) 2020      Triad National Security, LLC. All rights
 #                         reserved.
 # Copyright (c) 2022      Amazon.com, Inc. or its affiliates.  All Rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -18,15 +19,14 @@
 #
 
 EXTRA_DIST = post_configure.sh \
+    help-mtl-ofi.txt \
     $(generated_source_modules)
 
 MAINTAINERCLEANFILES = \
     $(generated_sources)
 
 AM_CPPFLAGS = $(mtl_ofi_CPPFLAGS)
 
-dist_ompidata_DATA = help-mtl-ofi.txt
-
 generated_source_modules = \
     mtl_ofi_send_opt.pm \
     mtl_ofi_isend_opt.pm \

ompi/mca/mtl/psm2/Makefile.am

@@ -13,20 +13,22 @@
 # Copyright (c) 2015      Intel, Inc. All rights reserved
 # Copyright (c) 2017      Los Alamos National Security, LLC.
 #                         All rights reserved.
-#   
+#
 # Copyright (c) 2017      IBM Corporation.  All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-EXTRA_DIST = post_configure.sh
+EXTRA_DIST = \
+        post_configure.sh \
+        help-mtl-psm2.txt
 
 AM_CPPFLAGS = $(mtl_psm2_CPPFLAGS)
 
-dist_ompidata_DATA = help-mtl-psm2.txt
 
 mtl_psm2_sources = \
 	       mtl_psm2.c \

ompi/mca/pml/ob1/Makefile.am

@@ -14,18 +14,18 @@
 # Copyright (c) 2012      NVIDIA Corporation.  All rights reserved.
 # Copyright (c) 2017      IBM Corporation.  All rights reserved.
 # Copyright (c) 2022      Amazon.com, Inc. or its affiliates.  All Rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-dist_ompidata_DATA = \
+EXTRA_DIST = \
+        post_configure.sh \
 	help-mpi-pml-ob1.txt
 
-EXTRA_DIST = post_configure.sh
-
 ob1_sources  = \
 	pml_ob1.c \
 	pml_ob1.h \

ompi/mpi/Makefile.am

@@ -12,14 +12,14 @@
 # Copyright (c) 2006-2018 Cisco Systems, Inc.  All rights reserved.
 # Copyright (c) 2015      Research Organization for Information Science
 #                         and Technology (RIST). All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-EXTRA_DIST = \
-        mpi/fortran/configure-fortran-output-bottom.h
-
-dist_ompidata_DATA += mpi/help-mpi-api.txt
+EXTRA_DIST += \
+        mpi/fortran/configure-fortran-output-bottom.h \
+        mpi/help-mpi-api.txt

ompi/mpiext/ftmpi/c/Makefile.am

@@ -3,6 +3,7 @@
 # Copyright (c) 2016-2022 The University of Tennessee and The University
 #                         of Tennessee Research Foundation.  All rights
 #                         reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -37,7 +38,7 @@ libmpiext_ftmpi_c_la_SOURCES = \
 libmpiext_ftmpi_c_la_LIBADD = \
     profile/libpmpiext_ftmpi_c.la
 
-dist_ompidata_DATA = help-mpi-ft.txt
+EXTRA_DIST = help-mpi-ft.txt
 
 ompidir = $(ompiincludedir)/mpiext/
 ompi_HEADERS = $(headers)

ompi/runtime/Makefile.am

@@ -12,6 +12,7 @@
 # Copyright (c) 2006-2015 Cisco Systems, Inc.  All rights reserved.
 # Copyright (c) 2014-2019 Intel, Inc.  All rights reserved.
 # Copyright (c) 2016      IBM Corporation.  All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -21,7 +22,7 @@
 
 # This makefile.am does not stand on its own - it is included from ompi/Makefile.am
 
-dist_ompidata_DATA += runtime/help-mpi-runtime.txt
+EXTRA_DIST += runtime/help-mpi-runtime.txt
 
 headers += \
         runtime/mpiruntime.h \

ompi/tools/mpirun/Makefile.am

@@ -4,6 +4,7 @@
 # Copyright (c) 2021-2022 Amazon.com, Inc. or its affiliates.  All Rights reserved.
 # Copyright (c) 2021      Nanook Consulting.  All rights reserved.
 # Copyright (c) 2022      Cisco Systems, Inc.  All rights reserved
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -15,7 +16,7 @@ if OMPI_WANT_PRRTE
 
 bin_PROGRAMS = mpirun
 
-dist_ompidata_DATA = help-mpirun.txt
+EXTRA_DIST = help-mpirun.txt
 
 mpirun_SOURCES = \
     main.c

opal/Makefile.am

@@ -15,6 +15,7 @@
 #                         and Technology (RIST). All rights reserved.
 # Copyright (c) 2020-2022 Amazon.com, Inc. or its affiliates.  All Rights reserved.
 # Copyright (c) 2022      Advanced Micro Devices, Inc. All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -69,7 +70,7 @@ lib@OPAL_LIB_NAME@_la_LDFLAGS = -version-info @libopen_pal_so_version@
 
 # included subdirectory Makefile.am's and appended-to variables
 headers =
-dist_opaldata_DATA =
+EXTRA_DIST =
 lib@OPAL_LIB_NAME@_la_SOURCES += $(headers)
 
 # Conditionally install the header files

opal/mca/accelerator/base/Makefile.am

@@ -4,14 +4,15 @@
 # Copyright (c) 2014      Intel, Inc. All rights reserved.
 # Copyright (c) 2022      Amazon.com, Inc. or its affiliates.
 #                         All Rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-dist_opaldata_DATA = base/help-accelerator-base.txt
+EXTRA_DIST = base/help-accelerator-base.txt
 
 headers += \
 	base/base.h

opal/mca/accelerator/cuda/Makefile.am

@@ -3,6 +3,7 @@
 # Copyright (c) 2017      IBM Corporation.  All rights reserved.
 # Copyright (c) 2022      Amazon.com, Inc. or its affiliates.
 #                         All Rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -12,7 +13,7 @@
 
 
 AM_CPPFLAGS = $(common_cuda_CPPFLAGS)
-dist_opaldata_DATA = help-accelerator-cuda.txt
+EXTRA_DIST = help-accelerator-cuda.txt
 sources = \
         accelerator_cuda.h \
         accelerator_cuda_component.c \

opal/mca/allocator/bucket/Makefile.am

@@ -11,14 +11,15 @@
 #                         All rights reserved.
 # Copyright (c) 2010      Cisco Systems, Inc.  All rights reserved.
 # Copyright (c) 2017      IBM Corporation.  All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-dist_opaldata_DATA = help-mca-allocator-bucket.txt
+EXTRA_DIST = help-mca-allocator-bucket.txt
 
 sources = \
         allocator_bucket.c \
@@ -46,4 +47,3 @@ mca_allocator_bucket_la_LIBADD = $(top_builddir)/opal/lib@[email protected]
 noinst_LTLIBRARIES = $(component_noinst)
 libmca_allocator_bucket_la_SOURCES = $(sources)
 libmca_allocator_bucket_la_LDFLAGS = -module -avoid-version
-

opal/mca/base/Makefile.am

@@ -11,6 +11,7 @@
 #                         All rights reserved.
 # Copyright (c) 2010 Cisco Systems, Inc.  All rights reserved.
 # Copyright (c) 2020      Google LLC. All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
@@ -26,7 +27,7 @@ AM_CPPFLAGS = \
 
 noinst_LTLIBRARIES = libmca_base.la
 
-dist_opaldata_DATA = help-mca-base.txt help-mca-var.txt
+EXTRA_DIST = help-mca-base.txt help-mca-var.txt
 
 # Source code files
 

opal/mca/btl/base/Makefile.am

@@ -11,14 +11,15 @@
 #                         All rights reserved.
 # Copyright (c) 2021      Triad National Security, LLC. All rights reserved.
 # Copyright (c) 2021      Google, LLC. All rights reserved.
+# Copyright (c) 2025      Jeffrey M. Squyres.  All rights reserved.
 # $COPYRIGHT$
 #
 # Additional copyrights may follow
 #
 # $HEADER$
 #
 
-dist_opaldata_DATA = base/help-mpi-btl-base.txt
+EXTRA_DIST = base/help-mpi-btl-base.txt
 
 headers += \
         base/base.h \