Revert some interface changes of THistSvc

The recent interface changes in THistSvc would require too much manual intervention for quick adaption in Athena. For this reason I reverted some of the changes and added (deprecated) methods to preserve most of the old interface. This also means, that there are more StatusCodes again, opposed to returning nullable types to communicate failures.

As a rule, the THistSvc is expected to take ownership of the managed histograms, but a very common use case is to register a histogram pointer and continue to work on it afterwards. The interface now offers methods to do exactly that in one call, while communicating ownership transfer to the service to some extend.

This affects only histogram methods. regTree, getTree, regGraph and getGraph aren't used that often in Athena (< 100 times), so that I should be able to migrate those to unique_ptrs within a couple of days on my own.

The deprecation attribute is introducing one additional compiler warning in Gaudi (ITHistSvc.h -> THistSvc.h), so how should I address that in the future? I could remove the attribute from the interface and only leave a comment there. This way, only clients of the THistSvc implementation would be marked during compile time. (None in Gaudi; O(1000) times in Athena without any scripted migration to a non-deprecated method)

To prepare the THistSvc for future rewriting efforts (with ROOT 7 histograms in mind), I have changed the order of functions and added many comments. Hopefully this makes the MR/commits not too bloated for everyones taste.

GaudiExamples/src/THist/THistRead.cpp

@@ -34,45 +34,50 @@ StatusCode THistRead::initialize()
   }
 
   // stream read1, 1D in "/xxx"
-  StatusCode sc1 = m_ths->regHist( "/read1/xxx/1Dgauss" );
-  TH1* h1        = m_ths->getHistTH1( "/read1/xxx/1Dgauss" );
-  if ( sc1.isFailure() || h1 == nullptr ) {
+  StatusCode sc1a = m_ths->regHist( "/read1/xxx/1Dgauss" );
+  TH1* h1( nullptr );
+  StatusCode sc1b = m_ths->getHist( "/read1/xxx/1Dgauss", h1 );
+  if ( sc1a.isFailure() || sc1b.isFailure() || h1 == nullptr ) {
     error() << "Couldn't read gauss1d" << endmsg;
   } else {
     info() << h1->GetName() << ": " << h1->GetEntries() << endmsg;
   }
 
   // stream read2, 2D tree in "/"
-  StatusCode sc2 = m_ths->regHist( "/read2/2Dgauss" );
-  TH2* h2        = m_ths->getHistTH2( "/read2/2Dgauss" );
-  if ( sc2.isFailure() || h2 == nullptr ) {
+  StatusCode sc2a = m_ths->regHist( "/read2/2Dgauss" );
+  TH2* h2( nullptr );
+  StatusCode sc2b = m_ths->getHist( "/read2/2Dgauss", h2 );
+  if ( sc2a.isFailure() || sc2b.isFailure() || h2 == nullptr ) {
     error() << "Couldn't read 2Dgauss" << endmsg;
   } else {
     info() << h2->GetName() << ": " << h2->GetEntries() << endmsg;
   }
 
   // 3D tree in "/"
-  StatusCode sc3 = m_ths->regHist( "/read2/3Dgauss" );
-  TH3* h3        = m_ths->getHistTH3( "/read2/3Dgauss" );
-  if ( sc3.isFailure() || h3 == nullptr ) {
+  StatusCode sc3a = m_ths->regHist( "/read2/3Dgauss" );
+  TH3* h3( nullptr );
+  StatusCode sc3b = m_ths->getHist( "/read2/3Dgauss", h3 );
+  if ( sc3a.isFailure() || sc3b.isFailure() || h3 == nullptr ) {
     error() << "Couldn't read 3Dgauss" << endmsg;
   } else {
     info() << h3->GetName() << ": " << h3->GetEntries() << endmsg;
   }
 
   // Profile in "/"
-  StatusCode sc4 = m_ths->regHist( "/read2/profile" );
-  TH1* tp        = m_ths->getHistTH1( "/read2/profile" );
-  if ( sc4.isFailure() || tp == nullptr ) {
+  StatusCode sc4a = m_ths->regHist( "/read2/profile" );
+  TH1* tp( nullptr );
+  StatusCode sc4b = m_ths->getHist( "/read2/profile", tp );
+  if ( sc4a.isFailure() || sc4b.isFailure() || tp == nullptr ) {
     error() << "Couldn't read profile" << endmsg;
   } else {
     info() << tp->GetName() << ": " << tp->GetEntries() << endmsg;
   }
 
   // Tree with branches in "/trees/stuff"
-  StatusCode sc5 = m_ths->regTree( "/read2/trees/stuff/treename" );
-  TTree* tr      = m_ths->getTree( "/read2/trees/stuff/treename" );
-  if ( sc5.isFailure() || tr == nullptr ) {
+  StatusCode sc5a = m_ths->regTree( "/read2/trees/stuff/treename" );
+  TTree* tr( nullptr );
+  StatusCode sc5b = m_ths->getTree( "/read2/trees/stuff/treename", tr );
+  if ( sc5a.isFailure() || sc5b.isFailure() || tr == nullptr ) {
     error() << "Couldn't read tree" << endmsg;
   } else {
     info() << tr->GetName() << ": " << tr->GetEntries() << endmsg;