diff options
Diffstat (limited to 'gcc/ada/ali.ads')
-rw-r--r-- | gcc/ada/ali.ads | 22 |
1 files changed, 15 insertions, 7 deletions
diff --git a/gcc/ada/ali.ads b/gcc/ada/ali.ads index 7fbf1a48e78..f789b0c3581 100644 --- a/gcc/ada/ali.ads +++ b/gcc/ada/ali.ads @@ -808,13 +808,14 @@ package ALI is -- Initialize the ALI tables. Also resets all switch values to defaults. function Scan_ALI - (F : File_Name_Type; - T : Text_Buffer_Ptr; - Ignore_ED : Boolean; - Err : Boolean; - Read_Xref : Boolean := False; - Read_Lines : String := ""; - Ignore_Lines : String := "X") return ALI_Id; + (F : File_Name_Type; + T : Text_Buffer_Ptr; + Ignore_ED : Boolean; + Err : Boolean; + Read_Xref : Boolean := False; + Read_Lines : String := ""; + Ignore_Lines : String := "X"; + Ignore_Errors : Boolean := False) return ALI_Id; -- Given the text, T, of an ALI file, F, scan and store the information -- from the file, and return the Id of the resulting entry in the ALI -- table. Switch settings may be modified as described above in the @@ -854,5 +855,12 @@ package ALI is -- Ignore_Lines and Read_Lines parameters are ignored (i.e. the -- use of True for Read_XREF is equivalent to specifying an -- argument of "UWDX" for Read_Lines. + -- + -- Ignore_Errors is normally False. If it is set True, then Scan_ALI + -- will do its best to scan through a file and extract all information + -- it can, even if there are errors. In this case Err is only set if + -- Scan_ALI was completely unable to process the file (e.g. it did not + -- look like an ALI file at all). Ignore_Errors is intended to improve + -- the downward compatibility of new compilers with old tools. end ALI; |