-- --
-- B o d y --
-- --
--- Copyright (C) 1992-2004 Free Software Foundation, Inc. --
+-- Copyright (C) 1992-2007, Free Software Foundation, Inc. --
-- --
-- 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- --
-- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
-- for more details. You should have received a copy of the GNU General --
-- Public License distributed with GNAT; see file COPYING. If not, write --
--- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
--- MA 02111-1307, USA. --
+-- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
+-- Boston, MA 02110-1301, USA. --
-- --
-- As a special exception, if other files instantiate generics from this --
-- unit, or you link this unit with other files to produce an executable, --
-- dC Output debugging information on check suppression
-- dD Delete elaboration checks in inner level routines
-- dE Apply elaboration checks to predefined units
- -- dF Front end data layout enabled.
+ -- dF Front end data layout enabled
-- dG Generate all warnings including those normally suppressed
-- dH Hold (kill) call to gigi
-- dI Inhibit internal name numbering in gnatG listing
-- dU Enable garbage collection of unreachable entities
-- dV Enable viewing of all symbols in debugger
-- dW Disable warnings on calls for IN OUT parameters
- -- dX Enable Frontend ZCX even when it is not supported
+ -- dX
-- dY Enable configurable run-time mode
- -- dZ
+ -- dZ Generate listing showing the contents of the dispatch tables
-- d.a
-- d.b
-- d.c
-- d.d
-- d.e
- -- d.f
- -- d.g
+ -- d.f Inhibit folding of static expressions
+ -- d.g Enable conversion of raise into goto
-- d.h
-- d.i
-- d.j
-- d.k
- -- d.l
- -- d.m
+ -- d.l Use Ada 95 semantics for limited function returns
+ -- d.m For -gnatl, print full source only for main unit
-- d.n
-- d.o
-- d.p
-- d.q
-- d.r
-- d.s
- -- d.t
+ -- d.t Disable static allocation of library level dispatch tables
-- d.u
-- d.v
- -- d.w
+ -- d.w Do not check for infinite while loops
-- d.x No exception handlers
-- d.y
-- d.z
-
+ -- d.A
+ -- d.B
+ -- d.C
+ -- d.D
+ -- d.E
+ -- d.F
+ -- d.G
+ -- d.H
+ -- d.I
+ -- d.J
+ -- d.K
+ -- d.L
+ -- d.M
+ -- d.N
+ -- d.O
+ -- d.P
+ -- d.Q
+ -- d.R
+ -- d.S
+ -- d.T
+ -- d.U
+ -- d.V
+ -- d.W
+ -- d.X
+ -- d.Y
+ -- d.Z
-- d1 Error msgs have node numbers where possible
-- d2 Eliminate error flags in verbose form error messages
-- Debug flags for binder (GNATBIND)
- -- da
- -- db
+ -- da All links (including internal units) listed if there is a cycle
+ -- db Output information from Better_Choice
-- dc List units as they are chosen
-- dd
-- de Elaboration dependencies including system units
-- dl
-- dm
-- dn List details of manipulation of Num_Pred values
- -- do
+ -- do Use old preference for elaboration order
-- dp
-- dq
-- dr
-- dy
-- dz
- -- d1
- -- d2
- -- d3
- -- d4
- -- d5
- -- d6
- -- d7
- -- d8
- -- d9
-
-- Debug flags used in package Make and its clients (e.g. GNATMAKE)
-- da
-- dy
-- dz
- -- d1
- -- d2
- -- d3
- -- d4
- -- d5
- -- d6
- -- d7
- -- d8
- -- d9
-
--------------------------------------------
-- Documentation for Compiler Debug Flags --
--------------------------------------------
-- an interepretation is incompatible with the context.
-- dw Write semantic scope stack messages. Each time a scope is created
- -- or removed, a message is output (see the Sem_Ch8.New_Scope and
+ -- or removed, a message is output (see the Sem_Ch8.Push_Scope and
-- Sem_Ch8.Pop_Scope subprograms).
-- dx Force expansion on, even if no code being generated. Normally the
-- layout, and may be useful in other debugging situations where
-- you do not want gigi to intefere with the testing.
- -- dI Inhibit internal name numbering in gnatDG listing. For internal
- -- names of the form <uppercase-letters><digits><suffix>, the output
- -- will be modified to <uppercase-letters>...<suffix>. This is used
- -- in the fixed bugs run to minimize system and version dependency
- -- in filed -gnatDG output.
+ -- dI Inhibit internal name numbering in gnatDG listing. Any sequence of
+ -- the form <uppercase-letter><digits><lowercase-letter> appearing in
+ -- a name is replaced by <uppercase-letter>...<lowercase-letter>. This
+ -- is used in the fixed bugs run to minimize system and version
+ -- dependency in filed -gnatD or -gnatG output.
-- dJ Generate debugging trace output for the JGNAT back end. This
-- consists of symbolic Java Byte Code sequences for all generated
-- indications. This debug flag disconnects the tracking of constant
-- values (see Exp_Ch2.Expand_Current_Value).
- -- dN Do not generate file name information in exception messages.
+ -- dN Do not generate file name information in exception messages
-- dO Output immediate error messages. This causes error messages to
-- be output as soon as they are generated (disconnecting several
-- in preelaborable packages, but this restriction is a huge pain,
-- especially in the predefined library units.
+ -- dQ needs full documentation ???
+
-- dR Bypass the check for a proper version of s-rpc being present
-- to use the -gnatz? switch. This allows debugging of the use
-- of stubs generation without needing to have GLADE (or some
-- task of transitioning incorrect legacy code, we provide this
-- undocumented feature for suppressing these warnings.
- -- dX Enable frontend ZCX even when it is not supported. Equivalent to
- -- -gnatZ but without verifying that System.Front_End_ZCX_Support
- -- is set. This causes the front end to generate suitable tables
- -- for ZCX handling even when the runtime cannot handle ZCX. This
- -- is used for testing the front end for correct ZCX operation, and
- -- in particular is useful for multi-target testing.
-
-- dY Enable configurable run-time mode, just as though the System file
-- had Configurable_Run_Time_Mode set to True. This is useful in
-- testing high integrity mode.
+ -- dZ Generate listing showing the contents of the dispatch tables. Each
+ -- line has an internally generated number used for references between
+ -- tagged types and primitives. For each primitive the output has the
+ -- following fields:
+ -- - Letter 'P' or letter 's': The former indicates that this
+ -- primitive will be located in a primary dispatch table. The
+ -- latter indicates that it will be located in a secondary
+ -- dispatch table.
+ -- - Name of the primitive. In case of predefined Ada primitives
+ -- the text "(predefined)" is added before the name, and these
+ -- acronyms are used: SR (Stream_Read), SW (Stream_Write), SI
+ -- (Stream_Input), SO (Stream_Output), DA (Deep_Adjust), DF
+ -- (Deep_Finalize). In addition Oeq identifies the equality
+ -- operator, and "_assign" the assignment.
+ -- - If the primitive covers interface types, two extra fields
+ -- referencing other primitives are generated: "Alias" references
+ -- the primitive of the tagged type that covers an interface
+ -- primitive, and "AI_Alias" references the covered interface
+ -- primitive.
+ -- - The expression "at #xx" indicates the slot of the dispatch
+ -- table occupied by such primitive in its corresponding primary
+ -- or secondary dispatch table.
+ -- - In case of abstract subprograms the text "is abstract" is
+ -- added at the end of the line.
+
+ -- d.f Suppress folding of static expressions. This of course results
+ -- in seriously non-conforming behavior, but is useful sometimes
+ -- when tracking down handling of complex expressions.
+
+ -- d.g Enables conversion of a raise statement into a goto when the
+ -- relevant handler is statically determinable. For now we only try
+ -- this if this debug flag is set. Later we will enable this more
+ -- generally by default.
+
+ -- d.l Use Ada 95 semantics for limited function returns. This may be
+ -- used to work around the incompatibility introduced by AI-318-2.
+ -- It is useful only in -gnat05 mode.
+
+ -- d.m When -gnatl is used, the normal output includes full listings of
+ -- all files in the extended main source (body/spec/subunits). If this
+ -- debug switch is used, then the full listing is given only for the
+ -- main source (this corresponds to a previous behavior of -gnatl and
+ -- is used for running the ACATS tests).
+
+ -- d.t The compiler has been modified (a fairly extensive modification)
+ -- to generate static dispatch tables for library level tagged types.
+ -- This debug switch disables this modification and reverts to the
+ -- previous dynamic construction of tables. It is there as a possible
+ -- work around if we run into trouble with the new implementation.
+
+ -- d.w This flag turns off the scanning of while loops to detect possible
+ -- infinite loops.
+
-- d.x No exception handlers in generated code. This causes exception
-- handlers to be eliminated from the generated code. They are still
-- fully compiled and analyzed, they just get eliminated from the
-- Documentation for Binder Debug Flags --
------------------------------------------
+ -- da Normally if there is an elaboration circularity, then in describing
+ -- the cycle, links involving internal units are omitted, since they
+ -- are irrelevant and confusing. This debug flag causes all links to
+ -- be listed, and is useful when diagnosing circularities introduced
+ -- by incorrect changes to the run-time library itself.
+
-- dc List units as they are chosen. As units are selected for addition to
-- the elaboration order, a line of output is generated showing which
-- unit has been selected.
-- the algorithm used to determine a correct order of elaboration. This
-- is useful in diagnosing any problems in its behavior.
+ -- do Use old elaboration order preference. The new preference rules
+ -- prefer specs with no bodies to specs with bodies, and between two
+ -- specs with bodies, prefers the one whose body is closer to being
+ -- able to be elaborated. This is a clear improvement, but we provide
+ -- this debug flag in case of regressions.
+
-- du List unit name and file name for each unit as it is read in
-- dx Force the binder to read (and then ignore) the xref information
-- dw Prints the list of units withed by the unit currently explored
-- during the main loop of Make.Compile_Sources.
- ----------------------
- -- Get_Debug_Flag_K --
- ----------------------
-
- function Get_Debug_Flag_K return Boolean is
- begin
- return Debug_Flag_K;
- end Get_Debug_Flag_K;
-
--------------------
-- Set_Debug_Flag --
--------------------