Commit d56cbeed45ec911e782104e58ca6a24a830bf8ca

Authored by Jürgen Knödlseder
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,7 +22,9 @@ Below you will find a list of known issues.
22 many unit tests will fail. If you are sure that cfitsio is installed, 22 many unit tests will fail. If you are sure that cfitsio is installed,
23 but the path where the library and the path where the ``fitsio.h`` header 23 but the path where the library and the path where the ``fitsio.h`` header
24 reside are non-standard, you may add the paths explicitly during 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 $ ./configure LDFLAGS='-L/path/to/cftsio/library' CPPFLAGS='-I/path/to/fitsio.h/header' 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,6 +32,23 @@ Below you will find a list of known issues.
30 although these libraries are not manadatory for getting the full 32 although these libraries are not manadatory for getting the full
31 GammaLib functionalities. 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 .. _issue_python: 52 .. _issue_python:
34 53
35 .. topic:: Python module does not work 54 .. topic:: Python module does not work
@@ -73,7 +92,9 @@ Below you will find a list of known issues. @@ -73,7 +92,9 @@ Below you will find a list of known issues.
73 etc...). The easiest way to get the needed software is using a package 92 etc...). The easiest way to get the needed software is using a package
74 management system such as `MacPorts <https://www.macports.org/>`_ or 93 management system such as `MacPorts <https://www.macports.org/>`_ or
75 `Homebrew <http://brew.sh/>`_. On a fresh El Capitan install you need 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 $ brew install automake 99 $ brew install automake
79 $ brew install libtool 100 $ brew install libtool
@@ -108,7 +129,9 @@ Below you will find a list of known issues. @@ -108,7 +129,9 @@ Below you will find a list of known issues.
108 recommended library as more recent version feature relocation 129 recommended library as more recent version feature relocation
109 problems. GammaLib has been tested using gcc 4.3.2 on OpenSolaris 130 problems. GammaLib has been tested using gcc 4.3.2 on OpenSolaris
110 2009.06. Make sure to create the following symbolic links if they do 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 $ ln -s /usr/bin/gcc4.3.2 /usr/bin/gcc 136 $ ln -s /usr/bin/gcc4.3.2 /usr/bin/gcc
114 $ ln -s /usr/bin/g++4.3.2 /usr/bin/g++ 137 $ ln -s /usr/bin/g++4.3.2 /usr/bin/g++