Commit d56cbeed45ec911e782104e58ca6a24a830bf8ca
1 parent
e6e41a4e
Update known issues.
Showing
1 changed file
with
26 additions
and
3 deletions
doc/source/issues.rst
| ... | ... | @@ -22,7 +22,9 @@ Below you will find a list of known issues. |
| 22 | 22 | many unit tests will fail. If you are sure that cfitsio is installed, |
| 23 | 23 | but the path where the library and the path where the ``fitsio.h`` header |
| 24 | 24 | reside are non-standard, you may add the paths explicitly during |
| 25 | - configuration using:: | |
| 25 | + configuration using: | |
| 26 | + | |
| 27 | + .. code-block:: bash | |
| 26 | 28 | |
| 27 | 29 | $ ./configure LDFLAGS='-L/path/to/cftsio/library' CPPFLAGS='-I/path/to/fitsio.h/header' |
| 28 | 30 | |
| ... | ... | @@ -30,6 +32,23 @@ Below you will find a list of known issues. |
| 30 | 32 | although these libraries are not manadatory for getting the full |
| 31 | 33 | GammaLib functionalities. |
| 32 | 34 | |
| 35 | + Alternatively, cfitsio can be found when compiling GammaLib but not | |
| 36 | + when using the shared library. To solve the issue, locate the | |
| 37 | + directory where the shared ``libcfitsio`` library resides and then type | |
| 38 | + | |
| 39 | + .. code-block:: bash | |
| 40 | + | |
| 41 | + $ export LD_LIBRARY_PATH=/directory/to/lib:$LD_LIBRARY_PATH | |
| 42 | + | |
| 43 | + on Unix based systems or | |
| 44 | + | |
| 45 | + .. code-block:: bash | |
| 46 | + | |
| 47 | + $ export DYLD_LIBRARY_PATH=/directory/to/lib:$DYLD_LIBRARY_PATH | |
| 48 | + | |
| 49 | + on Mac OS X (``/directory/to/lib`` should be replaced by the correct | |
| 50 | + library path on your system). | |
| 51 | + | |
| 33 | 52 | .. _issue_python: |
| 34 | 53 | |
| 35 | 54 | .. topic:: Python module does not work |
| ... | ... | @@ -73,7 +92,9 @@ Below you will find a list of known issues. |
| 73 | 92 | etc...). The easiest way to get the needed software is using a package |
| 74 | 93 | management system such as `MacPorts <https://www.macports.org/>`_ or |
| 75 | 94 | `Homebrew <http://brew.sh/>`_. On a fresh El Capitan install you need |
| 76 | - for example the following from `Homebrew <http://brew.sh/>`_:: | |
| 95 | + for example the following from `Homebrew <http://brew.sh/>`_: | |
| 96 | + | |
| 97 | + .. code-block:: bash | |
| 77 | 98 | |
| 78 | 99 | $ brew install automake |
| 79 | 100 | $ brew install libtool |
| ... | ... | @@ -108,7 +129,9 @@ Below you will find a list of known issues. |
| 108 | 129 | recommended library as more recent version feature relocation |
| 109 | 130 | problems. GammaLib has been tested using gcc 4.3.2 on OpenSolaris |
| 110 | 131 | 2009.06. Make sure to create the following symbolic links if they do |
| 111 | - not yet exist on your system :: | |
| 132 | + not yet exist on your system: | |
| 133 | + | |
| 134 | + .. code-block:: bash | |
| 112 | 135 | |
| 113 | 136 | $ ln -s /usr/bin/gcc4.3.2 /usr/bin/gcc |
| 114 | 137 | $ ln -s /usr/bin/g++4.3.2 /usr/bin/g++ | ... | ... |