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 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++
... ...