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 | 144 | from this site by clicking on the download button. Alternatively, the |
| 145 | 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 | 148 | $ tar xfz gammalib-00-08-00.tar.gz |
| 150 | 149 | |
| 151 | 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 | 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. | ... | ... |