2009-08-17 Robert Dewar <dewar@adacore.com>

[pf3gnuchains/gcc-fork.git] / gcc / ada / g-trasym.ads

diff --git a/gcc/ada/g-trasym.ads b/gcc/ada/g-trasym.ads
index 60681d3..8936231 100644 (file)
--- a/gcc/ada/g-trasym.ads
+++ b/gcc/ada/g-trasym.ads
@@ -6,7 +6,7 @@
 --                                                                          --
 --                                 S p e c                                  --
 --                                                                          --
---                     Copyright (C) 1999-2007, AdaCore                     --
+--                     Copyright (C) 1999-2008, AdaCore                     --
 --                                                                          --
 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
 -- terms of the  GNU General Public License as published  by the Free Soft- --
@@ -35,13 +35,14 @@
 
 --  This capability is currently supported on the following targets:
 
---     HP-UX
---     Irix MIPS
---     GNU/Linux x86
---     Solaris sparc
---     Tru64 alpha
+--     HP-UX hppa and ia64
+--     IRIX
+--     GNU/Linux x86, x86_64, ia64
+--     AIX
+--     Solaris sparc and x86
+--     Tru64
 --     OpenVMS/Alpha
---     Windows NT/XP
+--     Windows NT/XP/Vista
 
 --  The routines provided in this package assume that your application has
 --  been compiled with debugging information turned on, since this information
@@ -59,16 +60,15 @@
 --  - archive this executable
 --  - strip a copy of the executable and distribute/deploy this version
 --  - at run time, compute absolute traceback (-bargs -E) from your
---    executable and log it using Ada.Exceptions.Exception_Occurrence
+--    executable and log it using Ada.Exceptions.Exception_Information
 --  - off line, compute the symbolic traceback using the executable archived
 --    with debug info and addr2line or gdb (using info line *<addr>) on the
 --    absolute addresses logged by your application.
 
 --  In order to retrieve symbolic information, functions in this package will
 --  read on disk all the debug information of the executable file (found via
---  Argument (0), so any path information needed to read the executable file
---  need to be provided when launching the executable), and load then in
---  memory, causing a significant cpu and memory overhead.
+--  Argument (0), and looked in the PATH if needed), and load them in memory,
+--  causing a significant cpu and memory overhead.
 
 --  On all platforms except VMS, this package is not intended to be used
 --  within a shared library, symbolic tracebacks are only supported for the
@@ -84,12 +84,11 @@ with Ada.Exceptions; use Ada.Exceptions;
 package GNAT.Traceback.Symbolic is
    pragma Elaborate_Body;
 
-   ------------------------
-   -- Symbolic_Traceback --
-   ------------------------
-
    function Symbolic_Traceback (Traceback : Tracebacks_Array) return String;
    --  Build a string containing a symbolic traceback of the given call chain
+   --
+   --  Note: This procedure may be installed by Set_Trace_Decorator, to get a
+   --  symbolic traceback on all exceptions raised (see GNAT.Exception_Traces).
 
    function Symbolic_Traceback (E : Exception_Occurrence) return String;
    --  Build string containing symbolic traceback of given exception occurrence