OSDN Git Service

* s-stalib.adb: Add more comments on with statements being needed
[pf3gnuchains/gcc-fork.git] / gcc / ada / s-stalib.adb
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT COMPILER COMPONENTS                         --
4 --                                                                          --
5 --              S Y S T E M . S T A N D A R D _ L I B R A R Y               --
6 --                                                                          --
7 --                                 B o d y                                  --
8 --                                                                          --
9 --                            $Revision$
10 --                                                                          --
11 --          Copyright (C) 1995-2001 Free Software Foundation, Inc.          --
12 --                                                                          --
13 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
14 -- terms of the  GNU General Public License as published  by the Free Soft- --
15 -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
16 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
17 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
18 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
19 -- for  more details.  You should have  received  a copy of the GNU General --
20 -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
21 -- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
22 -- MA 02111-1307, USA.                                                      --
23 --                                                                          --
24 -- As a special exception,  if other files  instantiate  generics from this --
25 -- unit, or you link  this unit with other files  to produce an executable, --
26 -- this  unit  does not  by itself cause  the resulting  executable  to  be --
27 -- covered  by the  GNU  General  Public  License.  This exception does not --
28 -- however invalidate  any other reasons why  the executable file  might be --
29 -- covered by the  GNU Public License.                                      --
30 --                                                                          --
31 -- GNAT was originally developed  by the GNAT team at  New York University. --
32 -- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
33 --                                                                          --
34 ------------------------------------------------------------------------------
35
36 --  The purpose of this body is simply to ensure that the two with'ed units
37 --  are properly included in the link. They are not with'ed from the spec
38 --  of System.Standard_Library, since this would cause order of elaboration
39 --  problems (Elaborate_Body would have the same problem).
40
41 pragma Warnings (Off);
42 --  Kill warnings from unused withs
43
44 pragma Polling (Off);
45 --  We must turn polling off for this unit, because otherwise we get
46 --  elaboration circularities with Ada.Exceptions if polling is on.
47
48 with System.Soft_Links;
49 --  Referenced directly from generated code using external symbols so it
50 --  must always be present in a build, even if no unit has a direct with
51 --  of this unit. Also referenced from exception handling routines.
52 --  This is needed for programs that don't use exceptions explicitely but
53 --  direct calls to Ada.Exceptions are generated by gigi (for example,
54 --  by calling __gnat_raise_constraint_error directly).
55
56 with System.Memory;
57 --  Referenced directly from generated code using external symbols, so it
58 --  must always be present in a build, even if no unit has a direct with
59 --  of this unit.
60
61 package body System.Standard_Library is
62
63    Runtime_Finalized : Boolean := False;
64    --  Set to True when adafinal is called. Used to ensure that subsequent
65    --  calls to adafinal after the first have no effect.
66
67    Inside_Elab_Final_Code : Integer := 0;
68    pragma Export (C, Inside_Elab_Final_Code, "__gnat_inside_elab_final_code");
69    --  ???This variable is obsolete starting from 29/08 but cannot be removed
70    --  ???right away due to the bootstrap problems
71
72    --------------------------
73    -- Abort_Undefer_Direct --
74    --------------------------
75
76    procedure Abort_Undefer_Direct is
77    begin
78       System.Soft_Links.Abort_Undefer.all;
79    end Abort_Undefer_Direct;
80
81    --------------
82    -- Adafinal --
83    --------------
84
85    procedure Adafinal is
86    begin
87       if not Runtime_Finalized then
88          Runtime_Finalized := True;
89          System.Soft_Links.Adafinal.all;
90       end if;
91    end Adafinal;
92
93 end System.Standard_Library;