Commit ff7f7a1428480dcbafb8782369c56cd696dfa154
1 parent
0e75f692
Update
Showing
1 changed file
with
41 additions
and
3 deletions
doc/source/user_manual/getting.rst
| @@ -144,8 +144,7 @@ https://sourceforge.net/projects/gammalib/. The code can be downloaded | @@ -144,8 +144,7 @@ https://sourceforge.net/projects/gammalib/. The code can be downloaded | ||
| 144 | from this site by clicking on the download button. Alternatively, the | 144 | from this site by clicking on the download button. Alternatively, the |
| 145 | code can be downloaded and unpacked from the UNIX prompt using:: | 145 | code can be downloaded and unpacked from the UNIX prompt using:: |
| 146 | 146 | ||
| 147 | - $ wget --no-check-certificate https://downloads.sourceforge.net/project/gammalib/ | ||
| 148 | - gammalib/gammalib-00-08-00.tar.gz | 147 | + $ wget --no-check-certificate https://downloads.sourceforge.net/project/gammalib/gammalib/gammalib-00-08-00.tar.gz |
| 149 | $ tar xfz gammalib-00-08-00.tar.gz | 148 | $ tar xfz gammalib-00-08-00.tar.gz |
| 150 | 149 | ||
| 151 | The GammaLib source code can also be cloned using git. This method is | 150 | The GammaLib source code can also be cloned using git. This method is |
| @@ -539,4 +538,43 @@ or by sending an e-mail to the mailing list. | @@ -539,4 +538,43 @@ or by sending an e-mail to the mailing list. | ||
| 539 | Known problems | 538 | Known problems |
| 540 | -------------- | 539 | -------------- |
| 541 | 540 | ||
| 542 | -Solaris (TBW) | 541 | +* Python support |
| 542 | + GammaLib comes with Python wrappers so that all classes can be directly | ||
| 543 | + used from Python. To compile-in Python support, GammaLib needs the | ||
| 544 | + Python.h header file, which on many distributions is not installed by | ||
| 545 | + default. To make Python.h available, install the Python developer | ||
| 546 | + package in your distribution using the package manager. Otherwise you | ||
| 547 | + will not be able to use GammaLib from Python. | ||
| 548 | + | ||
| 549 | +* Mac OS X | ||
| 550 | + The Python development package is not installed as default on Mac OS X, | ||
| 551 | + and consequently, the Python.h header file is missing that is needed to | ||
| 552 | + compile in the Python bindings. The configure script recognises this | ||
| 553 | + fact and adjust the build procedure accordingly, but you will not be | ||
| 554 | + able to use GammaLib from Python. So better install the Python | ||
| 555 | + development package before installing GammaLib (see above). | ||
| 556 | + | ||
| 557 | +* Solaris | ||
| 558 | + Although GammaLib builds on Solaris using the Sun compiler, there are | ||
| 559 | + problems with global symbols in shared libraries and exception catching, | ||
| 560 | + which prevents the FITS interface to work correctly. GammaLib has | ||
| 561 | + however been built and tested successfully using the GNU compiler, and | ||
| 562 | + this is the only build method that is currently supported. Problems have | ||
| 563 | + also been encountered when compiling cfitsio versions more recent than | ||
| 564 | + 3.250. The problems have been reported to the cfitsio developer team, | ||
| 565 | + and are likely to be solved in the future. For the time being, it is | ||
| 566 | + recommended to use cfitsio version 3.250 on Solaris. | ||
| 567 | + | ||
| 568 | +* OpenSolaris | ||
| 569 | + On OpenSolaris, the same problems concerning the SunStudio compiler | ||
| 570 | + occur as for Solaris, and also here, the GNU compiler is the recommended | ||
| 571 | + tool to build GammaLib. Also here, cfitsio version 3.250 is the | ||
| 572 | + recommended library as more recent version feature relocation | ||
| 573 | + problems. GammaLib has been tested using gcc 4.3.2 on OpenSolaris | ||
| 574 | + 2009.06. Make sure to create the symbolic links :: | ||
| 575 | + | ||
| 576 | + $ ln -s /usr/bin/gcc4.3.2 /usr/bin/gcc | ||
| 577 | + $ ln -s /usr/bin/g++4.3.2 /usr/bin/g++ | ||
| 578 | + | ||
| 579 | + which are not there by default to avoid excess warnings during | ||
| 580 | + compilation. |