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/THistWrite.cpp

@@ -2,9 +2,9 @@
 #include "THistWrite.h"
 
 #include "GaudiKernel/ITHistSvc.h"
+#include "GaudiKernel/LockedHandle.h"
 #include "GaudiKernel/MsgStream.h"
 #include "GaudiKernel/RndmGenerators.h"
-#include "GaudiKernel/LockedHandle.h"
 #include <math.h>
 
 #include "TDirectory.h"
@@ -74,7 +74,7 @@ StatusCode THistWrite::initialize()
   if ( m_ths->regHist( "TempHist5", std::unique_ptr<TH1F>( h5 ) ).isFailure() ) {
     error() << "Couldn't register TempHist5" << endmsg;
   }
-  if( strcmp( h5->GetName(), "TempHist5" ) ){
+  if ( strcmp( h5->GetName(), "TempHist5" ) ) {
     error() << "Couldn't use TempHist5 afterwards. getName = " << h5->GetName() << endmsg;
   }
 
@@ -82,11 +82,10 @@ StatusCode THistWrite::initialize()
   if ( m_ths->regHist( "TempHist6", std::unique_ptr<TH1D>( h6 ), h6 ).isFailure() ) {
     error() << "Couldn't register TempHist6" << endmsg;
   }
-  if( strcmp( h6->GetName(), "TempHist6" ) ){
+  if ( strcmp( h6->GetName(), "TempHist6" ) ) {
     error() << "Couldn't use TempHist6 afterwards. getName = " << h6->GetName() << endmsg;
   }
 
-
   // Profile in "/"
   std::unique_ptr<TH1> tp = std::make_unique<TProfile>( "profile", "profile", 100, -50., -50. );
   if ( m_ths->regHist( "/rec/prof", std::move( tp ) ).isFailure() ) {
@@ -99,11 +98,10 @@ StatusCode THistWrite::initialize()
     error() << "Couldn't register tr" << endmsg;
   }
 
-
   // Update to stream "upd", dir "/xxx"
   std::unique_ptr<TH1F> h3s = std::make_unique<TH1F>( "1Dgauss_shared", "1D Gaussian", 100, -50., 50. );
   LockedHandle<TH1> lh1;
-  if ( m_ths->regShared( "/upd/xxx/gauss1d_shared", std::move ( h3s ), lh1 ).isFailure() ) {
+  if ( m_ths->regShared( "/upd/xxx/gauss1d_shared", std::move( h3s ), lh1 ).isFailure() ) {
     error() << "Couldn't register gauss1d_shared" << endmsg;
   }
 
@@ -219,7 +217,6 @@ StatusCode THistWrite::execute()
     error() << "Couldn't retrieve 3Dgauss_shared" << endmsg;
   }
 
-
   TTree* tr;
   if ( m_ths->getTree( "/rec/trees/stuff/tree1", tr ).isFailure() ) {
     error() << "Couldn't retrieve tree tree1" << endmsg;