File : errout.adb


   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --                               E R R O U T                                --
   6 --                                                                          --
   7 --                                 B o d y                                  --
   8 --                                                                          --
   9 --          Copyright (C) 1992-2016, 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.  See the GNU General Public License --
  17 -- for  more details.  You should have  received  a copy of the GNU General --
  18 -- Public License  distributed with GNAT; see file COPYING3.  If not, go to --
  19 -- http://www.gnu.org/licenses for a complete copy of the license.          --
  20 --                                                                          --
  21 -- GNAT was originally developed  by the GNAT team at  New York University. --
  22 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  23 --                                                                          --
  24 ------------------------------------------------------------------------------
  25 
  26 --  Warning: Error messages can be generated during Gigi processing by direct
  27 --  calls to error message routines, so it is essential that the processing
  28 --  in this body be consistent with the requirements for the Gigi processing
  29 --  environment, and that in particular, no disallowed table expansion is
  30 --  allowed to occur.
  31 
  32 with Atree;    use Atree;
  33 with Casing;   use Casing;
  34 with Csets;    use Csets;
  35 with Debug;    use Debug;
  36 with Einfo;    use Einfo;
  37 with Erroutc;  use Erroutc;
  38 with Fname;    use Fname;
  39 with Gnatvsn;  use Gnatvsn;
  40 with Lib;      use Lib;
  41 with Opt;      use Opt;
  42 with Nlists;   use Nlists;
  43 with Output;   use Output;
  44 with Scans;    use Scans;
  45 with Sem_Aux;  use Sem_Aux;
  46 with Sinput;   use Sinput;
  47 with Sinfo;    use Sinfo;
  48 with Snames;   use Snames;
  49 with Stand;    use Stand;
  50 with Stylesw;  use Stylesw;
  51 with Uname;    use Uname;
  52 
  53 package body Errout is
  54 
  55    Errors_Must_Be_Ignored : Boolean := False;
  56    --  Set to True by procedure Set_Ignore_Errors (True), when calls to error
  57    --  message procedures should be ignored (when parsing irrelevant text in
  58    --  sources being preprocessed).
  59 
  60    Finalize_Called : Boolean := False;
  61    --  Set True if the Finalize routine has been called
  62 
  63    Warn_On_Instance : Boolean;
  64    --  Flag set true for warning message to be posted on instance
  65 
  66    ------------------------------------
  67    -- Table of Non-Instance Messages --
  68    ------------------------------------
  69 
  70    --  This table contains an entry for every error message processed by the
  71    --  Error_Msg routine that is not posted on generic (or inlined) instance.
  72    --  As explained in further detail in the Error_Msg procedure body, this
  73    --  table is used to avoid posting redundant messages on instances.
  74 
  75    type NIM_Record is record
  76       Msg : String_Ptr;
  77       Loc : Source_Ptr;
  78    end record;
  79    --  Type used to store text and location of one message
  80 
  81    package Non_Instance_Msgs is new Table.Table (
  82      Table_Component_Type => NIM_Record,
  83      Table_Index_Type     => Int,
  84      Table_Low_Bound      => 1,
  85      Table_Initial        => 100,
  86      Table_Increment      => 100,
  87      Table_Name           => "Non_Instance_Msgs");
  88 
  89    -----------------------
  90    -- Local Subprograms --
  91    -----------------------
  92 
  93    procedure Error_Msg_Internal
  94      (Msg      : String;
  95       Sptr     : Source_Ptr;
  96       Optr     : Source_Ptr;
  97       Msg_Cont : Boolean);
  98    --  This is the low level routine used to post messages after dealing with
  99    --  the issue of messages placed on instantiations (which get broken up
 100    --  into separate calls in Error_Msg). Sptr is the location on which the
 101    --  flag will be placed in the output. In the case where the flag is on
 102    --  the template, this points directly to the template, not to one of the
 103    --  instantiation copies of the template. Optr is the original location
 104    --  used to flag the error, and this may indeed point to an instantiation
 105    --  copy. So typically we can see Optr pointing to the template location
 106    --  in an instantiation copy when Sptr points to the source location of
 107    --  the actual instantiation (i.e the line with the new). Msg_Cont is
 108    --  set true if this is a continuation message.
 109 
 110    function No_Warnings (N : Node_Or_Entity_Id) return Boolean;
 111    --  Determines if warnings should be suppressed for the given node
 112 
 113    function OK_Node (N : Node_Id) return Boolean;
 114    --  Determines if a node is an OK node to place an error message on (return
 115    --  True) or if the error message should be suppressed (return False). A
 116    --  message is suppressed if the node already has an error posted on it,
 117    --  or if it refers to an Etype that has an error posted on it, or if
 118    --  it references an Entity that has an error posted on it.
 119 
 120    procedure Output_Source_Line
 121      (L     : Physical_Line_Number;
 122       Sfile : Source_File_Index;
 123       Errs  : Boolean);
 124    --  Outputs text of source line L, in file S, together with preceding line
 125    --  number, as described above for Output_Line_Number. The Errs parameter
 126    --  indicates if there are errors attached to the line, which forces
 127    --  listing on, even in the presence of pragma List (Off).
 128 
 129    procedure Set_Msg_Insertion_Column;
 130    --  Handle column number insertion (@ insertion character)
 131 
 132    procedure Set_Msg_Insertion_Node;
 133    --  Handle node (name from node) insertion (& insertion character)
 134 
 135    procedure Set_Msg_Insertion_Type_Reference (Flag : Source_Ptr);
 136    --  Handle type reference (right brace insertion character). Flag is the
 137    --  location of the flag, which is provided for the internal call to
 138    --  Set_Msg_Insertion_Line_Number,
 139 
 140    procedure Set_Msg_Insertion_Unit_Name (Suffix : Boolean := True);
 141    --  Handle unit name insertion ($ insertion character). Depending on Boolean
 142    --  parameter Suffix, (spec) or (body) is appended after the unit name.
 143 
 144    procedure Set_Msg_Node (Node : Node_Id);
 145    --  Add the sequence of characters for the name associated with the given
 146    --  node to the current message. For N_Designator, N_Selected_Component,
 147    --  N_Defining_Program_Unit_Name, and N_Expanded_Name, the Prefix is
 148    --  included as well.
 149 
 150    procedure Set_Msg_Text (Text : String; Flag : Source_Ptr);
 151    --  Add a sequence of characters to the current message. The characters may
 152    --  be one of the special insertion characters (see documentation in spec).
 153    --  Flag is the location at which the error is to be posted, which is used
 154    --  to determine whether or not the # insertion needs a file name. The
 155    --  variables Msg_Buffer are set on return Msglen.
 156 
 157    procedure Set_Posted (N : Node_Id);
 158    --  Sets the Error_Posted flag on the given node, and all its parents that
 159    --  are subexpressions and then on the parent non-subexpression construct
 160    --  that contains the original expression. If that parent is a named
 161    --  association, the flag is further propagated to its parent. This is done
 162    --  in order to guard against cascaded errors. Note that this call has an
 163    --  effect for a serious error only.
 164 
 165    procedure Set_Qualification (N : Nat; E : Entity_Id);
 166    --  Outputs up to N levels of qualification for the given entity. For
 167    --  example, the entity A.B.C.D will output B.C. if N = 2.
 168 
 169    function Special_Msg_Delete
 170      (Msg : String;
 171       N   : Node_Or_Entity_Id;
 172       E   : Node_Or_Entity_Id) return Boolean;
 173    --  This function is called from Error_Msg_NEL, passing the message Msg,
 174    --  node N on which the error is to be posted, and the entity or node E
 175    --  to be used for an & insertion in the message if any. The job of this
 176    --  procedure is to test for certain cascaded messages that we would like
 177    --  to suppress. If the message is to be suppressed then we return True.
 178    --  If the message should be generated (the normal case) False is returned.
 179 
 180    procedure Unwind_Internal_Type (Ent : in out Entity_Id);
 181    --  This procedure is given an entity id for an internal type, i.e. a type
 182    --  with an internal name. It unwinds the type to try to get to something
 183    --  reasonably printable, generating prefixes like "subtype of", "access
 184    --  to", etc along the way in the buffer. The value in Ent on return is the
 185    --  final name to be printed. Hopefully this is not an internal name, but in
 186    --  some internal name cases, it is an internal name, and has to be printed
 187    --  anyway (although in this case the message has been killed if possible).
 188    --  The global variable Class_Flag is set to True if the resulting entity
 189    --  should have 'Class appended to its name (see Add_Class procedure), and
 190    --  is otherwise unchanged.
 191 
 192    function Warn_Insertion return String;
 193    --  This is called for warning messages only (so Warning_Msg_Char is set)
 194    --  and returns a corresponding string to use at the beginning of generated
 195    --  auxiliary messages, such as "in instantiation at ...".
 196    --    'a' .. 'z'   returns "?x?"
 197    --    'A' .. 'Z'   returns "?X?"
 198    --    '*'          returns "?*?"
 199    --    '$'          returns "?$?info: "
 200    --    ' '          returns " "
 201    --  No other settings are valid
 202 
 203    -----------------------
 204    -- Change_Error_Text --
 205    -----------------------
 206 
 207    procedure Change_Error_Text (Error_Id : Error_Msg_Id; New_Msg : String) is
 208       Save_Next : Error_Msg_Id;
 209       Err_Id    : Error_Msg_Id := Error_Id;
 210 
 211    begin
 212       Set_Msg_Text (New_Msg, Errors.Table (Error_Id).Sptr);
 213       Errors.Table (Error_Id).Text := new String'(Msg_Buffer (1 .. Msglen));
 214 
 215       --  If in immediate error message mode, output modified error message now
 216       --  This is just a bit tricky, because we want to output just a single
 217       --  message, and the messages we modified is already linked in. We solve
 218       --  this by temporarily resetting its forward pointer to empty.
 219 
 220       if Debug_Flag_OO then
 221          Save_Next := Errors.Table (Error_Id).Next;
 222          Errors.Table (Error_Id).Next := No_Error_Msg;
 223          Write_Eol;
 224          Output_Source_Line
 225            (Errors.Table (Error_Id).Line, Errors.Table (Error_Id).Sfile, True);
 226          Output_Error_Msgs (Err_Id);
 227          Errors.Table (Error_Id).Next := Save_Next;
 228       end if;
 229    end Change_Error_Text;
 230 
 231    ------------------------
 232    -- Compilation_Errors --
 233    ------------------------
 234 
 235    function Compilation_Errors return Boolean is
 236    begin
 237       if not Finalize_Called then
 238          raise Program_Error;
 239       else
 240          return Erroutc.Compilation_Errors;
 241       end if;
 242    end Compilation_Errors;
 243 
 244    --------------------------------------
 245    -- Delete_Warning_And_Continuations --
 246    --------------------------------------
 247 
 248    procedure Delete_Warning_And_Continuations (Msg : Error_Msg_Id) is
 249       Id : Error_Msg_Id;
 250 
 251    begin
 252       pragma Assert (not Errors.Table (Msg).Msg_Cont);
 253 
 254       Id := Msg;
 255       loop
 256          declare
 257             M : Error_Msg_Object renames Errors.Table (Id);
 258 
 259          begin
 260             if not M.Deleted then
 261                M.Deleted := True;
 262                Warnings_Detected := Warnings_Detected - 1;
 263 
 264                if M.Info then
 265                   Info_Messages := Info_Messages - 1;
 266                end if;
 267 
 268                if M.Warn_Err then
 269                   Warnings_Treated_As_Errors := Warnings_Treated_As_Errors - 1;
 270                end if;
 271             end if;
 272 
 273             Id := M.Next;
 274             exit when Id = No_Error_Msg;
 275             exit when not Errors.Table (Id).Msg_Cont;
 276          end;
 277       end loop;
 278    end Delete_Warning_And_Continuations;
 279 
 280    ---------------
 281    -- Error_Msg --
 282    ---------------
 283 
 284    --  Error_Msg posts a flag at the given location, except that if the
 285    --  Flag_Location points within a generic template and corresponds to an
 286    --  instantiation of this generic template, then the actual message will be
 287    --  posted on the generic instantiation, along with additional messages
 288    --  referencing the generic declaration.
 289 
 290    procedure Error_Msg (Msg : String; Flag_Location : Source_Ptr) is
 291       Sindex : Source_File_Index;
 292       --  Source index for flag location
 293 
 294       Orig_Loc : Source_Ptr;
 295       --  Original location of Flag_Location (i.e. location in original
 296       --  template in instantiation case, otherwise unchanged).
 297 
 298    begin
 299       --  It is a fatal error to issue an error message when scanning from the
 300       --  internal source buffer (see Sinput for further documentation)
 301 
 302       pragma Assert (Sinput.Source /= Internal_Source_Ptr);
 303 
 304       --  Return if all errors are to be ignored
 305 
 306       if Errors_Must_Be_Ignored then
 307          return;
 308       end if;
 309 
 310       --  If we already have messages, and we are trying to place a message at
 311       --  No_Location, then just ignore the attempt since we assume that what
 312       --  is happening is some cascaded junk. Note that this is safe in the
 313       --  sense that proceeding will surely bomb. We will also bomb if the flag
 314       --  location is No_Location and we don't have any messages so far, but
 315       --  that is a real bug and a legitimate bomb, so we go ahead.
 316 
 317       if Flag_Location = No_Location
 318         and then Total_Errors_Detected > 0
 319       then
 320          return;
 321       end if;
 322 
 323       --  Start of processing for new message
 324 
 325       Sindex := Get_Source_File_Index (Flag_Location);
 326       Prescan_Message (Msg);
 327       Orig_Loc := Original_Location (Flag_Location);
 328 
 329       --  If the current location is in an instantiation, the issue arises of
 330       --  whether to post the message on the template or the instantiation.
 331 
 332       --  The way we decide is to see if we have posted the same message on
 333       --  the template when we compiled the template (the template is always
 334       --  compiled before any instantiations). For this purpose, we use a
 335       --  separate table of messages. The reason we do this is twofold:
 336 
 337       --     First, the messages can get changed by various processing
 338       --     including the insertion of tokens etc, making it hard to
 339       --     do the comparison.
 340 
 341       --     Second, we will suppress a warning on a template if it is not in
 342       --     the current extended source unit. That's reasonable and means we
 343       --     don't want the warning on the instantiation here either, but it
 344       --     does mean that the main error table would not in any case include
 345       --     the message.
 346 
 347       if Flag_Location = Orig_Loc then
 348          Non_Instance_Msgs.Append ((new String'(Msg), Flag_Location));
 349          Warn_On_Instance := False;
 350 
 351       --  Here we have an instance message
 352 
 353       else
 354          --  Delete if debug flag off, and this message duplicates a message
 355          --  already posted on the corresponding template
 356 
 357          if not Debug_Flag_GG then
 358             for J in Non_Instance_Msgs.First .. Non_Instance_Msgs.Last loop
 359                if Msg = Non_Instance_Msgs.Table (J).Msg.all
 360                  and then Non_Instance_Msgs.Table (J).Loc = Orig_Loc
 361                then
 362                   return;
 363                end if;
 364             end loop;
 365          end if;
 366 
 367          --  No duplicate, so error/warning will be posted on instance
 368 
 369          Warn_On_Instance := Is_Warning_Msg;
 370       end if;
 371 
 372       --  Ignore warning message that is suppressed for this location. Note
 373       --  that style checks are not considered warning messages for this
 374       --  purpose.
 375 
 376       if Is_Warning_Msg and then Warnings_Suppressed (Orig_Loc) /= No_String
 377       then
 378          return;
 379 
 380       --  For style messages, check too many messages so far
 381 
 382       elsif Is_Style_Msg
 383         and then Maximum_Messages /= 0
 384         and then Warnings_Detected >= Maximum_Messages
 385       then
 386          return;
 387       end if;
 388 
 389       --  The idea at this stage is that we have two kinds of messages
 390 
 391       --  First, we have those messages that are to be placed as requested at
 392       --  Flag_Location. This includes messages that have nothing to do with
 393       --  generics, and also messages placed on generic templates that reflect
 394       --  an error in the template itself. For such messages we simply call
 395       --  Error_Msg_Internal to place the message in the requested location.
 396 
 397       if Instantiation (Sindex) = No_Location then
 398          Error_Msg_Internal (Msg, Flag_Location, Flag_Location, False);
 399          return;
 400       end if;
 401 
 402       --  If we are trying to flag an error in an instantiation, we may have
 403       --  a generic contract violation. What we generate in this case is:
 404 
 405       --     instantiation error at ...
 406       --     original error message
 407 
 408       --  or
 409 
 410       --     warning: in instantiation at
 411       --     warning: original warning message
 412 
 413       --  All these messages are posted at the location of the top level
 414       --  instantiation. If there are nested instantiations, then the
 415       --  instantiation error message can be repeated, pointing to each
 416       --  of the relevant instantiations.
 417 
 418       --  Note: the instantiation mechanism is also shared for inlining of
 419       --  subprogram bodies when front end inlining is done. In this case the
 420       --  messages have the form:
 421 
 422       --     in inlined body at ...
 423       --     original error message
 424 
 425       --  or
 426 
 427       --     warning: in inlined body at
 428       --     warning: original warning message
 429 
 430       --  OK, here we have an instantiation error, and we need to generate the
 431       --  error on the instantiation, rather than on the template.
 432 
 433       declare
 434          Actual_Error_Loc : Source_Ptr;
 435          --  Location of outer level instantiation in instantiation case, or
 436          --  just a copy of Flag_Location in the normal case. This is the
 437          --  location where all error messages will actually be posted.
 438 
 439          Save_Error_Msg_Sloc : constant Source_Ptr := Error_Msg_Sloc;
 440          --  Save possible location set for caller's message. We need to use
 441          --  Error_Msg_Sloc for the location of the instantiation error but we
 442          --  have to preserve a possible original value.
 443 
 444          X : Source_File_Index;
 445 
 446          Msg_Cont_Status : Boolean;
 447          --  Used to label continuation lines in instantiation case with
 448          --  proper Msg_Cont status.
 449 
 450       begin
 451          --  Loop to find highest level instantiation, where all error
 452          --  messages will be placed.
 453 
 454          X := Sindex;
 455          loop
 456             Actual_Error_Loc := Instantiation (X);
 457             X := Get_Source_File_Index (Actual_Error_Loc);
 458             exit when Instantiation (X) = No_Location;
 459          end loop;
 460 
 461          --  Since we are generating the messages at the instantiation point in
 462          --  any case, we do not want the references to the bad lines in the
 463          --  instance to be annotated with the location of the instantiation.
 464 
 465          Suppress_Instance_Location := True;
 466          Msg_Cont_Status := False;
 467 
 468          --  Loop to generate instantiation messages
 469 
 470          Error_Msg_Sloc := Flag_Location;
 471          X := Get_Source_File_Index (Flag_Location);
 472          while Instantiation (X) /= No_Location loop
 473 
 474             --  Suppress instantiation message on continuation lines
 475 
 476             if Msg (Msg'First) /= '\' then
 477 
 478                --  Case of inlined body
 479 
 480                if Inlined_Body (X) then
 481                   if Is_Warning_Msg or Is_Style_Msg then
 482                      Error_Msg_Internal
 483                        (Warn_Insertion & "in inlined body #",
 484                         Actual_Error_Loc, Flag_Location, Msg_Cont_Status);
 485                   else
 486                      Error_Msg_Internal
 487                        ("error in inlined body #",
 488                         Actual_Error_Loc, Flag_Location, Msg_Cont_Status);
 489                   end if;
 490 
 491                --  Case of generic instantiation
 492 
 493                else
 494                   if Is_Warning_Msg or else Is_Style_Msg then
 495                      Error_Msg_Internal
 496                        (Warn_Insertion & "in instantiation #",
 497                         Actual_Error_Loc, Flag_Location, Msg_Cont_Status);
 498                   else
 499                      Error_Msg_Internal
 500                        ("instantiation error #",
 501                         Actual_Error_Loc, Flag_Location, Msg_Cont_Status);
 502                   end if;
 503                end if;
 504             end if;
 505 
 506             Error_Msg_Sloc := Instantiation (X);
 507             X := Get_Source_File_Index (Error_Msg_Sloc);
 508             Msg_Cont_Status := True;
 509          end loop;
 510 
 511          Suppress_Instance_Location := False;
 512          Error_Msg_Sloc := Save_Error_Msg_Sloc;
 513 
 514          --  Here we output the original message on the outer instantiation
 515 
 516          Error_Msg_Internal
 517            (Msg, Actual_Error_Loc, Flag_Location, Msg_Cont_Status);
 518       end;
 519    end Error_Msg;
 520 
 521    --------------------------------
 522    -- Error_Msg_Ada_2012_Feature --
 523    --------------------------------
 524 
 525    procedure Error_Msg_Ada_2012_Feature (Feature : String; Loc : Source_Ptr) is
 526    begin
 527       if Ada_Version < Ada_2012 then
 528          Error_Msg (Feature & " is an Ada 2012 feature", Loc);
 529 
 530          if No (Ada_Version_Pragma) then
 531             Error_Msg ("\unit must be compiled with -gnat2012 switch", Loc);
 532          else
 533             Error_Msg_Sloc := Sloc (Ada_Version_Pragma);
 534             Error_Msg ("\incompatible with Ada version set#", Loc);
 535          end if;
 536       end if;
 537    end Error_Msg_Ada_2012_Feature;
 538 
 539    ------------------
 540    -- Error_Msg_AP --
 541    ------------------
 542 
 543    procedure Error_Msg_AP (Msg : String) is
 544       S1 : Source_Ptr;
 545       C  : Character;
 546 
 547    begin
 548       --  If we had saved the Scan_Ptr value after scanning the previous
 549       --  token, then we would have exactly the right place for putting
 550       --  the flag immediately at hand. However, that would add at least
 551       --  two instructions to a Scan call *just* to service the possibility
 552       --  of an Error_Msg_AP call. So instead we reconstruct that value.
 553 
 554       --  We have two possibilities, start with Prev_Token_Ptr and skip over
 555       --  the current token, which is made harder by the possibility that this
 556       --  token may be in error, or start with Token_Ptr and work backwards.
 557       --  We used to take the second approach, but it's hard because of
 558       --  comments, and harder still because things that look like comments
 559       --  can appear inside strings. So now we take the first approach.
 560 
 561       --  Note: in the case where there is no previous token, Prev_Token_Ptr
 562       --  is set to Source_First, which is a reasonable position for the
 563       --  error flag in this situation.
 564 
 565       S1 := Prev_Token_Ptr;
 566       C := Source (S1);
 567 
 568       --  If the previous token is a string literal, we need a special approach
 569       --  since there may be white space inside the literal and we don't want
 570       --  to stop on that white space.
 571 
 572       --  Note: since this is an error recovery issue anyway, it is not worth
 573       --  worrying about special UTF_32 line terminator characters here.
 574 
 575       if Prev_Token = Tok_String_Literal then
 576          loop
 577             S1 := S1 + 1;
 578 
 579             if Source (S1) = C then
 580                S1 := S1 + 1;
 581                exit when Source (S1) /= C;
 582             elsif Source (S1) in Line_Terminator then
 583                exit;
 584             end if;
 585          end loop;
 586 
 587       --  Character literal also needs special handling
 588 
 589       elsif Prev_Token = Tok_Char_Literal then
 590          S1 := S1 + 3;
 591 
 592       --  Otherwise we search forward for the end of the current token, marked
 593       --  by a line terminator, white space, a comment symbol or if we bump
 594       --  into the following token (i.e. the current token).
 595 
 596       --  Again, it is not worth worrying about UTF_32 special line terminator
 597       --  characters in this context, since this is only for error recovery.
 598 
 599       else
 600          while Source (S1) not in Line_Terminator
 601            and then Source (S1) /= ' '
 602            and then Source (S1) /= ASCII.HT
 603            and then (Source (S1) /= '-' or else Source (S1 + 1) /= '-')
 604            and then S1 /= Token_Ptr
 605          loop
 606             S1 := S1 + 1;
 607          end loop;
 608       end if;
 609 
 610       --  S1 is now set to the location for the flag
 611 
 612       Error_Msg (Msg, S1);
 613    end Error_Msg_AP;
 614 
 615    ------------------
 616    -- Error_Msg_BC --
 617    ------------------
 618 
 619    procedure Error_Msg_BC (Msg : String) is
 620    begin
 621       --  If we are at end of file, post the flag after the previous token
 622 
 623       if Token = Tok_EOF then
 624          Error_Msg_AP (Msg);
 625 
 626       --  If we are at start of file, post the flag at the current token
 627 
 628       elsif Token_Ptr = Source_First (Current_Source_File) then
 629          Error_Msg_SC (Msg);
 630 
 631       --  If the character before the current token is a space or a horizontal
 632       --  tab, then we place the flag on this character (in the case of a tab
 633       --  we would really like to place it in the "last" character of the tab
 634       --  space, but that it too much trouble to worry about).
 635 
 636       elsif Source (Token_Ptr - 1) = ' '
 637          or else Source (Token_Ptr - 1) = ASCII.HT
 638       then
 639          Error_Msg (Msg, Token_Ptr - 1);
 640 
 641       --  If there is no space or tab before the current token, then there is
 642       --  no room to place the flag before the token, so we place it on the
 643       --  token instead (this happens for example at the start of a line).
 644 
 645       else
 646          Error_Msg (Msg, Token_Ptr);
 647       end if;
 648    end Error_Msg_BC;
 649 
 650    -------------------
 651    -- Error_Msg_CRT --
 652    -------------------
 653 
 654    procedure Error_Msg_CRT (Feature : String; N : Node_Id) is
 655       CNRT : constant String := " not allowed in no run time mode";
 656       CCRT : constant String := " not supported by configuration>";
 657 
 658       S : String (1 .. Feature'Length + 1 + CCRT'Length);
 659       L : Natural;
 660 
 661    begin
 662       S (1) := '|';
 663       S (2 .. Feature'Length + 1) := Feature;
 664       L := Feature'Length + 2;
 665 
 666       if No_Run_Time_Mode then
 667          S (L .. L + CNRT'Length - 1) := CNRT;
 668          L := L + CNRT'Length - 1;
 669 
 670       else pragma Assert (Configurable_Run_Time_Mode);
 671          S (L .. L + CCRT'Length - 1) := CCRT;
 672          L := L + CCRT'Length - 1;
 673       end if;
 674 
 675       Error_Msg_N (S (1 .. L), N);
 676       Configurable_Run_Time_Violations := Configurable_Run_Time_Violations + 1;
 677    end Error_Msg_CRT;
 678 
 679    ------------------
 680    -- Error_Msg_PT --
 681    ------------------
 682 
 683    procedure Error_Msg_PT (E : Entity_Id; Iface_Prim : Entity_Id) is
 684    begin
 685       Error_Msg_N
 686         ("illegal overriding of subprogram inherited from interface", E);
 687 
 688       Error_Msg_Sloc := Sloc (Iface_Prim);
 689 
 690       if Ekind (E) = E_Function then
 691          Error_Msg_N
 692            ("\first formal of & declared # must be of mode `IN` "
 693             & "or access-to-constant", E);
 694       else
 695          Error_Msg_N
 696            ("\first formal of & declared # must be of mode `OUT`, `IN OUT` "
 697             & "or access-to-variable", E);
 698       end if;
 699    end Error_Msg_PT;
 700 
 701    -----------------
 702    -- Error_Msg_F --
 703    -----------------
 704 
 705    procedure Error_Msg_F (Msg : String; N : Node_Id) is
 706    begin
 707       Error_Msg_NEL (Msg, N, N, Sloc (First_Node (N)));
 708    end Error_Msg_F;
 709 
 710    ------------------
 711    -- Error_Msg_FE --
 712    ------------------
 713 
 714    procedure Error_Msg_FE
 715      (Msg : String;
 716       N   : Node_Id;
 717       E   : Node_Or_Entity_Id)
 718    is
 719    begin
 720       Error_Msg_NEL (Msg, N, E, Sloc (First_Node (N)));
 721    end Error_Msg_FE;
 722 
 723    ------------------------
 724    -- Error_Msg_Internal --
 725    ------------------------
 726 
 727    procedure Error_Msg_Internal
 728      (Msg      : String;
 729       Sptr     : Source_Ptr;
 730       Optr     : Source_Ptr;
 731       Msg_Cont : Boolean)
 732    is
 733       Next_Msg : Error_Msg_Id;
 734       --  Pointer to next message at insertion point
 735 
 736       Prev_Msg : Error_Msg_Id;
 737       --  Pointer to previous message at insertion point
 738 
 739       Temp_Msg : Error_Msg_Id;
 740 
 741       Warn_Err : Boolean;
 742       --  Set if warning to be treated as error
 743 
 744       procedure Handle_Serious_Error;
 745       --  Internal procedure to do all error message handling for a serious
 746       --  error message, other than bumping the error counts and arranging
 747       --  for the message to be output.
 748 
 749       --------------------------
 750       -- Handle_Serious_Error --
 751       --------------------------
 752 
 753       procedure Handle_Serious_Error is
 754       begin
 755          --  Turn off code generation if not done already
 756 
 757          if Operating_Mode = Generate_Code then
 758             Operating_Mode := Check_Semantics;
 759             Expander_Active := False;
 760          end if;
 761 
 762          --  Set the fatal error flag in the unit table unless we are in
 763          --  Try_Semantics mode (in which case we set ignored mode if not
 764          --  currently set. This stops the semantics from being performed
 765          --  if we find a serious error. This is skipped if we are currently
 766          --  dealing with the configuration pragma file.
 767 
 768          if Current_Source_Unit /= No_Unit then
 769             declare
 770                U : constant Unit_Number_Type := Get_Source_Unit (Sptr);
 771             begin
 772                if Try_Semantics then
 773                   if Fatal_Error (U) = None then
 774                      Set_Fatal_Error (U, Error_Ignored);
 775                   end if;
 776                else
 777                   Set_Fatal_Error (U, Error_Detected);
 778                end if;
 779             end;
 780          end if;
 781       end Handle_Serious_Error;
 782 
 783    --  Start of processing for Error_Msg_Internal
 784 
 785    begin
 786       if Raise_Exception_On_Error /= 0 then
 787          raise Error_Msg_Exception;
 788       end if;
 789 
 790       Continuation := Msg_Cont;
 791       Continuation_New_Line := False;
 792       Suppress_Message := False;
 793       Kill_Message := False;
 794       Set_Msg_Text (Msg, Sptr);
 795 
 796       --  Kill continuation if parent message killed
 797 
 798       if Continuation and Last_Killed then
 799          return;
 800       end if;
 801 
 802       --  Return without doing anything if message is suppressed
 803 
 804       if Suppress_Message
 805         and then not All_Errors_Mode
 806         and then not Is_Warning_Msg
 807         and then not Is_Unconditional_Msg
 808       then
 809          if not Continuation then
 810             Last_Killed := True;
 811          end if;
 812 
 813          return;
 814       end if;
 815 
 816       --  Return without doing anything if message is killed and this is not
 817       --  the first error message. The philosophy is that if we get a weird
 818       --  error message and we already have had a message, then we hope the
 819       --  weird message is a junk cascaded message
 820 
 821       if Kill_Message
 822         and then not All_Errors_Mode
 823         and then Total_Errors_Detected /= 0
 824       then
 825          if not Continuation then
 826             Last_Killed := True;
 827          end if;
 828 
 829          return;
 830       end if;
 831 
 832       --  Special check for warning message to see if it should be output
 833 
 834       if Is_Warning_Msg then
 835 
 836          --  Immediate return if warning message and warnings are suppressed
 837 
 838          if Warnings_Suppressed (Optr) /= No_String
 839               or else
 840             Warnings_Suppressed (Sptr) /= No_String
 841          then
 842             Cur_Msg := No_Error_Msg;
 843             return;
 844          end if;
 845 
 846          --  If the flag location is in the main extended source unit then for
 847          --  sure we want the warning since it definitely belongs
 848 
 849          if In_Extended_Main_Source_Unit (Sptr) then
 850             null;
 851 
 852          --  If the main unit has not been read yet. the warning must be on
 853          --  a configuration file: gnat.adc or user-defined. This means we
 854          --  are not parsing the main unit yet, so skip following checks.
 855 
 856          elsif No (Cunit (Main_Unit)) then
 857             null;
 858 
 859          --  If the flag location is not in the main extended source unit, then
 860          --  we want to eliminate the warning, unless it is in the extended
 861          --  main code unit and we want warnings on the instance.
 862 
 863          elsif In_Extended_Main_Code_Unit (Sptr) and then Warn_On_Instance then
 864             null;
 865 
 866          --  Keep warning if debug flag G set
 867 
 868          elsif Debug_Flag_GG then
 869             null;
 870 
 871          --  Keep warning if message text contains !!
 872 
 873          elsif Has_Double_Exclam then
 874             null;
 875 
 876          --  Here is where we delete a warning from a with'ed unit
 877 
 878          else
 879             Cur_Msg := No_Error_Msg;
 880 
 881             if not Continuation then
 882                Last_Killed := True;
 883             end if;
 884 
 885             return;
 886          end if;
 887       end if;
 888 
 889       --  If message is to be ignored in special ignore message mode, this is
 890       --  where we do this special processing, bypassing message output.
 891 
 892       if Ignore_Errors_Enable > 0 then
 893          if Is_Serious_Error then
 894             Handle_Serious_Error;
 895          end if;
 896 
 897          return;
 898       end if;
 899 
 900       --  If error message line length set, and this is a continuation message
 901       --  then all we do is to append the text to the text of the last message
 902       --  with a comma space separator (eliminating a possible (style) or
 903       --  info prefix).
 904 
 905       if Error_Msg_Line_Length /= 0 and then Continuation then
 906          Cur_Msg := Errors.Last;
 907 
 908          declare
 909             Oldm : String_Ptr := Errors.Table (Cur_Msg).Text;
 910             Newm : String (1 .. Oldm'Last + 2 + Msglen);
 911             Newl : Natural;
 912             M    : Natural;
 913 
 914          begin
 915             --  First copy old message to new one and free it
 916 
 917             Newm (Oldm'Range) := Oldm.all;
 918             Newl := Oldm'Length;
 919             Free (Oldm);
 920 
 921             --  Remove (style) or info: at start of message
 922 
 923             if Msglen > 8 and then Msg_Buffer (1 .. 8) = "(style) " then
 924                M := 9;
 925 
 926             elsif Msglen > 6 and then Msg_Buffer (1 .. 6) = "info: " then
 927                M := 7;
 928 
 929             else
 930                M := 1;
 931             end if;
 932 
 933             --  Now deal with separation between messages. Normally this is
 934             --  simply comma space, but there are some special cases.
 935 
 936             --  If continuation new line, then put actual NL character in msg
 937 
 938             if Continuation_New_Line then
 939                Newl := Newl + 1;
 940                Newm (Newl) := ASCII.LF;
 941 
 942             --  If continuation message is enclosed in parentheses, then
 943             --  special treatment (don't need a comma, and we want to combine
 944             --  successive parenthetical remarks into a single one with
 945             --  separating commas).
 946 
 947             elsif Msg_Buffer (M) = '(' and then Msg_Buffer (Msglen) = ')' then
 948 
 949                --  Case where existing message ends in right paren, remove
 950                --  and separate parenthetical remarks with a comma.
 951 
 952                if Newm (Newl) = ')' then
 953                   Newm (Newl) := ',';
 954                   Msg_Buffer (M) := ' ';
 955 
 956                --  Case where we are adding new parenthetical comment
 957 
 958                else
 959                   Newl := Newl + 1;
 960                   Newm (Newl) := ' ';
 961                end if;
 962 
 963             --  Case where continuation not in parens and no new line
 964 
 965             else
 966                Newm (Newl + 1 .. Newl + 2) := ", ";
 967                Newl := Newl + 2;
 968             end if;
 969 
 970             --  Append new message
 971 
 972             Newm (Newl + 1 .. Newl + Msglen - M + 1) :=
 973               Msg_Buffer (M .. Msglen);
 974             Newl := Newl + Msglen - M + 1;
 975             Errors.Table (Cur_Msg).Text := new String'(Newm (1 .. Newl));
 976 
 977             --  Update warning msg flag and message doc char if needed
 978 
 979             if Is_Warning_Msg then
 980                if not Errors.Table (Cur_Msg).Warn then
 981                   Errors.Table (Cur_Msg).Warn := True;
 982                   Errors.Table (Cur_Msg).Warn_Chr := Warning_Msg_Char;
 983 
 984                elsif Warning_Msg_Char /= ' ' then
 985                   Errors.Table (Cur_Msg).Warn_Chr := Warning_Msg_Char;
 986                end if;
 987             end if;
 988          end;
 989 
 990          return;
 991       end if;
 992 
 993       --  Here we build a new error object
 994 
 995       Errors.Append
 996         ((Text     => new String'(Msg_Buffer (1 .. Msglen)),
 997           Next     => No_Error_Msg,
 998           Prev     => No_Error_Msg,
 999           Sptr     => Sptr,
1000           Optr     => Optr,
1001           Sfile    => Get_Source_File_Index (Sptr),
1002           Line     => Get_Physical_Line_Number (Sptr),
1003           Col      => Get_Column_Number (Sptr),
1004           Warn     => Is_Warning_Msg,
1005           Info     => Is_Info_Msg,
1006           Check    => Is_Check_Msg,
1007           Warn_Err => False, -- reset below
1008           Warn_Chr => Warning_Msg_Char,
1009           Style    => Is_Style_Msg,
1010           Serious  => Is_Serious_Error,
1011           Uncond   => Is_Unconditional_Msg,
1012           Msg_Cont => Continuation,
1013           Deleted  => False));
1014       Cur_Msg := Errors.Last;
1015 
1016       --  Test if warning to be treated as error
1017 
1018       Warn_Err :=
1019         Is_Warning_Msg
1020           and then (Warning_Treated_As_Error (Msg_Buffer (1 .. Msglen))
1021                       or else
1022                     Warning_Treated_As_Error (Get_Warning_Tag (Cur_Msg)));
1023 
1024       --  Propagate Warn_Err to this message and preceding continuations
1025 
1026       for J in reverse 1 .. Errors.Last loop
1027          Errors.Table (J).Warn_Err := Warn_Err;
1028          exit when not Errors.Table (J).Msg_Cont;
1029       end loop;
1030 
1031       --  If immediate errors mode set, output error message now. Also output
1032       --  now if the -d1 debug flag is set (so node number message comes out
1033       --  just before actual error message)
1034 
1035       if Debug_Flag_OO or else Debug_Flag_1 then
1036          Write_Eol;
1037          Output_Source_Line
1038            (Errors.Table (Cur_Msg).Line, Errors.Table (Cur_Msg).Sfile, True);
1039          Temp_Msg := Cur_Msg;
1040          Output_Error_Msgs (Temp_Msg);
1041 
1042       --  If not in immediate errors mode, then we insert the message in the
1043       --  error chain for later output by Finalize. The messages are sorted
1044       --  first by unit (main unit comes first), and within a unit by source
1045       --  location (earlier flag location first in the chain).
1046 
1047       else
1048          --  First a quick check, does this belong at the very end of the chain
1049          --  of error messages. This saves a lot of time in the normal case if
1050          --  there are lots of messages.
1051 
1052          if Last_Error_Msg /= No_Error_Msg
1053            and then Errors.Table (Cur_Msg).Sfile =
1054                     Errors.Table (Last_Error_Msg).Sfile
1055            and then (Sptr > Errors.Table (Last_Error_Msg).Sptr
1056                        or else
1057                           (Sptr = Errors.Table (Last_Error_Msg).Sptr
1058                              and then
1059                                Optr > Errors.Table (Last_Error_Msg).Optr))
1060          then
1061             Prev_Msg := Last_Error_Msg;
1062             Next_Msg := No_Error_Msg;
1063 
1064          --  Otherwise do a full sequential search for the insertion point
1065 
1066          else
1067             Prev_Msg := No_Error_Msg;
1068             Next_Msg := First_Error_Msg;
1069             while Next_Msg /= No_Error_Msg loop
1070                exit when
1071                  Errors.Table (Cur_Msg).Sfile < Errors.Table (Next_Msg).Sfile;
1072 
1073                if Errors.Table (Cur_Msg).Sfile = Errors.Table (Next_Msg).Sfile
1074                then
1075                   exit when Sptr < Errors.Table (Next_Msg).Sptr
1076                     or else (Sptr = Errors.Table (Next_Msg).Sptr
1077                               and then Optr < Errors.Table (Next_Msg).Optr);
1078                end if;
1079 
1080                Prev_Msg := Next_Msg;
1081                Next_Msg := Errors.Table (Next_Msg).Next;
1082             end loop;
1083          end if;
1084 
1085          --  Now we insert the new message in the error chain.
1086 
1087          --  The possible insertion point for the new message is after Prev_Msg
1088          --  and before Next_Msg. However, this is where we do a special check
1089          --  for redundant parsing messages, defined as messages posted on the
1090          --  same line. The idea here is that probably such messages are junk
1091          --  from the parser recovering. In full errors mode, we don't do this
1092          --  deletion, but otherwise such messages are discarded at this stage.
1093 
1094          if Prev_Msg /= No_Error_Msg
1095            and then Errors.Table (Prev_Msg).Line =
1096                                              Errors.Table (Cur_Msg).Line
1097            and then Errors.Table (Prev_Msg).Sfile =
1098                                              Errors.Table (Cur_Msg).Sfile
1099            and then Compiler_State = Parsing
1100            and then not All_Errors_Mode
1101          then
1102             --  Don't delete unconditional messages and at this stage, don't
1103             --  delete continuation lines; we attempted to delete those earlier
1104             --  if the parent message was deleted.
1105 
1106             if not Errors.Table (Cur_Msg).Uncond
1107               and then not Continuation
1108             then
1109                --  Don't delete if prev msg is warning and new msg is an error.
1110                --  This is because we don't want a real error masked by a
1111                --  warning. In all other cases (that is parse errors for the
1112                --  same line that are not unconditional) we do delete the
1113                --  message. This helps to avoid junk extra messages from
1114                --  cascaded parsing errors
1115 
1116                if not (Errors.Table (Prev_Msg).Warn
1117                          or else
1118                        Errors.Table (Prev_Msg).Style)
1119                  or else
1120                       (Errors.Table (Cur_Msg).Warn
1121                          or else
1122                        Errors.Table (Cur_Msg).Style)
1123                then
1124                   --  All tests passed, delete the message by simply returning
1125                   --  without any further processing.
1126 
1127                   pragma Assert (not Continuation);
1128 
1129                   Last_Killed := True;
1130                   return;
1131                end if;
1132             end if;
1133          end if;
1134 
1135          --  Come here if message is to be inserted in the error chain
1136 
1137          if not Continuation then
1138             Last_Killed := False;
1139          end if;
1140 
1141          if Prev_Msg = No_Error_Msg then
1142             First_Error_Msg := Cur_Msg;
1143          else
1144             Errors.Table (Prev_Msg).Next := Cur_Msg;
1145          end if;
1146 
1147          Errors.Table (Cur_Msg).Next := Next_Msg;
1148 
1149          if Next_Msg = No_Error_Msg then
1150             Last_Error_Msg := Cur_Msg;
1151          end if;
1152       end if;
1153 
1154       --  Bump appropriate statistics counts
1155 
1156       if Errors.Table (Cur_Msg).Info then
1157          Info_Messages := Info_Messages + 1;
1158 
1159          --  Could be (usually is) both "info" and "warning"
1160 
1161          if Errors.Table (Cur_Msg).Warn then
1162             Warnings_Detected := Warnings_Detected + 1;
1163          end if;
1164 
1165       elsif Errors.Table (Cur_Msg).Warn
1166         or else Errors.Table (Cur_Msg).Style
1167       then
1168          Warnings_Detected := Warnings_Detected + 1;
1169 
1170       elsif Errors.Table (Cur_Msg).Check then
1171          Check_Messages := Check_Messages + 1;
1172 
1173       else
1174          Total_Errors_Detected := Total_Errors_Detected + 1;
1175 
1176          if Errors.Table (Cur_Msg).Serious then
1177             Serious_Errors_Detected := Serious_Errors_Detected + 1;
1178             Handle_Serious_Error;
1179 
1180          --  If not serious error, set Fatal_Error to indicate ignored error
1181 
1182          else
1183             declare
1184                U : constant Unit_Number_Type := Get_Source_Unit (Sptr);
1185             begin
1186                if Fatal_Error (U) = None then
1187                   Set_Fatal_Error (U, Error_Ignored);
1188                end if;
1189             end;
1190          end if;
1191       end if;
1192 
1193       --  Record warning message issued
1194 
1195       if Errors.Table (Cur_Msg).Warn
1196         and then not Errors.Table (Cur_Msg).Msg_Cont
1197       then
1198          Warning_Msg := Cur_Msg;
1199       end if;
1200 
1201       --  If too many warnings turn off warnings
1202 
1203       if Maximum_Messages /= 0 then
1204          if Warnings_Detected = Maximum_Messages then
1205             Warning_Mode := Suppress;
1206          end if;
1207 
1208          --  If too many errors abandon compilation
1209 
1210          if Total_Errors_Detected = Maximum_Messages then
1211             raise Unrecoverable_Error;
1212          end if;
1213       end if;
1214    end Error_Msg_Internal;
1215 
1216    -----------------
1217    -- Error_Msg_N --
1218    -----------------
1219 
1220    procedure Error_Msg_N (Msg : String; N : Node_Or_Entity_Id) is
1221    begin
1222       Error_Msg_NEL (Msg, N, N, Sloc (N));
1223    end Error_Msg_N;
1224 
1225    ------------------
1226    -- Error_Msg_NE --
1227    ------------------
1228 
1229    procedure Error_Msg_NE
1230      (Msg : String;
1231       N   : Node_Or_Entity_Id;
1232       E   : Node_Or_Entity_Id)
1233    is
1234    begin
1235       Error_Msg_NEL (Msg, N, E, Sloc (N));
1236    end Error_Msg_NE;
1237 
1238    -------------------
1239    -- Error_Msg_NEL --
1240    -------------------
1241 
1242    procedure Error_Msg_NEL
1243      (Msg           : String;
1244       N             : Node_Or_Entity_Id;
1245       E             : Node_Or_Entity_Id;
1246       Flag_Location : Source_Ptr)
1247    is
1248    begin
1249       if Special_Msg_Delete (Msg, N, E) then
1250          return;
1251       end if;
1252 
1253       Prescan_Message (Msg);
1254 
1255       --  Special handling for warning messages
1256 
1257       if Is_Warning_Msg then
1258 
1259          --  Suppress if no warnings set for either entity or node
1260 
1261          if No_Warnings (N) or else No_Warnings (E) then
1262 
1263             --  Disable any continuation messages as well
1264 
1265             Last_Killed := True;
1266             return;
1267          end if;
1268 
1269          --  Suppress if inside loop that is known to be null or is probably
1270          --  null (case where loop executes only if invalid values present).
1271          --  In either case warnings in the loop are likely to be junk.
1272 
1273          declare
1274             P : Node_Id;
1275 
1276          begin
1277             P := Parent (N);
1278             while Present (P) loop
1279                if Nkind (P) = N_Loop_Statement
1280                  and then Suppress_Loop_Warnings (P)
1281                then
1282                   return;
1283                end if;
1284 
1285                P := Parent (P);
1286             end loop;
1287          end;
1288       end if;
1289 
1290       --  Test for message to be output
1291 
1292       if All_Errors_Mode
1293         or else Is_Unconditional_Msg
1294         or else Is_Warning_Msg
1295         or else OK_Node (N)
1296         or else (Msg (Msg'First) = '\' and then not Last_Killed)
1297       then
1298          Debug_Output (N);
1299          Error_Msg_Node_1 := E;
1300          Error_Msg (Msg, Flag_Location);
1301 
1302       else
1303          Last_Killed := True;
1304       end if;
1305 
1306       Set_Posted (N);
1307    end Error_Msg_NEL;
1308 
1309    ------------------
1310    -- Error_Msg_NW --
1311    ------------------
1312 
1313    procedure Error_Msg_NW
1314      (Eflag : Boolean;
1315       Msg   : String;
1316       N     : Node_Or_Entity_Id)
1317    is
1318    begin
1319       if Eflag
1320         and then In_Extended_Main_Source_Unit (N)
1321         and then Comes_From_Source (N)
1322       then
1323          Error_Msg_NEL (Msg, N, N, Sloc (N));
1324       end if;
1325    end Error_Msg_NW;
1326 
1327    -----------------
1328    -- Error_Msg_S --
1329    -----------------
1330 
1331    procedure Error_Msg_S (Msg : String) is
1332    begin
1333       Error_Msg (Msg, Scan_Ptr);
1334    end Error_Msg_S;
1335 
1336    ------------------
1337    -- Error_Msg_SC --
1338    ------------------
1339 
1340    procedure Error_Msg_SC (Msg : String) is
1341    begin
1342       --  If we are at end of file, post the flag after the previous token
1343 
1344       if Token = Tok_EOF then
1345          Error_Msg_AP (Msg);
1346 
1347       --  For all other cases the message is posted at the current token
1348       --  pointer position
1349 
1350       else
1351          Error_Msg (Msg, Token_Ptr);
1352       end if;
1353    end Error_Msg_SC;
1354 
1355    ------------------
1356    -- Error_Msg_SP --
1357    ------------------
1358 
1359    procedure Error_Msg_SP (Msg : String) is
1360    begin
1361       --  Note: in the case where there is no previous token, Prev_Token_Ptr
1362       --  is set to Source_First, which is a reasonable position for the
1363       --  error flag in this situation
1364 
1365       Error_Msg (Msg, Prev_Token_Ptr);
1366    end Error_Msg_SP;
1367 
1368    --------------
1369    -- Finalize --
1370    --------------
1371 
1372    procedure Finalize (Last_Call : Boolean) is
1373       Cur : Error_Msg_Id;
1374       Nxt : Error_Msg_Id;
1375       F   : Error_Msg_Id;
1376 
1377       procedure Delete_Warning (E : Error_Msg_Id);
1378       --  Delete a warning msg if not already deleted and adjust warning count
1379 
1380       --------------------
1381       -- Delete_Warning --
1382       --------------------
1383 
1384       procedure Delete_Warning (E : Error_Msg_Id) is
1385       begin
1386          if not Errors.Table (E).Deleted then
1387             Errors.Table (E).Deleted := True;
1388             Warnings_Detected := Warnings_Detected - 1;
1389 
1390             if Errors.Table (E).Info then
1391                Info_Messages := Info_Messages - 1;
1392             end if;
1393 
1394             if Errors.Table (E).Warn_Err then
1395                Warnings_Treated_As_Errors := Warnings_Treated_As_Errors - 1;
1396             end if;
1397          end if;
1398       end Delete_Warning;
1399 
1400    --  Start of processing for Finalize
1401 
1402    begin
1403       --  Set Prev pointers
1404 
1405       Cur := First_Error_Msg;
1406       while Cur /= No_Error_Msg loop
1407          Nxt := Errors.Table (Cur).Next;
1408          exit when Nxt = No_Error_Msg;
1409          Errors.Table (Nxt).Prev := Cur;
1410          Cur := Nxt;
1411       end loop;
1412 
1413       --  Eliminate any duplicated error messages from the list. This is
1414       --  done after the fact to avoid problems with Change_Error_Text.
1415 
1416       Cur := First_Error_Msg;
1417       while Cur /= No_Error_Msg loop
1418          Nxt := Errors.Table (Cur).Next;
1419 
1420          F := Nxt;
1421          while F /= No_Error_Msg
1422            and then Errors.Table (F).Sptr = Errors.Table (Cur).Sptr
1423          loop
1424             Check_Duplicate_Message (Cur, F);
1425             F := Errors.Table (F).Next;
1426          end loop;
1427 
1428          Cur := Nxt;
1429       end loop;
1430 
1431       --  Mark any messages suppressed by specific warnings as Deleted
1432 
1433       Cur := First_Error_Msg;
1434       while Cur /= No_Error_Msg loop
1435          declare
1436             CE  : Error_Msg_Object renames Errors.Table (Cur);
1437             Tag : constant String := Get_Warning_Tag (Cur);
1438 
1439          begin
1440             if (CE.Warn and not CE.Deleted)
1441               and then
1442                    (Warning_Specifically_Suppressed (CE.Sptr, CE.Text, Tag) /=
1443                                                                    No_String
1444                       or else
1445                     Warning_Specifically_Suppressed (CE.Optr, CE.Text, Tag) /=
1446                                                                    No_String)
1447             then
1448                Delete_Warning (Cur);
1449 
1450                --  If this is a continuation, delete previous parts of message
1451 
1452                F := Cur;
1453                while Errors.Table (F).Msg_Cont loop
1454                   F := Errors.Table (F).Prev;
1455                   exit when F = No_Error_Msg;
1456                   Delete_Warning (F);
1457                end loop;
1458 
1459                --  Delete any following continuations
1460 
1461                F := Cur;
1462                loop
1463                   F := Errors.Table (F).Next;
1464                   exit when F = No_Error_Msg;
1465                   exit when not Errors.Table (F).Msg_Cont;
1466                   Delete_Warning (F);
1467                end loop;
1468             end if;
1469          end;
1470 
1471          Cur := Errors.Table (Cur).Next;
1472       end loop;
1473 
1474       Finalize_Called := True;
1475 
1476       --  Check consistency of specific warnings (may add warnings). We only
1477       --  do this on the last call, after all possible warnings are posted.
1478 
1479       if Last_Call then
1480          Validate_Specific_Warnings (Error_Msg'Access);
1481       end if;
1482    end Finalize;
1483 
1484    ----------------
1485    -- First_Node --
1486    ----------------
1487 
1488    function First_Node (C : Node_Id) return Node_Id is
1489       Orig     : constant Node_Id           := Original_Node (C);
1490       Loc      : constant Source_Ptr        := Sloc (Orig);
1491       Sfile    : constant Source_File_Index := Get_Source_File_Index (Loc);
1492       Earliest : Node_Id;
1493       Eloc     : Source_Ptr;
1494 
1495       function Test_Earlier (N : Node_Id) return Traverse_Result;
1496       --  Function applied to every node in the construct
1497 
1498       procedure Search_Tree_First is new Traverse_Proc (Test_Earlier);
1499       --  Create traversal procedure
1500 
1501       ------------------
1502       -- Test_Earlier --
1503       ------------------
1504 
1505       function Test_Earlier (N : Node_Id) return Traverse_Result is
1506          Norig : constant Node_Id    := Original_Node (N);
1507          Loc   : constant Source_Ptr := Sloc (Norig);
1508 
1509       begin
1510          --  Check for earlier
1511 
1512          if Loc < Eloc
1513 
1514            --  Ignore nodes with no useful location information
1515 
1516            and then Loc /= Standard_Location
1517            and then Loc /= No_Location
1518 
1519            --  Ignore nodes from a different file. This ensures against cases
1520            --  of strange foreign code somehow being present. We don't want
1521            --  wild placement of messages if that happens.
1522 
1523            and then Get_Source_File_Index (Loc) = Sfile
1524          then
1525             Earliest := Norig;
1526             Eloc     := Loc;
1527          end if;
1528 
1529          return OK_Orig;
1530       end Test_Earlier;
1531 
1532    --  Start of processing for First_Node
1533 
1534    begin
1535       if Nkind (Orig) in N_Subexpr then
1536          Earliest := Orig;
1537          Eloc := Loc;
1538          Search_Tree_First (Orig);
1539          return Earliest;
1540 
1541       else
1542          return Orig;
1543       end if;
1544    end First_Node;
1545 
1546    ----------------
1547    -- First_Sloc --
1548    ----------------
1549 
1550    function First_Sloc (N : Node_Id) return Source_Ptr is
1551       SI : constant Source_File_Index := Source_Index (Get_Source_Unit (N));
1552       SF : constant Source_Ptr        := Source_First (SI);
1553       F  : Node_Id;
1554       S  : Source_Ptr;
1555 
1556    begin
1557       F := First_Node (N);
1558       S := Sloc (F);
1559 
1560       --  The following circuit is a bit subtle. When we have parenthesized
1561       --  expressions, then the Sloc will not record the location of the paren,
1562       --  but we would like to post the flag on the paren. So what we do is to
1563       --  crawl up the tree from the First_Node, adjusting the Sloc value for
1564       --  any parentheses we know are present. Yes, we know this circuit is not
1565       --  100% reliable (e.g. because we don't record all possible paren level
1566       --  values), but this is only for an error message so it is good enough.
1567 
1568       Node_Loop : loop
1569          Paren_Loop : for J in 1 .. Paren_Count (F) loop
1570 
1571             --  We don't look more than 12 characters behind the current
1572             --  location, and in any case not past the front of the source.
1573 
1574             Search_Loop : for K in 1 .. 12 loop
1575                exit Search_Loop when S = SF;
1576 
1577                if Source_Text (SI) (S - 1) = '(' then
1578                   S := S - 1;
1579                   exit Search_Loop;
1580 
1581                elsif Source_Text (SI) (S - 1) <= ' ' then
1582                   S := S - 1;
1583 
1584                else
1585                   exit Search_Loop;
1586                end if;
1587             end loop Search_Loop;
1588          end loop Paren_Loop;
1589 
1590          exit Node_Loop when F = N;
1591          F := Parent (F);
1592          exit Node_Loop when Nkind (F) not in N_Subexpr;
1593       end loop Node_Loop;
1594 
1595       return S;
1596    end First_Sloc;
1597 
1598    -----------------------
1599    -- Get_Ignore_Errors --
1600    -----------------------
1601 
1602    function Get_Ignore_Errors return Boolean is
1603    begin
1604       return Errors_Must_Be_Ignored;
1605    end Get_Ignore_Errors;
1606 
1607    ----------------
1608    -- Initialize --
1609    ----------------
1610 
1611    procedure Initialize is
1612    begin
1613       Errors.Init;
1614       First_Error_Msg := No_Error_Msg;
1615       Last_Error_Msg := No_Error_Msg;
1616       Serious_Errors_Detected := 0;
1617       Total_Errors_Detected := 0;
1618       Warnings_Treated_As_Errors := 0;
1619       Warnings_Detected := 0;
1620       Info_Messages := 0;
1621       Warnings_As_Errors_Count := 0;
1622       Cur_Msg := No_Error_Msg;
1623       List_Pragmas.Init;
1624 
1625       --  Initialize warnings tables
1626 
1627       Warnings.Init;
1628       Specific_Warnings.Init;
1629    end Initialize;
1630 
1631    -----------------
1632    -- No_Warnings --
1633    -----------------
1634 
1635    function No_Warnings (N : Node_Or_Entity_Id) return Boolean is
1636    begin
1637       if Error_Posted (N) then
1638          return True;
1639 
1640       elsif Nkind (N) in N_Entity and then Has_Warnings_Off (N) then
1641          return True;
1642 
1643       elsif Is_Entity_Name (N)
1644         and then Present (Entity (N))
1645         and then Has_Warnings_Off (Entity (N))
1646       then
1647          return True;
1648 
1649       else
1650          return False;
1651       end if;
1652    end No_Warnings;
1653 
1654    -------------
1655    -- OK_Node --
1656    -------------
1657 
1658    function OK_Node (N : Node_Id) return Boolean is
1659       K : constant Node_Kind := Nkind (N);
1660 
1661    begin
1662       if Error_Posted (N) then
1663          return False;
1664 
1665       elsif K in N_Has_Etype
1666         and then Present (Etype (N))
1667         and then Error_Posted (Etype (N))
1668       then
1669          return False;
1670 
1671       elsif (K in N_Op
1672               or else K = N_Attribute_Reference
1673               or else K = N_Character_Literal
1674               or else K = N_Expanded_Name
1675               or else K = N_Identifier
1676               or else K = N_Operator_Symbol)
1677         and then Present (Entity (N))
1678         and then Error_Posted (Entity (N))
1679       then
1680          return False;
1681       else
1682          return True;
1683       end if;
1684    end OK_Node;
1685 
1686    ---------------------
1687    -- Output_Messages --
1688    ---------------------
1689 
1690    procedure Output_Messages is
1691       E        : Error_Msg_Id;
1692       Err_Flag : Boolean;
1693 
1694       procedure Write_Error_Summary;
1695       --  Write error summary
1696 
1697       procedure Write_Header (Sfile : Source_File_Index);
1698       --  Write header line (compiling or checking given file)
1699 
1700       procedure Write_Max_Errors;
1701       --  Write message if max errors reached
1702 
1703       -------------------------
1704       -- Write_Error_Summary --
1705       -------------------------
1706 
1707       procedure Write_Error_Summary is
1708       begin
1709          --  Extra blank line if error messages or source listing were output
1710 
1711          if Total_Errors_Detected + Warnings_Detected > 0 or else Full_List
1712          then
1713             Write_Eol;
1714          end if;
1715 
1716          --  Message giving number of lines read and number of errors detected.
1717          --  This normally goes to Standard_Output. The exception is when brief
1718          --  mode is not set, verbose mode (or full list mode) is set, and
1719          --  there are errors. In this case we send the message to standard
1720          --  error to make sure that *something* appears on standard error
1721          --  in an error situation.
1722 
1723          if Total_Errors_Detected + Warnings_Detected /= 0
1724            and then not Brief_Output
1725            and then (Verbose_Mode or Full_List)
1726          then
1727             Set_Standard_Error;
1728          end if;
1729 
1730          --  Message giving total number of lines. Don't give this message if
1731          --  the Main_Source line is unknown (this happens in error situations,
1732          --  e.g. when integrated preprocessing fails).
1733 
1734          if Main_Source_File /= No_Source_File then
1735             Write_Str (" ");
1736             Write_Int (Num_Source_Lines (Main_Source_File));
1737 
1738             if Num_Source_Lines (Main_Source_File) = 1 then
1739                Write_Str (" line: ");
1740             else
1741                Write_Str (" lines: ");
1742             end if;
1743          end if;
1744 
1745          if Total_Errors_Detected = 0 then
1746             Write_Str ("No errors");
1747 
1748          elsif Total_Errors_Detected = 1 then
1749             Write_Str ("1 error");
1750 
1751          else
1752             Write_Int (Total_Errors_Detected);
1753             Write_Str (" errors");
1754          end if;
1755 
1756          if Warnings_Detected - Info_Messages /= 0 then
1757             Write_Str (", ");
1758             Write_Int (Warnings_Detected);
1759             Write_Str (" warning");
1760 
1761             if Warnings_Detected - Info_Messages /= 1 then
1762                Write_Char ('s');
1763             end if;
1764 
1765             if Warning_Mode = Treat_As_Error then
1766                Write_Str (" (treated as error");
1767 
1768                if Warnings_Detected /= 1 then
1769                   Write_Char ('s');
1770                end if;
1771 
1772                Write_Char (')');
1773 
1774             elsif Warnings_Treated_As_Errors /= 0 then
1775                Write_Str (" (");
1776                Write_Int (Warnings_Treated_As_Errors);
1777                Write_Str (" treated as errors)");
1778             end if;
1779          end if;
1780 
1781          if Info_Messages /= 0 then
1782             Write_Str (", ");
1783             Write_Int (Info_Messages);
1784             Write_Str (" info message");
1785 
1786             if Info_Messages > 1 then
1787                Write_Char ('s');
1788             end if;
1789          end if;
1790 
1791          Write_Eol;
1792          Set_Standard_Output;
1793       end Write_Error_Summary;
1794 
1795       ------------------
1796       -- Write_Header --
1797       ------------------
1798 
1799       procedure Write_Header (Sfile : Source_File_Index) is
1800       begin
1801          if Verbose_Mode or Full_List then
1802             if Original_Operating_Mode = Generate_Code then
1803                Write_Str ("Compiling: ");
1804             else
1805                Write_Str ("Checking: ");
1806             end if;
1807 
1808             Write_Name (Full_File_Name (Sfile));
1809 
1810             if not Debug_Flag_7 then
1811                Write_Eol;
1812                Write_Str ("Source file time stamp: ");
1813                Write_Time_Stamp (Sfile);
1814                Write_Eol;
1815                Write_Str ("Compiled at: " & Compilation_Time);
1816             end if;
1817 
1818             Write_Eol;
1819          end if;
1820       end Write_Header;
1821 
1822       ----------------------
1823       -- Write_Max_Errors --
1824       ----------------------
1825 
1826       procedure Write_Max_Errors is
1827       begin
1828          if Maximum_Messages /= 0 then
1829             if Warnings_Detected >= Maximum_Messages then
1830                Set_Standard_Error;
1831                Write_Line ("maximum number of warnings output");
1832                Write_Line ("any further warnings suppressed");
1833                Set_Standard_Output;
1834             end if;
1835 
1836             --  If too many errors print message
1837 
1838             if Total_Errors_Detected >= Maximum_Messages then
1839                Set_Standard_Error;
1840                Write_Line ("fatal error: maximum number of errors detected");
1841                Set_Standard_Output;
1842             end if;
1843          end if;
1844       end Write_Max_Errors;
1845 
1846    --  Start of processing for Output_Messages
1847 
1848    begin
1849       --  Error if Finalize has not been called
1850 
1851       if not Finalize_Called then
1852          raise Program_Error;
1853       end if;
1854 
1855       --  Reset current error source file if the main unit has a pragma
1856       --  Source_Reference. This ensures outputting the proper name of
1857       --  the source file in this situation.
1858 
1859       if Main_Source_File = No_Source_File
1860         or else Num_SRef_Pragmas (Main_Source_File) /= 0
1861       then
1862          Current_Error_Source_File := No_Source_File;
1863       end if;
1864 
1865       --  Brief Error mode
1866 
1867       if Brief_Output or (not Full_List and not Verbose_Mode) then
1868          Set_Standard_Error;
1869 
1870          E := First_Error_Msg;
1871          while E /= No_Error_Msg loop
1872             if not Errors.Table (E).Deleted and then not Debug_Flag_KK then
1873                if Full_Path_Name_For_Brief_Errors then
1874                   Write_Name (Full_Ref_Name (Errors.Table (E).Sfile));
1875                else
1876                   Write_Name (Reference_Name (Errors.Table (E).Sfile));
1877                end if;
1878 
1879                Write_Char (':');
1880                Write_Int (Int (Physical_To_Logical
1881                                 (Errors.Table (E).Line,
1882                                  Errors.Table (E).Sfile)));
1883                Write_Char (':');
1884 
1885                if Errors.Table (E).Col < 10 then
1886                   Write_Char ('0');
1887                end if;
1888 
1889                Write_Int (Int (Errors.Table (E).Col));
1890                Write_Str (": ");
1891                Output_Msg_Text (E);
1892                Write_Eol;
1893             end if;
1894 
1895             E := Errors.Table (E).Next;
1896          end loop;
1897 
1898          Set_Standard_Output;
1899       end if;
1900 
1901       --  Full source listing case
1902 
1903       if Full_List then
1904          List_Pragmas_Index := 1;
1905          List_Pragmas_Mode := True;
1906          E := First_Error_Msg;
1907 
1908          --  Normal case, to stdout (copyright notice already output)
1909 
1910          if Full_List_File_Name = null then
1911             if not Debug_Flag_7 then
1912                Write_Eol;
1913             end if;
1914 
1915          --  Output to file
1916 
1917          else
1918             Create_List_File_Access.all (Full_List_File_Name.all);
1919             Set_Special_Output (Write_List_Info_Access.all'Access);
1920 
1921             --  Write copyright notice to file
1922 
1923             if not Debug_Flag_7 then
1924                Write_Str ("GNAT ");
1925                Write_Str (Gnat_Version_String);
1926                Write_Eol;
1927                Write_Str ("Copyright 1992-" &
1928                           Current_Year &
1929                           ", Free Software Foundation, Inc.");
1930                Write_Eol;
1931             end if;
1932          end if;
1933 
1934          --  First list extended main source file units with errors
1935 
1936          for U in Main_Unit .. Last_Unit loop
1937             if In_Extended_Main_Source_Unit (Cunit_Entity (U))
1938 
1939               --  If debug flag d.m is set, only the main source is listed
1940 
1941               and then (U = Main_Unit or else not Debug_Flag_Dot_M)
1942 
1943               --  If the unit of the entity does not come from source, it is
1944               --  an implicit subprogram declaration for a child subprogram.
1945               --  Do not emit errors for it, they are listed with the body.
1946 
1947               and then
1948                 (No (Cunit_Entity (U))
1949                   or else Comes_From_Source (Cunit_Entity (U))
1950                   or else not Is_Subprogram (Cunit_Entity (U)))
1951 
1952               --  If the compilation unit associated with this unit does not
1953               --  come from source, it means it is an instantiation that should
1954               --  not be included in the source listing.
1955 
1956               and then Comes_From_Source (Cunit (U))
1957             then
1958                declare
1959                   Sfile : constant Source_File_Index := Source_Index (U);
1960 
1961                begin
1962                   Write_Eol;
1963 
1964                   --  Only write the header if Sfile is known
1965 
1966                   if Sfile /= No_Source_File then
1967                      Write_Header (Sfile);
1968                      Write_Eol;
1969                   end if;
1970 
1971                   --  Normally, we don't want an "error messages from file"
1972                   --  message when listing the entire file, so we set the
1973                   --  current source file as the current error source file.
1974                   --  However, the old style of doing things was to list this
1975                   --  message if pragma Source_Reference is present, even for
1976                   --  the main unit. Since the purpose of the -gnatd.m switch
1977                   --  is to duplicate the old behavior, we skip the reset if
1978                   --  this debug flag is set.
1979 
1980                   if not Debug_Flag_Dot_M then
1981                      Current_Error_Source_File := Sfile;
1982                   end if;
1983 
1984                   --  Only output the listing if Sfile is known, to avoid
1985                   --  crashing the compiler.
1986 
1987                   if Sfile /= No_Source_File then
1988                      for N in 1 .. Last_Source_Line (Sfile) loop
1989                         while E /= No_Error_Msg
1990                           and then Errors.Table (E).Deleted
1991                         loop
1992                            E := Errors.Table (E).Next;
1993                         end loop;
1994 
1995                         Err_Flag :=
1996                           E /= No_Error_Msg
1997                             and then Errors.Table (E).Line = N
1998                             and then Errors.Table (E).Sfile = Sfile;
1999 
2000                         Output_Source_Line (N, Sfile, Err_Flag);
2001 
2002                         if Err_Flag then
2003                            Output_Error_Msgs (E);
2004 
2005                            if not Debug_Flag_2 then
2006                               Write_Eol;
2007                            end if;
2008                         end if;
2009                      end loop;
2010                   end if;
2011                end;
2012             end if;
2013          end loop;
2014 
2015          --  Then output errors, if any, for subsidiary units not in the
2016          --  main extended unit.
2017 
2018          --  Note: if debug flag d.m set, include errors for any units other
2019          --  than the main unit in the extended source unit (e.g. spec and
2020          --  subunits for a body).
2021 
2022          while E /= No_Error_Msg
2023            and then (not In_Extended_Main_Source_Unit (Errors.Table (E).Sptr)
2024                        or else
2025                         (Debug_Flag_Dot_M
2026                           and then Get_Source_Unit
2027                                      (Errors.Table (E).Sptr) /= Main_Unit))
2028          loop
2029             if Errors.Table (E).Deleted then
2030                E := Errors.Table (E).Next;
2031 
2032             else
2033                Write_Eol;
2034                Output_Source_Line
2035                  (Errors.Table (E).Line, Errors.Table (E).Sfile, True);
2036                Output_Error_Msgs (E);
2037             end if;
2038          end loop;
2039 
2040          --  If output to file, write extra copy of error summary to the
2041          --  output file, and then close it.
2042 
2043          if Full_List_File_Name /= null then
2044             Write_Error_Summary;
2045             Write_Max_Errors;
2046             Close_List_File_Access.all;
2047             Cancel_Special_Output;
2048          end if;
2049       end if;
2050 
2051       --  Verbose mode (error lines only with error flags). Normally this is
2052       --  ignored in full list mode, unless we are listing to a file, in which
2053       --  case we still generate -gnatv output to standard output.
2054 
2055       if Verbose_Mode
2056         and then (not Full_List or else Full_List_File_Name /= null)
2057       then
2058          Write_Eol;
2059 
2060          --  Output the header only when Main_Source_File is known
2061 
2062          if Main_Source_File /= No_Source_File then
2063             Write_Header (Main_Source_File);
2064          end if;
2065 
2066          E := First_Error_Msg;
2067 
2068          --  Loop through error lines
2069 
2070          while E /= No_Error_Msg loop
2071             if Errors.Table (E).Deleted then
2072                E := Errors.Table (E).Next;
2073             else
2074                Write_Eol;
2075                Output_Source_Line
2076                  (Errors.Table (E).Line, Errors.Table (E).Sfile, True);
2077                Output_Error_Msgs (E);
2078             end if;
2079          end loop;
2080       end if;
2081 
2082       --  Output error summary if verbose or full list mode
2083 
2084       if Verbose_Mode or else Full_List then
2085          Write_Error_Summary;
2086       end if;
2087 
2088       Write_Max_Errors;
2089 
2090       if Warning_Mode = Treat_As_Error then
2091          Total_Errors_Detected :=
2092            Total_Errors_Detected + Warnings_Detected - Info_Messages;
2093          Warnings_Detected := Info_Messages;
2094       end if;
2095    end Output_Messages;
2096 
2097    ------------------------
2098    -- Output_Source_Line --
2099    ------------------------
2100 
2101    procedure Output_Source_Line
2102      (L     : Physical_Line_Number;
2103       Sfile : Source_File_Index;
2104       Errs  : Boolean)
2105    is
2106       S : Source_Ptr;
2107       C : Character;
2108 
2109       Line_Number_Output : Boolean := False;
2110       --  Set True once line number is output
2111 
2112       Empty_Line : Boolean := True;
2113       --  Set False if line includes at least one character
2114 
2115    begin
2116       if Sfile /= Current_Error_Source_File then
2117          Write_Str ("==============Error messages for ");
2118 
2119          case Sinput.File_Type (Sfile) is
2120             when Sinput.Src =>
2121                Write_Str ("source");
2122 
2123             when Sinput.Config =>
2124                Write_Str ("configuration pragmas");
2125 
2126             when Sinput.Def =>
2127                Write_Str ("symbol definition");
2128 
2129             when Sinput.Preproc =>
2130                Write_Str ("preprocessing data");
2131          end case;
2132 
2133          Write_Str (" file: ");
2134          Write_Name (Full_File_Name (Sfile));
2135          Write_Eol;
2136 
2137          if Num_SRef_Pragmas (Sfile) > 0 then
2138             Write_Str ("--------------Line numbers from file: ");
2139             Write_Name (Full_Ref_Name (Sfile));
2140             Write_Str (" (starting at line ");
2141             Write_Int (Int (First_Mapped_Line (Sfile)));
2142             Write_Char (')');
2143             Write_Eol;
2144          end if;
2145 
2146          Current_Error_Source_File := Sfile;
2147       end if;
2148 
2149       if Errs or List_Pragmas_Mode then
2150          Output_Line_Number (Physical_To_Logical (L, Sfile));
2151          Line_Number_Output := True;
2152       end if;
2153 
2154       S := Line_Start (L, Sfile);
2155 
2156       loop
2157          C := Source_Text (Sfile) (S);
2158          exit when C = ASCII.LF or else C = ASCII.CR or else C = EOF;
2159 
2160          --  Deal with matching entry in List_Pragmas table
2161 
2162          if Full_List
2163            and then List_Pragmas_Index <= List_Pragmas.Last
2164            and then S = List_Pragmas.Table (List_Pragmas_Index).Ploc
2165          then
2166             case List_Pragmas.Table (List_Pragmas_Index).Ptyp is
2167                when Page =>
2168                   Write_Char (C);
2169 
2170                   --  Ignore if on line with errors so that error flags
2171                   --  get properly listed with the error line .
2172 
2173                   if not Errs then
2174                      Write_Char (ASCII.FF);
2175                   end if;
2176 
2177                when List_On =>
2178                   List_Pragmas_Mode := True;
2179 
2180                   if not Line_Number_Output then
2181                      Output_Line_Number (Physical_To_Logical (L, Sfile));
2182                      Line_Number_Output := True;
2183                   end if;
2184 
2185                   Write_Char (C);
2186 
2187                when List_Off =>
2188                   Write_Char (C);
2189                   List_Pragmas_Mode := False;
2190             end case;
2191 
2192             List_Pragmas_Index := List_Pragmas_Index + 1;
2193 
2194          --  Normal case (no matching entry in List_Pragmas table)
2195 
2196          else
2197             if Errs or List_Pragmas_Mode then
2198                Write_Char (C);
2199             end if;
2200          end if;
2201 
2202          Empty_Line := False;
2203          S := S + 1;
2204       end loop;
2205 
2206       --  If we have output a source line, then add the line terminator, with
2207       --  training spaces preserved (so we output the line exactly as input).
2208 
2209       if Line_Number_Output then
2210          if Empty_Line then
2211             Write_Eol;
2212          else
2213             Write_Eol_Keep_Blanks;
2214          end if;
2215       end if;
2216    end Output_Source_Line;
2217 
2218    -----------------------------
2219    -- Remove_Warning_Messages --
2220    -----------------------------
2221 
2222    procedure Remove_Warning_Messages (N : Node_Id) is
2223 
2224       function Check_For_Warning (N : Node_Id) return Traverse_Result;
2225       --  This function checks one node for a possible warning message
2226 
2227       function Check_All_Warnings is new Traverse_Func (Check_For_Warning);
2228       --  This defines the traversal operation
2229 
2230       -----------------------
2231       -- Check_For_Warning --
2232       -----------------------
2233 
2234       function Check_For_Warning (N : Node_Id) return Traverse_Result is
2235          Loc : constant Source_Ptr := Sloc (N);
2236          E   : Error_Msg_Id;
2237 
2238          function To_Be_Removed (E : Error_Msg_Id) return Boolean;
2239          --  Returns True for a message that is to be removed. Also adjusts
2240          --  warning count appropriately.
2241 
2242          -------------------
2243          -- To_Be_Removed --
2244          -------------------
2245 
2246          function To_Be_Removed (E : Error_Msg_Id) return Boolean is
2247          begin
2248             if E /= No_Error_Msg
2249 
2250                --  Don't remove if location does not match
2251 
2252                and then Errors.Table (E).Optr = Loc
2253 
2254                --  Don't remove if not warning/info message. Note that we do
2255                --  not remove style messages here. They are warning messages
2256                --  but not ones we want removed in this context.
2257 
2258                and then Errors.Table (E).Warn
2259 
2260                --  Don't remove unconditional messages
2261 
2262                and then not Errors.Table (E).Uncond
2263             then
2264                Warnings_Detected := Warnings_Detected - 1;
2265 
2266                if Errors.Table (E).Info then
2267                   Info_Messages := Info_Messages - 1;
2268                end if;
2269 
2270                return True;
2271 
2272             --  No removal required
2273 
2274             else
2275                return False;
2276             end if;
2277          end To_Be_Removed;
2278 
2279       --  Start of processing for Check_For_Warnings
2280 
2281       begin
2282          while To_Be_Removed (First_Error_Msg) loop
2283             First_Error_Msg := Errors.Table (First_Error_Msg).Next;
2284          end loop;
2285 
2286          if First_Error_Msg = No_Error_Msg then
2287             Last_Error_Msg := No_Error_Msg;
2288          end if;
2289 
2290          E := First_Error_Msg;
2291          while E /= No_Error_Msg loop
2292             while To_Be_Removed (Errors.Table (E).Next) loop
2293                Errors.Table (E).Next :=
2294                  Errors.Table (Errors.Table (E).Next).Next;
2295 
2296                if Errors.Table (E).Next = No_Error_Msg then
2297                   Last_Error_Msg := E;
2298                end if;
2299             end loop;
2300 
2301             E := Errors.Table (E).Next;
2302          end loop;
2303 
2304          if Nkind (N) = N_Raise_Constraint_Error
2305            and then Original_Node (N) /= N
2306            and then No (Condition (N))
2307          then
2308             --  Warnings may have been posted on subexpressions of the original
2309             --  tree. We place the original node back on the tree to remove
2310             --  those warnings, whose sloc do not match those of any node in
2311             --  the current tree. Given that we are in unreachable code, this
2312             --  modification to the tree is harmless.
2313 
2314             declare
2315                Status : Traverse_Final_Result;
2316 
2317             begin
2318                if Is_List_Member (N) then
2319                   Set_Condition (N, Original_Node (N));
2320                   Status := Check_All_Warnings (Condition (N));
2321                else
2322                   Rewrite (N, Original_Node (N));
2323                   Status := Check_All_Warnings (N);
2324                end if;
2325 
2326                return Status;
2327             end;
2328 
2329          else
2330             return OK;
2331          end if;
2332       end Check_For_Warning;
2333 
2334    --  Start of processing for Remove_Warning_Messages
2335 
2336    begin
2337       if Warnings_Detected /= 0 then
2338          declare
2339             Discard : Traverse_Final_Result;
2340             pragma Warnings (Off, Discard);
2341 
2342          begin
2343             Discard := Check_All_Warnings (N);
2344          end;
2345       end if;
2346    end Remove_Warning_Messages;
2347 
2348    procedure Remove_Warning_Messages (L : List_Id) is
2349       Stat : Node_Id;
2350    begin
2351       if Is_Non_Empty_List (L) then
2352          Stat := First (L);
2353          while Present (Stat) loop
2354             Remove_Warning_Messages (Stat);
2355             Next (Stat);
2356          end loop;
2357       end if;
2358    end Remove_Warning_Messages;
2359 
2360    ----------------------
2361    -- Adjust_Name_Case --
2362    ----------------------
2363 
2364    procedure Adjust_Name_Case
2365      (Buf : in out Bounded_String;
2366       Loc : Source_Ptr)
2367    is
2368    begin
2369       --  We have an all lower case name from Namet, and now we want to set
2370       --  the appropriate case. If possible we copy the actual casing from
2371       --  the source. If not we use standard identifier casing.
2372 
2373       declare
2374          Src_Ind : constant Source_File_Index := Get_Source_File_Index (Loc);
2375          Sbuffer : Source_Buffer_Ptr;
2376          Ref_Ptr : Integer;
2377          Src_Ptr : Source_Ptr;
2378 
2379       begin
2380          Ref_Ptr := 1;
2381          Src_Ptr := Loc;
2382 
2383          --  For standard locations, always use mixed case
2384 
2385          if Loc <= No_Location then
2386             Set_Casing (Mixed_Case);
2387 
2388          else
2389             --  Determine if the reference we are dealing with corresponds to
2390             --  text at the point of the error reference. This will often be
2391             --  the case for simple identifier references, and is the case
2392             --  where we can copy the casing from the source.
2393 
2394             Sbuffer := Source_Text (Src_Ind);
2395 
2396             while Ref_Ptr <= Buf.Length loop
2397                exit when
2398                  Fold_Lower (Sbuffer (Src_Ptr)) /=
2399                    Fold_Lower (Buf.Chars (Ref_Ptr));
2400                Ref_Ptr := Ref_Ptr + 1;
2401                Src_Ptr := Src_Ptr + 1;
2402             end loop;
2403 
2404             --  If we get through the loop without a mismatch, then output the
2405             --  name the way it is cased in the source program
2406 
2407             if Ref_Ptr > Buf.Length then
2408                Src_Ptr := Loc;
2409 
2410                for J in 1 .. Buf.Length loop
2411                   Buf.Chars (J) := Sbuffer (Src_Ptr);
2412                   Src_Ptr := Src_Ptr + 1;
2413                end loop;
2414 
2415             --  Otherwise set the casing using the default identifier casing
2416 
2417             else
2418                Set_Casing (Buf, Identifier_Casing (Src_Ind));
2419             end if;
2420          end if;
2421       end;
2422    end Adjust_Name_Case;
2423 
2424    procedure Adjust_Name_Case (Loc : Source_Ptr) is
2425    begin
2426       Adjust_Name_Case (Global_Name_Buffer, Loc);
2427    end Adjust_Name_Case;
2428 
2429    ---------------------------
2430    -- Set_Identifier_Casing --
2431    ---------------------------
2432 
2433    procedure Set_Identifier_Casing
2434      (Identifier_Name : System.Address;
2435       File_Name       : System.Address)
2436    is
2437       Ident : constant Big_String_Ptr := To_Big_String_Ptr (Identifier_Name);
2438       File  : constant Big_String_Ptr := To_Big_String_Ptr (File_Name);
2439       Flen  : Natural;
2440 
2441       Desired_Case : Casing_Type := Mixed_Case;
2442       --  Casing required for result. Default value of Mixed_Case is used if
2443       --  for some reason we cannot find the right file name in the table.
2444 
2445    begin
2446       --  Get length of file name
2447 
2448       Flen := 0;
2449       while File (Flen + 1) /= ASCII.NUL loop
2450          Flen := Flen + 1;
2451       end loop;
2452 
2453       --  Loop through file names to find matching one. This is a bit slow, but
2454       --  we only do it in error situations so it is not so terrible. Note that
2455       --  if the loop does not exit, then the desired case will be left set to
2456       --  Mixed_Case, this can happen if the name was not in canonical form.
2457 
2458       for J in 1 .. Last_Source_File loop
2459          Get_Name_String (Full_Debug_Name (J));
2460 
2461          if Name_Len = Flen
2462            and then Name_Buffer (1 .. Name_Len) = String (File (1 .. Flen))
2463          then
2464             Desired_Case := Identifier_Casing (J);
2465             exit;
2466          end if;
2467       end loop;
2468 
2469       --  Copy identifier as given to Name_Buffer
2470 
2471       for J in Name_Buffer'Range loop
2472          Name_Buffer (J) := Ident (J);
2473 
2474          if Name_Buffer (J) = ASCII.NUL then
2475             Name_Len := J - 1;
2476             exit;
2477          end if;
2478       end loop;
2479 
2480       Set_Casing (Desired_Case);
2481    end Set_Identifier_Casing;
2482 
2483    -----------------------
2484    -- Set_Ignore_Errors --
2485    -----------------------
2486 
2487    procedure Set_Ignore_Errors (To : Boolean) is
2488    begin
2489       Errors_Must_Be_Ignored := To;
2490    end Set_Ignore_Errors;
2491 
2492    ------------------------------
2493    -- Set_Msg_Insertion_Column --
2494    ------------------------------
2495 
2496    procedure Set_Msg_Insertion_Column is
2497    begin
2498       if RM_Column_Check then
2499          Set_Msg_Str (" in column ");
2500          Set_Msg_Int (Int (Error_Msg_Col) + 1);
2501       end if;
2502    end Set_Msg_Insertion_Column;
2503 
2504    ----------------------------
2505    -- Set_Msg_Insertion_Node --
2506    ----------------------------
2507 
2508    procedure Set_Msg_Insertion_Node is
2509       K : Node_Kind;
2510 
2511    begin
2512       Suppress_Message :=
2513         Error_Msg_Node_1 = Error
2514           or else Error_Msg_Node_1 = Any_Type;
2515 
2516       if Error_Msg_Node_1 = Empty then
2517          Set_Msg_Blank_Conditional;
2518          Set_Msg_Str ("<empty>");
2519 
2520       elsif Error_Msg_Node_1 = Error then
2521          Set_Msg_Blank;
2522          Set_Msg_Str ("<error>");
2523 
2524       elsif Error_Msg_Node_1 = Standard_Void_Type then
2525          Set_Msg_Blank;
2526          Set_Msg_Str ("procedure name");
2527 
2528       elsif Nkind (Error_Msg_Node_1) in N_Entity
2529         and then Ekind (Error_Msg_Node_1) = E_Anonymous_Access_Subprogram_Type
2530       then
2531          Set_Msg_Blank;
2532          Set_Msg_Str ("access to subprogram");
2533 
2534       else
2535          Set_Msg_Blank_Conditional;
2536 
2537          --  Output name
2538 
2539          K := Nkind (Error_Msg_Node_1);
2540 
2541          --  If we have operator case, skip quotes since name of operator
2542          --  itself will supply the required quotations. An operator can be an
2543          --  applied use in an expression or an explicit operator symbol, or an
2544          --  identifier whose name indicates it is an operator.
2545 
2546          if K in N_Op
2547            or else K = N_Operator_Symbol
2548            or else K = N_Defining_Operator_Symbol
2549            or else ((K = N_Identifier or else K = N_Defining_Identifier)
2550                       and then Is_Operator_Name (Chars (Error_Msg_Node_1)))
2551          then
2552             Set_Msg_Node (Error_Msg_Node_1);
2553 
2554          --  Normal case, not an operator, surround with quotes
2555 
2556          else
2557             Set_Msg_Quote;
2558             Set_Qualification (Error_Msg_Qual_Level, Error_Msg_Node_1);
2559             Set_Msg_Node (Error_Msg_Node_1);
2560             Set_Msg_Quote;
2561          end if;
2562       end if;
2563 
2564       --  The following assignment ensures that a second ampersand insertion
2565       --  character will correspond to the Error_Msg_Node_2 parameter. We
2566       --  suppress possible validity checks in case operating in -gnatVa mode,
2567       --  and Error_Msg_Node_2 is not needed and has not been set.
2568 
2569       declare
2570          pragma Suppress (Range_Check);
2571       begin
2572          Error_Msg_Node_1 := Error_Msg_Node_2;
2573       end;
2574    end Set_Msg_Insertion_Node;
2575 
2576    --------------------------------------
2577    -- Set_Msg_Insertion_Type_Reference --
2578    --------------------------------------
2579 
2580    procedure Set_Msg_Insertion_Type_Reference (Flag : Source_Ptr) is
2581       Ent : Entity_Id;
2582 
2583    begin
2584       Set_Msg_Blank;
2585 
2586       if Error_Msg_Node_1 = Standard_Void_Type then
2587          Set_Msg_Str ("package or procedure name");
2588          return;
2589 
2590       elsif Error_Msg_Node_1 = Standard_Exception_Type then
2591          Set_Msg_Str ("exception name");
2592          return;
2593 
2594       elsif     Error_Msg_Node_1 = Any_Access
2595         or else Error_Msg_Node_1 = Any_Array
2596         or else Error_Msg_Node_1 = Any_Boolean
2597         or else Error_Msg_Node_1 = Any_Character
2598         or else Error_Msg_Node_1 = Any_Composite
2599         or else Error_Msg_Node_1 = Any_Discrete
2600         or else Error_Msg_Node_1 = Any_Fixed
2601         or else Error_Msg_Node_1 = Any_Integer
2602         or else Error_Msg_Node_1 = Any_Modular
2603         or else Error_Msg_Node_1 = Any_Numeric
2604         or else Error_Msg_Node_1 = Any_Real
2605         or else Error_Msg_Node_1 = Any_Scalar
2606         or else Error_Msg_Node_1 = Any_String
2607       then
2608          Get_Unqualified_Decoded_Name_String (Chars (Error_Msg_Node_1));
2609          Set_Msg_Name_Buffer;
2610          return;
2611 
2612       elsif Error_Msg_Node_1 = Universal_Real then
2613          Set_Msg_Str ("type universal real");
2614          return;
2615 
2616       elsif Error_Msg_Node_1 = Universal_Integer then
2617          Set_Msg_Str ("type universal integer");
2618          return;
2619 
2620       elsif Error_Msg_Node_1 = Universal_Fixed then
2621          Set_Msg_Str ("type universal fixed");
2622          return;
2623       end if;
2624 
2625       --  Special case of anonymous array
2626 
2627       if Nkind (Error_Msg_Node_1) in N_Entity
2628         and then Is_Array_Type (Error_Msg_Node_1)
2629         and then Present (Related_Array_Object (Error_Msg_Node_1))
2630       then
2631          Set_Msg_Str ("type of ");
2632          Set_Msg_Node (Related_Array_Object (Error_Msg_Node_1));
2633          Set_Msg_Str (" declared");
2634          Set_Msg_Insertion_Line_Number
2635            (Sloc (Related_Array_Object (Error_Msg_Node_1)), Flag);
2636          return;
2637       end if;
2638 
2639       --  If we fall through, it is not a special case, so first output
2640       --  the name of the type, preceded by private for a private type
2641 
2642       if Is_Private_Type (Error_Msg_Node_1) then
2643          Set_Msg_Str ("private type ");
2644       else
2645          Set_Msg_Str ("type ");
2646       end if;
2647 
2648       Ent := Error_Msg_Node_1;
2649 
2650       if Is_Internal_Name (Chars (Ent)) then
2651          Unwind_Internal_Type (Ent);
2652       end if;
2653 
2654       --  Types in Standard are displayed as "Standard.name"
2655 
2656       if Sloc (Ent) <= Standard_Location then
2657          Set_Msg_Quote;
2658          Set_Msg_Str ("Standard.");
2659          Set_Msg_Node (Ent);
2660          Add_Class;
2661          Set_Msg_Quote;
2662 
2663       --  Types in other language defined units are displayed as
2664       --  "package-name.type-name"
2665 
2666       elsif
2667         Is_Predefined_File_Name (Unit_File_Name (Get_Source_Unit (Ent)))
2668       then
2669          Get_Unqualified_Decoded_Name_String
2670            (Unit_Name (Get_Source_Unit (Ent)));
2671          Name_Len := Name_Len - 2;
2672          Set_Msg_Blank_Conditional;
2673          Set_Msg_Quote;
2674          Set_Casing (Mixed_Case);
2675          Set_Msg_Name_Buffer;
2676          Set_Msg_Char ('.');
2677          Set_Casing (Mixed_Case);
2678          Set_Msg_Node (Ent);
2679          Add_Class;
2680          Set_Msg_Quote;
2681 
2682       --  All other types display as "type name" defined at line xxx
2683       --  possibly qualified if qualification is requested.
2684 
2685       else
2686          Set_Msg_Quote;
2687          Set_Qualification (Error_Msg_Qual_Level, Ent);
2688          Set_Msg_Node (Ent);
2689          Add_Class;
2690 
2691          --  If we did not print a name (e.g. in the case of an anonymous
2692          --  subprogram type), there is no name to print, so remove quotes.
2693 
2694          if Buffer_Ends_With ('"') then
2695             Buffer_Remove ('"');
2696          else
2697             Set_Msg_Quote;
2698          end if;
2699       end if;
2700 
2701       --  If the original type did not come from a predefined file, add the
2702       --  location where the type was defined.
2703 
2704       if Sloc (Error_Msg_Node_1) > Standard_Location
2705         and then
2706           not Is_Predefined_File_Name
2707                 (Unit_File_Name (Get_Source_Unit (Error_Msg_Node_1)))
2708       then
2709          Set_Msg_Str (" defined");
2710          Set_Msg_Insertion_Line_Number (Sloc (Error_Msg_Node_1), Flag);
2711 
2712       --  If it did come from a predefined file, deal with the case where
2713       --  this was a file with a generic instantiation from elsewhere.
2714 
2715       else
2716          if Sloc (Error_Msg_Node_1) > Standard_Location then
2717             declare
2718                Iloc : constant Source_Ptr :=
2719                  Instantiation_Location (Sloc (Error_Msg_Node_1));
2720 
2721             begin
2722                if Iloc /= No_Location
2723                  and then not Suppress_Instance_Location
2724                then
2725                   Set_Msg_Str (" from instance");
2726                   Set_Msg_Insertion_Line_Number (Iloc, Flag);
2727                end if;
2728             end;
2729          end if;
2730       end if;
2731    end Set_Msg_Insertion_Type_Reference;
2732 
2733    ---------------------------------
2734    -- Set_Msg_Insertion_Unit_Name --
2735    ---------------------------------
2736 
2737    procedure Set_Msg_Insertion_Unit_Name (Suffix : Boolean := True) is
2738    begin
2739       if Error_Msg_Unit_1 = No_Unit_Name then
2740          null;
2741 
2742       elsif Error_Msg_Unit_1 = Error_Unit_Name then
2743          Set_Msg_Blank;
2744          Set_Msg_Str ("<error>");
2745 
2746       else
2747          Get_Unit_Name_String (Error_Msg_Unit_1, Suffix);
2748          Set_Msg_Blank;
2749          Set_Msg_Quote;
2750          Set_Msg_Name_Buffer;
2751          Set_Msg_Quote;
2752       end if;
2753 
2754       --  The following assignment ensures that a second percent insertion
2755       --  character will correspond to the Error_Msg_Unit_2 parameter. We
2756       --  suppress possible validity checks in case operating in -gnatVa mode,
2757       --  and Error_Msg_Unit_2 is not needed and has not been set.
2758 
2759       declare
2760          pragma Suppress (Range_Check);
2761       begin
2762          Error_Msg_Unit_1 := Error_Msg_Unit_2;
2763       end;
2764    end Set_Msg_Insertion_Unit_Name;
2765 
2766    ------------------
2767    -- Set_Msg_Node --
2768    ------------------
2769 
2770    procedure Set_Msg_Node (Node : Node_Id) is
2771       Loc : Source_Ptr;
2772       Ent : Entity_Id;
2773       Nam : Name_Id;
2774 
2775    begin
2776       case Nkind (Node) is
2777          when N_Designator =>
2778             Set_Msg_Node (Name (Node));
2779             Set_Msg_Char ('.');
2780             Set_Msg_Node (Identifier (Node));
2781             return;
2782 
2783          when N_Defining_Program_Unit_Name =>
2784             Set_Msg_Node (Name (Node));
2785             Set_Msg_Char ('.');
2786             Set_Msg_Node (Defining_Identifier (Node));
2787             return;
2788 
2789          when N_Selected_Component | N_Expanded_Name =>
2790             Set_Msg_Node (Prefix (Node));
2791             Set_Msg_Char ('.');
2792             Set_Msg_Node (Selector_Name (Node));
2793             return;
2794 
2795          when others =>
2796             null;
2797       end case;
2798 
2799       --  The only remaining possibilities are identifiers, defining
2800       --  identifiers, pragmas, and pragma argument associations.
2801 
2802       if Nkind (Node) = N_Pragma then
2803          Nam := Pragma_Name (Node);
2804          Loc := Sloc (Node);
2805 
2806       --  The other cases have Chars fields
2807 
2808       --  First deal with internal names, which generally represent something
2809       --  gone wrong. First attempt: if this is a rewritten node that rewrites
2810       --  something with a Chars field that is not an internal name, use that.
2811 
2812       elsif Is_Internal_Name (Chars (Node))
2813         and then Nkind (Original_Node (Node)) in N_Has_Chars
2814         and then not Is_Internal_Name (Chars (Original_Node (Node)))
2815       then
2816          Nam := Chars (Original_Node (Node));
2817          Loc := Sloc (Original_Node (Node));
2818 
2819       --  Another shot for internal names, in the case of internal type names,
2820       --  we try to find a reasonable representation for the external name.
2821 
2822       elsif Is_Internal_Name (Chars (Node))
2823         and then
2824           ((Is_Entity_Name (Node)
2825              and then Present (Entity (Node))
2826              and then Is_Type (Entity (Node)))
2827             or else
2828              (Nkind (Node) = N_Defining_Identifier and then Is_Type (Node)))
2829       then
2830          if Nkind (Node) = N_Identifier then
2831             Ent := Entity (Node);
2832          else
2833             Ent := Node;
2834          end if;
2835 
2836          Loc := Sloc (Ent);
2837 
2838          --  If the type is the designated type of an access_to_subprogram,
2839          --  then there is no name to provide in the call.
2840 
2841          if Ekind (Ent) = E_Subprogram_Type then
2842             return;
2843 
2844          --  Otherwise, we will be able to find some kind of name to output
2845 
2846          else
2847             Unwind_Internal_Type (Ent);
2848             Nam := Chars (Ent);
2849          end if;
2850 
2851       --  If not internal name, or if we could not find a reasonable possible
2852       --  substitution for the internal name, just use name in Chars field.
2853 
2854       else
2855          Nam := Chars (Node);
2856          Loc := Sloc (Node);
2857       end if;
2858 
2859       --  At this stage, the name to output is in Nam
2860 
2861       Get_Unqualified_Decoded_Name_String (Nam);
2862 
2863       --  Remove trailing upper case letters from the name (useful for
2864       --  dealing with some cases of internal names).
2865 
2866       while Name_Len > 1 and then Name_Buffer (Name_Len) in 'A' .. 'Z' loop
2867          Name_Len := Name_Len  - 1;
2868       end loop;
2869 
2870       --  If we have any of the names from standard that start with the
2871       --  characters "any " (e.g. Any_Type), then kill the message since
2872       --  almost certainly it is a junk cascaded message.
2873 
2874       if Name_Len > 4
2875         and then Name_Buffer (1 .. 4) = "any "
2876       then
2877          Kill_Message := True;
2878       end if;
2879 
2880       --  If we still have an internal name, kill the message (will only
2881       --  work if we already had errors!)
2882 
2883       if Is_Internal_Name then
2884          Kill_Message := True;
2885       end if;
2886       --  Remaining step is to adjust casing and possibly add 'Class
2887 
2888       Adjust_Name_Case (Global_Name_Buffer, Loc);
2889       Set_Msg_Name_Buffer;
2890       Add_Class;
2891    end Set_Msg_Node;
2892 
2893    ------------------
2894    -- Set_Msg_Text --
2895    ------------------
2896 
2897    procedure Set_Msg_Text (Text : String; Flag : Source_Ptr) is
2898       C : Character;   -- Current character
2899       P : Natural;     -- Current index;
2900 
2901       procedure Skip_Msg_Insertion_Warning (C : Character);
2902       --  Deal with ? ?? ?x? ?X? ?*? ?$? insertion sequences (and the same
2903       --  sequences using < instead of ?). The caller has already bumped
2904       --  the pointer past the initial ? or < and C is set to this initial
2905       --  character (? or <). This procedure skips past the rest of the
2906       --  sequence. We do not need to set Msg_Insertion_Char, since this
2907       --  was already done during the message prescan.
2908 
2909       --------------------------------
2910       -- Skip_Msg_Insertion_Warning --
2911       --------------------------------
2912 
2913       procedure Skip_Msg_Insertion_Warning (C : Character) is
2914       begin
2915          if P <= Text'Last and then Text (P) = C then
2916             P := P + 1;
2917 
2918          elsif P + 1 <= Text'Last
2919            and then (Text (P) in 'a' .. 'z'
2920                        or else
2921                      Text (P) in 'A' .. 'Z'
2922                        or else
2923                      Text (P) = '*'
2924                        or else
2925                      Text (P) = '$')
2926            and then Text (P + 1) = C
2927          then
2928             P := P + 2;
2929          end if;
2930       end Skip_Msg_Insertion_Warning;
2931 
2932    --  Start of processing for Set_Msg_Text
2933 
2934    begin
2935       Manual_Quote_Mode := False;
2936       Msglen := 0;
2937       Flag_Source := Get_Source_File_Index (Flag);
2938 
2939       --  Skip info: at start, we have recorded this in Is_Info_Msg, and this
2940       --  will be used (Info field in error message object) to put back the
2941       --  string when it is printed. We need to do this, or we get confused
2942       --  with instantiation continuations.
2943 
2944       if Text'Length > 6
2945         and then Text (Text'First .. Text'First + 5) = "info: "
2946       then
2947          P := Text'First + 6;
2948       else
2949          P := Text'First;
2950       end if;
2951 
2952       --  Loop through characters of message
2953 
2954       while P <= Text'Last loop
2955          C := Text (P);
2956          P := P + 1;
2957 
2958          --  Check for insertion character or sequence
2959 
2960          case C is
2961             when '%' =>
2962                if P <= Text'Last and then Text (P) = '%' then
2963                   P := P + 1;
2964                   Set_Msg_Insertion_Name_Literal;
2965                else
2966                   Set_Msg_Insertion_Name;
2967                end if;
2968 
2969             when '$' =>
2970                if P <= Text'Last and then Text (P) = '$' then
2971                   P := P + 1;
2972                   Set_Msg_Insertion_Unit_Name (Suffix => False);
2973                else
2974                   Set_Msg_Insertion_Unit_Name;
2975                end if;
2976 
2977             when '{' =>
2978                Set_Msg_Insertion_File_Name;
2979 
2980             when '}' =>
2981                Set_Msg_Insertion_Type_Reference (Flag);
2982 
2983             when '*' =>
2984                Set_Msg_Insertion_Reserved_Name;
2985 
2986             when '&' =>
2987                Set_Msg_Insertion_Node;
2988 
2989             when '#' =>
2990                Set_Msg_Insertion_Line_Number (Error_Msg_Sloc, Flag);
2991 
2992             when '\' =>
2993                Continuation := True;
2994 
2995                if Text (P) = '\' then
2996                   Continuation_New_Line := True;
2997                   P := P + 1;
2998                end if;
2999 
3000             when '@' =>
3001                Set_Msg_Insertion_Column;
3002 
3003             when '>' =>
3004                Set_Msg_Insertion_Run_Time_Name;
3005 
3006             when '^' =>
3007                Set_Msg_Insertion_Uint;
3008 
3009             when '`' =>
3010                Manual_Quote_Mode := not Manual_Quote_Mode;
3011                Set_Msg_Char ('"');
3012 
3013             when '!' =>
3014                null; -- already dealt with
3015 
3016             when '?' =>
3017                Skip_Msg_Insertion_Warning ('?');
3018 
3019             when '<' =>
3020                Skip_Msg_Insertion_Warning ('<');
3021 
3022             when '|' =>
3023                null; -- already dealt with
3024 
3025             when ''' =>
3026                Set_Msg_Char (Text (P));
3027                P := P + 1;
3028 
3029             when '~' =>
3030                Set_Msg_Str (Error_Msg_String (1 .. Error_Msg_Strlen));
3031 
3032             --  Upper case letter
3033 
3034             when 'A' .. 'Z' =>
3035 
3036                --  Start of reserved word if two or more
3037 
3038                if P <= Text'Last and then Text (P) in 'A' .. 'Z' then
3039                   P := P - 1;
3040                   Set_Msg_Insertion_Reserved_Word (Text, P);
3041 
3042                --  Single upper case letter is just inserted
3043 
3044                else
3045                   Set_Msg_Char (C);
3046                end if;
3047 
3048             --  '[' (will be/would have been raised at run time)
3049 
3050             when '[' =>
3051                if Is_Warning_Msg then
3052                   Set_Msg_Str ("will be raised at run time");
3053                else
3054                   Set_Msg_Str ("would have been raised at run time");
3055                end if;
3056 
3057             --   ']' (may be/might have been raised at run time)
3058 
3059             when ']' =>
3060                if Is_Warning_Msg then
3061                   Set_Msg_Str ("may be raised at run time");
3062                else
3063                   Set_Msg_Str ("might have been raised at run time");
3064                end if;
3065 
3066             --  Normal character with no special treatment
3067 
3068             when others =>
3069                Set_Msg_Char (C);
3070          end case;
3071       end loop;
3072    end Set_Msg_Text;
3073 
3074    ----------------
3075    -- Set_Posted --
3076    ----------------
3077 
3078    procedure Set_Posted (N : Node_Id) is
3079       P : Node_Id;
3080 
3081    begin
3082       if Is_Serious_Error then
3083 
3084          --  We always set Error_Posted on the node itself
3085 
3086          Set_Error_Posted (N);
3087 
3088          --  If it is a subexpression, then set Error_Posted on parents up to
3089          --  and including the first non-subexpression construct. This helps
3090          --  avoid cascaded error messages within a single expression.
3091 
3092          P := N;
3093          loop
3094             P := Parent (P);
3095             exit when No (P);
3096             Set_Error_Posted (P);
3097             exit when Nkind (P) not in N_Subexpr;
3098          end loop;
3099 
3100          if Nkind_In (P, N_Pragma_Argument_Association,
3101                          N_Component_Association,
3102                          N_Discriminant_Association,
3103                          N_Generic_Association,
3104                          N_Parameter_Association)
3105          then
3106             Set_Error_Posted (Parent (P));
3107          end if;
3108 
3109          --  A special check, if we just posted an error on an attribute
3110          --  definition clause, then also set the entity involved as posted.
3111          --  For example, this stops complaining about the alignment after
3112          --  complaining about the size, which is likely to be useless.
3113 
3114          if Nkind (P) = N_Attribute_Definition_Clause then
3115             if Is_Entity_Name (Name (P)) then
3116                Set_Error_Posted (Entity (Name (P)));
3117             end if;
3118          end if;
3119       end if;
3120    end Set_Posted;
3121 
3122    -----------------------
3123    -- Set_Qualification --
3124    -----------------------
3125 
3126    procedure Set_Qualification (N : Nat; E : Entity_Id) is
3127    begin
3128       if N /= 0 and then Scope (E) /= Standard_Standard then
3129          Set_Qualification (N - 1, Scope (E));
3130          Set_Msg_Node (Scope (E));
3131          Set_Msg_Char ('.');
3132       end if;
3133    end Set_Qualification;
3134 
3135    ------------------------
3136    -- Special_Msg_Delete --
3137    ------------------------
3138 
3139    --  Is it really right to have all this specialized knowledge in errout?
3140 
3141    function Special_Msg_Delete
3142      (Msg : String;
3143       N   : Node_Or_Entity_Id;
3144       E   : Node_Or_Entity_Id) return Boolean
3145    is
3146    begin
3147       --  Never delete messages in -gnatdO mode
3148 
3149       if Debug_Flag_OO then
3150          return False;
3151 
3152       --  Processing for "atomic access cannot be guaranteed"
3153 
3154       elsif Msg = "atomic access to & cannot be guaranteed" then
3155 
3156          --  When an atomic object refers to a non-atomic type in the same
3157          --  scope, we implicitly make the type atomic. In the non-error case
3158          --  this is surely safe (and in fact prevents an error from occurring
3159          --  if the type is not atomic by default). But if the object cannot be
3160          --  made atomic, then we introduce an extra junk message by this
3161          --  manipulation, which we get rid of here.
3162 
3163          --  We identify this case by the fact that it references a type for
3164          --  which Is_Atomic is set, but there is no Atomic pragma setting it.
3165 
3166          if Is_Type (E)
3167            and then Is_Atomic (E)
3168            and then No (Get_Rep_Pragma (E, Name_Atomic))
3169          then
3170             return True;
3171          end if;
3172 
3173       --  Similar processing for "volatile full access cannot be guaranteed"
3174 
3175       elsif Msg = "volatile full access to & cannot be guaranteed" then
3176          if Is_Type (E)
3177            and then Is_Volatile_Full_Access (E)
3178            and then No (Get_Rep_Pragma (E, Name_Volatile_Full_Access))
3179          then
3180             return True;
3181          end if;
3182 
3183       --  Processing for "Size too small" messages
3184 
3185       elsif Msg = "size for& too small, minimum allowed is ^" then
3186 
3187          --  Suppress "size too small" errors in CodePeer mode, since code may
3188          --  be analyzed in a different configuration than the one used for
3189          --  compilation. Even when the configurations match, this message
3190          --  may be issued on correct code, because pragma Pack is ignored
3191          --  in CodePeer mode.
3192 
3193          if CodePeer_Mode then
3194             return True;
3195 
3196          --  When a size is wrong for a frozen type there is no explicit size
3197          --  clause, and other errors have occurred, suppress the message,
3198          --  since it is likely that this size error is a cascaded result of
3199          --  other errors. The reason we eliminate unfrozen types is that
3200          --  messages issued before the freeze type are for sure OK.
3201 
3202          elsif Is_Frozen (E)
3203            and then Serious_Errors_Detected > 0
3204            and then Nkind (N) /= N_Component_Clause
3205            and then Nkind (Parent (N)) /= N_Component_Clause
3206            and then
3207              No (Get_Attribute_Definition_Clause (E, Attribute_Size))
3208            and then
3209              No (Get_Attribute_Definition_Clause (E, Attribute_Object_Size))
3210            and then
3211              No (Get_Attribute_Definition_Clause (E, Attribute_Value_Size))
3212          then
3213             return True;
3214          end if;
3215       end if;
3216 
3217       --  All special tests complete, so go ahead with message
3218 
3219       return False;
3220    end Special_Msg_Delete;
3221 
3222    -----------------
3223    -- SPARK_Msg_N --
3224    -----------------
3225 
3226    procedure SPARK_Msg_N (Msg : String; N : Node_Or_Entity_Id) is
3227    begin
3228       if SPARK_Mode /= Off then
3229          Error_Msg_N (Msg, N);
3230       end if;
3231    end SPARK_Msg_N;
3232 
3233    ------------------
3234    -- SPARK_Msg_NE --
3235    ------------------
3236 
3237    procedure SPARK_Msg_NE
3238      (Msg : String;
3239       N   : Node_Or_Entity_Id;
3240       E   : Node_Or_Entity_Id)
3241    is
3242    begin
3243       if SPARK_Mode /= Off then
3244          Error_Msg_NE (Msg, N, E);
3245       end if;
3246    end SPARK_Msg_NE;
3247 
3248    --------------------------
3249    -- Unwind_Internal_Type --
3250    --------------------------
3251 
3252    procedure Unwind_Internal_Type (Ent : in out Entity_Id) is
3253       Derived : Boolean := False;
3254       Mchar   : Character;
3255       Old_Ent : Entity_Id;
3256 
3257    begin
3258       --  Undo placement of a quote, since we will put it back later
3259 
3260       Mchar := Msg_Buffer (Msglen);
3261 
3262       if Mchar = '"' then
3263          Msglen := Msglen - 1;
3264       end if;
3265 
3266       --  The loop here deals with recursive types, we are trying to find a
3267       --  related entity that is not an implicit type. Note that the check with
3268       --  Old_Ent stops us from getting "stuck". Also, we don't output the
3269       --  "type derived from" message more than once in the case where we climb
3270       --  up multiple levels.
3271 
3272       Find : loop
3273          Old_Ent := Ent;
3274 
3275          --  Implicit access type, use directly designated type In Ada 2005,
3276          --  the designated type may be an anonymous access to subprogram, in
3277          --  which case we can only point to its definition.
3278 
3279          if Is_Access_Type (Ent) then
3280             if Ekind (Ent) = E_Access_Subprogram_Type
3281               or else Ekind (Ent) = E_Anonymous_Access_Subprogram_Type
3282               or else Is_Access_Protected_Subprogram_Type (Ent)
3283             then
3284                Ent := Directly_Designated_Type (Ent);
3285 
3286                if not Comes_From_Source (Ent) then
3287                   if Buffer_Ends_With ("type ") then
3288                      Buffer_Remove ("type ");
3289                   end if;
3290                end if;
3291 
3292                if Ekind (Ent) = E_Function then
3293                   Set_Msg_Str ("access to function ");
3294                elsif Ekind (Ent) = E_Procedure then
3295                   Set_Msg_Str ("access to procedure ");
3296                else
3297                   Set_Msg_Str ("access to subprogram");
3298                end if;
3299 
3300                exit Find;
3301 
3302             --  Type is access to object, named or anonymous
3303 
3304             else
3305                Set_Msg_Str ("access to ");
3306                Ent := Directly_Designated_Type (Ent);
3307             end if;
3308 
3309          --  Classwide type
3310 
3311          elsif Is_Class_Wide_Type (Ent) then
3312             Class_Flag := True;
3313             Ent := Root_Type (Ent);
3314 
3315          --  Use base type if this is a subtype
3316 
3317          elsif Ent /= Base_Type (Ent) then
3318             Buffer_Remove ("type ");
3319 
3320             --  Avoid duplication "subtype of subtype of", and also replace
3321             --  "derived from subtype of" simply by "derived from"
3322 
3323             if not Buffer_Ends_With ("subtype of ")
3324               and then not Buffer_Ends_With ("derived from ")
3325             then
3326                Set_Msg_Str ("subtype of ");
3327             end if;
3328 
3329             Ent := Base_Type (Ent);
3330 
3331          --  If this is a base type with a first named subtype, use the first
3332          --  named subtype instead. This is not quite accurate in all cases,
3333          --  but it makes too much noise to be accurate and add 'Base in all
3334          --  cases. Note that we only do this is the first named subtype is not
3335          --  itself an internal name. This avoids the obvious loop (subtype ->
3336          --  basetype -> subtype) which would otherwise occur).
3337 
3338          else
3339             declare
3340                FST : constant Entity_Id := First_Subtype (Ent);
3341 
3342             begin
3343                if not Is_Internal_Name (Chars (FST)) then
3344                   Ent := FST;
3345                   exit Find;
3346 
3347                   --  Otherwise use root type
3348 
3349                else
3350                   if not Derived then
3351                      Buffer_Remove ("type ");
3352 
3353                      --  Test for "subtype of type derived from" which seems
3354                      --  excessive and is replaced by "type derived from".
3355 
3356                      Buffer_Remove ("subtype of");
3357 
3358                      --  Avoid duplicated "type derived from type derived from"
3359 
3360                      if not Buffer_Ends_With ("type derived from ") then
3361                         Set_Msg_Str ("type derived from ");
3362                      end if;
3363 
3364                      Derived := True;
3365                   end if;
3366                end if;
3367             end;
3368 
3369             Ent := Etype (Ent);
3370          end if;
3371 
3372          --  If we are stuck in a loop, get out and settle for the internal
3373          --  name after all. In this case we set to kill the message if it is
3374          --  not the first error message (we really try hard not to show the
3375          --  dirty laundry of the implementation to the poor user).
3376 
3377          if Ent = Old_Ent then
3378             Kill_Message := True;
3379             exit Find;
3380          end if;
3381 
3382          --  Get out if we finally found a non-internal name to use
3383 
3384          exit Find when not Is_Internal_Name (Chars (Ent));
3385       end loop Find;
3386 
3387       if Mchar = '"' then
3388          Set_Msg_Char ('"');
3389       end if;
3390    end Unwind_Internal_Type;
3391 
3392    --------------------
3393    -- Warn_Insertion --
3394    --------------------
3395 
3396    function Warn_Insertion return String is
3397    begin
3398       case Warning_Msg_Char is
3399          when '?' =>
3400             return "??";
3401          when 'a' .. 'z' | 'A' .. 'Z' | '*' | '$' =>
3402             return '?' & Warning_Msg_Char & '?';
3403          when ' ' =>
3404             return "?";
3405          when others =>
3406             raise Program_Error;
3407       end case;
3408    end Warn_Insertion;
3409 
3410 end Errout;