1------------------------------------------------------------------------------
2--                                                                          --
3--                         GNAT COMPILER COMPONENTS                         --
4--                                                                          --
5--                                D E B U G                                 --
6--                                                                          --
7--                                 B o d y                                  --
8--                                                                          --
9--          Copyright (C) 1992-2019, Free Software Foundation, Inc.         --
10--                                                                          --
11-- GNAT is free software;  you can  redistribute it  and/or modify it under --
12-- terms of the  GNU General Public License as published  by the Free Soft- --
13-- ware  Foundation;  either version 3,  or (at your option) any later ver- --
14-- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
15-- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
16-- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
17--                                                                          --
18-- As a special exception under Section 7 of GPL version 3, you are granted --
19-- additional permissions described in the GCC Runtime Library Exception,   --
20-- version 3.1, as published by the Free Software Foundation.               --
21--                                                                          --
22-- You should have received a copy of the GNU General Public License and    --
23-- a copy of the GCC Runtime Library Exception along with this program;     --
24-- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
25-- <http://www.gnu.org/licenses/>.                                          --
26--                                                                          --
27-- GNAT was originally developed  by the GNAT team at  New York University. --
28-- Extensive contributions were provided by Ada Core Technologies Inc.      --
29--                                                                          --
30------------------------------------------------------------------------------
31
32package body Debug is
33
34   ---------------------------------
35   -- Summary of Debug Flag Usage --
36   ---------------------------------
37
38   --  Debug flags for compiler (GNAT1)
39
40   --  da   Generate messages tracking semantic analyzer progress
41   --  db   Show encoding of type names for debug output
42   --  dc   List names of units as they are compiled
43   --  dd   Dynamic allocation of tables messages generated
44   --  de   List the entity table
45   --  df   Full tree/source print (includes withed units)
46   --  dg   Print source from tree (generated code only)
47   --  dh   Generate listing showing loading of name table hash chains
48   --  di   Generate messages for visibility linking/delinking
49   --  dj   Suppress "junk null check" for access parameter values
50   --  dk   Generate GNATBUG message on abort, even if previous errors
51   --  dl   Generate unit load trace messages
52   --  dm   Prevent special frontend inlining in GNATprove mode
53   --  dn   Generate messages for node/list allocation
54   --  do   Print source from tree (original code only)
55   --  dp   Generate messages for parser scope stack push/pops
56   --  dq   No auto-alignment of small records
57   --  dr   Generate parser resynchronization messages
58   --  ds   Print source from tree (including original and generated stuff)
59   --  dt   Print full tree
60   --  du   Uncheck categorization pragmas
61   --  dv   Output trace of overload resolution
62   --  dw   Print trace of semantic scope stack
63   --  dx   Force expansion on, even if no code being generated
64   --  dy   Print tree of package Standard
65   --  dz   Print source of package Standard
66
67   --  dA   All entities included in representation information output
68   --  dB   Output debug encoding of type names and variants
69   --  dC   Output debugging information on check suppression
70   --  dD   Delete elaboration checks in inner level routines
71   --  dE   Apply elaboration checks to predefined units
72   --  dF   Perform the new SPARK checking rules for pointer aliasing
73   --  dG   Generate all warnings including those normally suppressed
74   --  dH   Hold (kill) call to gigi
75   --  dI   Inhibit internal name numbering in gnatG listing
76   --  dJ   Prepend subprogram name in messages
77   --  dK   Kill all error messages
78   --  dL   Ignore external calls from instances for elaboration
79   --  dM   Assume all variables are modified (no current values)
80   --  dN   No file name information in exception messages
81   --  dO   Output immediate error messages
82   --  dP   Do not check for controlled objects in preelaborable packages
83   --  dQ   Use old secondary stack method
84   --  dR   Bypass check for correct version of s-rpc
85   --  dS   Never convert numbers to machine numbers in Sem_Eval
86   --  dT   Convert to machine numbers only for constant declarations
87   --  dU   Enable garbage collection of unreachable entities
88   --  dV   Enable viewing of all symbols in debugger
89   --  dW   Disable warnings on calls for IN OUT parameters
90   --  dX   Display messages on reads of potentially uninitialized scalars
91   --  dY   Enable configurable run-time mode
92   --  dZ   Generate listing showing the contents of the dispatch tables
93
94   --  d.a  Force Target_Strict_Alignment mode to True
95   --  d.b  Dump backend types
96   --  d.c  Generate inline concatenation, do not call procedure
97   --  d.d  Disable atomic synchronization
98   --  d.e  Enable atomic synchronization
99   --  d.f  Inhibit folding of static expressions
100   --  d.g  Enable conversion of raise into goto
101   --  d.h  Minimize the creation of public internal symbols for concatenation
102   --  d.i  Ignore Warnings pragmas
103   --  d.j  Generate listing of frontend inlined calls
104   --  d.k  Kill referenced run-time library unit line numbers
105   --  d.l  Use Ada 95 semantics for limited function returns
106   --  d.m  For -gnatl, print full source only for main unit
107   --  d.n  Print source file names
108   --  d.o  Conservative elaboration order for indirect calls
109   --  d.p  Use original Ada 95 semantics for Bit_Order (disable AI95-0133)
110   --  d.q  Suppress optimizations on imported 'in'
111   --  d.r  Disable reordering of components in record types
112   --  d.s  Strict secondary stack management
113   --  d.t  Disable static allocation of library level dispatch tables
114   --  d.u  Enable Modify_Tree_For_C (update tree for c)
115   --  d.v  Enforce SPARK elaboration rules in SPARK code
116   --  d.w  Do not check for infinite loops
117   --  d.x  No exception handlers
118   --  d.y  Disable implicit pragma Elaborate_All on task bodies
119   --  d.z  Restore previous support for frontend handling of Inline_Always
120
121   --  d.A  Read/write Aspect_Specifications hash table to tree
122   --  d.B  Generate a bug box on abort_statement
123   --  d.C  Generate concatenation call, do not generate inline code
124   --  d.D  Disable errors on use of overriding keyword in Ada 95 mode
125   --  d.E  Turn selected errors into warnings
126   --  d.F  Debug mode for GNATprove
127   --  d.G  Ignore calls through generic formal parameters for elaboration
128   --  d.H  GNSA mode for ASIS
129   --  d.I  Do not ignore enum representation clauses in CodePeer mode
130   --  d.J  Relaxed rules for pragma No_Return
131   --  d.K  Enable generation of contract-only procedures in CodePeer mode
132   --  d.L  Depend on back end for limited types in if and case expressions
133   --  d.M  Relaxed RM semantics
134   --  d.N  Add node to all entities
135   --  d.O  Dump internal SCO tables
136   --  d.P  Previous (non-optimized) handling of length comparisons
137   --  d.Q  Previous (incomplete) style check for binary operators
138   --  d.R  Restrictions in ali files in positional form
139   --  d.S  Force Optimize_Alignment (Space)
140   --  d.T  Force Optimize_Alignment (Time)
141   --  d.U  Ignore indirect calls for static elaboration
142   --  d.V  Do not verify validity of SCIL files (CodePeer mode)
143   --  d.W  Print out debugging information for Walk_Library_Items
144   --  d.X  Old treatment of indexing aspects
145   --  d.Y
146   --  d.Z  Do not enable expansion in configurable run-time mode
147
148   --  d_a  Stop elaboration checks on accept or select statement
149   --  d_b
150   --  d_c
151   --  d_d
152   --  d_e  Ignore entry calls and requeue statements for elaboration
153   --  d_f  Issue info messages related to GNATprove usage
154   --  d_g
155   --  d_h
156   --  d_i  Ignore activations and calls to instances for elaboration
157   --  d_j
158   --  d_k
159   --  d_l
160   --  d_m
161   --  d_n
162   --  d_o
163   --  d_p  Ignore assertion pragmas for elaboration
164   --  d_q
165   --  d_r
166   --  d_s  Stop elaboration checks on synchronous suspension
167   --  d_t
168   --  d_u
169   --  d_v
170   --  d_w
171   --  d_x
172   --  d_y
173   --  d_z
174
175   --  d_A  Stop generation of ALI file
176   --  d_B
177   --  d_C
178   --  d_D
179   --  d_E
180   --  d_F
181   --  d_G
182   --  d_H
183   --  d_I
184   --  d_J
185   --  d_K
186   --  d_L  Output trace information on elaboration checking
187   --  d_M
188   --  d_N
189   --  d_O
190   --  d_P
191   --  d_Q
192   --  d_R
193   --  d_S
194   --  d_T
195   --  d_U
196   --  d_V
197   --  d_W
198   --  d_X
199   --  d_Y
200   --  d_Z
201
202   --  d1   Error msgs have node numbers where possible
203   --  d2   Eliminate error flags in verbose form error messages
204   --  d3   Dump bad node in Comperr on an abort
205   --  d4   Inhibit automatic krunch of predefined library unit files
206   --  d5   Debug output for tree read/write
207   --  d6   Default access unconstrained to thin pointers
208   --  d7   Suppress version/source stamp/compilation time for -gnatv/-gnatl
209   --  d8   Force opposite endianness in packed stuff
210   --  d9   Allow lock free implementation
211
212   --  d.1  Enable unnesting of nested procedures
213   --  d.2  Allow statements in declarative part
214   --  d.3  Output debugging information from Exp_Unst
215   --  d.4  Do not delete generated C file in case of errors
216   --  d.5  Do not generate imported subprogram definitions in C code
217   --  d.6  Do not avoid declaring unreferenced types in C code
218   --  d.7  Disable unsound heuristics in gnat2scil (for CP as SPARK prover)
219   --  d.8
220   --  d.9  Disable build-in-place for nonlimited types
221
222   --  d_1
223   --  d_2
224   --  d_3
225   --  d_4
226   --  d_5
227   --  d_6
228   --  d_7
229   --  d_8
230   --  d_9
231
232   --  Debug flags for binder (GNATBIND)
233
234   --  da  All links (including internal units) listed if there is a cycle
235   --  db  Output information from Better_Choice
236   --  dc  List units as they are chosen
237   --  dd
238   --  de  Elaboration dependencies including system units
239   --  df
240   --  dg
241   --  dh
242   --  di  Ignore_Errors mode for reading ali files
243   --  dj
244   --  dk
245   --  dl
246   --  dm
247   --  dn  List details of manipulation of Num_Pred values
248   --  do  Use older preference for elaboration order
249   --  dp  Use old preference for elaboration order
250   --  dq
251   --  dr
252   --  ds
253   --  dt
254   --  du  List units as they are acquired
255   --  dv  Verbose debugging printouts
256   --  dw
257   --  dx  Force binder to read xref information from ali files
258   --  dy
259   --  dz
260
261   --  Debug flags used in package Make and its clients (e.g. GNATMAKE)
262
263   --  da
264   --  db
265   --  dc
266   --  dd
267   --  de
268   --  df  Only output file names, not path names, in log
269   --  dg
270   --  dh  Generate listing showing loading of name table hash chains
271   --  di
272   --  dj
273   --  dk
274   --  dl
275   --  dm  Display the number of maximum simultaneous compilations
276   --  dn  Do not delete temp files created by gnatmake
277   --  do
278   --  dp  Prints the contents of the Q used by Make.Compile_Sources
279   --  dq  Prints source files as they are enqueued and dequeued
280   --  dr
281   --  ds
282   --  dt  Display time stamps when there is a mismatch
283   --  du  List units as their ali files are acquired
284   --  dv
285   --  dw  Prints the list of units withed by the unit currently explored
286   --  dx
287   --  dy
288   --  dz
289
290   --------------------------------------------
291   -- Documentation for Compiler Debug Flags --
292   --------------------------------------------
293
294   --  da   Generate messages tracking semantic analyzer progress. A message
295   --       is output showing each node as it gets analyzed, expanded,
296   --       resolved, or evaluated. This option is useful for finding out
297   --       exactly where a bomb during semantic analysis is occurring.
298
299   --  db   In Exp_Dbug, certain type names are encoded to include debugging
300   --       information. This debug switch causes lines to be output showing
301   --       the encodings used.
302
303   --  dc   List names of units as they are compiled. One line of output will
304   --       be generated at the start of compiling each unit (package or
305   --       subprogram).
306
307   --  dd   Dynamic allocation of tables messages generated. Each time a
308   --       table is reallocated, a line is output indicating the expansion.
309
310   --  de   List the entity table
311
312   --  df   Full tree/source print (includes withed units). Normally the tree
313   --       output (dt) or recreated source output (dg,do,ds) includes only
314   --       the main unit. If df is set, then the output in either case
315   --       includes all compiled units (see also dg,do,ds,dt). Note that to
316   --       be effective, this switch must be used in combination with one or
317   --       more of dt, dg, do or ds.
318
319   --  dg   Print the source recreated from the generated tree. In the case
320   --       where the tree has been rewritten this output includes only the
321   --       generated code, not the original code (see also df,do,ds,dz).
322   --       This flag differs from -gnatG in that the output also includes
323   --       non-source generated null statements, and freeze nodes, which
324   --       are normally omitted in -gnatG mode.
325
326   --  dh   Generates a table at the end of a compilation showing how the hash
327   --       table chains built by the Namet package are loaded. This is useful
328   --       in ensuring that the hashing algorithm (in Namet.Hash) is working
329   --       effectively with typical sets of program identifiers.
330
331   --  di   Generate messages for visibility linking/delinking
332
333   --  dj   Suppress "junk null check" for access parameters. This flag permits
334   --       Ada programs to pass null parameters to access parameters, and to
335   --       explicitly check such access values against the null literal.
336   --       Neither of these is valid Ada, but both were allowed in versions of
337   --       GNAT before 3.10, so this switch can ease the transition process.
338
339   --  dk   Immediate kill on abort. Normally on an abort (i.e. a call to
340   --       Comperr.Compiler_Abort), the GNATBUG message is not given if
341   --       there is a previous error. This debug switch bypasses this test
342   --       and gives the message unconditionally (useful for debugging).
343
344   --  dl   Generate unit load trace messages. A line of traceback output is
345   --       generated each time a request is made to the library manager to
346   --       load a new unit.
347
348   --  dm   Prevent special frontend inlining in GNATprove mode. In some cases,
349   --       some subprogram calls are inlined in GNATprove mode in order to
350   --       facilitate formal verification. This debug switch prevents that
351   --       inlining to happen.
352
353   --  dn   Generate messages for node/list allocation. Each time a node or
354   --       list header is allocated, a line of output is generated. Certain
355   --       other basic tree operations also cause a line of output to be
356   --       generated. This option is useful in seeing where the parser is
357   --       blowing up.
358
359   --  do   Print the source recreated from the generated tree. In the case
360   --       where the tree has been rewritten, this output includes only the
361   --       original code, not the generated code (see also df,dg,ds,dz).
362
363   --  dp   Generate messages for parser scope stack push/pops. A line of
364   --       output by the parser each time the parser scope stack is either
365   --       pushed or popped. Useful in debugging situations where the
366   --       parser scope stack ends up incorrectly synchronized
367
368   --  dq   In layout version 1.38, 2002/01/12, a circuit was implemented
369   --       to give decent default alignment to short records that had no
370   --       specific alignment set. This debug option restores the previous
371   --       behavior of giving such records poor alignments, typically 1.
372   --       This may be useful in dealing with transition.
373
374   --  dr   Generate parser resynchronization messages. Normally the parser
375   --       resynchronizes quietly. With this debug option, two messages
376   --       are generated, one when the parser starts a resynchronization
377   --       skip, and another when it resumes parsing. Useful in debugging
378   --       inadequate error recovery situations.
379
380   --  ds   Print the source recreated from the generated tree. In the case
381   --       where the tree has been rewritten this output includes both the
382   --       generated code and the original code with the generated code
383   --       being enlosed in curly brackets (see also df,do,ds,dz)
384
385   --  dt   Print full tree. The generated tree is output (see also df,dy)
386
387   --  du   Uncheck categorization pragmas. This debug switch causes the
388   --       elaboration control pragmas (Pure, Preelaborate, etc.) and the
389   --       categorization pragmas (Shared_Passive, Remote_Types, etc.) to be
390   --       ignored, so that normal checks are not made (this is particularly
391   --       useful for adding temporary debugging code to units that have
392   --       pragmas that are inconsistent with the debugging code added).
393
394   --  dv   Output trace of overload resolution. Outputs messages for
395   --       overload attempts that involve cascaded errors, or where
396   --       an interpretation is incompatible with the context.
397
398   --  dw   Write semantic scope stack messages. Each time a scope is created
399   --       or removed, a message is output (see the Sem_Ch8.Push_Scope and
400   --       Sem_Ch8.Pop_Scope subprograms).
401
402   --  dx   Force expansion on, even if no code being generated. Normally the
403   --       expander is inhibited if no code is generated. This switch forces
404   --       expansion to proceed normally even if the backend is not being
405   --       called. This is particularly useful for debugging purposes when
406   --       using the front-end only version of the compiler (which normally
407   --       would never do any expansion).
408
409   --  dy   Print tree of package Standard. Normally the tree print out does
410   --       not include package Standard, even if the -df switch is set. This
411   --       switch forces output of the internal tree built for Standard.
412
413   --  dz   Print source of package Standard. Normally the source print out
414   --       does not include package Standard, even if the -df switch is set.
415   --       This switch forces output of the source recreated from the internal
416   --       tree built for Standard. Note that this differs from -gnatS in
417   --       that it prints from the actual tree using the normal Sprint
418   --       circuitry for printing trees.
419
420   --  dA   Forces output of representation information, including full
421   --       information for all internal type and object entities, as well
422   --       as all user defined type and object entities including private
423   --       and incomplete types. This debug switch also automatically sets
424   --       the equivalent of -gnatRm.
425
426   --  dB   Output debug encodings for types and variants. See Exp_Dbug for
427   --       exact form of the generated output.
428
429   --  dC   Output trace information showing the decisions made during
430   --       check suppression activity in unit Checks.
431
432   --  dD   Delete new elaboration checks. This flag causes GNAT to return
433   --       to the 3.13a elaboration semantics, and to suppress the fixing
434   --       of two bugs. The first is in the context of inner routines in
435   --       dynamic elaboration mode, when the subprogram we are in was
436   --       called at elaboration time by a unit that was also compiled with
437   --       dynamic elaboration checks. In this case, if A calls B calls C,
438   --       and all are in different units, we need an elaboration check at
439   --       each call. These nested checks were only put in recently (see
440   --       version 1.80 of Sem_Elab) and we provide this debug flag to
441   --       revert to the previous behavior in case of regressions. The
442   --       other behavior reverted by this flag is the treatment of the
443   --       Elaborate_Body pragma in static elaboration mode. This used to
444   --       be treated as not needing elaboration checking, but in fact in
445   --       general Elaborate_All is still required because of nested calls.
446
447   --  dE   Apply compile time elaboration checking for with relations between
448   --       predefined units. Normally no checks are made.
449
450   --  dF   Perform the new SPARK checking rules for pointer aliasing. This is
451   --       only activated in GNATprove mode and on SPARK code. These rules are
452   --       not yet part of the official SPARK language, but are expected to be
453   --       included in a future version of SPARK.
454
455   --  dG   Generate all warnings. Normally Errout suppresses warnings on
456   --       units that are not part of the main extended source, and also
457   --       suppresses warnings on instantiations in the main extended
458   --       source that duplicate warnings already posted on the template.
459   --       This switch stops both kinds of deletion and causes Errout to
460   --       post all warnings sent to it.
461
462   --  dH   Inhibit call to gigi. This is useful for testing front end data
463   --       layout, and may be useful in other debugging situations where
464   --       you do not want gigi to intefere with the testing.
465
466   --  dI   Inhibit internal name numbering in gnatDG listing. Any sequence of
467   --       the form <uppercase-letter><digits><lowercase-letter> appearing in
468   --       a name is replaced by <uppercase-letter>...<lowercase-letter>. This
469   --       is used in the fixed bugs run to minimize system and version
470   --       dependency in filed -gnatD or -gnatG output.
471
472   --  dJ   Prepend the name of the enclosing subprogram in compiler messages
473   --       (errors, warnings, style checks). This is useful in particular to
474   --       integrate compiler warnings in static analysis tools such as
475   --       CodePeer.
476
477   --  dK   Kill all error messages. This debug flag suppresses the output
478   --       of all error messages. It is used in regression tests where the
479   --       error messages are target dependent and irrelevant.
480
481   --  dL   The compiler ignores calls in instances and invoke subprograms
482   --       which are external to the instance for both the static and dynamic
483   --       elaboration models.
484
485   --  dM   Assume all variables have been modified, and ignore current value
486   --       indications. This debug flag disconnects the tracking of constant
487   --       values (see Exp_Ch2.Expand_Current_Value).
488
489   --  dN   Do not generate file name information in exception messages
490
491   --  dO   Output immediate error messages. This causes error messages to
492   --       be output as soon as they are generated (disconnecting several
493   --       circuits for improvement of messages, deletion of duplicate
494   --       messages etc). Useful to diagnose compiler bombs caused by
495   --       erroneous handling of error situations
496
497   --  dP   Do not check for controlled objects in preelaborable packages.
498   --       RM 10.2.1(9) forbids the use of library level controlled objects
499   --       in preelaborable packages, but this restriction is a huge pain,
500   --       especially in the predefined library units.
501
502   --  dQ   Use old method for determining what goes on the secondary stack.
503   --       This disables some newer optimizations. The intent is to use this
504   --       temporarily to measure before/after efficiency. ???Remove this
505   --       when we are done (see Sem_Util.Requires_Transient_Scope).
506
507   --  dR   Bypass the check for a proper version of s-rpc being present
508   --       to use the -gnatz? switch. This allows debugging of the use
509   --       of stubs generation without needing to have GLADE (or some
510   --       other PCS  installed).
511
512   --  dS   Omit conversion of fpt numbers to exact machine numbers in
513   --       non-static evaluation contexts (see Check_Non_Static_Context).
514   --       This is intended for testing out timing problems with this
515   --       conversion circuit.
516
517   --  dT   Similar to dS, but omits the conversions only in the case where
518   --       the parent is not a constant declaration.
519
520   --  dU   Enable garbage collection of unreachable entities. This enables
521   --       both the reachability analysis and changing the Is_Public and
522   --       Is_Eliminated flags.
523
524   --  dV   Enable viewing of all symbols in debugger. Causes debug information
525   --       to be generated for all symbols, including internal symbols. This
526   --       is enabled by default for -gnatD, but this switch allows this to
527   --       be enabled without generating modified source files. Note that the
528   --       use of -gnatdV ensures in the dwarf/elf case that all symbols that
529   --       are present in the elf tables are also in the dwarf tables (which
530   --       seems to be required by some tools). Another effect of dV is to
531   --       generate full qualified names, including internal names generated
532   --       for blocks and loops.
533
534   --  dW   Disable warnings when a possibly uninitialized scalar value is
535   --       passed to an IN OUT parameter of a procedure. This usage is a
536   --       quite improper bounded error [erroneous in Ada 83] situation,
537   --       and would normally generate a warning. However, to ease the
538   --       task of transitioning incorrect legacy code, we provide this
539   --       undocumented feature for suppressing these warnings.
540
541   --  dY   Enable configurable run-time mode, just as though the System file
542   --       had Configurable_Run_Time_Mode set to True. This is useful in
543   --       testing high integrity mode.
544
545   --  dZ   Generate listing showing the contents of the dispatch tables. Each
546   --       line has an internally generated number used for references between
547   --       tagged types and primitives. For each primitive the output has the
548   --       following fields:
549   --
550   --         - Letter 'P' or letter 's': The former indicates that this
551   --           primitive will be located in a primary dispatch table. The
552   --           latter indicates that it will be located in a secondary
553   --           dispatch table.
554   --
555   --         - Name of the primitive. In case of predefined Ada primitives
556   --           the text "(predefined)" is added before the name, and these
557   --           acronyms are used: SR (Stream_Read), SW (Stream_Write), SI
558   --           (Stream_Input), SO (Stream_Output), DA (Deep_Adjust), DF
559   --           (Deep_Finalize). In addition Oeq identifies the equality
560   --           operator, and "_assign" the assignment.
561   --
562   --         - If the primitive covers interface types, two extra fields
563   --           referencing other primitives are generated: "Alias" references
564   --           the primitive of the tagged type that covers an interface
565   --           primitive, and "AI_Alias" references the covered interface
566   --           primitive.
567   --
568   --         - The expression "at #xx" indicates the slot of the dispatch
569   --           table occupied by such primitive in its corresponding primary
570   --           or secondary dispatch table.
571   --
572   --         - In case of abstract subprograms the text "is abstract" is
573   --           added at the end of the line.
574
575   --  d.a  Force Target_Strict_Alignment to True, even on targets where it
576   --       would normally be false. Can be used for testing strict alignment
577   --       circuitry in the compiler.
578
579   --  d.b  Dump back end types. During Create_Standard, the back end is
580   --       queried for all available types. This option shows them.
581
582   --  d.c  Generate inline concatenation, instead of calling one of the
583   --       System.Concat_n.Str_Concat_n routines in cases where the latter
584   --       routines would normally be called.
585
586   --  d.d  Disable atomic synchronization for all atomic variable references.
587   --       Pragma Enable_Atomic_Synchronization is ignored.
588
589   --  d.e  Enable atomic synchronization for all atomic variable references.
590   --       Pragma Disable_Atomic_Synchronization is ignored, and also the
591   --       compiler switch -gnated is ignored.
592
593   --  d.f  Suppress folding of static expressions. This of course results
594   --       in seriously non-conforming behavior, but is useful sometimes
595   --       when tracking down handling of complex expressions.
596
597   --  d.g  Enables conversion of a raise statement into a goto when the
598   --       relevant handler is statically determinable. For now we only try
599   --       this if this debug flag is set. Later we will enable this more
600   --       generally by default.
601
602   --  d.h  Minimize the creation of public internal symbols for concatenation
603   --       by enforcing a secondary stack-like handling of the final result.
604   --       The target of the concatenation is thus constrained in place and
605   --       initialized with the result instead of acting as its alias.
606
607   --  d.i  Ignore all occurrences of pragma Warnings in the sources. This can
608   --       be used in particular to disable Warnings (Off) to check if any of
609   --       these statements are inappropriate.
610
611   --  d.k  If an error message contains a reference to a location in an
612   --       internal unit, then suppress the line number in this reference.
613
614   --  d.j  Generate listing of frontend inlined calls and inline calls passed
615   --       to the backend. This is useful to locate skipped calls that must be
616   --       inlined by the frontend.
617
618   --  d.l  Use Ada 95 semantics for limited function returns. This may be
619   --       used to work around the incompatibility introduced by AI-318-2.
620   --       It is useful only in Ada 2005 and later.
621
622   --  d.m  When -gnatl is used, the normal output includes full listings of
623   --       all files in the extended main source (body/spec/subunits). If this
624   --       debug switch is used, then the full listing is given only for the
625   --       main source (this corresponds to a previous behavior of -gnatl and
626   --       is used for running the ACATS tests).
627
628   --  d.n  Print source file names as they are loaded. This is useful if the
629   --       compiler has a bug -- these are the files that need to be included
630   --       in a bug report.
631
632   --  d.o  Conservative elaboration order for indirect calls. This causes
633   --       P'Access to be treated as a call in more cases.
634
635   --  d.p  In Ada 95 (or 83) mode, use original Ada 95 behavior for the
636   --       interpretation of component clauses crossing byte boundaries when
637   --       using the non-default bit order (i.e. ignore AI95-0133).
638
639   --  d.q  If an array variable or constant is not modified in Ada code, and
640   --       is passed to an 'in' parameter of a foreign-convention subprogram,
641   --       and that subprogram modifies the array, the Ada compiler normally
642   --       assumes that the array is not modified. This option suppresses such
643   --       optimizations. This option should not be used; the correct solution
644   --       is to declare the parameter 'in out'.
645
646   --  d.r  Do not reorder components in record types.
647
648   --  d.s  The compiler no longer attempts to optimize the calls to secondary
649   --       stack management routines SS_Mark and SS_Release. As a result, each
650   --       transient block tasked with secondary stack management will fulfill
651   --       its role unconditionally.
652
653   --  d.s  The compiler does not generate calls to secondary stack management
654   --       routines SS_Mark and SS_Release for a transient block when there is
655   --       an enclosing scoping construct which already manages the secondary
656   --       stack.
657
658   --  d.t  The compiler has been modified (a fairly extensive modification)
659   --       to generate static dispatch tables for library level tagged types.
660   --       This debug switch disables this modification and reverts to the
661   --       previous dynamic construction of tables. It is there as a possible
662   --       work around if we run into trouble with the new implementation.
663
664   --  d.u  Sets Modify_Tree_For_C mode in which tree is modified to make it
665   --       easier to generate code using a C compiler.
666
667   --  d.v  This flag enforces the elaboration rules defined in the SPARK
668   --       Reference Manual, chapter 7.7, to all SPARK code within a unit. As
669   --       a result, constructs which violate the rules in chapter 7.7 are no
670   --       longer accepted, even if the implementation is able to statically
671   --       ensure that accepting these constructs does not introduce the
672   --       possibility of failing an elaboration check.
673
674   --  d.w  This flag turns off the scanning of loops to detect possible
675   --       infinite loops.
676
677   --  d.x  No exception handlers in generated code. This causes exception
678   --       handlers to be eliminated from the generated code. They are still
679   --       fully compiled and analyzed, they just get eliminated from the
680   --       code generation step.
681
682   --  d.y  Disable implicit pragma Elaborate_All on task bodies. When a task
683   --       body calls a procedure in the same package, and that procedure
684   --       calls a procedure in another package, the static elaboration
685   --       machinery adds an implicit Elaborate_All on the other package. This
686   --       switch disables the addition of the implicit pragma in such cases.
687
688   --  d.z  Restore previous front-end support for Inline_Always. In default
689   --       mode, for targets that use the GCC back end, Inline_Always is
690   --       handled by the back end. Use of this switch restores the previous
691   --       handling of Inline_Always by the front end on such targets. For the
692   --       targets that do not use the GCC back end, this switch is ignored.
693
694   --  d.A  There seems to be a problem with ASIS if we activate the circuit
695   --       for reading and writing the aspect specification hash table, so
696   --       for now, this is controlled by the debug flag d.A. The hash table
697   --       is only written and read if this flag is set.
698
699   --  d.B  Generate a bug box when we see an abort_statement, even though
700   --       there is no bug. Useful for testing Comperr.Compiler_Abort: write
701   --       some code containing an abort_statement, and compile it with
702   --       -gnatd.B. There is nothing special about abort_statements; it just
703   --       provides a way to control where the bug box is generated. See "when
704   --       N_Abort_Statement" in package body Expander.
705
706   --  d.C  Generate call to System.Concat_n.Str_Concat_n routines in cases
707   --       where we would normally generate inline concatenation code.
708
709   --  d.D  For compatibility with some Ada 95 compilers implementing only
710   --       one feature of Ada 2005 (overriding keyword), disable errors on use
711   --       of overriding keyword in Ada 95 mode.
712
713   --  d.E  Turn selected errors into warnings. This debug switch causes a
714   --       specific set of error messages into warnings. Setting this switch
715   --       causes Opt.Error_To_Warning to be set to True. The intention is
716   --       that this be used for messages representing upwards incompatible
717   --       changes to Ada 2012 that cause previously correct programs to be
718   --       treated as illegal now. The following cases are affected:
719   --
720   --          Errors relating to overlapping subprogram parameters for cases
721   --          other than IN OUT parameters to functions.
722   --
723   --          Errors relating to the new rules about not defining equality
724   --          too late so that composition of equality can be assured.
725   --
726   --          Errors relating to overriding indicators on protected subprogram
727   --          bodies (not an Ada 2012 incompatibility, but might cause errors
728   --          for existing programs assuming they were legal because GNAT
729   --          formerly allowed them).
730
731   --  d.F  Sets GNATprove_Mode to True. This allows debugging the frontend in
732   --       the special mode used by GNATprove.
733
734   --  d.G  Previously the compiler ignored calls via generic formal parameters
735   --       when doing the analysis for the static elaboration model. This is
736   --       now fixed, but we provide this debug flag to revert to the previous
737   --       situation of ignoring such calls to aid in transition.
738
739   --  d.H  Sets ASIS_GNSA_Mode to True. This signals the front end to suppress
740   --       the call to gigi in ASIS_Mode.
741
742   --  d.I  Do not ignore enum representation clauses in CodePeer mode.
743   --       The default of ignoring representation clauses for enumeration
744   --       types in CodePeer is good for the majority of Ada code, but in some
745   --       cases being able to change this default might be useful to remove
746   --       some false positives.
747
748   --  d.J  Relaxed rules for pragma No_Return. A pragma No_Return is illegal
749   --       if it applies to a body. This switch disables the legality check
750   --       for that. If the procedure does in fact return normally, execution
751   --       is erroneous, and therefore unpredictable.
752
753   --  d.K  Enable generation of contract-only procedures in CodePeer mode and
754   --       report a warning on subprograms for which the contract-only body
755   --       cannot be built. Currently reported on subprograms defined in
756   --       nested package specs that have some formal (or return type) whose
757   --       type is a private type defined in some enclosing package and that
758   --       have pre/postconditions.
759
760   --  d.L  Normally the front end generates special expansion for conditional
761   --       expressions of a limited type. This debug flag removes this special
762   --       case expansion, leaving it up to the back end to handle conditional
763   --       expressions correctly.
764
765   --  d.M  Relaxed RM semantics. This flag sets Opt.Relaxed_RM_Semantics
766   --       See Opt.Relaxed_RM_Semantics for more details.
767
768   --  d.N  Enlarge entities by one node (but don't attempt to use this extra
769   --       node for storage of any flags or fields). This can be used to do
770   --       experiments on the impact of increasing entity sizes.
771
772   --  d.O  Dump internal SCO tables. Before outputting the SCO information to
773   --       the ALI file, the internal SCO tables (SCO_Table/SCO_Unit_Table)
774   --       are dumped for debugging purposes.
775
776   --  d.P  Previous non-optimized handling of length comparisons. Setting this
777   --       flag inhibits the effect of Optimize_Length_Comparison in Exp_Ch4.
778   --       This is there in case we find a situation where the optimization
779   --       malfunctions, to provide a work around.
780
781   --  d.Q  Previous incomplete style checks for binary operators. Style checks
782   --       for token separation rules were incomplete and have been made
783   --       compliant with the documentation. For example, no warning was
784   --       issued for expressions such as 16-One or "A"&"B". Setting this flag
785   --       inhibits these new checks.
786
787   --  d.R  As documented in lib-writ.ads, restrictions in the ali file can
788   --       have two forms, positional and named. The named notation is the
789   --       current preferred form, but the use of this debug switch will force
790   --       the use of the obsolescent positional form.
791
792   --  d.S  Force Optimize_Alignment (Space) mode as the default
793
794   --  d.T  Force Optimize_Alignment (Time) mode as the default
795
796   --  d.U  Ignore indirect calls for static elaboration. The static
797   --       elaboration model is conservative, especially regarding indirect
798   --       calls. If you say Proc'Access, it will assume you might call
799   --       Proc. This can cause elaboration cycles at bind time. This flag
800   --       reverts to the behavior of earlier compilers, which ignored
801   --       indirect calls.
802
803   --  d.V  Do not verify the validity of SCIL files (CodePeer mode). When
804   --       generating SCIL files for CodePeer, by default we verify that the
805   --       SCIL is well formed before saving it on disk. This switch can be
806   --       used to disable this checking, either to improve speed or to shut
807   --       down a false positive detected during the verification.
808
809   --  d.W  Print out debugging information for Walk_Library_Items, including
810   --       the order in which units are walked. This is primarily for use in
811   --       debugging CodePeer mode.
812
813   --  d.X  A previous version of GNAT allowed indexing aspects to be redefined
814   --       on derived container types, while the default iterator was
815   --       inherited from the parent type. This nonstandard extension is
816   --       preserved temporarily for use by the modeling project under debug
817   --       flag d.X.
818
819   --  d.Z  Normally we always enable expansion in configurable run-time mode
820   --       to make sure we get error messages about unsupported features even
821   --       when compiling in -gnatc mode. But expansion is turned off in this
822   --       case if debug flag -gnatd.Z is used. This is to deal with the case
823   --       where we discover difficulties in this new processing.
824
825   --  d_a  The compiler stops the examination of a task body once it reaches
826   --       an accept or select statement for the static elaboration model. The
827   --       behavior is similar to that of No_Entry_Calls_In_Elaboration_Code,
828   --       but does not penalize actual entry calls in elaboration code.
829
830   --  d_e  The compiler ignores simple entry calls, asynchronous transfer of
831   --       control, conditional entry calls, timed entry calls, and requeue
832   --       statements in both the static and dynamic elaboration models.
833
834   --  d_f  Issue info messages related to GNATprove usage to help users
835   --       understand analysis results. By default these are not issued as
836   --       beginners find them confusing. Set automatically by GNATprove when
837   --       switch --info is used.
838
839   --  d_i  The compiler ignores calls and task activations when they target a
840   --       subprogram or task type defined in an external instance for both
841   --       the static and dynamic elaboration models.
842
843   --  d_p  The compiler ignores calls to subprograms which verify the run-time
844   --       semantics of invariants and postconditions in both the static and
845   --       dynamic elaboration models.
846
847   --  d_s  The compiler stops the examination of a task body once it reaches
848   --       a call to routine Ada.Synchronous_Task_Control.Suspend_Until_True
849   --       or Ada.Synchronous_Barriers.Wait_For_Release.
850
851   --  d_A  Do not generate ALI files by setting Opt.Disable_ALI_File.
852
853   --  d_L  Output trace information on elaboration checking. This debug switch
854   --       causes output to be generated showing each call or instantiation as
855   --       it is checked, and the progress of the recursive trace through
856   --       elaboration calls at compile time.
857
858   --  d1   Error messages have node numbers where possible. Normally error
859   --       messages have only source locations. This option is useful when
860   --       debugging errors caused by expanded code, where the source location
861   --       does not give enough information.
862
863   --  d2   Suppress output of the error position flags for verbose form error
864   --       messages. The messages are still interspersed in the listing, but
865   --       without any error flags or extra blank lines. Also causes an extra
866   --       <<< to be output at the right margin. This is intended to be the
867   --       easiest format for checking conformance of ACATS B tests. This
868   --       flag also suppresses the additional messages explaining why a
869   --       non-static expression is non-static (see Sem_Eval.Why_Not_Static).
870   --       This avoids having to worry about these messages in ACATS testing.
871
872   --  d3   Causes Comperr to dump the contents of the node for which an abort
873   --       was detected (normally only the Node_Id of the node is output).
874
875   --  d4   Inhibits automatic krunching of predefined library unit file names.
876   --       Normally, as described in the spec of package Krunch, such files
877   --       are automatically krunched to 8 characters, with special treatment
878   --       of the prefixes Ada, System, and Interfaces. Setting this debug
879   --       switch disables this special treatment.
880
881   --  d5   Causes the tree read/write circuit to output detailed information
882   --       tracking the data that is read and written element by element.
883
884   --  d6   Normally access-to-unconstrained-array types are represented
885   --       using fat (double) pointers. Using this debug flag causes them
886   --       to default to thin. This can be used to test the performance
887   --       implications of using thin pointers, and also to test that the
888   --       compiler functions correctly with this choice.
889
890   --  d7   Normally a -gnatl or -gnatv listing includes the time stamp of the
891   --       source file and the time of the compilation. This debug flag can
892   --       be used to suppress this output, and also suppresses the message
893   --       with the version of the compiler. This is useful for regression
894   --       tests which need to have consistent output.
895
896   --  d8   This forces the packed stuff to generate code assuming the
897   --       opposite endianness from the actual correct value. Useful in
898   --       testing out code generation from the packed routines.
899
900   --  d9   This allows lock free implementation for protected objects
901   --       (see Exp_Ch9).
902
903   --  d.1  Sets Opt.Unnest_Subprogram_Mode to enable unnesting of subprograms.
904   --       This special pass does not actually unnest things, but it ensures
905   --       that a nested procedure does not contain any uplevel references.
906   --       See spec of Exp_Unst for full details.
907
908   --  d.2  Allow statements within declarative parts. This is not usually
909   --       allowed, but in some debugging contexts (e.g. testing the circuit
910   --       for unnesting of procedures), it is useful to allow this.
911
912   --  d.3  Output debugging information from Exp_Unst, including the name of
913   --       any unreachable subprograms that get deleted.
914
915   --  d.4  By default in case of an error during C generation, the .c or .h
916   --       file is deleted. This flag keeps the C file.
917
918   --  d.5  By default a subprogram imported generates a subprogram profile.
919   --       This debug flag disables this generation when generating C code,
920   --       assuming a proper #include will be used instead.
921
922   --  d.6  By default the C back-end avoids declaring types that are not
923   --       referenced by the generated C code. This debug flag restores the
924   --       output of all the types.
925
926   --  d.7  Indicates (to gnat2scil) that CodePeer is being invoked as a
927   --       prover by the SPARK tools and that therefore gnat2scil should
928   --       avoid SCIL generation strategies which can introduce soundness
929   --       issues (e.g., assuming that a low bound of an array parameter
930   --       of an unconstrained subtype belongs to the index subtype).
931
932   --  d.9  Enable build-in-place for function calls returning some nonlimited
933   --       types.
934
935   ------------------------------------------
936   -- Documentation for Binder Debug Flags --
937   ------------------------------------------
938
939   --  da  Normally if there is an elaboration circularity, then in describing
940   --      the cycle, links involving internal units are omitted, since they
941   --      are irrelevant and confusing. This debug flag causes all links to
942   --      be listed, and is useful when diagnosing circularities introduced
943   --      by incorrect changes to the run-time library itself.
944
945   --  db  Output debug information from Better_Choice in Binde, which uses
946   --      various heuristics to determine elaboration order in cases where
947   --      multiple orders are valid.
948
949   --  dc  List units as they are chosen. As units are selected for addition to
950   --      the elaboration order, a line of output is generated showing which
951   --      unit has been selected.
952
953   --  de  Similar to the effect of -e (output complete list of elaboration
954   --      dependencies) except that internal units are included in the
955   --      listing.
956
957   --  di  Normally gnatbind calls Read_Ali with Ignore_Errors set to
958   --      False, since the binder really needs correct version ALI
959   --      files to do its job. This debug flag causes Ignore_Errors
960   --      mode to be set for the binder (and is particularly useful
961   --      for testing ignore errors mode).
962
963   --  dn  List details of manipulation of Num_Pred values during execution of
964   --      the algorithm used to determine a correct order of elaboration. This
965   --      is useful in diagnosing any problems in its behavior.
966
967   --  do  Use older elaboration order preference. The new preference rules
968   --      prefer specs with no bodies to specs with bodies, and between two
969   --      specs with bodies, prefers the one whose body is closer to being
970   --      able to be elaborated. This is a clear improvement, but we provide
971   --      this debug flag in case of regressions. Note: -do is even older
972   --      than -dp.
973
974   --  dp  Use old elaboration order preference. The new preference rules
975   --      elaborate all units within a strongly connected component together,
976   --      with no other units in between. In particular, if a spec/body pair
977   --      can be elaborated together, it will be. In the new order, the binder
978   --      behaves as if every pragma Elaborate_All that would be legal is
979   --      present, even if it does not appear in the source code.
980
981   --  du  List unit name and file name for each unit as it is read in
982
983   --  dv  Verbose debugging printouts
984
985   --  dx  Force the binder to read (and then ignore) the xref information
986   --      in ali files (used to check that read circuit is working OK).
987
988   --------------------------------------------
989   -- Documentation for gnatmake Debug Flags --
990   --------------------------------------------
991
992   --  df  Only output file names, not path names, in log
993
994   --  dh  Generate listing showing loading of name table hash chains,
995   --      same as for the compiler.
996
997   --  dm  Issue a message indicating the maximum number of simultaneous
998   --      compilations.
999
1000   --  dn  Do not delete temporary files created by gnatmake at the end
1001   --      of execution, such as temporary config pragma files, mapping
1002   --      files or project path files. This debug switch is equivalent to
1003   --      the standard switch --keep-temp-files. We retain the debug switch
1004   --      for back compatibility with past usage.
1005
1006   --  dp  Prints the Q used by routine Make.Compile_Sources every time
1007   --      we go around the main compile loop of Make.Compile_Sources
1008
1009   --  dq  Prints source files as they are enqueued and dequeued in the Q
1010   --      used by routine Make.Compile_Sources. Useful to figure out the
1011   --      order in which sources are recompiled.
1012
1013   --  dt  When a time stamp mismatch has been found for an ALI file,
1014   --      display the source file name, the time stamp expected and
1015   --      the time stamp found.
1016
1017   --  du  List unit name and file name for each unit as it is read in
1018
1019   --  dw  Prints the list of units withed by the unit currently explored
1020   --      during the main loop of Make.Compile_Sources.
1021
1022   ---------------------------------------------
1023   -- Documentation for gprbuild Debug Flags  --
1024   ---------------------------------------------
1025
1026   --  dm  Display the maximum number of simultaneous compilations.
1027
1028   --  dn  Do not delete temporary files created by gprbuild at the end
1029   --      of execution, such as temporary config pragma files, mapping
1030   --      files or project path files. This debug switch is equivalent to
1031   --      the standard switch --keep-temp-files. We retain the debug switch
1032   --      for back compatibility with past usage.
1033
1034   --  dt  When a time stamp mismatch has been found for an ALI file,
1035   --      display the source file name, the time stamp expected and
1036   --      the time stamp found.
1037
1038   --------------------
1039   -- Set_Debug_Flag --
1040   --------------------
1041
1042   procedure Set_Debug_Flag (C : Character; Val : Boolean := True) is
1043      subtype Dig  is Character range '1' .. '9';
1044      subtype LLet is Character range 'a' .. 'z';
1045      subtype ULet is Character range 'A' .. 'Z';
1046
1047   begin
1048      if C in Dig then
1049         case Dig (C) is
1050            when '1' =>
1051               Debug_Flag_1 := Val;
1052            when '2' =>
1053               Debug_Flag_2 := Val;
1054            when '3' =>
1055               Debug_Flag_3 := Val;
1056            when '4' =>
1057               Debug_Flag_4 := Val;
1058            when '5' =>
1059               Debug_Flag_5 := Val;
1060            when '6' =>
1061               Debug_Flag_6 := Val;
1062            when '7' =>
1063               Debug_Flag_7 := Val;
1064            when '8' =>
1065               Debug_Flag_8 := Val;
1066            when '9' =>
1067               Debug_Flag_9 := Val;
1068         end case;
1069
1070      elsif C in ULet then
1071         case ULet (C) is
1072            when 'A' =>
1073               Debug_Flag_AA := Val;
1074            when 'B' =>
1075               Debug_Flag_BB := Val;
1076            when 'C' =>
1077               Debug_Flag_CC := Val;
1078            when 'D' =>
1079               Debug_Flag_DD := Val;
1080            when 'E' =>
1081               Debug_Flag_EE := Val;
1082            when 'F' =>
1083               Debug_Flag_FF := Val;
1084            when 'G' =>
1085               Debug_Flag_GG := Val;
1086            when 'H' =>
1087               Debug_Flag_HH := Val;
1088            when 'I' =>
1089               Debug_Flag_II := Val;
1090            when 'J' =>
1091               Debug_Flag_JJ := Val;
1092            when 'K' =>
1093               Debug_Flag_KK := Val;
1094            when 'L' =>
1095               Debug_Flag_LL := Val;
1096            when 'M' =>
1097               Debug_Flag_MM := Val;
1098            when 'N' =>
1099               Debug_Flag_NN := Val;
1100            when 'O' =>
1101               Debug_Flag_OO := Val;
1102            when 'P' =>
1103               Debug_Flag_PP := Val;
1104            when 'Q' =>
1105               Debug_Flag_QQ := Val;
1106            when 'R' =>
1107               Debug_Flag_RR := Val;
1108            when 'S' =>
1109               Debug_Flag_SS := Val;
1110            when 'T' =>
1111               Debug_Flag_TT := Val;
1112            when 'U' =>
1113               Debug_Flag_UU := Val;
1114            when 'V' =>
1115               Debug_Flag_VV := Val;
1116            when 'W' =>
1117               Debug_Flag_WW := Val;
1118            when 'X' =>
1119               Debug_Flag_XX := Val;
1120            when 'Y' =>
1121               Debug_Flag_YY := Val;
1122            when 'Z' =>
1123               Debug_Flag_ZZ := Val;
1124         end case;
1125
1126      else
1127         case LLet (C) is
1128            when 'a' =>
1129               Debug_Flag_A := Val;
1130            when 'b' =>
1131               Debug_Flag_B := Val;
1132            when 'c' =>
1133               Debug_Flag_C := Val;
1134            when 'd' =>
1135               Debug_Flag_D := Val;
1136            when 'e' =>
1137               Debug_Flag_E := Val;
1138            when 'f' =>
1139               Debug_Flag_F := Val;
1140            when 'g' =>
1141               Debug_Flag_G := Val;
1142            when 'h' =>
1143               Debug_Flag_H := Val;
1144            when 'i' =>
1145               Debug_Flag_I := Val;
1146            when 'j' =>
1147               Debug_Flag_J := Val;
1148            when 'k' =>
1149               Debug_Flag_K := Val;
1150            when 'l' =>
1151               Debug_Flag_L := Val;
1152            when 'm' =>
1153               Debug_Flag_M := Val;
1154            when 'n' =>
1155               Debug_Flag_N := Val;
1156            when 'o' =>
1157               Debug_Flag_O := Val;
1158            when 'p' =>
1159               Debug_Flag_P := Val;
1160            when 'q' =>
1161               Debug_Flag_Q := Val;
1162            when 'r' =>
1163               Debug_Flag_R := Val;
1164            when 's' =>
1165               Debug_Flag_S := Val;
1166            when 't' =>
1167               Debug_Flag_T := Val;
1168            when 'u' =>
1169               Debug_Flag_U := Val;
1170            when 'v' =>
1171               Debug_Flag_V := Val;
1172            when 'w' =>
1173               Debug_Flag_W := Val;
1174            when 'x' =>
1175               Debug_Flag_X := Val;
1176            when 'y' =>
1177               Debug_Flag_Y := Val;
1178            when 'z' =>
1179               Debug_Flag_Z := Val;
1180         end case;
1181      end if;
1182   end Set_Debug_Flag;
1183
1184   ---------------------------
1185   -- Set_Dotted_Debug_Flag --
1186   ---------------------------
1187
1188   procedure Set_Dotted_Debug_Flag (C : Character; Val : Boolean := True) is
1189      subtype Dig  is Character range '1' .. '9';
1190      subtype LLet is Character range 'a' .. 'z';
1191      subtype ULet is Character range 'A' .. 'Z';
1192
1193   begin
1194      if C in Dig then
1195         case Dig (C) is
1196            when '1' =>
1197               Debug_Flag_Dot_1 := Val;
1198            when '2' =>
1199               Debug_Flag_Dot_2 := Val;
1200            when '3' =>
1201               Debug_Flag_Dot_3 := Val;
1202            when '4' =>
1203               Debug_Flag_Dot_4 := Val;
1204            when '5' =>
1205               Debug_Flag_Dot_5 := Val;
1206            when '6' =>
1207               Debug_Flag_Dot_6 := Val;
1208            when '7' =>
1209               Debug_Flag_Dot_7 := Val;
1210            when '8' =>
1211               Debug_Flag_Dot_8 := Val;
1212            when '9' =>
1213               Debug_Flag_Dot_9 := Val;
1214         end case;
1215
1216      elsif C in ULet then
1217         case ULet (C) is
1218            when 'A' =>
1219               Debug_Flag_Dot_AA := Val;
1220            when 'B' =>
1221               Debug_Flag_Dot_BB := Val;
1222            when 'C' =>
1223               Debug_Flag_Dot_CC := Val;
1224            when 'D' =>
1225               Debug_Flag_Dot_DD := Val;
1226            when 'E' =>
1227               Debug_Flag_Dot_EE := Val;
1228            when 'F' =>
1229               Debug_Flag_Dot_FF := Val;
1230            when 'G' =>
1231               Debug_Flag_Dot_GG := Val;
1232            when 'H' =>
1233               Debug_Flag_Dot_HH := Val;
1234            when 'I' =>
1235               Debug_Flag_Dot_II := Val;
1236            when 'J' =>
1237               Debug_Flag_Dot_JJ := Val;
1238            when 'K' =>
1239               Debug_Flag_Dot_KK := Val;
1240            when 'L' =>
1241               Debug_Flag_Dot_LL := Val;
1242            when 'M' =>
1243               Debug_Flag_Dot_MM := Val;
1244            when 'N' =>
1245               Debug_Flag_Dot_NN := Val;
1246            when 'O' =>
1247               Debug_Flag_Dot_OO := Val;
1248            when 'P' =>
1249               Debug_Flag_Dot_PP := Val;
1250            when 'Q' =>
1251               Debug_Flag_Dot_QQ := Val;
1252            when 'R' =>
1253               Debug_Flag_Dot_RR := Val;
1254            when 'S' =>
1255               Debug_Flag_Dot_SS := Val;
1256            when 'T' =>
1257               Debug_Flag_Dot_TT := Val;
1258            when 'U' =>
1259               Debug_Flag_Dot_UU := Val;
1260            when 'V' =>
1261               Debug_Flag_Dot_VV := Val;
1262            when 'W' =>
1263               Debug_Flag_Dot_WW := Val;
1264            when 'X' =>
1265               Debug_Flag_Dot_XX := Val;
1266            when 'Y' =>
1267               Debug_Flag_Dot_YY := Val;
1268            when 'Z' =>
1269               Debug_Flag_Dot_ZZ := Val;
1270         end case;
1271
1272      else
1273         case LLet (C) is
1274            when 'a' =>
1275               Debug_Flag_Dot_A := Val;
1276            when 'b' =>
1277               Debug_Flag_Dot_B := Val;
1278            when 'c' =>
1279               Debug_Flag_Dot_C := Val;
1280            when 'd' =>
1281               Debug_Flag_Dot_D := Val;
1282            when 'e' =>
1283               Debug_Flag_Dot_E := Val;
1284            when 'f' =>
1285               Debug_Flag_Dot_F := Val;
1286            when 'g' =>
1287               Debug_Flag_Dot_G := Val;
1288            when 'h' =>
1289               Debug_Flag_Dot_H := Val;
1290            when 'i' =>
1291               Debug_Flag_Dot_I := Val;
1292            when 'j' =>
1293               Debug_Flag_Dot_J := Val;
1294            when 'k' =>
1295               Debug_Flag_Dot_K := Val;
1296            when 'l' =>
1297               Debug_Flag_Dot_L := Val;
1298            when 'm' =>
1299               Debug_Flag_Dot_M := Val;
1300            when 'n' =>
1301               Debug_Flag_Dot_N := Val;
1302            when 'o' =>
1303               Debug_Flag_Dot_O := Val;
1304            when 'p' =>
1305               Debug_Flag_Dot_P := Val;
1306            when 'q' =>
1307               Debug_Flag_Dot_Q := Val;
1308            when 'r' =>
1309               Debug_Flag_Dot_R := Val;
1310            when 's' =>
1311               Debug_Flag_Dot_S := Val;
1312            when 't' =>
1313               Debug_Flag_Dot_T := Val;
1314            when 'u' =>
1315               Debug_Flag_Dot_U := Val;
1316            when 'v' =>
1317               Debug_Flag_Dot_V := Val;
1318            when 'w' =>
1319               Debug_Flag_Dot_W := Val;
1320            when 'x' =>
1321               Debug_Flag_Dot_X := Val;
1322            when 'y' =>
1323               Debug_Flag_Dot_Y := Val;
1324            when 'z' =>
1325               Debug_Flag_Dot_Z := Val;
1326         end case;
1327      end if;
1328   end Set_Dotted_Debug_Flag;
1329
1330   --------------------------------
1331   -- Set_Underscored_Debug_Flag --
1332   --------------------------------
1333
1334   procedure Set_Underscored_Debug_Flag
1335     (C   : Character;
1336      Val : Boolean := True)
1337   is
1338      subtype Dig  is Character range '1' .. '9';
1339      subtype LLet is Character range 'a' .. 'z';
1340      subtype ULet is Character range 'A' .. 'Z';
1341
1342   begin
1343      if C in Dig then
1344         case Dig (C) is
1345            when '1' =>
1346               Debug_Flag_Underscore_1 := Val;
1347            when '2' =>
1348               Debug_Flag_Underscore_2 := Val;
1349            when '3' =>
1350               Debug_Flag_Underscore_3 := Val;
1351            when '4' =>
1352               Debug_Flag_Underscore_4 := Val;
1353            when '5' =>
1354               Debug_Flag_Underscore_5 := Val;
1355            when '6' =>
1356               Debug_Flag_Underscore_6 := Val;
1357            when '7' =>
1358               Debug_Flag_Underscore_7 := Val;
1359            when '8' =>
1360               Debug_Flag_Underscore_8 := Val;
1361            when '9' =>
1362               Debug_Flag_Underscore_9 := Val;
1363         end case;
1364
1365      elsif C in ULet then
1366         case ULet (C) is
1367            when 'A' =>
1368               Debug_Flag_Underscore_AA := Val;
1369            when 'B' =>
1370               Debug_Flag_Underscore_BB := Val;
1371            when 'C' =>
1372               Debug_Flag_Underscore_CC := Val;
1373            when 'D' =>
1374               Debug_Flag_Underscore_DD := Val;
1375            when 'E' =>
1376               Debug_Flag_Underscore_EE := Val;
1377            when 'F' =>
1378               Debug_Flag_Underscore_FF := Val;
1379            when 'G' =>
1380               Debug_Flag_Underscore_GG := Val;
1381            when 'H' =>
1382               Debug_Flag_Underscore_HH := Val;
1383            when 'I' =>
1384               Debug_Flag_Underscore_II := Val;
1385            when 'J' =>
1386               Debug_Flag_Underscore_JJ := Val;
1387            when 'K' =>
1388               Debug_Flag_Underscore_KK := Val;
1389            when 'L' =>
1390               Debug_Flag_Underscore_LL := Val;
1391            when 'M' =>
1392               Debug_Flag_Underscore_MM := Val;
1393            when 'N' =>
1394               Debug_Flag_Underscore_NN := Val;
1395            when 'O' =>
1396               Debug_Flag_Underscore_OO := Val;
1397            when 'P' =>
1398               Debug_Flag_Underscore_PP := Val;
1399            when 'Q' =>
1400               Debug_Flag_Underscore_QQ := Val;
1401            when 'R' =>
1402               Debug_Flag_Underscore_RR := Val;
1403            when 'S' =>
1404               Debug_Flag_Underscore_SS := Val;
1405            when 'T' =>
1406               Debug_Flag_Underscore_TT := Val;
1407            when 'U' =>
1408               Debug_Flag_Underscore_UU := Val;
1409            when 'V' =>
1410               Debug_Flag_Underscore_VV := Val;
1411            when 'W' =>
1412               Debug_Flag_Underscore_WW := Val;
1413            when 'X' =>
1414               Debug_Flag_Underscore_XX := Val;
1415            when 'Y' =>
1416               Debug_Flag_Underscore_YY := Val;
1417            when 'Z' =>
1418               Debug_Flag_Underscore_ZZ := Val;
1419         end case;
1420
1421      else
1422         case LLet (C) is
1423            when 'a' =>
1424               Debug_Flag_Underscore_A := Val;
1425            when 'b' =>
1426               Debug_Flag_Underscore_B := Val;
1427            when 'c' =>
1428               Debug_Flag_Underscore_C := Val;
1429            when 'd' =>
1430               Debug_Flag_Underscore_D := Val;
1431            when 'e' =>
1432               Debug_Flag_Underscore_E := Val;
1433            when 'f' =>
1434               Debug_Flag_Underscore_F := Val;
1435            when 'g' =>
1436               Debug_Flag_Underscore_G := Val;
1437            when 'h' =>
1438               Debug_Flag_Underscore_H := Val;
1439            when 'i' =>
1440               Debug_Flag_Underscore_I := Val;
1441            when 'j' =>
1442               Debug_Flag_Underscore_J := Val;
1443            when 'k' =>
1444               Debug_Flag_Underscore_K := Val;
1445            when 'l' =>
1446               Debug_Flag_Underscore_L := Val;
1447            when 'm' =>
1448               Debug_Flag_Underscore_M := Val;
1449            when 'n' =>
1450               Debug_Flag_Underscore_N := Val;
1451            when 'o' =>
1452               Debug_Flag_Underscore_O := Val;
1453            when 'p' =>
1454               Debug_Flag_Underscore_P := Val;
1455            when 'q' =>
1456               Debug_Flag_Underscore_Q := Val;
1457            when 'r' =>
1458               Debug_Flag_Underscore_R := Val;
1459            when 's' =>
1460               Debug_Flag_Underscore_S := Val;
1461            when 't' =>
1462               Debug_Flag_Underscore_T := Val;
1463            when 'u' =>
1464               Debug_Flag_Underscore_U := Val;
1465            when 'v' =>
1466               Debug_Flag_Underscore_V := Val;
1467            when 'w' =>
1468               Debug_Flag_Underscore_W := Val;
1469            when 'x' =>
1470               Debug_Flag_Underscore_X := Val;
1471            when 'y' =>
1472               Debug_Flag_Underscore_Y := Val;
1473            when 'z' =>
1474               Debug_Flag_Underscore_Z := Val;
1475         end case;
1476      end if;
1477   end Set_Underscored_Debug_Flag;
1478
1479end Debug;
1480