annotate gcc/ada/prepcomp.ads @ 158:494b0b89df80 default tip

...
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 25 May 2020 18:13:55 +0900
parents 1830386684a0
children
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 -- P R E P C O M P --
kono
parents:
diff changeset
6 -- --
kono
parents:
diff changeset
7 -- S p e c --
kono
parents:
diff changeset
8 -- --
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
9 -- Copyright (C) 2002-2019, 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 package stores all preprocessing data for the compiler
kono
parents:
diff changeset
27
kono
parents:
diff changeset
28 with Namet; use Namet;
kono
parents:
diff changeset
29 with Types; use Types;
kono
parents:
diff changeset
30
kono
parents:
diff changeset
31 package Prepcomp is
kono
parents:
diff changeset
32
kono
parents:
diff changeset
33 procedure Add_Dependency (S : Source_File_Index);
kono
parents:
diff changeset
34 -- Add a dependency on a non-source file. This is used internally for the
kono
parents:
diff changeset
35 -- preprocessing data file and the preprocessing definition file, and also
kono
parents:
diff changeset
36 -- externally for non-temporary configuration pragmas files.
kono
parents:
diff changeset
37
kono
parents:
diff changeset
38 procedure Add_Dependencies;
kono
parents:
diff changeset
39 -- Add dependencies on the preprocessing data file and the preprocessing
kono
parents:
diff changeset
40 -- definition files, if any, and the non-temporary configuration pragmas
kono
parents:
diff changeset
41 -- files, if any.
kono
parents:
diff changeset
42
kono
parents:
diff changeset
43 procedure Check_Symbols;
kono
parents:
diff changeset
44 -- Check if there are preprocessing symbols on the command line and set
kono
parents:
diff changeset
45 -- preprocessing if there are some: all files are preprocessed with these
kono
parents:
diff changeset
46 -- symbols. This procedure should not be called if there is a preprocessing
kono
parents:
diff changeset
47 -- data file specified on the command line. Instead a call should be made
kono
parents:
diff changeset
48 -- to Parse_Preprocessing_Data_File.
kono
parents:
diff changeset
49
kono
parents:
diff changeset
50 procedure Parse_Preprocessing_Data_File (N : File_Name_Type);
kono
parents:
diff changeset
51 -- Parse a preprocessing data file, specified with a -gnatep= switch
kono
parents:
diff changeset
52
kono
parents:
diff changeset
53 procedure Prepare_To_Preprocess
kono
parents:
diff changeset
54 (Source : File_Name_Type;
kono
parents:
diff changeset
55 Preprocessing_Needed : out Boolean);
kono
parents:
diff changeset
56 -- Prepare, if necessary, the preprocessor for a source file. If the source
kono
parents:
diff changeset
57 -- file needs to be preprocessed, Preprocessing_Needed is set to True.
kono
parents:
diff changeset
58 -- Otherwise, Preprocessing_Needed is set to False and no preprocessing
kono
parents:
diff changeset
59 -- needs to be done.
kono
parents:
diff changeset
60
kono
parents:
diff changeset
61 procedure Process_Command_Line_Symbol_Definitions;
kono
parents:
diff changeset
62 -- Check symbol definitions that have been added by calls to procedure
kono
parents:
diff changeset
63 -- Add_Symbol_Definition and stored as pointers to string, and put them in
kono
parents:
diff changeset
64 -- a table. The reason the definitions were stored as pointer to strings is
kono
parents:
diff changeset
65 -- that the name table is not yest initialized when we process the command
kono
parents:
diff changeset
66 -- line switches. These symbol definitions will be later used in
kono
parents:
diff changeset
67 -- the call to Prepare_To_Preprocess.
kono
parents:
diff changeset
68
kono
parents:
diff changeset
69 end Prepcomp;