| 1 |
george 07/09/29 20:20:19 |
| 2 |
|
| 3 |
Modified: dev_reference.xml index.xml |
| 4 |
Log: |
| 5 |
another update, dev_reference has only one chapter now |
| 6 |
|
| 7 |
Revision Changes Path |
| 8 |
1.2 xml/htdocs/proj/en/prog_lang/ada/dev_reference.xml |
| 9 |
|
| 10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/dev_reference.xml?rev=1.2&view=markup |
| 11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/dev_reference.xml?rev=1.2&content-type=text/plain |
| 12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/dev_reference.xml?r1=1.1&r2=1.2 |
| 13 |
|
| 14 |
Index: dev_reference.xml |
| 15 |
=================================================================== |
| 16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/prog_lang/ada/dev_reference.xml,v |
| 17 |
retrieving revision 1.1 |
| 18 |
retrieving revision 1.2 |
| 19 |
diff -u -r1.1 -r1.2 |
| 20 |
--- dev_reference.xml 28 Sep 2007 22:59:52 -0000 1.1 |
| 21 |
+++ dev_reference.xml 29 Sep 2007 20:20:19 -0000 1.2 |
| 22 |
@@ -31,7 +31,7 @@ |
| 23 |
Ada related packages can be divided into three important categories: |
| 24 |
</p> |
| 25 |
<dl> |
| 26 |
- <dt>Compilers and packages that directly extend them.</dt> |
| 27 |
+ <dt><b>Compilers and packages that directly extend them.</b></dt> |
| 28 |
<dd> |
| 29 |
Currently two closely related "brands" are supported: |
| 30 |
<c>gnat-gcc</c> released by FSF and <c>gnat-gpl</c>, the |
| 31 |
@@ -41,36 +41,52 @@ |
| 32 |
of the corresponding gnat go. The packages in this category should use the |
| 33 |
<c>gnatbuild.eclass</c>. |
| 34 |
</dd> |
| 35 |
- <dt>Ada libraries</dt> |
| 36 |
+ <dt><b>Ada libraries</b></dt> |
| 37 |
<dd> |
| 38 |
These are built for every installed gnat and profile-dependent files are |
| 39 |
installed to profile specific dirs, similarly to those of gnat, however they |
| 40 |
go in a "library place". This is handled automatically by gnat.eclass, inner |
| 41 |
- workings of which are discussed <uri link="#doc_chap2">below</uri>. |
| 42 |
+ workings of which are discussed below. |
| 43 |
</dd> |
| 44 |
- <dt>Executables/other programs</dt> |
| 45 |
+ <dt><b>Executables/other programs</b></dt> |
| 46 |
<dd>The stuff that is to be executed directly or otherwise is not supposed to be linked |
| 47 |
against. The prominent examples would be gps, c2ada, etc. These require no special |
| 48 |
treatment and can be built in a regular way with any active compiler or can |
| 49 |
- depend on a particular variant. |
| 50 |
+ depend on a particular variant. One particular issue should be observed however. |
| 51 |
+ If the execuables link against any of the |
| 52 |
+ profile-specific Ada libraries, when user switches gnat profile the particular |
| 53 |
+ binary versions of these libs will become unavailable. In fact, the linker will |
| 54 |
+ attempt to select the library by name and will try to link against the binary |
| 55 |
+ incompatible variant, resulting in execution failure. To resolve this, such binaries |
| 56 |
+ should be compiled with LD_RUN_PATH defined and containing the locations of the |
| 57 |
+ needed variants of the libs. |
| 58 |
</dd> |
| 59 |
</dl> |
| 60 |
<p> |
| 61 |
- The profiles are switched vie eselect-gnat module, the usual way. Its internal workings |
| 62 |
- are also discussed in the <uri link="#doc_chap1">chapter</uri> describing |
| 63 |
+ The profiles are switched via eselect-gnat module, the usual way. Its internal workings |
| 64 |
+ are also discussed in the chapter describing |
| 65 |
<c>gnatbuild.eclass</c>. |
| 66 |
</p> |
| 67 |
</body> |
| 68 |
</section> |
| 69 |
- </chapter> |
| 70 |
- |
| 71 |
- <chapter> |
| 72 |
- <title>gnatbuild.eclass and eselect-gnat</title> |
| 73 |
|
| 74 |
<section> |
| 75 |
- <title>Introduction</title> |
| 76 |
+ <title>gnatbuild.eclass and eselect-gnat</title> |
| 77 |
<body> |
| 78 |
- <p>To be completed. </p> |
| 79 |
+ <p> |
| 80 |
+ The <c>gnatbuildeclass</c> has been modelled after the <c>toolchain.eclass</c>, |
| 81 |
+ similarly providing multiple SLOTs tracking the gcc backend variations. One additional |
| 82 |
+ "complication" that we have in Ada case is that there are two related, however different |
| 83 |
+ compilers available, as mentioned above. These are provided as separate packages, |
| 84 |
+ <c>dev-lang/gnat-gcc</c> for FSF's Ada and <c>dev-lang/gnat-gpl</c> for the one by |
| 85 |
+ AdaCore. |
| 86 |
+ </p> |
| 87 |
+ <warn>Maintainer, beware! The last one has changed the license from GMGPL to pure GPL no |
| 88 |
+ so long ago.</warn> |
| 89 |
+ <p> |
| 90 |
+ It is possible they change it again to GPL-3 and FSF will likely want to do so as well. |
| 91 |
+ Therefore attention needs to be paid to the licenses when these packages are updated. |
| 92 |
+ </p> |
| 93 |
</body> |
| 94 |
</section> |
| 95 |
</chapter> |
| 96 |
|
| 97 |
|
| 98 |
|
| 99 |
1.4 xml/htdocs/proj/en/prog_lang/ada/index.xml |
| 100 |
|
| 101 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/index.xml?rev=1.4&view=markup |
| 102 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/index.xml?rev=1.4&content-type=text/plain |
| 103 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/prog_lang/ada/index.xml?r1=1.3&r2=1.4 |
| 104 |
|
| 105 |
Index: index.xml |
| 106 |
=================================================================== |
| 107 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/prog_lang/ada/index.xml,v |
| 108 |
retrieving revision 1.3 |
| 109 |
retrieving revision 1.4 |
| 110 |
diff -u -r1.3 -r1.4 |
| 111 |
--- index.xml 28 Sep 2007 22:59:52 -0000 1.3 |
| 112 |
+++ index.xml 29 Sep 2007 20:20:19 -0000 1.4 |
| 113 |
@@ -28,19 +28,12 @@ |
| 114 |
of the active lib variant is done simultaneously with the selection of the |
| 115 |
active compiler via the same eselect gnat command. More details on the |
| 116 |
setup can be found in the |
| 117 |
- resources section below and the lengthy discussion that lead to this system in |
| 118 |
+ resource section below and the lengthy discussion that lead to this organization in |
| 119 |
<uri link="https://bugs.gentoo.org/show_bug.cgi?id=111340">bug #111340</uri>. |
| 120 |
- </p> |
| 121 |
- <p> |
| 122 |
The implementation of the structure is nearing completion. Its progress can be |
| 123 |
tracked via: |
| 124 |
<uri link="https://bugs.gentoo.org/show_bug.cgi?id=137268">bug #137268</uri>. |
| 125 |
"Old-style" dev-lang/gnat and dev-ada/asis packages have been masked and recently removed. |
| 126 |
- One remaining consideration is |
| 127 |
- dev-lang/gnat-3.15p, which still seems to have preferential use by some people. |
| 128 |
- However that version no longer works with new binutils and requires an antiquated gcc |
| 129 |
- backend. Help is sought by those interested to keep this version alive, in case there |
| 130 |
- is such desire. |
| 131 |
</p> |
| 132 |
</longdescription> |
| 133 |
|
| 134 |
|
| 135 |
|
| 136 |
|
| 137 |
-- |
| 138 |
gentoo-commits@g.o mailing list |
Archives