changelog

CHANGES/v2.5.md

@@ -6,6 +6,9 @@ Changes from version 2.4 which are relevant for users:
 - Changes leading to incompatible behavior:
   - \ref RMSD, \ref PATHMSD, \ref PROPERTYMAP, \ref PCAVARS, \ref PCARMSD, \ref FIT_TO_TEMPLATE and \ref DIPOLE now automatically make molecules whole.
     In case you do not want them to do it, use NOPBC flag,
+  - There is some subtle change in the installation layout (see below). There should be no visible effect, however it is now compulsory
+    to set correctly the `LD_LIBRARY_PATH` variable for the linux executable to work correctly. The procedure has been tested well on OSX and Linux,
+    but could give problems on other platform. Please report possible problems on the mailing list.
 
 - New actions:
   - \ref PAMM
@@ -46,7 +49,11 @@ Changes from version 2.4 which are relevant for developers:
   (WORK IN PROGRESS: in principle we could aim at eliminating all delete statements)
 - Exceptions cannot be disabled (`--disable-cxx-exceptions` option has been removed from `./configure`).
 - Every exception thrown in PLUMED now also writes its message on PLUMED log.
-- On OSX, `libplumed.dylib` links to `libplumedKernel.dylib` and `plumed` links to `libplumed.dylib`.
+- The installation layout of shared libraries has been modified. In particular,
+  `libplumed.so` links to `libplumedKernel.so` and `plumed` links to `libplumed.so`.
+  This reduces considerably the size of the installed package. In addition, it allows
+  using two-level namespace on OSX. Notice that this implies that on Linux one should
+  always set the `LD_LIBRARY_PATH` flag to have a working executable.
 - On OSX, `./configure` uses `clang++` as first choice among non-MPI compilers.
 - Added `--enable-static-archive` to `./configure` to build a `libplumed.a` static library.
 - Stop setting `DYLD_LIBRARY_PATH` in `sourceme.sh` and in modulefile. Notice that as of PLUMED v2.3.3
@@ -71,3 +78,4 @@ Changes from version 2.4 which are relevant for developers:
     searches the relevant functions using `dlsym`. In addition, if it is not able to
     load `libplumedKernel` since the latter is <=2.4 and needs `Plumed.c` to be visible,
     it just uses as a fallback `libplumed`, which should load properly.
+- A copy of `plumed-runtime` is installed in `prefix/lib/plumed` and can be used for testing.