annotate gcc/ada/fname-sf.ads @ 131:84e7813d76e9

gcc-8.2
author mir3636
date Thu, 25 Oct 2018 07:37:49 +0900
parents 04ced10e8804
children 1830386684a0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 ------------------------------------------------------------------------------
kono
parents:
diff changeset
2 -- --
kono
parents:
diff changeset
3 -- GNAT COMPILER COMPONENTS --
kono
parents:
diff changeset
4 -- --
kono
parents:
diff changeset
5 -- F N A M E . S F --
kono
parents:
diff changeset
6 -- --
kono
parents:
diff changeset
7 -- S p e c --
kono
parents:
diff changeset
8 -- --
131
84e7813d76e9 gcc-8.2
mir3636
parents: 111
diff changeset
9 -- Copyright (C) 1992-2018, Free Software Foundation, Inc. --
111
kono
parents:
diff changeset
10 -- --
kono
parents:
diff changeset
11 -- GNAT is free software; you can redistribute it and/or modify it under --
kono
parents:
diff changeset
12 -- terms of the GNU General Public License as published by the Free Soft- --
kono
parents:
diff changeset
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
kono
parents:
diff changeset
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
kono
parents:
diff changeset
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
kono
parents:
diff changeset
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
kono
parents:
diff changeset
17 -- for more details. You should have received a copy of the GNU General --
kono
parents:
diff changeset
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
kono
parents:
diff changeset
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
kono
parents:
diff changeset
20 -- --
kono
parents:
diff changeset
21 -- GNAT was originally developed by the GNAT team at New York University. --
kono
parents:
diff changeset
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
kono
parents:
diff changeset
23 -- --
kono
parents:
diff changeset
24 ------------------------------------------------------------------------------
kono
parents:
diff changeset
25
kono
parents:
diff changeset
26 -- This child package contains a routine to read and process Source_File_Name
kono
parents:
diff changeset
27 -- pragmas from the gnat.adc file in the current directory. In order to use
kono
parents:
diff changeset
28 -- the routines in package Fname.UF, it is required that Source_File_Name
kono
parents:
diff changeset
29 -- pragmas be processed. There are two places where such processing takes
kono
parents:
diff changeset
30 -- place:
kono
parents:
diff changeset
31
kono
parents:
diff changeset
32 -- The compiler front end (par-prag.adb), which is the general circuit
kono
parents:
diff changeset
33 -- for processing all pragmas, including Source_File_Name.
kono
parents:
diff changeset
34
kono
parents:
diff changeset
35 -- The stand alone routine in this unit, which is convenient to use
kono
parents:
diff changeset
36 -- from tools that do not want to include the compiler front end.
kono
parents:
diff changeset
37
kono
parents:
diff changeset
38 -- Note that this unit does depend on several of the compiler front-end
kono
parents:
diff changeset
39 -- sources, including osint. If it is necessary to scan source file name
kono
parents:
diff changeset
40 -- pragmas with less dependence on such sources, look at unit SFN_Scan.
kono
parents:
diff changeset
41
kono
parents:
diff changeset
42 package Fname.SF is
kono
parents:
diff changeset
43
kono
parents:
diff changeset
44 procedure Read_Source_File_Name_Pragmas;
kono
parents:
diff changeset
45 -- This procedure is called to read the gnat.adc file and process any
kono
parents:
diff changeset
46 -- Source_File_Name pragmas contained in this file. All other pragmas
kono
parents:
diff changeset
47 -- are ignored. The result is appropriate calls to routines in the
kono
parents:
diff changeset
48 -- package Fname.UF to register the pragmas so that subsequent calls
kono
parents:
diff changeset
49 -- to Get_File_Name work correctly.
kono
parents:
diff changeset
50 --
kono
parents:
diff changeset
51 -- Note: The caller must have made an appropriate call to the
kono
parents:
diff changeset
52 -- Osint.Initialize routine to initialize Osint before calling
kono
parents:
diff changeset
53 -- this procedure.
kono
parents:
diff changeset
54 --
kono
parents:
diff changeset
55 -- If a syntax error is detected while scanning the gnat.adc file,
kono
parents:
diff changeset
56 -- then the exception SFN_Scan.Syntax_Error_In_GNAT_ADC is raised
kono
parents:
diff changeset
57 -- and SFN_Scan.Cursor contains the approximate index relative to
kono
parents:
diff changeset
58 -- the start of the gnat.adc file of the error.
kono
parents:
diff changeset
59
kono
parents:
diff changeset
60 end Fname.SF;