From 5903c91cae1f2046aa0fa463f76dd80fc0ed5c7a Mon Sep 17 00:00:00 2001 From: Joel Brobecker Date: Mon, 16 Dec 2019 10:33:27 +0000 Subject: [Ada] Reword the impact of -minimal on the debugger 2019-12-16 Joel Brobecker 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 --- gcc/ada/ChangeLog | 7 +++++++ gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst | 5 ++++- gcc/ada/gnat_ugn.texi | 5 ++++- 3 files changed, 15 insertions(+), 2 deletions(-) (limited to 'gcc') diff --git a/gcc/ada/ChangeLog b/gcc/ada/ChangeLog index 12380b6..2eeef49 100644 --- a/gcc/ada/ChangeLog +++ b/gcc/ada/ChangeLog @@ -1,3 +1,10 @@ +2019-12-16 Joel Brobecker + + * 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 * 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 457646a..fd18547 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 07db41f..f37679e 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. -- cgit v1.1