ada: Document support for the mold linker

gcc/ada/

	* doc/gnat_ugn/building_executable_programs_with_gnat.rst
	(Linker Switches): Document support for mold along with gold; add some
	advice regarding OpenSSL in the Pro version.
	* gnat_ugn.texi: Regenerate.

diff --git a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
index 6a478095cfcb700821d635fb17a1abc9e1139315..f675732aae28f1e0023b1495bf2f549a6e115723 100644 (file)
--- a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
+++ b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
@@ -6229,11 +6229,33 @@ Linker switches can be specified after :switch:`-largs` builder switch.
 .. index:: -fuse-ld=name
 
 :switch:`-fuse-ld={name}`
-  Linker to be used. The default is ``bfd`` for :file:`ld.bfd`,
-  the alternative being ``gold`` for :file:`ld.gold`. The later is
-  a more recent and faster linker, but only available on GNU/Linux
+  Linker to be used. The default is ``bfd`` for :file:`ld.bfd`; ``gold``
+  (for :file:`ld.gold`) and ``mold`` (for :file:`ld.mold`) are more
+  recent and faster alternatives, but only available on GNU/Linux
   platforms.
 
+  .. only:: PRO
+
+    The GNAT distribution for native Linux platforms includes ``mold``,
+    compiled against OpenSSL version 1.1; however, the distribution does
+    not include OpenSSL.  In order to use this linker, you may either:
+
+    * use your system's OpenSSL library, if the version matches: in this
+      situation, you need not do anything beside using the
+      :switch:`-fuse-ld=mold` switch,
+
+    * obtain a source distribution for OpenSSL 1.1, compile the
+      :file:`libcrypto.so` library and install it in the directory of
+      your choice, then include this directory in the
+      :envvar:`LD_LIBRARY_PATH` environment variable,
+
+    * install another copy of ``mold`` by other means in the directory
+      of your choice, and include this directory in the :envvar:`PATH`
+      environment variable; you may find this alternative preferable if
+      the copy of ``mold`` included in GNAT does not suit your needs
+      (e.g. being able to link against your system's OpenSSL, or using
+      another version of ``mold``).
+
 .. _Binding_with_gnatbind:
 
 Binding with ``gnatbind``

diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi
index f2cb1ed638a0a7f03047453fe2e294305355ebea..d7bcf74e278c5c493c95cc47cced077e81e19a8e 100644 (file)
--- a/gcc/ada/gnat_ugn.texi
+++ b/gcc/ada/gnat_ugn.texi
@@ -19,7 +19,7 @@
 
 @copying
 @quotation
-GNAT User's Guide for Native Platforms , Sep 09, 2022
+GNAT User's Guide for Native Platforms , Sep 26, 2022
 
 AdaCore
 
@@ -15317,10 +15317,11 @@ Linker switches can be specified after @code{-largs} builder switch.
 
 @item @code{-fuse-ld=`name'}
 
-Linker to be used. The default is @code{bfd} for @code{ld.bfd},
-the alternative being @code{gold} for @code{ld.gold}. The later is
-a more recent and faster linker, but only available on GNU/Linux
+Linker to be used. The default is @code{bfd} for @code{ld.bfd}; @code{gold}
+(for @code{ld.gold}) and @code{mold} (for @code{ld.mold}) are more
+recent and faster alternatives, but only available on GNU/Linux
 platforms.
+
 @end table
 
 @node Binding with gnatbind,Linking with gnatlink,Linker Switches,Building Executable Programs with GNAT
@@ -17932,7 +17933,6 @@ instr.ads
 
 
 
-
 @c -- Example: A |withing| unit has a |with| clause, it |withs| a |withed| unit
 
 @node GNAT and Program Execution,Platform-Specific Information,GNAT Utility Programs,Top