Preliminary support for tool directives.

3 files changed, 369 insertions, 46 deletions

diff --git a/src/vhdl/errorout.ads b/src/vhdl/errorout.ads
index 5d34759e0..f2f07ed57 100644
--- a/src/vhdl/errorout.ads
+++ b/src/vhdl/errorout.ads
@@ -68,6 +68,9 @@ package Errorout is
       --  Start of block comment ('/*') appears in a block comment.
       Warnid_Nested_Comment,
 
+      --  Use of a tool directive.
+      Warnid_Directive,
+
       --  Weird use of parenthesis.
       Warnid_Parenthesis,
 
diff --git a/src/vhdl/scanner-directive_protect.adb b/src/vhdl/scanner-directive_protect.adb
new file mode 100644
index 000000000..1a70144d8
--- /dev/null
+++ b/src/vhdl/scanner-directive_protect.adb
@@ -0,0 +1,98 @@
+separate (Scanner)
+package body Directive_Protect is
+   function Scan_Expression_List return Boolean;
+
+   --  Scan/parse a keyword expression.
+   --  Initial spaces must have been skipped.
+   --  Return False in case of error.
+   function Scan_Keyword_Expression return Boolean is
+   begin
+      if Characters_Kind (Source (Pos)) not in Letter then
+         Error_Msg_Scan ("identifier expected in protect directive");
+         return False;
+      end if;
+
+      Scan_Identifier (False);
+      if Current_Token /= Tok_Identifier then
+         Error_Msg_Scan (Get_Token_Location, "keyword must be an identifier");
+         return False;
+      end if;
+
+      Skip_Spaces;
+      if Source (Pos) /= '=' then
+         return True;
+      end if;
+
+      --  Eat '='.
+      Pos := Pos + 1;
+      Skip_Spaces;
+
+      case Source (Pos) is
+         when 'A' .. 'Z' | 'a' .. 'z' =>
+            Scan_Identifier (False);
+         when '0' .. '9' =>
+            Scan_Literal;
+         when '"' =>
+            Scan_String;
+         when '(' =>
+            --  Eat '('.
+            Pos := Pos + 1;
+            Skip_Spaces;
+
+            if not Scan_Expression_List then
+               return False;
+            end if;
+
+            Skip_Spaces;
+            if Source (Pos) /= ')' then
+               Error_Msg_Scan ("')' expected at end of protect keyword list");
+               return False;
+            end if;
+
+            --  Eat ')'.
+            Pos := Pos + 1;
+
+         when others =>
+            --  Ok, we don't handle all the letters, nor extended identifiers.
+            Error_Msg_Scan ("literal expected in protect tool directive");
+            return False;
+      end case;
+
+      return True;
+   end Scan_Keyword_Expression;
+
+   --  Scan: keyword_expression { , keyword_expression }
+   function Scan_Expression_List return Boolean is
+   begin
+      loop
+         if not Scan_Keyword_Expression then
+            return False;
+         end if;
+
+         Skip_Spaces;
+
+         if Source (Pos) /= ',' then
+            return True;
+         end if;
+
+         --  Eat ','.
+         Pos := Pos + 1;
+
+         Skip_Spaces;
+      end loop;
+   end Scan_Expression_List;
+
+   --  LRM08 24.1 Protect tool directives
+   --  protect_directive ::=
+   --    `PROTECT keyword_expression {, keyword_expression }
+   procedure Scan_Protect_Directive is
+   begin
+      if Scan_Expression_List then
+         if not Is_EOL (Source (Pos)) then
+            Error_Msg_Scan ("end of line expected in protect directive");
+         end if;
+      end if;
+
+      Skip_Until_EOL;
+   end Scan_Protect_Directive;
+end Directive_Protect;
diff --git a/src/vhdl/scanner.adb b/src/vhdl/scanner.adb
index 824f69d81..fdafdae27 100644
--- a/src/vhdl/scanner.adb
+++ b/src/vhdl/scanner.adb
@@ -16,7 +16,6 @@
 --  Software Foundation, 59 Temple Place - Suite 330, Boston, MA
 --  02111-1307, USA.
 with Ada.Characters.Latin_1; use Ada.Characters.Latin_1;
-with Ada.Characters.Handling;
 with Errorout; use Errorout;
 with Name_Table;
 with Files_Map; use Files_Map;
@@ -33,28 +32,35 @@ package body Scanner is
 
    type Character_Kind_Type is
       (
-   -- Neither a format effector nor a graphic character.
+       -- Neither a format effector nor a graphic character.
        Invalid,
        Format_Effector,
+       Lower_Case_Letter,
        Upper_Case_Letter,
        Digit,
        Special_Character,
        Space_Character,
-       Lower_Case_Letter,
-       Other_Special_Character);
+       Other_Special_Character
+      );
 
-   -- LRM93 13.1
-   -- BASIC_GRAPHIC_CHARACTER ::=
-   --   UPPER_CASE_LETTER | DIGIT | SPECIAL_CHARACTER | SPACE_CHARACTER
+   --  LRM93 13.1
+   --  basic_graphic_character ::=
+   --    upper_case_letter | digit | special_character | space_character
+   --
    --subtype Basic_Graphic_Character is
    --  Character_Kind_Type range Upper_Case_Letter .. Space_Character;
 
-   -- LRM93 13.1
-   -- GRAPHIC_CHARACTER ::=
-   --   BASIC_GRAPHIC_CHARACTER | LOWER_CASE_LETTER | OTHER_SPECIAL_CHARACTER
-   -- Note: There is 191 graphic character.
+   --  LRM93 13.1
+   --  graphic_character ::=
+   --    basic_graphic_character | lower_case_letter | other_special_character
+   --
+   --  Note: There are 191 graphic characters.
    subtype Graphic_Character is
-     Character_Kind_Type range Upper_Case_Letter .. Other_Special_Character;
+     Character_Kind_Type range Lower_Case_Letter .. Other_Special_Character;
+
+   --  letter ::= upper_case_letter | lower_case_letter
+   subtype Letter is
+     Character_Kind_Type range Lower_Case_Letter .. Upper_Case_Letter;
 
    -- LRM93 13.1
    -- The characters included in each of the categories of basic graphic
@@ -765,6 +771,140 @@ package body Scanner is
       Current_Context.Str_Len := Length;
    end Scan_Dec_Bit_String;
 
+   --  LRM08 15.2 Character set
+   --  For each uppercase letter, there is a corresponding lowercase letter;
+   --  and for each lowercase letter except [y diaeresis] and [german sharp s],
+   --  there is a corresponding uppercase letter.
+   type Character_Map is array (Character) of Character;
+   To_Lower_Map : constant Character_Map :=
+     (
+      --  Uppercase ASCII letters.
+      'A' => 'a',
+      'B' => 'b',
+      'C' => 'c',
+      'D' => 'd',
+      'E' => 'e',
+      'F' => 'f',
+      'G' => 'g',
+      'H' => 'h',
+      'I' => 'i',
+      'J' => 'j',
+      'K' => 'k',
+      'L' => 'l',
+      'M' => 'm',
+      'N' => 'n',
+      'O' => 'o',
+      'P' => 'p',
+      'Q' => 'q',
+      'R' => 'r',
+      'S' => 's',
+      'T' => 't',
+      'U' => 'u',
+      'V' => 'v',
+      'W' => 'w',
+      'X' => 'x',
+      'Y' => 'y',
+      'Z' => 'z',
+
+      --  Lowercase ASCII letters.
+      'a' => 'a',
+      'b' => 'b',
+      'c' => 'c',
+      'd' => 'd',
+      'e' => 'e',
+      'f' => 'f',
+      'g' => 'g',
+      'h' => 'h',
+      'i' => 'i',
+      'j' => 'j',
+      'k' => 'k',
+      'l' => 'l',
+      'm' => 'm',
+      'n' => 'n',
+      'o' => 'o',
+      'p' => 'p',
+      'q' => 'q',
+      'r' => 'r',
+      's' => 's',
+      't' => 't',
+      'u' => 'u',
+      'v' => 'v',
+      'w' => 'w',
+      'x' => 'x',
+      'y' => 'y',
+      'z' => 'z',
+
+      --  Uppercase Latin-1 letters.
+      UC_A_Grave          => LC_A_Grave,
+      UC_A_Acute          => LC_A_Acute,
+      UC_A_Circumflex     => LC_A_Circumflex,
+      UC_A_Tilde          => LC_A_Tilde,
+      UC_A_Diaeresis      => LC_A_Diaeresis,
+      UC_A_Ring           => LC_A_Ring,
+      UC_AE_Diphthong     => LC_AE_Diphthong,
+      UC_C_Cedilla        => LC_C_Cedilla,
+      UC_E_Grave          => LC_E_Grave,
+      UC_E_Acute          => LC_E_Acute,
+      UC_E_Circumflex     => LC_E_Circumflex,
+      UC_E_Diaeresis      => LC_E_Diaeresis,
+      UC_I_Grave          => LC_I_Grave,
+      UC_I_Acute          => LC_I_Acute,
+      UC_I_Circumflex     => LC_I_Circumflex,
+      UC_I_Diaeresis      => LC_I_Diaeresis,
+      UC_Icelandic_Eth    => LC_Icelandic_Eth,
+      UC_N_Tilde          => LC_N_Tilde,
+      UC_O_Grave          => LC_O_Grave,
+      UC_O_Acute          => LC_O_Acute,
+      UC_O_Circumflex     => LC_O_Circumflex,
+      UC_O_Tilde          => LC_O_Tilde,
+      UC_O_Diaeresis      => LC_O_Diaeresis,
+      UC_O_Oblique_Stroke => LC_O_Oblique_Stroke,
+      UC_U_Grave          => LC_U_Grave,
+      UC_U_Acute          => LC_U_Acute,
+      UC_U_Circumflex     => LC_U_Circumflex,
+      UC_U_Diaeresis      => LC_U_Diaeresis,
+      UC_Y_Acute          => LC_Y_Acute,
+      UC_Icelandic_Thorn  => LC_Icelandic_Thorn,
+
+      --  Lowercase Latin-1 letters.
+      LC_A_Grave          => LC_A_Grave,
+      LC_A_Acute          => LC_A_Acute,
+      LC_A_Circumflex     => LC_A_Circumflex,
+      LC_A_Tilde          => LC_A_Tilde,
+      LC_A_Diaeresis      => LC_A_Diaeresis,
+      LC_A_Ring           => LC_A_Ring,
+      LC_AE_Diphthong     => LC_AE_Diphthong,
+      LC_C_Cedilla        => LC_C_Cedilla,
+      LC_E_Grave          => LC_E_Grave,
+      LC_E_Acute          => LC_E_Acute,
+      LC_E_Circumflex     => LC_E_Circumflex,
+      LC_E_Diaeresis      => LC_E_Diaeresis,
+      LC_I_Grave          => LC_I_Grave,
+      LC_I_Acute          => LC_I_Acute,
+      LC_I_Circumflex     => LC_I_Circumflex,
+      LC_I_Diaeresis      => LC_I_Diaeresis,
+      LC_Icelandic_Eth    => LC_Icelandic_Eth,
+      LC_N_Tilde          => LC_N_Tilde,
+      LC_O_Grave          => LC_O_Grave,
+      LC_O_Acute          => LC_O_Acute,
+      LC_O_Circumflex     => LC_O_Circumflex,
+      LC_O_Tilde          => LC_O_Tilde,
+      LC_O_Diaeresis      => LC_O_Diaeresis,
+      LC_O_Oblique_Stroke => LC_O_Oblique_Stroke,
+      LC_U_Grave          => LC_U_Grave,
+      LC_U_Acute          => LC_U_Acute,
+      LC_U_Circumflex     => LC_U_Circumflex,
+      LC_U_Diaeresis      => LC_U_Diaeresis,
+      LC_Y_Acute          => LC_Y_Acute,
+      LC_Icelandic_Thorn  => LC_Icelandic_Thorn,
+
+      --  Lowercase latin-1 characters without corresponding uppercase one.
+      LC_Y_Diaeresis      => LC_Y_Diaeresis,
+      LC_German_Sharp_S   => LC_German_Sharp_S,
+
+      --  Not a letter.
+      others => NUL);
+
    -- LRM93 13.3.1
    -- Basic Identifiers
    -- A basic identifier consists only of letters, digits, and underlines.
@@ -774,7 +914,7 @@ package body Scanner is
    --
    -- NB: At the call of this procedure, the current character must be a legal
    -- character for a basic identifier.
-   procedure Scan_Identifier
+   procedure Scan_Identifier (Allow_PSL : Boolean)
    is
       use Name_Table;
       C : Character;
@@ -815,7 +955,8 @@ package body Scanner is
                      if Vhdl_Std = Vhdl_87 then
                         Error_8bit;
                      end if;
-                     C := Ada.Characters.Handling.To_Lower (C);
+                     C := To_Lower_Map (C);
+                     pragma Assert (C /= NUL);
                   when Digit =>
                      raise Internal_Error;
                   when others =>
@@ -833,7 +974,7 @@ package body Scanner is
       end loop;
 
       if Source (Pos - 1) = '_' then
-         if not Flag_Psl then
+         if not Allow_PSL then
             --  Some PSL reserved words finish with '_'.  This case is handled
             --  later.
             Error_Msg_Scan ("identifier cannot finish with '_'");
@@ -965,6 +1106,11 @@ package body Scanner is
 
       -- Hash it.
       Current_Context.Identifier := Name_Table.Get_Identifier;
+      Current_Token := Tok_Identifier;
+   end Scan_Identifier;
+
+   procedure Identifier_To_Token is
+   begin
       if Current_Identifier in Std_Names.Name_Id_Keywords then
          -- LRM93 13.9
          --   The identifiers listed below are called reserved words and are
@@ -1068,14 +1214,12 @@ package body Scanner is
                Current_Token := Tok_Until;
             when others =>
                Current_Token := Tok_Identifier;
-               if C = '_' then
+               if Source (Pos - 1) = '_' then
                   Error_Msg_Scan ("identifiers cannot finish with '_'");
                end if;
          end case;
-      else
-         Current_Token := Tok_Identifier;
       end if;
-   end Scan_Identifier;
+   end Identifier_To_Token;
 
    --  LRM93 13.3.2
    --  EXTENDED_IDENTIFIER ::= \ GRAPHIC_CHARACTER { GRAPHIC_CHARACTER } \
@@ -1217,7 +1361,7 @@ package body Scanner is
                   if Vhdl_Std = Vhdl_87 and C > 'Z' then
                      Error_8bit;
                   end if;
-                  Nam_Buffer (I) := Ada.Characters.Handling.To_Lower (C);
+                  Nam_Buffer (I) := To_Lower_Map (C);
                when Lower_Case_Letter | Digit =>
                   if Vhdl_Std = Vhdl_87 and C > 'z' then
                      Error_8bit;
@@ -1250,6 +1394,37 @@ package body Scanner is
       end if;
    end Convert_Identifier;
 
+   --  Internal scanner function: return True if C must be considered as a line
+   --  terminator.  This also includes EOT (which terminates the file or is
+   --  invalid).
+   function Is_EOL (C : Character) return Boolean is
+   begin
+      case C is
+         when CR | LF | VT | FF | Files_Map.EOT =>
+            return True;
+         when others =>
+            return False;
+      end case;
+   end Is_EOL;
+
+   --  Advance scanner till the first non-space character.
+   procedure Skip_Spaces is
+   begin
+      while Source (Pos) = ' ' or Source (Pos) = HT loop
+         Pos := Pos + 1;
+      end loop;
+   end Skip_Spaces;
+
+   --  Eat all characters until end-of-line (not included).
+   procedure Skip_Until_EOL is
+   begin
+      while not Is_EOL (Source (Pos)) loop
+         --  Don't warn about invalid character, it's somewhat out of the
+         --  scope.
+         Pos := Pos + 1;
+      end loop;
+   end Skip_Until_EOL;
+
    --  Scan an identifier within a comment.  Only lower case letters are
    --  allowed.
    function Scan_Comment_Identifier return Boolean
@@ -1258,10 +1433,7 @@ package body Scanner is
       Len : Natural;
       C : Character;
    begin
-      --  Skip spaces.
-      while Source (Pos) = ' ' or Source (Pos) = HT loop
-         Pos := Pos + 1;
-      end loop;
+      Skip_Spaces;
 
       --  The identifier shall start with a lower case letter.
       if Source (Pos) not in 'a' .. 'z' then
@@ -1279,17 +1451,64 @@ package body Scanner is
       end loop;
 
       --  Shall be followed by a space or a new line.
-      case C is
-         when ' ' | HT | LF | CR =>
-            null;
-         when others =>
-            return False;
-      end case;
+      if not (C = ' ' or else C = HT or else Is_EOL (C)) then
+         return False;
+      end if;
 
       Nam_Length := Len;
       return True;
    end Scan_Comment_Identifier;
 
+   package Directive_Protect is
+      --  Called to scan a protect tool directive.
+      procedure Scan_Protect_Directive;
+   end Directive_Protect;
+
+   --  Body is put in a separate file to avoid pollution.
+   package body Directive_Protect is separate;
+
+   --  Called to scan a tool directive.
+   procedure Scan_Tool_Directive
+   is
+      procedure Error_Missing_Directive is
+      begin
+         Error_Msg_Scan
+           ("tool directive required after '`'");
+         Skip_Until_EOL;
+      end Error_Missing_Directive;
+
+      C : Character;
+   begin
+      --  The current character is '`'.
+      Pos := Pos + 1;
+      Skip_Spaces;
+
+      --  Check and scan identifier.
+      C := Source (Pos);
+      if Characters_Kind (C) not in Letter then
+         Error_Missing_Directive;
+         return;
+      end if;
+
+      Scan_Identifier (False);
+
+      if Current_Token /= Tok_Identifier then
+         Error_Missing_Directive;
+         return;
+      end if;
+
+      Skip_Spaces;
+
+      --  Dispatch according to the identifier.
+      if Current_Identifier = Std_Names.Name_Protect then
+         Directive_Protect.Scan_Protect_Directive;
+      else
+         Error_Msg_Scan
+           ("unknown tool directive %i ignored", +Current_Identifier);
+         Skip_Until_EOL;
+      end if;
+   end Scan_Tool_Directive;
+
    --  Scan tokens within a comment.  Return TRUE if Current_Token was set,
    --  return FALSE to discard the comment (ie treat it like a real comment).
    function Scan_Comment return Boolean
@@ -1383,6 +1602,7 @@ package body Scanner is
       << Again >> null;
 
       --  Skip commonly used separators.
+      --  (Like Skip_Spaces but manually inlined for speed).
       while Source (Pos) = ' ' or Source (Pos) = HT loop
          Pos := Pos + 1;
       end loop;
@@ -1448,10 +1668,7 @@ package body Scanner is
                --  In any case, a sequence of one or more format
                --  effectors other than horizontal tabulation must
                --  cause at least one end of line.
-               while Source (Pos) /= CR and Source (Pos) /= LF and
-                 Source (Pos) /= VT and Source (Pos) /= FF and
-                 Source (Pos) /= Files_Map.EOT
-               loop
+               while not Is_EOL (Source (Pos)) loop
                   --  LRM93 13.1
                   --  The only characters allowed in the text of a VHDL
                   --  description are the graphic characters and the format
@@ -1904,7 +2121,16 @@ package body Scanner is
                end if;
             end if;
             return;
-         when '$' | '`'
+         when '`' =>
+            if Vhdl_Std >= Vhdl_08 then
+               Scan_Tool_Directive;
+            else
+               Warning_Msg_Scan (Warnid_Directive,
+                                 "tool directives are ignored");
+               Skip_Until_EOL;
+            end if;
+            goto Again;
+         when '$'
            | Inverted_Exclamation .. Inverted_Question
            | Multiplication_Sign | Division_Sign =>
             Error_Msg_Scan
@@ -1929,23 +2155,19 @@ package body Scanner is
             Pos := Pos + 1;
             goto Again;
          when 'A' .. 'Z' | 'a' .. 'z' =>
-            Scan_Identifier;
+            Scan_Identifier (Flag_Psl);
+            Identifier_To_Token;
             return;
          when UC_A_Grave .. UC_O_Diaeresis
-           | UC_O_Oblique_Stroke .. UC_Icelandic_Thorn =>
-            if Vhdl_Std = Vhdl_87 then
-               Error_Msg_Scan
-                 ("upper case letters above 128 are not allowed in vhdl87");
-            end if;
-            Scan_Identifier;
-            return;
-         when LC_German_Sharp_S .. LC_O_Diaeresis
+           | UC_O_Oblique_Stroke .. UC_Icelandic_Thorn
+           | LC_German_Sharp_S .. LC_O_Diaeresis
            | LC_O_Oblique_Stroke .. LC_Y_Diaeresis =>
             if Vhdl_Std = Vhdl_87 then
                Error_Msg_Scan
-                 ("lower case letters above 128 are not allowed in vhdl87");
+                 ("non 7-bit latin-1 letters are not allowed in vhdl87");
             end if;
-            Scan_Identifier;
+            Scan_Identifier (False);
+            --  Not a reserved word.
             return;
          when NUL .. ETX | ENQ .. BS | SO .. US | DEL .. APC =>
             Error_Msg_Scan