gcc/ada/style.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --                                S T Y L E                                 --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                                                                          --
   9 --          Copyright (C) 1992-2006, 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 2,  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 COPYING.  If not, write --
  19 -- to  the  Free Software Foundation,  51  Franklin  Street,  Fifth  Floor, --
  20 -- Boston, MA 02110-1301, USA.                                              --
  21 --                                                                          --
  22 -- GNAT was originally developed  by the GNAT team at  New York University. --
  23 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  24 --                                                                          --
  25 ------------------------------------------------------------------------------
  26
  27 --  This package collects all the routines used for style checking, as
  28 --  activated by the relevant command line option. These are gathered in a
  29 --  separate package so that they can more easily be customized. Calls to
  30 --  these subprograms are only made if Opt.Style_Check is set True.
  31
  32 with Errout;
  33 with Styleg;
  34 with Styleg.C;
  35 with Types;    use Types;
  36
  37 package Style is
  38
  39    package Style_Inst is new Styleg
  40      (Errout.Error_Msg,
  41       Errout.Error_Msg_S,
  42       Errout.Error_Msg_SC,
  43       Errout.Error_Msg_SP);
  44    --  Instantiation of Styleg for all subprograms that do not depend directly
  45    --  depend on the GNAT tree.
  46
  47    package Style_C_Inst is new Style_Inst.C
  48      (Errout.Error_Msg_N);
  49    --  Instantiation of Styleg.C for the subprograms that depend directly
  50    --  on the GNAT tree.
  51
  52    --  All subroutines below are renames of subroutines in the two
  53    --  instantiations above.
  54
  55    procedure Body_With_No_Spec (N : Node_Id)
  56      renames Style_C_Inst.Body_With_No_Spec;
  57    --  Called where N is a subprogram body node for a subprogram body
  58    --  for which no spec was given, i.e. a body acting as its own spec.
  59
  60    procedure Check_Abs_Not
  61      renames Style_Inst.Check_Abs_Not;
  62    --  Called after scanning an ABS or NOT operator to check spacing
  63
  64    procedure Check_Apostrophe
  65      renames Style_Inst.Check_Apostrophe;
  66    --  Called after scanning an apostrophe to check spacing
  67
  68    procedure Check_Arrow
  69      renames Style_Inst.Check_Arrow;
  70    --  Called after scanning out an arrow to check spacing
  71
  72    procedure Check_Attribute_Name (Reserved : Boolean)
  73      renames Style_Inst.Check_Attribute_Name;
  74    --  The current token is an attribute designator. Check that it is
  75    --  capitalized in an appropriate manner. Reserved is set if the attribute
  76    --  designator is a reserved word (access, digits, delta or range) to allow
  77    --  differing rules for the two cases.
  78
  79    procedure Check_Box
  80      renames Style_Inst.Check_Box;
  81    --  Called after scanning out a box to check spacing
  82
  83    procedure Check_Binary_Operator
  84      renames Style_Inst.Check_Binary_Operator;
  85    --  Called after scanning out a binary operator other than a plus, minus
  86    --  or exponentiation operator. Intended for checking spacing rules.
  87
  88    procedure Check_Exponentiation_Operator
  89      renames Style_Inst.Check_Exponentiation_Operator;
  90    --  Called after scanning out an exponentiation operator. Intended for
  91    --  checking spacing rules.
  92
  93    procedure Check_Colon
  94      renames Style_Inst.Check_Colon;
  95    --  Called after scanning out colon to check spacing
  96
  97    procedure Check_Colon_Equal
  98      renames Style_Inst.Check_Colon_Equal;
  99    --  Called after scanning out colon equal to check spacing
 100
 101    procedure Check_Comma
 102      renames Style_Inst.Check_Comma;
 103    --  Called after scanning out comma to check spacing
 104
 105    procedure Check_Comment
 106      renames Style_Inst.Check_Comment;
 107    --  Called with Scan_Ptr pointing to the first minus sign of a comment.
 108    --  Intended for checking any specific rules for comment placement/format.
 109
 110    procedure Check_Dot_Dot
 111      renames Style_Inst.Check_Dot_Dot;
 112    --  Called after scanning out dot dot to check spacing
 113
 114    procedure Check_EOF
 115      renames Style_Inst.Check_EOF;
 116    --  Called after scanning out end of file mark
 117
 118    procedure Check_HT
 119      renames Style_Inst.Check_HT;
 120    --  Called with Scan_Ptr pointing to a horizontal tab character
 121
 122    procedure Check_Identifier
 123      (Ref : Node_Or_Entity_Id;
 124       Def : Node_Or_Entity_Id)
 125      renames Style_C_Inst.Check_Identifier;
 126    --  Check style of identifier occurrence. Ref is an N_Identifier node whose
 127    --  spelling is to be checked against the Chars spelling in identifier node
 128    --  Def (which may be either an N_Identifier, or N_Defining_Identifier node)
 129
 130    procedure Check_Indentation
 131      renames Style_Inst.Check_Indentation;
 132    --  Called at the start of a new statement or declaration, with Token_Ptr
 133    --  pointing to the first token of the statement or declaration. The check
 134    --  is that the starting column is appropriate to the indentation rules if
 135    --  Token_Ptr is the first token on the line.
 136
 137    procedure Check_Left_Paren
 138      renames Style_Inst.Check_Left_Paren;
 139    --  Called after scanning out a left parenthesis to check spacing
 140
 141    procedure Check_Line_Terminator (Len : Int)
 142      renames Style_Inst.Check_Line_Terminator;
 143    --  Called with Scan_Ptr pointing to the first line terminator terminating
 144    --  the current line, used to check for appropriate line terminator and to
 145    --  check the line length (Len is the length of the current line). Note that
 146    --  the terminator may be the EOF character.
 147
 148    procedure Check_Pragma_Name
 149      renames Style_Inst.Check_Pragma_Name;
 150    --  The current token is a pragma identifier. Check that it is spelled
 151    --  properly (i.e. with an appropriate casing convention).
 152
 153    procedure Check_Right_Paren
 154      renames Style_Inst.Check_Right_Paren;
 155    --  Called after scanning out a right parenthesis to check spacing
 156
 157    procedure Check_Semicolon
 158      renames Style_Inst.Check_Semicolon;
 159    --  Called after scanning out a semicolon to check spacing
 160
 161    procedure Check_Then (If_Loc : Source_Ptr)
 162      renames Style_Inst.Check_Then;
 163    --  Called to check that THEN and IF keywords are appropriately positioned.
 164    --  The parameters show the first characters of the two keywords. This
 165    --  procedure is called only if THEN appears at the start of a line with
 166    --  Token_Ptr pointing to the THEN keyword.
 167
 168    procedure Check_Unary_Plus_Or_Minus
 169      renames Style_Inst.Check_Unary_Plus_Or_Minus;
 170    --  Called after scanning a unary plus or minus to check spacing
 171
 172    procedure Check_Vertical_Bar
 173      renames Style_Inst.Check_Vertical_Bar;
 174    --  Called after scanning a vertical bar to check spacing
 175
 176    procedure Check_Xtra_Parens (Loc : Source_Ptr)
 177      renames Style_Inst.Check_Xtra_Parens;
 178    --  Called after scanning a conditional expression that has at least one
 179    --  level of parentheses around the entire expression.
 180
 181    function Mode_In_Check return Boolean
 182      renames Style_Inst.Mode_In_Check;
 183    --  Determines whether style checking is active and the Mode_In_Check is
 184    --  set, forbidding the explicit use of mode IN.
 185
 186    procedure No_End_Name (Name : Node_Id)
 187      renames Style_Inst.No_End_Name;
 188    --  Called if an END is encountered where a name is allowed but not present.
 189    --  The parameter is the node whose name is the name that is permitted in
 190    --  the END line, and the scan pointer is positioned so that if an error
 191    --  message is to be generated in this situation, it should be generated
 192    --  using Error_Msg_SP.
 193
 194    procedure No_Exit_Name (Name : Node_Id)
 195      renames Style_Inst.No_Exit_Name;
 196    --  Called when exiting a named loop, but a name is not present on the EXIT.
 197    --  The parameter is the node whose name should have followed EXIT, and the
 198    --  scan pointer is positioned so that if an error message is to be
 199    --  generated, it should be generated using Error_Msg_SP.
 200
 201    procedure Non_Lower_Case_Keyword
 202      renames Style_Inst.Non_Lower_Case_Keyword;
 203    --  Called if a reserved keyword is scanned which is not spelled in all
 204    --  lower case letters. On entry Token_Ptr points to the keyword token.
 205    --  This is not used for keywords appearing as attribute designators,
 206    --  where instead Check_Attribute_Name (True) is called.
 207
 208    function RM_Column_Check return Boolean
 209      renames Style_Inst.RM_Column_Check;
 210    --  Determines whether style checking is active and the RM column check
 211    --  mode is set requiring checking of RM format layout.
 212
 213    procedure Subprogram_Not_In_Alpha_Order (Name : Node_Id)
 214      renames Style_C_Inst.Subprogram_Not_In_Alpha_Order;
 215    --  Called if Name is the name of a subprogram body in a package body
 216    --  that is not in alphabetical order.
 217
 218 end Style;