Comment (by Roland Haas):

Hello @Federico Cipolletta ,

last question first: yes you are welcome to directly push documentation, no review required.

The note may require some clarification though:

• the tarball in “dist” is only used if either THORN_DIR is set to BUILD or is left empty and no precompiled copy of the library (any version, for the most part anyway) is found. Ie the FFTW thorn, while it includes 3.3.3 tarball, will accept any installed version (both newer and older)
• the directories are stripped from THORN_INC_DIRS which default to THORN_DIR/include

• the same stripping happens to THORN_LIB_DIRS in lib/sbin/strip-libdirs.sh which a larger list of directories:

  1. /lib
  2. /usr/lib
  3. /usr/local/lib
  4. /lib64
  5. /usr/lib64
  6. /usr/local/lib64

You may want to add that “since the compiler is assumed to search them automatically at the end of all explicitly passed locations. This avoids picking up other libraries installed in these system locations.”.

--
Ticket URL: https://bitbucket.org/einsteintoolkit/tickets/issues/2428/possible-issue-between-externallibraries