[Ada] Reword the impact of -minimal on the debugger

2019-12-16  Joel Brobecker  <brobecker@adacore.com>

gcc/ada/

	* doc/gnat_ugn/building_executable_programs_with_gnat.rst
	(_Switches_for_gnatbind): Reword the section explaining the
	impact of -minimal on debugging.
	* gnat_ugn.texi: Regenerate.

From-SVN: r279416

diff --git a/gcc/ada/ChangeLog b/gcc/ada/ChangeLog
index 12380b6b983bfc718908f9bfea5e2b4bbc105cbb..2eeef49b859c57f65de2eb00a04637a9cac28a63 100644 (file)
--- a/gcc/ada/ChangeLog
+++ b/gcc/ada/ChangeLog
@@ -1,3 +1,10 @@
+2019-12-16  Joel Brobecker  <brobecker@adacore.com>
+
+       * doc/gnat_ugn/building_executable_programs_with_gnat.rst
+       (_Switches_for_gnatbind): Reword the section explaining the
+       impact of -minimal on debugging.
+       * gnat_ugn.texi: Regenerate.
+
 2019-12-16  Gary Dismukes  <dismukes@adacore.com>
 
        * libgnat/g-exptty.adb, libgnat/g-exptty.ads: Typo fixes and

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 457646a83be54653c05117ac421c335beb9cf101..fd1854749cc1d386d1911673687f87d419d49bc9 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
@@ -6540,7 +6540,10 @@ be presented in subsequent sections.
   longer generated. **Warning:** this option comes with the following
   limitations:
 
-  * Debugging will not work;
+  * Starting the program's execution in the debugger will cause it to
+    stop at the start of the ``main`` function instead of the main subprogram. 
+    This can be worked around by manually inserting a breakpoint on that 
+    subprogram and resuming the program's execution until reaching that breakpoint.
   * Programs using GNAT.Compiler_Version will not link.
 
   .. index:: -n  (gnatbind)

diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi
index 07db41f2f05f9fc16ddb7ba79ec8155d3451b2a3..f37679ec13ab8683a10faee1bd9e0ec1ff676230 100644 (file)
--- a/gcc/ada/gnat_ugn.texi
+++ b/gcc/ada/gnat_ugn.texi
@@ -15968,7 +15968,10 @@ limitations:
 @itemize *
 
 @item 
-Debugging will not work;
+Starting the program's execution in the debugger will cause it to
+stop at the start of the @code{main} function instead of the main subprogram.
+This can be worked around by manually inserting a breakpoint on that
+subprogram and resuming the program's execution until reaching that breakpoint.
 
 @item 
 Programs using GNAT.Compiler_Version will not link.