diff --git a/INSTALL b/INSTALL index 012129561..6688d2e77 100644 --- a/INSTALL +++ b/INSTALL @@ -26,7 +26,7 @@ However it requires that cmake be installed on your system. 4. Run cmake pointing to the source and specify the installation location: > cmake ../eccodes-x.y.z-Source -DCMAKE_INSTALL_PREFIX=/path/to/where/you/install/eccodes - It is recommended that you install into a clean directory + It is recommended that you always build in a clean directory and also install into a clean directory. 5. Compile, test and install: > make @@ -35,6 +35,7 @@ However it requires that cmake be installed on your system. You can also pass options to the cmake command above. Some typical examples are: + -DENABLE_EXTRA_TESTS=ON Enable extended regression testing -DENABLE_NETCDF=ON Enable GRIB to netCDF conversion -DENABLE_ECCODES_THREADS=ON Enable POSIX threads -DENABLE_JPG=ON Enable JPEG encoding/decoding (for GRIB packing) @@ -42,6 +43,14 @@ You can also pass options to the cmake command above. Some typical examples are: -DCMAKE_C_FLAGS="-O2 -Wall" Prepend the specified flags at the front of the compilation command for C source files +By default the ctest step above does NOT require any data to be downloaded and only runs basic sanity tests. +However if you wish to exercise more of the functionality of ecCodes, you are advised to configure the build with: + + > cmake ... -DENABLE_EXTRA_TESTS=ON + +In this mode the tests will take longer and you need to be connected to the internet so data files can be downloaded +for the tests. + For more details, please see: https://software.ecmwf.int/wiki/display/ECC/ecCodes+installation