v19.0.0

Breaking Changes

• CMake

  • Dropped our custom FindROOT.cmake by @ChristianTackeGSI in #1050
    • Using the native CMake package of ROOT, see https://root.cern/manual/integrate_root_into_my_cmake_project/,
    • ROOT targets MUST BE prefixed with ROOT:: now, see
      https://root.cern/manual/integrate_root_into_my_cmake_project/#full-example-event-project
    • Explicitely include(ROOTMacros) after your find_package2(... ROOT ...) now
    • Dropped ROOT_VERSION_NUMBER, use ROOT_VERSION (which is the dotted
      version number) and VERSION_GREATER/etc
      instead
    • Dropped ROOTSYS so use ROOT CMake targets instead, a change by @ChristianTackeGSI in #1118
  • Some CMake macros have been factored out into the
    FairCMakeModules
    project which is required by FairRoot, change by @ChristianTackeGSI in #1059
    • FairSoft apr21 and later ship it (see alternative
      installation methods)
    • find_package2 has moved to FairFindPackage2.
      To use it in your code, perform something like this:

      find_package(FairCMakeModules 1.0 REQUIRED)
      include(FairFindPackage2)

    • Dropped Color Codes and pad(), use FairFormattedOutput from FairCMakeModules
      instead, a change by @ChristianTackeGSI in #1064
      • Note that fair_pad()
        needs the width argument to be incremented by 1, and the COLOR option
        takes no argument
  • Dropped Generate_Exe_Script(), it was never meant for external use, by @ChristianTackeGSI in #1110
  • Dropped GENERATE_TEST_SCRIPT(), replace it with a locally maintained solution, by @ChristianTackeGSI in #1110
    • Consider using source @FairRoot_BINDIR@/FairRootConfig.sh -p
  • Dropped Generate_Version_Info() by @ChristianTackeGSI in #1377
    • If you just need to generate some files with your version number in it,
      use the standard configure_file
      CMake command.
    • Alternatively, consider creating a proper CMake Package
      with configure_package_config_file(), and write_basic_package_version_file().
    • If you need the "git version", use
      fair_get_git_version() from FairCMakeModules
      in addition.
  • Renamed our ROOT_GENERATE_DICTIONARY() to FAIRROOT_GENERATE_DICTIONARY(), by @ChristianTackeGSI in #1328
  • Dropped build switch BUILD_UNITTESTS, it was in conflict with the CMake
    standard switch BUILD_TESTING from the CTest module

• C++

  • fEvtHeader member variable now is a private unique pointer owned by
    FairRun. To access the event header, use the public member function
    GetEventHeader() by @YanzhaoW in #1254.
  • Dropped headers @rbx in #1340:
    • basemq/baseMQtools/baseMQtools.h
    • basemq/policies/Sampler/FairMQFileSource.h
    • basemq/policies/Sampler/FairSourceMQInterface.h
    • basemq/policies/Sampler/SimpleTreeReader.h
    • basemq/policies/Serialization/BinaryBaseClassSerializer.h
    • basemq/policies/Storage/BinaryOutFileManager.h
    • basemq/policies/Storage/BoostDataSaver.h
    • basemq/policies/Storage/RootOutFileManager.h
    • basemq/policies/Storage/TriviallyCopyableDataSaver.h
    • basemq/policies/Serialization/IOPolicy.h
  • The following files/classes have been moved to the example where they are used and renamed by @rbx in #1349:
    • basemq/devices/FairMQProcessor.h -> examples/advanced/Tutorial3/MQ/processor.cxx
    • basemq/devices/FairMQSampler.h -> examples/advanced/Tutorial3/MQ/sampler.cxx
    • basemq/tasks/FairMQProcessorTask.h -> examples/advanced/Tutorial3/MQ/processorTask/ProcessorTask.h
    • basemq/tasks/FairMQSamplerTask.h -> examples/advanced/Tutorial3/MQ/samplerTask/SamplerTask.h
  • FairTimeStamp change by @TobiasStockmanns in #1526
    • virtual bool operator<(const FairTimeStamp* rValue) const changed to bool operator<(const FairTimeStamp& rValue) const

Deprecations

If you think you really require a deprecated API, please
file an issue.

• Deprecated MbsAPI by @ChristianTackeGSI in #1056
  • We plan to remove it completely in the next major release
  • Disabled by default, enable via -DBUILD_MBS=ON
• Deprecated Proof related classes by @ChristianTackeGSI in #1235
  • Proof was deprecated in ROOT 6.26
  • Disabled by default, enable via -DBUILD_PROOF_SUPPORT=ON
• Deprecated FairEventBuilder and FairEventBuilderManager by @karabowi in #1414
  • Disabled by default, enable via -DBUILD_EVENT_BUILDER=ON
• Deprecated FairRun::SetEventHeader(FairEventHeader*), use
  FairRun::SetEventHeader(std::unique_ptr<FairEventHeader> EvHeader) instead, a change by @ChristianTackeGSI in #1423
  • Clarified ownership semantics by @YanzhaoW in #1254
• Deprecated FairRunAna::Run(Long64_t entry), use
  FairRunAna::RunSingleEntry(Long64_t entry) instead, a change by @karabowi in #1426
  • Semantics were unclear due to dubious Run(int) and Run(long)

Other Notable Changes

• Restructured the source tree by moving all public components to the new
  '/fairroot' folder
• Consider calling fairroot_check_root_cxxstd_compatibility()
  in your CMakeLists.txt by @ChristianTackeGSI in #1060
• fairsoft-config isn't searched for and not needed any more, a change by #1071

Full Changelog: v18.8.2...v19.0.0