This file is indexed.

/usr/share/ada/adainclude/opentoken/opentoken-production.ads is in libopentoken5-dev 6.0b-4.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
-------------------------------------------------------------------------------
--
-- Copyright (C) 2003, 2013, 2014 Stephe Leake
-- Copyright (C) 1999 Ted Dennison
--
-- This file is part of the OpenToken package.
--
-- The OpenToken package is free software; you can redistribute it and/or
-- modify it under the terms of the  GNU General Public License as published
-- by the Free Software Foundation; either version 3, or (at your option)
-- any later version. The OpenToken package is distributed in the hope that
-- it will be useful, but WITHOUT 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 the OpenToken
-- package;  see file GPL.txt.  If not, write to  the Free Software Foundation,
-- 59 Temple Place - Suite 330,  Boston, MA 02111-1307, USA.
--
--  As a special exception, if other files instantiate generics from
--  this unit, or you link this unit with other files to produce an
--  executable, this unit does not by itself cause the resulting
--  executable to be covered by the GNU General Public License. This
--  exception does not however invalidate any other reasons why the
--  executable file might be covered by the GNU Public License.
--
-------------------------------------------------------------------------------

with OpenToken.Token.Enumerated.List;
with OpenToken.Token.Enumerated.Nonterminal;

pragma Elaborate_All (OpenToken.Token.Enumerated);

-------------------------------------------------------------------------------
--  This package provides a type and operations for building grammar
--  productions.
-------------------------------------------------------------------------------
generic
   with package Token is new OpenToken.Token.Enumerated (<>);
   with package Token_List is new Token.List;
   with package Nonterminal is new Token.Nonterminal (Token_List);
package OpenToken.Production is

   ----------------------------------------------------------------------------
   --  The Right Hand Side of a production is a token list "+"ed with a
   --  synthesization routine. For example:
   --     Number & Minus_Sign & Number + Nonterminal.Synthesize_First
   --
   type Right_Hand_Side is private;

   --  Create the right hand side of a production from a list of
   --  tokens and a synthesization routine. The synthesization routine
   --  will be called whenever the production is reduced by the
   --  parser.

   function "+"
     (Tokens : in Token_List.Instance;
      Action : in Nonterminal.Synthesize)
     return Right_Hand_Side;
   function "+"
     (Tokens : in Token.Class;
      Action : in Nonterminal.Synthesize)
     return Right_Hand_Side;
   function "+"
     (Action : in Nonterminal.Synthesize)
     return Right_Hand_Side;

   function "+"
     (Tokens : in Token_List.Instance;
      Index  : in Integer)
     return Right_Hand_Side;
   function "+"
     (Tokens : in Token.Class;
      Index  : in Integer)
     return Right_Hand_Side;
   --  Add an index used to help identify the production.

   function "+"
     (Index  : in Integer)
     return Right_Hand_Side;
   --  A right hand side with no tokens

   ----------------------------------------------------------------------------
   --  A production instance consists of a nonterminal token instance "<=" ed to
   --  a Right Hand Side . For example:
   --    Subtraction <= Number & Minus_Sign & Number +
   --                   Nonterminal.Synthesize_Self
   --
   --  If a token list with no synthesization routine is used, the target
   --  non-terminal's default synthesization routine will be used. For example:
   --    Subtraction <= Number & Minus_Sign & Number
   --  will use Subtraction's default synthesization routine.
   --
   type Instance is private;

   type Handle is access all Instance;

   ----------------------------------------------------------------------------
   --  Production building operators using Right Hand Sides
   ----------------------------------------------------------------------------
   function "<=" (LHS : in Nonterminal.Handle;
                  RHS : in Right_Hand_Side
                 ) return Instance;

   function "<=" (LHS : in Nonterminal.Class;
                  RHS : in Right_Hand_Side
                 ) return Instance;

   ----------------------------------------------------------------------------
   --  Production building operators using token lists
   ----------------------------------------------------------------------------
   function "<=" (LHS : in Nonterminal.Handle;
                  RHS : in Token_List.Instance
                 ) return Instance;

   function "<=" (LHS : in Nonterminal.Class;
                  RHS : in Token_List.Instance
                 ) return Instance;

   ----------------------------------------------------------------------------
   --  Production building operators using tokens
   ----------------------------------------------------------------------------
   function "<=" (LHS : in Nonterminal.Handle;
                  RHS : in Token.Class
                 ) return Instance;

   function "<=" (LHS : in Nonterminal.Class;
                  RHS : in Token.Class
                 ) return Instance;

   ----------
   --  Access functions

   function First_Token (Item : in Instance) return Token_List.List_Iterator;
   function LHS (Item : in Instance) return Nonterminal.Handle;
   function LHS_ID (Item : in Instance) return Token.Token_ID;
   function Index (Item : in Instance) return Integer;
   function Action (Item : in Instance) return Nonterminal.Synthesize;

private

   type Right_Hand_Side is record
      Tokens : Token_List.Instance;
      Action : Nonterminal.Synthesize;
      Index  : Integer; -- In grammar rule
   end record;

   type Instance is record
      LHS : Nonterminal.Handle;
      RHS : Right_Hand_Side;
   end record;

end OpenToken.Production;