aboutsummaryrefslogtreecommitdiff
path: root/gcc/ada/lib-xref.ads
diff options
context:
space:
mode:
authorArnaud Charlet <charlet@gcc.gnu.org>2012-06-12 12:14:44 +0200
committerArnaud Charlet <charlet@gcc.gnu.org>2012-06-12 12:14:44 +0200
commit93901a431ff1050faddba401484ee8cc9c553e90 (patch)
tree92ef26c049da2ec8184dd48cb7db5e5da916e546 /gcc/ada/lib-xref.ads
parent3235dc87bf6bbe42b58a40f0d894283997e3100c (diff)
downloadgcc-93901a431ff1050faddba401484ee8cc9c553e90.zip
gcc-93901a431ff1050faddba401484ee8cc9c553e90.tar.gz
gcc-93901a431ff1050faddba401484ee8cc9c553e90.tar.bz2
[multiple changes]
2012-06-12 Robert Dewar <dewar@adacore.com> * xref_lib.adb, sem_ch13.adb, lib-xref.adb: Minor reformatting. 2012-06-12 Javier Miranda <miranda@adacore.com> * lib-xref.ads Adding missing documentation. From-SVN: r188439
Diffstat (limited to 'gcc/ada/lib-xref.ads')
-rw-r--r--gcc/ada/lib-xref.ads27
1 files changed, 20 insertions, 7 deletions
diff --git a/gcc/ada/lib-xref.ads b/gcc/ada/lib-xref.ads
index 7bdc158..c0fd316 100644
--- a/gcc/ada/lib-xref.ads
+++ b/gcc/ada/lib-xref.ads
@@ -565,22 +565,35 @@ package Lib.Xref is
-- y abstract function entry or entry family
-- z generic formal parameter (unused)
- --------------------------------------
- -- Handling of Imported Subprograms --
- --------------------------------------
+ ---------------------------------------------------
+ -- Handling of Imported and Exported Subprograms --
+ ---------------------------------------------------
-- If a pragma Import or Interface applies to a subprogram, the pragma is
-- the completion of the subprogram. This is noted in the ALI file by
-- making the occurrence of the subprogram in the pragma into a body
-- reference ('b') and by including the external name of the subprogram and
-- its language, bracketed by '<' and '>' in that reference. For example:
- --
- -- 3U13*elsewhere 4b<c,there>21
- --
- -- indicates that procedure elsewhere, declared at line 3, has a pragma
+
+ -- 3U13*imported_proc 4b<c,there>21
+
+ -- indicates that procedure imported_proc, declared at line 3, has a pragma
-- Import at line 4, that its body is in C, and that the link name as given
-- in the pragma is "there".
+ -- If a pragma Export applies to a subprogram exported to a foreign
+ -- language (ie. the pragma has convention different from Ada), then the
+ -- pragma is annotated in the ALI file by making the occurrence of the
+ -- subprogram in the pragma into an implicit reference ('i') and by
+ -- including the external name of the subprogram and its language,
+ -- bracketed by '<' and '>' in that reference. For example:
+
+ -- 3U13*exported_proc 4i<c,here>21
+
+ -- indicates that procedure exported_proc, declared at line 3, has a pragma
+ -- Export at line 4, that its body is exported to C, and that the link name
+ -- as given in the pragma is "here".
+
----------------------
-- Alfa Information --
----------------------