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.

GaudiKernel/GaudiKernel/ITHistSvc.h

@@ -39,7 +39,7 @@ public:
   /// @param [in] name      defines the histogram id/name under which it is recorded
   /// @param [in] hist      transfers ownership of the histogram to the THistSvc
   /// @param [out] hist_ptr for compatibility: return raw pointer to managed object to support common usage in Athena
-  virtual StatusCode regHist( const std::string& name, std::unique_ptr<TH1> hist, TH1*& hist_ptr ) = 0;
+  virtual StatusCode regHist( const std::string& name, std::unique_ptr<TH1> hist, TH1* hist_ptr ) = 0;
   /// @deprecated {Just for compatibility purposes. Ownership should be clearly managed.}
   /// Register an existing ROOT histogram TH*X with name and pointer
   [[deprecated( "Use regHist( name, std::move(hist), rawptr ) with std::unique_ptr<TH1> hist" )]] virtual StatusCode
@@ -81,13 +81,13 @@ public:
   /// @{
 
   /// Register shared object of type TH1 and return LockedHandle for that object
-  virtual LockedHandle<TH1> regShared( const std::string& name, std::unique_ptr<TH1> ) = 0;
+  virtual StatusCode regShared( const std::string& name, std::unique_ptr<TH1>, LockedHandle<TH1>& ) = 0;
   /// Register shared object of type TH2 and return LockedHandle for that object
-  virtual LockedHandle<TH2> regShared( const std::string& name, std::unique_ptr<TH2> ) = 0;
+  virtual StatusCode regShared( const std::string& name, std::unique_ptr<TH2>, LockedHandle<TH2>& ) = 0;
   /// Register shared object of type TH3 and return LockedHandle for that object
-  virtual LockedHandle<TH3> regShared( const std::string& name, std::unique_ptr<TH3> ) = 0;
+  virtual StatusCode regShared( const std::string& name, std::unique_ptr<TH3>, LockedHandle<TH3>& ) = 0;
   /// Register shared object of type TGraph and return LockedHandle for that object
-  virtual LockedHandle<TGraph> regShared( const std::string& name, std::unique_ptr<TGraph> ) = 0;
+  virtual StatusCode regShared( const std::string& name, std::unique_ptr<TGraph>, LockedHandle<TGraph>& ) = 0;
   /// Retrieve shared object with given name as TH1 through LockedHandle
   virtual StatusCode getShared( const std::string& name, LockedHandle<TH1>& ) const = 0;
   /// Retrieve shared object with given name as TH2 through LockedHandle