-- --
-- B o d y --
-- --
--- Copyright (C) 1992-2009, Free Software Foundation, Inc. --
+-- Copyright (C) 1992-2010, 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- --
-- dJ Output debugging trace info for JGNAT (Java VM version of GNAT)
-- dK Kill all error messages
-- dL Output trace information on elaboration checking
- -- dM Asssume all variables are modified (no current values)
+ -- dM Assume all variables are modified (no current values)
-- dN No file name information in exception messages
-- dO Output immediate error messages
-- dP Do not check for controlled objects in preelaborable packages
-- d.l Use Ada 95 semantics for limited function returns
-- d.m For -gnatl, print full source only for main unit
-- d.n Print source file names
- -- d.o
- -- d.p
+ -- d.o Generate .NET listing of CIL code
+ -- d.p Enable the .NET CIL verifier
-- d.q
-- d.r Enable OK_To_Reorder_Components in non-variant records
-- d.s Disable expansion of slice move, use memmove
-- d.y
-- d.z
- -- d.A
+ -- d.A Read/write Aspect_Specifications hash table to tree
-- d.B
-- d.C Generate concatenation call, do not generate inline code
-- d.D
-- d.G
-- d.H
-- d.I SCIL generation mode
- -- d.J Parallel SCIL generation mode
+ -- d.J Disable parallel SCIL generation mode
-- d.K
- -- d.L
+ -- d.L Depend on back end for limited types in conditional expressions
-- d.M
-- d.N
-- d.O Dump internal SCO tables
-- d.U
-- d.V
-- d.W Print out debugging information for Walk_Library_Items
- -- d.X Use Expression_With_Actions for short-circuited forms
- -- d.Y
+ -- d.X Use Expression_With_Actions
+ -- d.Y Do not use Expression_With_Actions
-- d.Z
-- d1 Error msgs have node numbers where possible
-- dj
-- dk
-- dl
- -- dm
+ -- dm Display the number of maximum simultaneous compilations
-- dn Do not delete temp files created by gnatmake
-- do
-- dp Prints the contents of the Q used by Make.Compile_Sources
-- compiler has a bug -- these are the files that need to be included
-- in a bug report.
+ -- d.o Generate listing showing the IL instructions generated by the .NET
+ -- compiler for each subprogram.
+
+ -- d.p Enable the .NET CIL verifier. During development the verifier is
+ -- disabled by default and this flag is used to enable it. In the
+ -- future we will reverse this functionality.
+
-- d.r Forces the flag OK_To_Reorder_Components to be set in all record
-- base types that have no discriminants.
-- d.w This flag turns off the scanning of loops to detect possible
-- infinite loops.
+ -- d.A There seems to be a problem with ASIS if we activate the circuit
+ -- for reading and writing the aspect specification hash table, so
+ -- for now, this is controlled by the debug flag d.A. The hash table
+ -- is only written and read if this flag is set.
+
-- 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
-- of static analysis tools, and ensure additional tree consistency
-- between different compilations of specs.
- -- d.J Ensure the SCIL generated is compatible with parallel builds.
- -- This means in particular not writing the same files under the
- -- same directory.
+ -- d.J Disable parallel SCIL generation. Normally SCIL file generation is
+ -- done in parallel to speed processing. This switch disables this
+ -- behavior.
+
+ -- d.L Normally the front end generates special expansion for conditional
+ -- expressions of a limited type. This debug flag removes this special
+ -- case expansion, leaving it up to the back end to handle conditional
+ -- expressions correctly.
-- d.O Dump internal SCO tables. Before outputting the SCO information to
-- the ALI file, the internal SCO tables (SCO_Table/SCO_Unit_Table)
-- d.T Force Optimize_Alignment (Time) mode as the default
-- d.W Print out debugging information for Walk_Library_Items, including
- -- the order in which units are walked. This is primarily for SofCheck
- -- Inspector.
+ -- the order in which units are walked. This is primarily for use in
+ -- debugging CodePeer mode.
-- d.X By default, the compiler uses an elaborate rewriting framework for
-- short-circuited forms where the right hand condition generates
- -- actions to be inserted. Use of this switch causes the compiler to
- -- use the much simpler Expression_With_Actions node for this purpose.
- -- It is a debug flag to aid transitional implementation in gigi and
- -- the back end. As soon as that works fine, we will remove this flag.
+ -- actions to be inserted. With the gcc backend, we now use the new
+ -- N_Expression_With_Actions node for this expansion, but we still use
+ -- the old method for other backends and in SCIL mode. This debug flag
+ -- forces use of the new N_Expression_With_Actions node in these other
+ -- cases and is intended for transitional use.
+
+ -- d.Y Prevents the use of the N_Expression_With_Actions node even in the
+ -- case of the gcc back end. Provided as a back up in case the new
+ -- scheme has problems.
-- d1 Error messages have node numbers where possible. Normally error
-- messages have only source locations. This option is useful when
-- df Only output file names, not path names, in log
+ -- dm Issue a message indicating the maximum number of simultaneous
+ -- compilations.
+
-- dn Do not delete temporary files created by gnatmake at the end
-- of execution, such as temporary config pragma files, mapping
-- files or project path files.