Subversion Repositories openrisc_2011-10-31

------------------------------------------------------------------------------

--                                                                          --

--                         GNAT COMPILER COMPONENTS                         --

--                                                                          --

--                                S T Y L E                                 --

--                                                                          --

--                                 S p e c                                  --

--                                                                          --

--          Copyright (C) 1992-2009, Free Software Foundation, Inc.         --

--                                                                          --

-- GNAT is free software;  you can  redistribute it  and/or modify it under --

-- terms of the  GNU General Public License as published  by the Free Soft- --

-- ware  Foundation;  either version 3,  or (at your option) any later ver- --

-- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --

-- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --

-- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --

-- for  more details.  You should have  received  a copy of the GNU General --

-- Public License  distributed with GNAT; see file COPYING3.  If not, go to --

-- http://www.gnu.org/licenses for a complete copy of the license.          --

--                                                                          --

-- GNAT was originally developed  by the GNAT team at  New York University. --

-- Extensive contributions were provided by Ada Core Technologies Inc.      --

--                                                                          --

------------------------------------------------------------------------------

--  This package collects all the routines used for style checking in the

--  compiler, as activated by the relevant command line option. These are

--  gathered in a separate package so that they can more easily be customized.

--  Calls to these subprograms are only made if Opt.Style_Check is set True.

with Errout;

with Styleg;

with Types;    use Types;

package Style is

   procedure Body_With_No_Spec (N : Node_Id);

   --  Called where N is a subprogram body node for a subprogram body

   --  for which no spec was given, i.e. a body acting as its own spec.

   procedure Check_Array_Attribute_Index

     (N  : Node_Id;

      E1 : Node_Id;

      D  : Int);

   --  Called for an array attribute specifying an index number. N is the

   --  node for the attribute, and E1 is the index expression (Empty if none

   --  present). If E1 is present, it is known to be a static integer. D is

   --  the number of dimensions of the array.

   procedure Check_Identifier

     (Ref : Node_Or_Entity_Id;

      Def : Node_Or_Entity_Id);

   --  Check style of identifier occurrence. Ref is an N_Identifier node whose

   --  spelling is to be checked against the Chars spelling in identifier node

   --  Def (which may be either an N_Identifier, or N_Defining_Identifier node)

   procedure Missing_Overriding (N : Node_Id; E : Entity_Id);

   --  Called where N is the declaration or body of an overriding operation,

   --  and the node does not have an overriding_indicator.

   procedure Subprogram_Not_In_Alpha_Order (Name : Node_Id);

   --  Called if Name is the name of a subprogram body in a package body

   --  that is not in alphabetical order.

   --  Remaining style routines come from instantiation of Styleg

   package Style_Inst is new Styleg

     (Errout.Error_Msg,

      Errout.Error_Msg_S,

      Errout.Error_Msg_SC,

      Errout.Error_Msg_SP);

   --  Instantiation of Styleg for compiler use

   procedure Check_Abs_Not

     renames Style_Inst.Check_Abs_Not;

   --  Called after scanning an ABS or NOT operator to check spacing

   procedure Check_Apostrophe

     renames Style_Inst.Check_Apostrophe;

   --  Called after scanning an apostrophe to check spacing

   procedure Check_Arrow

     renames Style_Inst.Check_Arrow;

   --  Called after scanning out an arrow to check spacing

   procedure Check_Attribute_Name (Reserved : Boolean)

     renames Style_Inst.Check_Attribute_Name;

   --  The current token is an attribute designator. Check that it is

   --  capitalized in an appropriate manner. Reserved is set if the attribute

   --  designator is a reserved word (access, digits, delta or range) to allow

   --  differing rules for the two cases.

   procedure Check_Boolean_Operator (Node : Node_Id)

     renames Style_Inst.Check_Boolean_Operator;

   --  Called after resolving AND or OR node to check short circuit rules

   procedure Check_Box

     renames Style_Inst.Check_Box;

   --  Called after scanning out a box to check spacing

   procedure Check_Binary_Operator

     renames Style_Inst.Check_Binary_Operator;

   --  Called after scanning out a binary operator other than a plus, minus

   --  or exponentiation operator. Intended for checking spacing rules.

   procedure Check_Exponentiation_Operator

     renames Style_Inst.Check_Exponentiation_Operator;

   --  Called after scanning out an exponentiation operator. Intended for

   --  checking spacing rules.

   procedure Check_Colon

     renames Style_Inst.Check_Colon;

   --  Called after scanning out colon to check spacing

   procedure Check_Colon_Equal

     renames Style_Inst.Check_Colon_Equal;

   --  Called after scanning out colon equal to check spacing

   procedure Check_Comma

     renames Style_Inst.Check_Comma;

   --  Called after scanning out comma to check spacing

   procedure Check_Comment

     renames Style_Inst.Check_Comment;

   --  Called with Scan_Ptr pointing to the first minus sign of a comment.

   --  Intended for checking any specific rules for comment placement/format.

   procedure Check_Dot_Dot

     renames Style_Inst.Check_Dot_Dot;

   --  Called after scanning out dot dot to check spacing

   procedure Check_EOF

     renames Style_Inst.Check_EOF;

   --  Called after scanning out end of file mark

   procedure Check_HT

     renames Style_Inst.Check_HT;

   --  Called with Scan_Ptr pointing to a horizontal tab character

   procedure Check_Indentation

     renames Style_Inst.Check_Indentation;

   --  Called at the start of a new statement or declaration, with Token_Ptr

   --  pointing to the first token of the statement or declaration. The check

   --  is that the starting column is appropriate to the indentation rules if

   --  Token_Ptr is the first token on the line.

   procedure Check_Left_Paren

     renames Style_Inst.Check_Left_Paren;

   --  Called after scanning out a left parenthesis to check spacing

   procedure Check_Line_Terminator (Len : Int)

     renames Style_Inst.Check_Line_Terminator;

   --  Called with Scan_Ptr pointing to the first line terminator terminating

   --  the current line, used to check for appropriate line terminator and to

   --  check the line length (Len is the length of the current line). Note that

   --  the terminator may be the EOF character.

   procedure Check_Pragma_Name

     renames Style_Inst.Check_Pragma_Name;

   --  The current token is a pragma identifier. Check that it is spelled

   --  properly (i.e. with an appropriate casing convention).

   procedure Check_Right_Paren

     renames Style_Inst.Check_Right_Paren;

   --  Called after scanning out a right parenthesis to check spacing

   procedure Check_Semicolon

     renames Style_Inst.Check_Semicolon;

   --  Called after scanning out a semicolon to check spacing

   procedure Check_Then (If_Loc : Source_Ptr)

     renames Style_Inst.Check_Then;

   --  Called to check that THEN and IF keywords are appropriately positioned.

   --  The parameters show the first characters of the two keywords. This

   --  procedure is called only if THEN appears at the start of a line with

   --  Token_Ptr pointing to the THEN keyword.

   procedure Check_Unary_Plus_Or_Minus

     renames Style_Inst.Check_Unary_Plus_Or_Minus;

   --  Called after scanning a unary plus or minus to check spacing

   procedure Check_Vertical_Bar

     renames Style_Inst.Check_Vertical_Bar;

   --  Called after scanning a vertical bar to check spacing

   procedure Check_Xtra_Parens (Loc : Source_Ptr)

     renames Style_Inst.Check_Xtra_Parens;

   --  Called after scanning a conditional expression that has at least one

   --  level of parentheses around the entire expression.

   function Mode_In_Check return Boolean

     renames Style_Inst.Mode_In_Check;

   --  Determines whether style checking is active and the Mode_In_Check is

   --  set, forbidding the explicit use of mode IN.

   procedure No_End_Name (Name : Node_Id)

     renames Style_Inst.No_End_Name;

   --  Called if an END is encountered where a name is allowed but not present.

   --  The parameter is the node whose name is the name that is permitted in

   --  the END line, and the scan pointer is positioned so that if an error

   --  message is to be generated in this situation, it should be generated

   --  using Error_Msg_SP.

   procedure No_Exit_Name (Name : Node_Id)

     renames Style_Inst.No_Exit_Name;

   --  Called when exiting a named loop, but a name is not present on the EXIT.

   --  The parameter is the node whose name should have followed EXIT, and the

   --  scan pointer is positioned so that if an error message is to be

   --  generated, it should be generated using Error_Msg_SP.

   procedure Non_Lower_Case_Keyword

     renames Style_Inst.Non_Lower_Case_Keyword;

   --  Called if a reserved keyword is scanned which is not spelled in all

   --  lower case letters. On entry Token_Ptr points to the keyword token.

   --  This is not used for keywords appearing as attribute designators,

   --  where instead Check_Attribute_Name (True) is called.

end Style;