blob: 4c4106b377ba11d8c94cf6f23ea938f6aca306e3 (
plain)
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
|
-- Specialisation of File_Comments for vhdl
-- Copyright (C) 2022 Tristan Gingold
--
-- This program 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 2 of the License, or
-- (at your option) any later version.
--
-- This program 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
-- along with this program. If not, see <gnu.org/licenses>.
-- All the variables declared in this package are set by Parse_Option function
-- and can by read as soon as the command line is parsed.
--
-- Since the names are not prefixed, this package is expected to be with'ed
-- but not to be use'd.
with Types; use Types;
with File_Comments; use File_Comments;
with Vhdl.Nodes; use Vhdl.Nodes;
package Vhdl.Comments is
-- Save comments and attached them to a node.
procedure Gather_Comments_Block (Rng : Comments_Range; N : Iir);
-- General rule:
-- Previous unattached comments are attached to node N.
-- Previous attached comments from the last empty line are attached to N.
--
-- For Gather_Comments_Block: the following comments until an empty line
-- will be attached to node N too.
-- For Gather_Comments_Line: if there is a comment on the same line, it
-- is attached to node N and so are the following comments until an
-- empty line.
procedure Gather_Comments_Block (N : Iir);
procedure Gather_Comments_Line (N : Iir);
-- Return the first comment attached to node N. FILE must be the file
-- of N.
-- Use File_Comments to iterate on comments.
function Find_First_Comment (File : Source_File_Entry; N : Node)
return Comment_Index;
end Vhdl.Comments;
|
