From 8c3129f8be1bb32556365221cb3fe06fcefa52c6 Mon Sep 17 00:00:00 2001 From: Wolfgang Kerzendorf Date: Wed, 27 May 2015 22:55:57 +0200 Subject: [PATCH 1/3] added a little FAQ --- docs/installation.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/installation.rst b/docs/installation.rst index 2c275e84fbf..af06d67da54 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -167,3 +167,11 @@ Before running, ensure that the directory ~/Library/Python/2.7/bin is in the app This has also been successfully tested on a clean MAC OS 10.9.1 (Mavericks) install. +Installation Troubles (FAQ) +=========================== + +We highly encourage with any installation problems to try the recommended install +method because this often fix problems. Here are some common problems when +installing and their fixes: + + * blah blah `python setup.py clean` blah blah `git -clean dfx` \ No newline at end of file From adb4a9b50209bb0c99662f080b602e5f27d56c9d Mon Sep 17 00:00:00 2001 From: Wolfgang Kerzendorf Date: Thu, 28 May 2015 17:41:09 +0200 Subject: [PATCH 2/3] added @unoebauers suggestion to the installation FAQ --- docs/installation.rst | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/installation.rst b/docs/installation.rst index af06d67da54..86a3148e9c3 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -174,4 +174,19 @@ We highly encourage with any installation problems to try the recommended instal method because this often fix problems. Here are some common problems when installing and their fixes: - * blah blah `python setup.py clean` blah blah `git -clean dfx` \ No newline at end of file +**Problem:** While building tardis via `python setup.py` build you +may encounter the following error:: + + error: tardis/montecarlo/montecarlo.c: Could not find C file tardis/montecarlo/montecarlo.c for Cython file tardis/montecarlo/montecarlo.pyx when building extension tardis.montecarlo.montecarlo. Cython must be installed to build from a git checkout. + + +**Solution:** There are several solutions to this problem. A clean checkout will +help. To clean up your repository please try `python setup.py clean` and +then `git clean -dfx` (**WARNING** will delete any non tardis file in that directory) +This will often clean this problem. If it still persists: + +Go into the tardis/montecarlo directory and build montecarlo.c by hand:: + + cython montecarlo.pyx + +Then, `python setup.py build` should run without problems. From 6657d16f27f82704f0176ccd94646f207ca419ba Mon Sep 17 00:00:00 2001 From: Wolfgang Kerzendorf Date: Thu, 28 May 2015 17:42:26 +0200 Subject: [PATCH 3/3] verbatized the commands --- docs/installation.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/installation.rst b/docs/installation.rst index 86a3148e9c3..a51c47b5037 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -174,19 +174,19 @@ We highly encourage with any installation problems to try the recommended instal method because this often fix problems. Here are some common problems when installing and their fixes: -**Problem:** While building tardis via `python setup.py` build you +**Problem:** While building tardis via ``python setup.py`` build you may encounter the following error:: error: tardis/montecarlo/montecarlo.c: Could not find C file tardis/montecarlo/montecarlo.c for Cython file tardis/montecarlo/montecarlo.pyx when building extension tardis.montecarlo.montecarlo. Cython must be installed to build from a git checkout. **Solution:** There are several solutions to this problem. A clean checkout will -help. To clean up your repository please try `python setup.py clean` and -then `git clean -dfx` (**WARNING** will delete any non tardis file in that directory) +help. To clean up your repository please try ``python setup.py clean`` and +then ``git clean -dfx`` (**WARNING** will delete any non tardis file in that directory) This will often clean this problem. If it still persists: Go into the tardis/montecarlo directory and build montecarlo.c by hand:: cython montecarlo.pyx -Then, `python setup.py build` should run without problems. +Then, ``python setup.py build`` should run without problems.