https://gcc.gnu.org/g:cdef5c46dd8421f9d664c69ffdd76d3084176e5b
commit r17-5551-gcdef5c46dd8421f9d664c69ffdd76d3084176e5b Author: Robert Dubner <[email protected]> Date: Wed Oct 21 15:28:48 2026 -0400 cobol: Document --enable-libgcobol-rpath configuration option. This new configuration option is a solution to the problem that cropped up when trying to create an installation package for an experimental version of GCOBOL-17. Executables created by GCOBOL-17 link to the -17 level of libstdc++.so. But the current managed Ubuntu packages don't have that that version of the library. The necessary version is created in a compilation of GCC, but I don't want to copy that version over the managed version in a user's system. This new option results in the COBOL executable having RUNPATH tags inserted. Those tags point to the version of the libstdc++ library created with GCOBOL, so the system and the executable created by GCOBOL can coexist without conflict. gcc/ChangeLog: * doc/install.texi: Configure.html documentation for --enable-libgcobol-rpath Diff: --- gcc/doc/install.texi | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index ff42549fb080..2be38423c792 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -3104,6 +3104,26 @@ If none of these options are specified, the library is assumed in default locations. @end table +The following options apply to the creation of COBOL executables. + +@table @code +@item --enable-libgcobol-rpath +@itemx --enable-libgcobol-rpath=yes + +Specify that COBOL executables are created with embedded RUNPATH information +specifying the location of shared libraries needed by the executable. + +The default behavior is @option{--disable-libgcobol-rpath} or +@option{--enable-libgcobol-rpath=no}, which specify that RUNPATH information +is not included. + +The libgcobol-rpath feature has been introduced so that GCOBOL installation +packages can be created which install the experimental GCOBOL and its shared +libraries in a way that won't interfere with libraries already installed by +package managers. +@end table + + @html <hr /> <p>
