| 1 |
george 07/09/28 22:59:53 |
| 2 |
|
| 3 |
Modified: index.xml |
| 4 |
Added: dev_reference.xml |
| 5 |
Log: |
| 6 |
updated description of the project, added preliminary version of dev_reference |
| 7 |
|
| 8 |
Revision Changes Path |
| 9 |
1.3 xml/htdocs/proj/en/prog_lang/ada/index.xml |
| 10 |
|
| 11 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/index.xml?rev=1.3&view=markup |
| 12 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/index.xml?rev=1.3&content-type=text/plain |
| 13 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/index.xml?r1=1.2&r2=1.3 |
| 14 |
|
| 15 |
Index: index.xml |
| 16 |
=================================================================== |
| 17 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/prog_lang/ada/index.xml,v |
| 18 |
retrieving revision 1.2 |
| 19 |
retrieving revision 1.3 |
| 20 |
diff -u -r1.2 -r1.3 |
| 21 |
--- index.xml 11 Nov 2006 19:43:28 -0000 1.2 |
| 22 |
+++ index.xml 28 Sep 2007 22:59:52 -0000 1.3 |
| 23 |
@@ -6,7 +6,7 @@ |
| 24 |
<name>Ada</name> |
| 25 |
<longname>Gentoo Resources for Ada</longname> |
| 26 |
|
| 27 |
- <date>11 Nov 2006</date> |
| 28 |
+ <date>28 Sep 2007</date> |
| 29 |
|
| 30 |
<author title="Developer"> |
| 31 |
<mail link="george@g.o">George Shapovalov</mail> |
| 32 |
@@ -19,23 +19,24 @@ |
| 33 |
|
| 34 |
<longdescription> |
| 35 |
<p> |
| 36 |
- This project deals with various Ada compilers and libraries in portage. |
| 37 |
+ This project provides support for Ada compilers and libraries in portage. |
| 38 |
At present two gnat compilers are provided, gnat-gcc by FSF and gnat-gpl by |
| 39 |
AdaCore. Both are SLOTted and made to coexist, with the selection of the active |
| 40 |
- compiler performed via eselect gnat module. There are multiple Ada libraries |
| 41 |
- under dev-ada that are tuned to use these multiple compilers. Selection of the active |
| 42 |
- lib variant is done simultaneously with the selection of the active compiler |
| 43 |
- via the same eselect gnat command. More details on the setup can be found in the |
| 44 |
+ compiler performed via the eselect gnat module. Various Ada libraries and related |
| 45 |
+ packages are available under dev-ada. The libs support the multi-compiler |
| 46 |
+ situation by being built for every gnat profile that is installed. Selection |
| 47 |
+ of the active lib variant is done simultaneously with the selection of the |
| 48 |
+ active compiler via the same eselect gnat command. More details on the |
| 49 |
+ setup can be found in the |
| 50 |
resources section below and the lengthy discussion that lead to this system in |
| 51 |
<uri link="https://bugs.gentoo.org/show_bug.cgi?id=111340">bug #111340</uri>. |
| 52 |
</p> |
| 53 |
<p> |
| 54 |
- This setup is in the transitional stage at the moment, nearing completion. |
| 55 |
- Its progress can be tracked in the |
| 56 |
+ The implementation of the structure is nearing completion. Its progress can be |
| 57 |
+ tracked via: |
| 58 |
<uri link="https://bugs.gentoo.org/show_bug.cgi?id=137268">bug #137268</uri>. |
| 59 |
- "Old-style" dev-lang/gnat and dev-ada/asis packages are deprecated and will be |
| 60 |
- removed when the new setup is fully functional (dev-ada/asis is already masked, |
| 61 |
- dev-ada/asis-{gcc,gpl} should be used instead). One remaining consideration is |
| 62 |
+ "Old-style" dev-lang/gnat and dev-ada/asis packages have been masked and recently removed. |
| 63 |
+ One remaining consideration is |
| 64 |
dev-lang/gnat-3.15p, which still seems to have preferential use by some people. |
| 65 |
However that version no longer works with new binutils and requires an antiquated gcc |
| 66 |
backend. Help is sought by those interested to keep this version alive, in case there |
| 67 |
@@ -44,7 +45,12 @@ |
| 68 |
</longdescription> |
| 69 |
|
| 70 |
|
| 71 |
+<!-- <herd name="ada" /> --> |
| 72 |
+ |
| 73 |
<dev role="lead">george</dev> |
| 74 |
|
| 75 |
+<resource link="dev_reference.xml"> |
| 76 |
+ Developer reference: internal structure and organization of Ada packages. |
| 77 |
+</resource> |
| 78 |
|
| 79 |
</project> |
| 80 |
|
| 81 |
|
| 82 |
|
| 83 |
1.1 xml/htdocs/proj/en/prog_lang/ada/dev_reference.xml |
| 84 |
|
| 85 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/dev_reference.xml?rev=1.1&view=markup |
| 86 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/dev_reference.xml?rev=1.1&content-type=text/plain |
| 87 |
|
| 88 |
Index: dev_reference.xml |
| 89 |
=================================================================== |
| 90 |
<?xml version="1.0" encoding="UTF-8"?> |
| 91 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 92 |
<guide link="dev_reference.xml" lang="en"> |
| 93 |
|
| 94 |
<title>Developer reference: Internal structure and organization of Ada packages.</title> |
| 95 |
<author title="Author"> |
| 96 |
<mail link="george@g.o">George Shapovalov</mail> |
| 97 |
</author> |
| 98 |
|
| 99 |
<abstract> |
| 100 |
This is a guide to internal workings of the gnat and gnatbuild eclasses and eselect-gnat module, |
| 101 |
as well as an authoritative reference to packaging principles of Ada libs and other |
| 102 |
related packages. |
| 103 |
</abstract> |
| 104 |
|
| 105 |
<version>1.0</version> |
| 106 |
<date>28 Sep 2007</date> |
| 107 |
|
| 108 |
<chapter> |
| 109 |
<title>Overview</title> |
| 110 |
|
| 111 |
<section> |
| 112 |
<title>Introduction</title> |
| 113 |
<body> |
| 114 |
<p> |
| 115 |
Before you start on the internals of the Ada packages you may want to |
| 116 |
go through the <uri link="ada_ug.xml">user guide</uri> in case you are not familiar with |
| 117 |
how to activate the chosen gnat profile and where to look for the important files. |
| 118 |
</p> |
| 119 |
<p> |
| 120 |
Ada related packages can be divided into three important categories: |
| 121 |
</p> |
| 122 |
<dl> |
| 123 |
<dt>Compilers and packages that directly extend them.</dt> |
| 124 |
<dd> |
| 125 |
Currently two closely related "brands" are supported: |
| 126 |
<c>gnat-gcc</c> released by FSF and <c>gnat-gpl</c>, the |
| 127 |
AdaCore version. The primary example of the "extending" package would |
| 128 |
be asis, as it is closely tied to a particular version of compiler |
| 129 |
and installs directly to the same locations where the specs and libs |
| 130 |
of the corresponding gnat go. The packages in this category should use the |
| 131 |
<c>gnatbuild.eclass</c>. |
| 132 |
</dd> |
| 133 |
<dt>Ada libraries</dt> |
| 134 |
<dd> |
| 135 |
These are built for every installed gnat and profile-dependent files are |
| 136 |
installed to profile specific dirs, similarly to those of gnat, however they |
| 137 |
go in a "library place". This is handled automatically by gnat.eclass, inner |
| 138 |
workings of which are discussed <uri link="#doc_chap2">below</uri>. |
| 139 |
</dd> |
| 140 |
<dt>Executables/other programs</dt> |
| 141 |
<dd>The stuff that is to be executed directly or otherwise is not supposed to be linked |
| 142 |
against. The prominent examples would be gps, c2ada, etc. These require no special |
| 143 |
treatment and can be built in a regular way with any active compiler or can |
| 144 |
depend on a particular variant. |
| 145 |
</dd> |
| 146 |
</dl> |
| 147 |
<p> |
| 148 |
The profiles are switched vie eselect-gnat module, the usual way. Its internal workings |
| 149 |
are also discussed in the <uri link="#doc_chap1">chapter</uri> describing |
| 150 |
<c>gnatbuild.eclass</c>. |
| 151 |
</p> |
| 152 |
</body> |
| 153 |
</section> |
| 154 |
</chapter> |
| 155 |
|
| 156 |
<chapter> |
| 157 |
<title>gnatbuild.eclass and eselect-gnat</title> |
| 158 |
|
| 159 |
<section> |
| 160 |
<title>Introduction</title> |
| 161 |
<body> |
| 162 |
<p>To be completed. </p> |
| 163 |
</body> |
| 164 |
</section> |
| 165 |
</chapter> |
| 166 |
</guide> |
| 167 |
|
| 168 |
<!-- vim: set tabstop=2: --> |
| 169 |
<!-- vim: set shiftwidth=2: --> |
| 170 |
|
| 171 |
|
| 172 |
|
| 173 |
-- |
| 174 |
gentoo-commits@g.o mailing list |
Archives