File: asis_ug_14.html

package info (click to toggle)
asis 2008-5
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 9,724 kB
  • ctags: 615
  • sloc: ada: 95,867; makefile: 259; xml: 19
file content (146 lines) | stat: -rw-r--r-- 5,414 bytes parent folder | download
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
<HTML>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created on May, 22  2008 by texi2html 1.64-gnat-1 -->
<!-- 
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
            Karl Berry  <karl@freefriends.org>
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
            and many others.
Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
 
-->
<HEAD>
<TITLE>ASIS-for-GNAT User's Guide: File Naming Conventions and Application Name Space</TITLE>
<META NAME="description" CONTENT="ASIS-for-GNAT User's Guide: File Naming Conventions and Application Name Space">
<META NAME="keywords" CONTENT="ASIS-for-GNAT User's Guide: File Naming Conventions and Application Name Space">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="texi2html 1.64-gnat-1">

</HEAD>

<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">

<A NAME="SEC55"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_13.html#SEC54"> &lt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_15.html#SEC56"> &gt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_3.html#SEC9"> &lt;&lt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug.html#SEC_Top"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug.html#SEC_Top">Top</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_toc.html#SEC_Contents">Contents</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_15.html#SEC56">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H1> 13. File Naming Conventions and Application Name Space </H1>
<!--docid::SEC55::-->
<P>

Any ASIS application depends on the ASIS
interface components; an ASIS application programmer thus needs to be alert to (and to avoid)
clashes with the names of these components.
</P><P>

ASIS-for-GNAT includes the full specification of the ASIS Standard,
and also adds the following children and grandchildren of the root <CODE>Asis</CODE> package:
<A NAME="IDX165"></A>
</P><P>

<UL>
<LI>
<CODE>Asis.Extensions</CODE> hierarchy (the source file names start with
  <TT>`asis-extensions'</TT>) defines some useful ASIS extensions, see ASIS
  Reference Manual for more details.
<A NAME="IDX166"></A>
<P>

<LI>
<CODE>Asis.Set_Get</CODE> (the source files <TT>`asis-set_get.ad(b|s)'</TT>
  respectively) contains the access and update subprograms for the
  implementation of the main ASIS abstractions defined in <CODE>Asis</CODE>.
<A NAME="IDX167"></A>
<P>

<LI>
<CODE>Asis.Text.Set_Get</CODE> (the source files <TT>`asis-text-set_get.ad(b|s)'</TT>
  respectively) contains the access and update subprograms for the
  implementation of the ASIS abstractions defined in <CODE>Asis.Text</CODE>;
<A NAME="IDX168"></A>
</UL>
<P>

All other ASIS-for-GNAT Ada implementation components belong to the
hierarchy rooted at the package <CODE>A4G</CODE>
<A NAME="IDX169"></A>
(which comes from "ASIS-for-GNAT").
</P><P>

ASIS-for-GNAT also incorporates the following GNAT components as a part of the
ASIS implementation:
</P><P>

<TABLE><tr><td>&nbsp;</td><td class=smallexample><FONT SIZE=+0><pre>   Alloc
   Atree
   Casing
   Csets
   Debug
   Einfo
   Elists
   Fname
   Gnatvsn
   Hostparm
   Krunch
   Lib
     Lib.List
     Lib.Sort
   Namet
   Nlists
   Opt
   Output
   Repinfo
   Scans
   Sinfo
   Sinput
   Snames
   Stand
   Stringt
   Table
   Tree_In
   Tree_Io
   Types
   Uintp
   Uname
   Urealp
   Widechar
</FONT></pre></td></tr></table></P><P>

Therefore, in your ASIS application you should not add children at any level of the <CODE>Asis</CODE>
or <CODE>A4G</CODE> hierarchies, and you should avoid using
any name from the list of the GNAT component names above.
</P><P>

All Ada source files making up the ASIS implementation for GNAT (including
the GNAT components being a part of ASIS-for-GNAT) follow the GNAT file name
conventions without any name "krunch"ing.
</P><P>

<A NAME="Index"></A>
<HR SIZE="6">
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_3.html#SEC9"> &lt;&lt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug.html#SEC_Top">Top</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_toc.html#SEC_Contents">Contents</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_15.html#SEC56">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="asis_ug_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<BR>  
<FONT SIZE="-1">
This document was generated
by <I>Mail Server</I> on <I>May, 22  2008</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html/"><I>texi2html</I></A>

</BODY>
</HTML>