[gnuastro-commits] master e14096b 3/3: Explanation on rpl_malloc error in make check

[Mohammad Akhlaghi]

branch: master
commit e14096bfbadfda2674359007ea81d21f426e342d
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>

    Explanation on rpl_malloc error in make check
    
    Alan Lefor kindly reported a problem with checking the Gnuastro
    installation on a fresh Arch Linux. While building the `versioncpp' test,
    it would complain about `rpl_malloc'. So he found this solution and it was
    added to the "Known issues" section of the book.
---
 doc/gnuastro.texi |   31 +++++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index df77b52..cc6feb0 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -3802,17 +3802,32 @@ installed from source.} Similar to the case for 
@file{LDFLAGS}
 @command{CPPFLAGS=-I/usr/local/include} to @command{./configure} to
 re-configure Gnuastro, then re-run make.
 
address@hidden
address@hidden @code{rpl_malloc}
address@hidden GNU portability library
address@hidden make check}: @emph{Complaint about @code{rpl_malloc} before the
+tests begin.} This is a problem with the different ways different operating
+systems implement C's @code{malloc} function. It doesn't happen when
+building Gnuastro with @command{$ make} because the GNU Portability Library
+(Gnulib) is used to compensate for the differences. But in @command{make
+check}, Gnulib is not used, so this error might pop-up there. To fix it,
+please re-run configure like below (adding any other options/arguments you
+might have already used):
+
address@hidden
+./configure ac_cv_func_malloc_0_nonnull=yes
address@hidden example
+
 @cindex Tests, only one passes
 @cindex @file{LD_LIBRARY_PATH}
 @item
address@hidden make check}: @emph{Only one (the first) test passes, all the
-rest fail.}  It is highly likely that your distribution doesn't look
-into the @file{/usr/local/lib} directory when searching for shared
-libraries. To make sure it is added to the list of directories, run
-the following command and restart your terminal: (you can ignore the
address@hidden and extra space if you type it, it is only necessary if
-you copy and paste). See @ref{Installation directory} for more
-details.
address@hidden make check}: @emph{Only one @file{.sh} test passes, all the rest
+fail.}  It is highly likely that your distribution doesn't look into the
address@hidden/usr/local/lib} directory when searching for shared libraries. To
+make sure it is added to the list of directories, run the following command
+and restart your terminal: (you can ignore the @command{\} and extra space
+if you type it, it is only necessary if you copy and paste). See
address@hidden directory} for more details.
 @example
 echo 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib' \
      >> ~/.bashrc