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>

Reply via email to