From: Joel Brobecker <brobecker@adacore.com>
Date: Mon, 16 Dec 2019 10:33:27 +0000 (+0000)
Subject: [Ada] Reword the impact of -minimal on the debugger
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=5903c91cae1f2046aa0fa463f76dd80fc0ed5c7a;p=gcc.git

[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 12380b6b983..2eeef49b859 100644
--- 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 457646a83be..fd1854749cc 100644
--- 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 07db41f2f05..f37679ec13a 100644
--- 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.