This file is indexed.

/usr/share/ada/adainclude/opentoken/opentoken-recognizer.ads is in libopentoken4-dev 5.0a-1.

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
-------------------------------------------------------------------------------
--
-- Copyright (C) 1999 FlightSafety International and 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.
--
-------------------------------------------------------------------------------

-----------------------------------------------------------------------------
--  This package declares an abstract type for recognizing a single
--  token. It is designed to be called by an instance of the
--  OpenToken.Analyzer class, which will typically be calling several
--  instances of Recognizer simultaniously to find the best match for
--  a string.
--
--  Note that the token analysis method of analyzing a character at a
--  time is a very fast method for complex grammars, but is also
--  fairly complicated to implement. Analyzers must be implemented as
--  state-machines and save their state between calls. This makes it a
--  bit tough for meer mortals to implement, so using the predefined
--  tokens in the child packages is highly reccomended where possible.
--  State information should be saved in the token itself to make the
--  system reentrant.
-----------------------------------------------------------------------------
package OpenToken.Recognizer is

   --  Indication from a recognizer of how the given string matches.
   type Analysis_Verdict is
     (Matches,         -- The string matches
      So_Far_So_Good,  -- The string might match if it were just a bit longer
      Failed);         -- The string will never match, no matter how many more characters it has


   type Instance is abstract tagged record
      --  Indication of if this token is to be reported to the parser
      --  (client) when it is found. Set to FALSE to ignore tokens
      --  like comments and whitespace.
      Report : Boolean := True;
   end record;

   subtype Class is Instance'Class;

   type Handle is access all Class;

   --------------------------------------------------------------------------
   --  This procedure will be called when analysis on a new candidate
   --  string is started. The Token needs to clear its state (if any).
   --------------------------------------------------------------------------
   procedure Clear (The_Token : in out Instance) is abstract;


   ----------------------------------------------------------------------------
   --  This procedure will be called to perform further analysis on a token
   --  based on the given next character.
   ----------------------------------------------------------------------------
   procedure Analyze (The_Token : in out Instance;
                      Next_Char : in Character;
                      Verdict   : out Analysis_Verdict) is abstract;

end OpenToken.Recognizer;