code cleanup, documentation, placement of 'using' statements
authorrichterm <richterm@f7af4fe6-9843-0410-8265-dc069ae4e863>
Mon, 30 Jul 2012 14:38:06 +0000 (14:38 +0000)
committerrichterm <richterm@f7af4fe6-9843-0410-8265-dc069ae4e863>
Mon, 30 Jul 2012 14:38:06 +0000 (14:38 +0000)
35 files changed:
HLT/BASE/AliHLTCalibrationProcessor.cxx
HLT/BASE/AliHLTComponent.h
HLT/BASE/AliHLTComponentHandler.cxx
HLT/BASE/AliHLTComponentHandler.h
HLT/BASE/AliHLTConfiguration.cxx
HLT/BASE/AliHLTConfiguration.h
HLT/BASE/AliHLTConfigurationHandler.cxx
HLT/BASE/AliHLTConfigurationHandler.h
HLT/BASE/AliHLTConsumerDescriptor.cxx
HLT/BASE/AliHLTConsumerDescriptor.h
HLT/BASE/AliHLTControlTask.cxx
HLT/BASE/AliHLTControlTask.h
HLT/BASE/AliHLTDataBuffer.cxx
HLT/BASE/AliHLTDataBuffer.h
HLT/BASE/AliHLTDataSink.cxx
HLT/BASE/AliHLTDataSink.h
HLT/BASE/AliHLTDataSource.cxx
HLT/BASE/AliHLTDataSource.h
HLT/BASE/AliHLTEventStatistics.cxx
HLT/BASE/AliHLTHOMERBlockDesc.cxx
HLT/BASE/AliHLTHOMERManager.cxx
HLT/BASE/AliHLTHOMERProxyHandler.cxx
HLT/BASE/AliHLTHOMERSourceDesc.cxx
HLT/BASE/AliHLTLogging.cxx
HLT/BASE/AliHLTLogging.h
HLT/BASE/AliHLTOUT.cxx
HLT/BASE/AliHLTOUT.h
HLT/BASE/AliHLTProcessor.cxx
HLT/BASE/AliHLTProcessor.h
HLT/BASE/AliHLTRunStatistics.cxx
HLT/BASE/AliHLTSystem.cxx
HLT/BASE/AliHLTSystem.h
HLT/BASE/AliHLTTask.cxx
HLT/BASE/AliHLTTask.h
HLT/BASE/AliHLT_C_Component_WrapperInterface.cxx

index 61f2c8e..dca9310 100644 (file)
@@ -1,36 +1,26 @@
 // $Id$
-/**************************************************************************
- * This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- *                                                                        *
- * Primary Authors: Jochen Thaeder <thaeder@kip.uni-heidelberg.de>        *
- *                  Sebastian Bablok                                      *
- *                  for The ALICE HLT Project.                            *
- *                                                                        *
- * Permission to use, copy, modify and distribute this software and its   *
- * documentation strictly for non-commercial purposes is hereby granted   *
- * without fee, provided that the above copyright notice appears in all   *
- * copies and that both the copyright notice and this permission notice   *
- * appear in the supporting documentation. The authors make no claims     *
- * about the suitability of this software for any purpose. It is          *
- * provided "as is" without express or implied warranty.                  *
- **************************************************************************/
-
-/** 
- * @file   AliHLTCalibrationProcessor.cxx
- * @author Jochen Thaeder, Sebastian Bablok
- * @date 
- * @brief  Base class of HLT calibration components.  */
-
-// see header file for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
-
-#if __GNUC__ >= 3
-using namespace std;
-#endif
+//**************************************************************************
+//* This file is property of and copyright by the ALICE HLT Project        * 
+//* ALICE Experiment at CERN, All rights reserved.                         *
+//*                                                                        *
+//* Primary Authors: Jochen Thaeder <thaeder@kip.uni-heidelberg.de>        *
+//*                  Sebastian Bablok                                      *
+//*                  for The ALICE HLT Project.                            *
+//*                                                                        *
+//* Permission to use, copy, modify and distribute this software and its   *
+//* documentation strictly for non-commercial purposes is hereby granted   *
+//* without fee, provided that the above copyright notice appears in all   *
+//* copies and that both the copyright notice and this permission notice   *
+//* appear in the supporting documentation. The authors make no claims     *
+//* about the suitability of this software for any purpose. It is          *
+//* provided "as is" without express or implied warranty.                  *
+//**************************************************************************
+
+// @file   AliHLTCalibrationProcessor.cxx
+// @author Jochen Thaeder, Sebastian Bablok
+// @date 
+// @brief  Base class of HLT calibration components.
+// 
 
 #include "AliHLTCalibrationProcessor.h"
 #include "AliHLTMemoryFile.h"
@@ -44,7 +34,6 @@ using namespace std;
 
 ClassImp(AliHLTCalibrationProcessor);
 
-
 const AliHLTUInt32_t AliHLTCalibrationProcessor::fgkFXSProtocolHeaderSize = 204;
 const AliHLTUInt32_t AliHLTCalibrationProcessor::fgkFXSProtocolHeaderVersion = 1;
 
index 849dcae..85531d1 100644 (file)
@@ -89,6 +89,8 @@ class AliHLTMemoryFile;
 class AliHLTCTPData;
 class AliHLTReadoutList;
 
+using std::vector;
+
 /** list of component data type structures */
 typedef vector<AliHLTComponentDataType>   AliHLTComponentDataTypeList;
 /** list of component block data structures */
index 8300fa5..0d833c6 100644 (file)
@@ -1,21 +1,21 @@
 // $Id$
 
-/**************************************************************************
- * This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- *                                                                        *
- * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
- *                  Timm Steinbeck <timm@kip.uni-heidelberg.de>           *
- *                  for The ALICE HLT Project.                            *
- *                                                                        *
- * Permission to use, copy, modify and distribute this software and its   *
- * documentation strictly for non-commercial purposes is hereby granted   *
- * without fee, provided that the above copyright notice appears in all   *
- * copies and that both the copyright notice and this permission notice   *
- * appear in the supporting documentation. The authors make no claims     *
- * about the suitability of this software for any purpose. It is          *
- * provided "as is" without express or implied warranty.                  *
- **************************************************************************/
+//**************************************************************************
+//* This file is property of and copyright by the                          * 
+//* ALICE Experiment at CERN, All rights reserved.                         *
+//*                                                                        *
+//* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
+//*                  Timm Steinbeck <timm@kip.uni-heidelberg.de>           *
+//*                  for The ALICE HLT Project.                            *
+//*                                                                        *
+//* Permission to use, copy, modify and distribute this software and its   *
+//* documentation strictly for non-commercial purposes is hereby granted   *
+//* without fee, provided that the above copyright notice appears in all   *
+//* copies and that both the copyright notice and this permission notice   *
+//* appear in the supporting documentation. The authors make no claims     *
+//* about the suitability of this software for any purpose. It is          *
+//* provided "as is" without express or implied warranty.                  *
+//**************************************************************************
 
 /// @file   AliHLTComponentHandler.cxx
 /// @author Matthias Richter, Timm Steinbeck
 /// @brief  Implementation of HLT component handler.
 ///
 
-// see header file for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
 //#undef HAVE_DLFCN_H
 #ifdef HAVE_DLFCN_H
 #include <dlfcn.h>
@@ -39,7 +30,6 @@ using namespace std;
 //#include <Riostream.h>
 #include <TSystem.h>
 #endif //HAVE_DLFCN_H
-//#include "AliHLTStdIncludes.h"
 #include "AliHLTComponentHandler.h"
 #include "AliHLTComponent.h"
 #include "AliHLTDataTypes.h"
@@ -82,7 +72,7 @@ AliHLTComponentHandler::AliHLTComponentHandler(AliHLTAnalysisEnvironment* pEnv)
   fRunDesc(kAliHLTVoidRunDesc),
   fRunType(NULL)
 {
-  // see header file for class documentation
+  // constructor with environment
   if (pEnv) {
     memcpy(&fEnvironment, pEnv, sizeof(AliHLTAnalysisEnvironment));
     if (pEnv->fLoggingFunc) {
@@ -107,7 +97,7 @@ AliHLTComponentHandler::AliHLTComponentHandler(AliHLTAnalysisEnvironment* pEnv)
 
 AliHLTComponentHandler::~AliHLTComponentHandler()
 {
-  // see header file for class documentation
+  // destructor
   DeleteOwnedComponents();
   UnloadLibraries();
   if (fRunType) delete [] fRunType;
@@ -119,7 +109,7 @@ int AliHLTComponentHandler::fgNofInstances=0;
 
 AliHLTComponentHandler* AliHLTComponentHandler::CreateHandler()
 {
-  // see header file for class documentation
+  // create global instance of handler
   if (!fgpInstance) fgpInstance=new AliHLTComponentHandler;
   fgNofInstances++;
   return fgpInstance;
@@ -141,7 +131,7 @@ int AliHLTComponentHandler::Destroy()
 
 int AliHLTComponentHandler::AnnounceVersion()
 {
-  // see header file for class documentation
+  // printout for version
   int iResult=0;
 #ifdef PACKAGE_STRING
   extern void HLTbaseCompileInfo( const char*& date, const char*& time);
@@ -159,7 +149,7 @@ int AliHLTComponentHandler::AnnounceVersion()
 
 Int_t AliHLTComponentHandler::AddComponent(AliHLTComponent* pSample)
 {
-  // see header file for class documentation
+  // add and register a component, handler becomes owner
   Int_t iResult=0;
   if (pSample==NULL) return -EINVAL;
   if ((iResult=RegisterComponent(pSample))>=0) {
@@ -171,7 +161,7 @@ Int_t AliHLTComponentHandler::AddComponent(AliHLTComponent* pSample)
 
 Int_t AliHLTComponentHandler::RegisterComponent(AliHLTComponent* pSample)
 {
-  // see header file for class documentation
+  // register a component, handler creates clone of sample
   Int_t iResult=0;
   if (pSample) {
     if (FindComponent(pSample->GetComponentID())==NULL) {
@@ -192,7 +182,7 @@ Int_t AliHLTComponentHandler::RegisterComponent(AliHLTComponent* pSample)
 
 int AliHLTComponentHandler::DeregisterComponent( const char* componentID )
 {
-  // see header file for class documentation
+  // deregister component
 
   int iResult=0;
   if (componentID) {
@@ -205,7 +195,7 @@ int AliHLTComponentHandler::DeregisterComponent( const char* componentID )
 
 Int_t AliHLTComponentHandler::ScheduleRegister(AliHLTComponent* pSample)
 {
-  // see header file for class documentation
+  // schedule registration
   Int_t iResult=0;
   if (pSample) {
     fScheduleList.push_back(pSample);
@@ -217,7 +207,7 @@ Int_t AliHLTComponentHandler::ScheduleRegister(AliHLTComponent* pSample)
 
 int AliHLTComponentHandler::CreateComponent(const char* componentID, void* pEnvParam, int argc, const char** argv, AliHLTComponent*& component)
 {
-  // see header file for class documentation
+  // create a component
   int iResult=CreateComponent(componentID, component);
   if (iResult>=0 && component) {
        HLTDebug("component \"%s\" created (%p)", componentID, component);
@@ -232,7 +222,7 @@ int AliHLTComponentHandler::CreateComponent(const char* componentID, void* pEnvP
 
 int AliHLTComponentHandler::CreateComponent(const char* componentID, AliHLTComponent*& component )
 {
-  // see header file for class documentation
+  // create a component
   int iResult=0;
   if (componentID) {
     AliHLTComponent* pSample=FindComponent(componentID);
@@ -256,7 +246,7 @@ int AliHLTComponentHandler::CreateComponent(const char* componentID, AliHLTCompo
 
 Int_t AliHLTComponentHandler::FindComponentIndex(const char* componentID)
 {
-  // see header file for class documentation
+  // find component by ID in the list and return index
   Int_t iResult=0;
   if (componentID) {
     AliHLTComponentPList::iterator element=fComponentList.begin();
@@ -276,7 +266,7 @@ Int_t AliHLTComponentHandler::FindComponentIndex(const char* componentID)
 
 AliHLTComponent* AliHLTComponentHandler::FindComponent(const char* componentID)
 {
-  // see header file for class documentation
+  // find component sample by ID
   AliHLTComponent* pSample=NULL;
   Int_t index=FindComponentIndex(componentID);
   if (index>=0) {
@@ -287,7 +277,7 @@ AliHLTComponent* AliHLTComponentHandler::FindComponent(const char* componentID)
 
 Int_t AliHLTComponentHandler::InsertComponent(AliHLTComponent* pSample)
 {
-  // see header file for class documentation
+  // insert a component sample in the list
   Int_t iResult=0;
   if (pSample!=NULL) {
     fComponentList.push_back(pSample);
@@ -299,7 +289,8 @@ Int_t AliHLTComponentHandler::InsertComponent(AliHLTComponent* pSample)
 
 void AliHLTComponentHandler::List() 
 {
-  // see header file for class documentation
+  // print list content
+  // TODO: implement Print()
   AliHLTComponentPList::iterator element=fComponentList.begin();
   int index=0;
   while (element!=fComponentList.end()) {
@@ -309,7 +300,7 @@ void AliHLTComponentHandler::List()
 
 int AliHLTComponentHandler::HasOutputData( const char* componentID)
 {
-  // see header file for class documentation
+  // check if a component has output data
   int iResult=0;
   AliHLTComponent* pSample=FindComponent(componentID);
   if (pSample) {
@@ -324,7 +315,7 @@ int AliHLTComponentHandler::HasOutputData( const char* componentID)
 
 void AliHLTComponentHandler::SetEnvironment(AliHLTAnalysisEnvironment* pEnv) 
 {
-  // see header file for class documentation
+  // set global environment
   if (pEnv) {
     memset(&fEnvironment, 0, sizeof(AliHLTAnalysisEnvironment));
     memcpy(&fEnvironment, pEnv, pEnv->fStructSize<sizeof(AliHLTAnalysisEnvironment)?pEnv->fStructSize:sizeof(AliHLTAnalysisEnvironment));
@@ -341,7 +332,7 @@ void AliHLTComponentHandler::SetEnvironment(AliHLTAnalysisEnvironment* pEnv)
 
 AliHLTComponentHandler::TLibraryMode AliHLTComponentHandler::SetLibraryMode(TLibraryMode mode)
 {
-  // see header file for class documentation
+  // set library mode
   TLibraryMode old=fLibraryMode;
   fLibraryMode=mode;
   return old;
@@ -349,7 +340,7 @@ AliHLTComponentHandler::TLibraryMode AliHLTComponentHandler::SetLibraryMode(TLib
 
 int AliHLTComponentHandler::LoadLibrary( const char* libraryPath, int bActivateAgents)
 {
-  // see header file for class documentation
+  // load a library
   int iResult=0;
   if (libraryPath) {
     TString libName=libraryPath;
@@ -458,7 +449,7 @@ int AliHLTComponentHandler::LoadLibrary( const char* libraryPath, int bActivateA
 
 int AliHLTComponentHandler::UnloadLibrary( const char* libraryPath )
 {
-  // see header file for class documentation
+  // unload a library
   int iResult=0;
   if (libraryPath) {
     vector<AliHLTLibHandle>::iterator element=fLibraryList.begin();
@@ -479,7 +470,7 @@ int AliHLTComponentHandler::UnloadLibrary( const char* libraryPath )
 
 int AliHLTComponentHandler::UnloadLibrary(AliHLTComponentHandler::AliHLTLibHandle &handle)
 {
-  // see header file for class documentation
+  // unload a library
   int iResult=0;
   fgAliLoggingFunc=NULL;
   TString* pName=reinterpret_cast<TString*>(handle.fName);
@@ -543,7 +534,7 @@ int AliHLTComponentHandler::UnloadLibrary(AliHLTComponentHandler::AliHLTLibHandl
 
 int AliHLTComponentHandler::UnloadLibraries()
 {
-  // see header file for class documentation
+  // unload all libraries
   int iResult=0;
   vector<AliHLTLibHandle>::iterator element=fLibraryList.begin();
   while (element!=fLibraryList.end()) {
@@ -556,7 +547,7 @@ int AliHLTComponentHandler::UnloadLibraries()
 
 AliHLTfctVoid AliHLTComponentHandler::FindSymbol(const char* library, const char* symbol)
 {
-  // see header file for class documentation
+  // find symbol in library
   AliHLTLibHandle* hLib=FindLibrary(library);
   if (hLib==NULL) return NULL;
   void (*pFunc)()=NULL;
@@ -571,7 +562,7 @@ AliHLTfctVoid AliHLTComponentHandler::FindSymbol(const char* library, const char
 
 AliHLTComponentHandler::AliHLTLibHandle* AliHLTComponentHandler::FindLibrary(const char* library)
 {
-  // see header file for class documentation
+  // find a library by name
   AliHLTLibHandle* hLib=NULL;
   vector<AliHLTLibHandle>::iterator element=fLibraryList.begin();
   while (element!=fLibraryList.end()) {
@@ -587,7 +578,7 @@ AliHLTComponentHandler::AliHLTLibHandle* AliHLTComponentHandler::FindLibrary(con
 
 int AliHLTComponentHandler::AddStandardComponents()
 {
-  // see header file for class documentation
+  // TODO: not quite clear what was the meaning behind this function
   int iResult=0;
   AliHLTComponent::SetGlobalComponentHandler(this);
   AliHLTComponent::UnsetGlobalComponentHandler();
@@ -597,7 +588,7 @@ int AliHLTComponentHandler::AddStandardComponents()
 
 int AliHLTComponentHandler::RegisterScheduledComponents()
 {
-  // see header file for class documentation
+  // register all scheduled components
   int iResult=0;
   AliHLTComponentPList::iterator element=fScheduleList.begin();
   int iLocalResult=0;
@@ -612,7 +603,7 @@ int AliHLTComponentHandler::RegisterScheduledComponents()
 
 int AliHLTComponentHandler::ActivateAgents(const char* library, const char* blackList)
 {
-  // see header file for class documentation
+  // activate module agents
   vector<AliHLTModuleAgent*> agents;
   for (AliHLTModuleAgent* pAgent=AliHLTModuleAgent::GetFirstAgent(); 
        pAgent!=NULL;
@@ -650,7 +641,7 @@ int AliHLTComponentHandler::ActivateAgents(const char* library, const char* blac
 
 int AliHLTComponentHandler::DeleteOwnedComponents()
 {
-  // see header file for class documentation
+  // delete all component samples owned by the handler
   int iResult=0;
   AliHLTComponentPList::iterator element=fOwnedComponents.begin();
   while (element!=fOwnedComponents.end()) {
@@ -674,7 +665,7 @@ int AliHLTComponentHandler::DeleteOwnedComponents()
 
 int AliHLTComponentHandler::SetRunDescription(const AliHLTRunDesc* desc, const char* runType)
 {
-  // see header file for class documentation
+  // set global run description
   if (!desc) return -EINVAL;
   if (desc->fStructSize!=sizeof(AliHLTRunDesc)) {
     HLTError("invalid size of RunDesc struct (%ul)", desc->fStructSize);
index bd042ad..96bebfb 100644 (file)
@@ -3,7 +3,7 @@
 
 #ifndef ALIHLTCOMPONENTHANDLER_H
 #define ALIHLTCOMPONENTHANDLER_H
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //* See cxx source for full Copyright notice                               *
 
 /// @note   The handler is part of the interface and both used in the
 ///         Online (PubSub) and Offline (AliRoot) context.
 
-// see below for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt   
-
 #include <vector>
-//#include "TObject.h"
 #include "AliHLTDataTypes.h"
 #include "AliHLTLogging.h"
 
+using std::vector;
+
 class AliHLTComponent;
 class AliHLTModuleAgent;
 struct AliHLTAnalysisEnvironment;
index 889b5f3..750d603 100644 (file)
@@ -1,7 +1,7 @@
 // $Id$
 
 ///**************************************************************************
-///* This file is property of and copyright by the ALICE HLT Project        * 
+///* This file is property of and copyright by the                          * 
 ///* ALICE Experiment at CERN, All rights reserved.                         *
 ///*                                                                        *
 ///* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
 /// @brief  HLT configuration description for a single component.
 /// @note   The class is used in Offline (AliRoot) context
 
-#if __GNUC__>= 3
-using namespace std;
-#endif
-
 #include <cerrno>
 #include "AliHLTConfiguration.h"
 #include "AliHLTConfigurationHandler.h"
@@ -36,6 +32,8 @@ using namespace std;
 #include <string>
 #include "TList.h"
 
+using std::vector;
+
 /** ROOT macro for the implementation of ROOT specific class methods */
 ClassImp(AliHLTConfiguration)
 
@@ -52,11 +50,12 @@ AliHLTConfiguration::AliHLTConfiguration()
   fArgv(NULL),
   fBufferSize(-1)
 { 
-  // see header file for class documentation
-  // or
-  // refer to README to build package
-  // or
-  // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
+  // This class describes a configuration for an HLT component by means of
+  // the following parameters:
+  // - configuration id:      a unique id string/name
+  // - component id:          id returned by AliHLTComponent::GetComponentID()
+  // - parent configuartions: ids of configurations it requires input from
+  // - component arguments:   passed to the component when it is initialized
 }
 
 AliHLTConfiguration::AliHLTConfiguration(const char* id, const char* component, const char* sources,
@@ -73,7 +72,7 @@ AliHLTConfiguration::AliHLTConfiguration(const char* id, const char* component,
   fArgv(NULL),
   fBufferSize(-1)
 {
-  // see header file for function documentation
+  // constructor
   if (bufsize) fBufferSize=ConvertSizeString(bufsize);
   if (id && component) {
     if (AliHLTConfigurationHandler::Instance()) {
@@ -99,12 +98,12 @@ AliHLTConfiguration::AliHLTConfiguration(const AliHLTConfiguration& src)
   fArgv(NULL),
   fBufferSize(src.fBufferSize)
 { 
-  // see header file for function documentation
+  // copy constructor
 }
 
 AliHLTConfiguration& AliHLTConfiguration::operator=(const AliHLTConfiguration& src)
 { 
-  // see header file for function documentation
+  // assignment operator
   if (this==&src) return *this;
 
   fID=src.fID;
@@ -120,7 +119,7 @@ AliHLTConfiguration& AliHLTConfiguration::operator=(const AliHLTConfiguration& s
 
 AliHLTConfiguration::~AliHLTConfiguration()
 {
-  // see header file for function documentation
+  // destructor
   if (AliHLTConfigurationHandler::Instance()) {
     if (AliHLTConfigurationHandler::Instance()->FindConfiguration(fID.Data())!=NULL) {
       // remove the configuration from the handler if it exists
@@ -147,7 +146,7 @@ AliHLTConfiguration::~AliHLTConfiguration()
 
 const char* AliHLTConfiguration::GetName() const 
 {
-  // see header file for function documentation
+  // get name
   if (!fID.IsNull())
     return fID.Data();
   return TObject::GetName();
@@ -155,7 +154,7 @@ const char* AliHLTConfiguration::GetName() const
 
 AliHLTConfiguration* AliHLTConfiguration::GetSource(const char* id)
 {
-  // see header file for function documentation
+  // get source by id
   AliHLTConfiguration* pSrc=NULL;
   if (id) {
     // first check the current element
@@ -178,7 +177,8 @@ AliHLTConfiguration* AliHLTConfiguration::GetSource(const char* id)
 
 AliHLTConfiguration* AliHLTConfiguration::GetFirstSource() const
 {
-  // see header file for function documentation
+  // get first source in the list
+  // TODO: iterator class
   AliHLTConfiguration* pSrc=NULL;
   if (fNofSources>0) {
     const_cast<AliHLTConfiguration*>(this)->fListSrcElementIdx=-1;
@@ -189,7 +189,7 @@ AliHLTConfiguration* AliHLTConfiguration::GetFirstSource() const
 
 AliHLTConfiguration* AliHLTConfiguration::GetNextSource() const
 {
-  // see header file for function documentation
+  // get next source
   AliHLTConfiguration* pSrc=NULL;
   if (fNofSources>0) {
     if (fListSrcElementIdx+1<(int)fListSources.size()) {
@@ -202,7 +202,7 @@ AliHLTConfiguration* AliHLTConfiguration::GetNextSource() const
 
 int AliHLTConfiguration::SourcesResolved() const
 {
-  // see header file for function documentation
+  // check if all sources are resolved
   int iResult=0;
   if (fNofSources>=0) {
     iResult=fNofSources==(int)fListSources.size();
@@ -212,7 +212,7 @@ int AliHLTConfiguration::SourcesResolved() const
 
 int AliHLTConfiguration::InvalidateSource(AliHLTConfiguration* pConf)
 {
-  // see header file for function documentation
+  // invalidate state of all sources
   int iResult=0;
   if (pConf) {
     vector<AliHLTConfiguration*>::iterator element=fListSources.begin();
@@ -235,7 +235,7 @@ int AliHLTConfiguration::InvalidateSource(AliHLTConfiguration* pConf)
 
 void AliHLTConfiguration::PrintStatus() const
 {
-  // see header file for function documentation
+  // print info
   HLTLogKeyword("configuration status");
   HLTMessage("status of configuration \"%s\" (%p)", GetName(), this);
   if (!fComponent.IsNull()) HLTMessage("  - component: \"%s\"", fComponent.Data());
@@ -269,7 +269,7 @@ void AliHLTConfiguration::Print(const char* option) const
 
 int AliHLTConfiguration::GetArguments(const char*** pArgv) const
 {
-  // see header file for function documentation
+  // get argument array
   int iResult=0;
   if (pArgv) {
     if (fArgc==-1) {
@@ -292,7 +292,9 @@ int AliHLTConfiguration::GetArguments(const char*** pArgv) const
 
 int AliHLTConfiguration::ExtractSources(AliHLTConfigurationHandler* pHandler)
 {
-  // see header file for function documentation
+  // extract source configurations from the handler
+  // TODO: would be less confusing to use 'parent' instead of 'source'
+  // but this needs to be changed consistently throughout the class
   int iResult=0;
   fNofSources=0; // indicates that the function was called, there are either n or 0 sources
   fListSources.clear();
@@ -325,7 +327,7 @@ int AliHLTConfiguration::ExtractSources(AliHLTConfigurationHandler* pHandler)
 
 int AliHLTConfiguration::ExtractArguments()
 {
-  // see header file for function documentation
+  // extract argument list from string
   int iResult=0;
   if (!fArguments.IsNull()) {
     vector<char*> tgtList;
@@ -357,7 +359,7 @@ int AliHLTConfiguration::ExtractArguments()
 
 int AliHLTConfiguration::InterpreteString(const char* arg, vector<char*>& argList)
 {
-  // see header file for function documentation
+  // interprete a string
   int iResult=0;
   if (arg) {
     //HLTDebug("interprete \"%s\"", arg);
@@ -393,7 +395,7 @@ int AliHLTConfiguration::InterpreteString(const char* arg, vector<char*>& argLis
 
 int AliHLTConfiguration::ConvertSizeString(const char* strSize) const
 {
-  // see header file for function documentation
+  // convert a size argument
   int size=0;
   if (!strSize) return -1;
 
@@ -423,7 +425,7 @@ int AliHLTConfiguration::ConvertSizeString(const char* strSize) const
 
 int AliHLTConfiguration::FollowDependency(const char* id, TList* pTgtList)
 {
-  // see header file for function documentation
+  // follow dependencies
   int iResult=0;
   if (id) {
     AliHLTConfiguration* pDep=NULL;
index 6623dd3..bfaa5b5 100644 (file)
@@ -3,7 +3,7 @@
 
 #ifndef ALIHLTCONFIGURATION_H
 #define ALIHLTCONFIGURATION_H
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //* See cxx source for full Copyright notice                               *
 
index 43fd10d..bcc78d9 100644 (file)
@@ -1,36 +1,26 @@
 // $Id$
-// splitted from AliHLTConfiguration.cxx,v 1.25 2007/10/12 13:24:47
-/**************************************************************************
- * This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- *                                                                        *
- * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
- *                  for The ALICE HLT Project.                            *
- *                                                                        *
- * Permission to use, copy, modify and distribute this software and its   *
- * documentation strictly for non-commercial purposes is hereby granted   *
- * without fee, provided that the above copyright notice appears in all   *
- * copies and that both the copyright notice and this permission notice   *
- * appear in the supporting documentation. The authors make no claims     *
- * about the suitability of this software for any purpose. It is          *
- * provided "as is" without express or implied warranty.                  *
- **************************************************************************/
-
-/** @file   AliHLTConfigurationHandler.cxx
-    @author Matthias Richter
-    @date   
-    @brief  Implementation of HLT tasks.
-*/
-
-// see header file for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
+// split from AliHLTConfiguration.cxx,v 1.25 2007/10/12 13:24:47
+///**************************************************************************
+///* This file is property of and copyright by the                          * 
+///* ALICE Experiment at CERN, All rights reserved.                         *
+///*                                                                        *
+///* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
+///*                  for The ALICE HLT Project.                            *
+///*                                                                        *
+///* Permission to use, copy, modify and distribute this software and its   *
+///* documentation strictly for non-commercial purposes is hereby granted   *
+///* without fee, provided that the above copyright notice appears in all   *
+///* copies and that both the copyright notice and this permission notice   *
+///* appear in the supporting documentation. The authors make no claims     *
+///* about the suitability of this software for any purpose. It is          *
+///* provided "as is" without express or implied warranty.                  *
+///**************************************************************************/
+
+/// @file   AliHLTConfigurationHandler.cxx
+/// @author Matthias Richter
+/// @date   
+/// @brief  Implementation of HLT tasks.
+///
 
 #include <cerrno>
 #include <iostream>
@@ -50,17 +40,20 @@ AliHLTConfigurationHandler::AliHLTConfigurationHandler()
   , fgListScheduledRegistrations()
   , fFlags(0)
 {
-  // see header file for class documentation
-  // or
-  // refer to README to build package
-  // or
-  // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
+  // constructor
+  //
+  // Global Handling of HLT configurations.
+  //
+  // This class implements the global handling of @ref AliHLTConfiguration objects.
+  // It is a list of all configuration descriptors currently available in the system.
+  // Each @ref AliHLTConfiguration object is registered automatically with the
+  // handler and put into the list.
   SetLocalLoggingLevel(kHLTLogInfo);
 }
 
 AliHLTConfigurationHandler::~AliHLTConfigurationHandler()
 {
-  // see header file for function documentation
+  // destructor
   TObjLink* lnk=NULL;
   while ((lnk=fgListConfigurations.FirstLink())!=NULL) {
     AliHLTConfiguration* pConf=(AliHLTConfiguration*)lnk->GetObject();
@@ -77,7 +70,7 @@ TMap* AliHLTConfigurationHandler::fgpSubstitutions=NULL;
 
 AliHLTConfigurationHandler* AliHLTConfigurationHandler::CreateHandler()
 {
-  // see header file for class documentation
+  // create global handler instance
   if (!fgpInstance) fgpInstance=new AliHLTConfigurationHandler;
   fgNofInstances++;
   return fgpInstance;
@@ -85,7 +78,7 @@ AliHLTConfigurationHandler* AliHLTConfigurationHandler::CreateHandler()
 
 int AliHLTConfigurationHandler::Destroy()
 {
-  // see header file for class documentation
+  // destroy instance
   int nofInstances=0;
   if (fgpInstance==this) {
     nofInstances=--fgNofInstances;
@@ -102,7 +95,7 @@ int AliHLTConfigurationHandler::Destroy()
 
 int AliHLTConfigurationHandler::RegisterConfiguration(AliHLTConfiguration* pConf)
 {
-  // see header file for function documentation
+  // register a configuration
   int iResult=0;
   if (pConf) {
     AliHLTConfiguration* pClone=new AliHLTConfiguration(*pConf);
@@ -138,7 +131,7 @@ int AliHLTConfigurationHandler::RegisterConfiguration(AliHLTConfiguration* pConf
 
 int AliHLTConfigurationHandler::CreateConfiguration(const char* id, const char* component, const char* sources, const char* arguments)
 {
-  // see header file for function documentation
+  // create configuration
   int iResult=0;
   // if this handler is the global instance the configuration is added
   // automatically in the creation of the AliHLTConfiguration object
@@ -175,7 +168,7 @@ int AliHLTConfigurationHandler::CreateConfiguration(const char* id, const char*
 
 void AliHLTConfigurationHandler::PrintConfigurations()
 {
-  // see header file for function documentation
+  // print information
   HLTLogKeyword("configuration listing");
   HLTMessage("registered configurations:");
   TObjLink *lnk = fgListConfigurations.FirstLink();
@@ -208,7 +201,7 @@ void AliHLTConfigurationHandler::Print(const char* option)
 
 int AliHLTConfigurationHandler::RemoveConfiguration(const char* id)
 {
-  // see header file for function documentation
+  // remove configuration from registry
   int iResult=0;
   if (id) {
     AliHLTConfiguration* pConf=NULL;
@@ -228,7 +221,7 @@ int AliHLTConfigurationHandler::RemoveConfiguration(const char* id)
 
 int AliHLTConfigurationHandler::RemoveConfiguration(AliHLTConfiguration* pConf)
 {
-  // see header file for function documentation
+  // remove configuration from registry
   int iResult=0;
   if (pConf) {
     // remove the configuration from the list
@@ -251,7 +244,7 @@ int AliHLTConfigurationHandler::RemoveConfiguration(AliHLTConfiguration* pConf)
 
 AliHLTConfiguration* AliHLTConfigurationHandler::FindConfiguration(const char* id)
 {
-  // see header file for function documentation
+  // find configuration by id
   AliHLTConfiguration* pConf=NULL;
   if (id) {
     pConf=(AliHLTConfiguration*)fgListConfigurations.FindObject(id); 
@@ -259,16 +252,18 @@ AliHLTConfiguration* AliHLTConfigurationHandler::FindConfiguration(const char* i
   return pConf;
 }
 
-int AliHLTConfigurationHandler::Deactivate(bool schedule) {
-  // see header file for function documentation
+int AliHLTConfigurationHandler::Deactivate(bool schedule)
+{
+  // deactivate handler
   fFlags|=kInactive;
   if (schedule)
     fFlags|=kScheduling;
   return 0;
 }
 
-int AliHLTConfigurationHandler::Activate() {
-  // see header file for function documentation
+int AliHLTConfigurationHandler::Activate()
+{
+  // activate handler
   fFlags&=~kInactive;
   if (IsScheduling()) {
     fFlags&=~kScheduling;
index d66542a..c920b89 100644 (file)
@@ -3,7 +3,7 @@
 
 #ifndef ALIHLTCONFIGURATIONHANDLER_H
 #define ALIHLTCONFIGURATIONHANDLER_H
-///* This file is property of and copyright by the ALICE HLT Project        * 
+///* This file is property of and copyright by the                          * 
 ///* ALICE Experiment at CERN, All rights reserved.                         *
 ///* See cxx source for full Copyright notice                               *
 
index 4fe9750..78bdda3 100644 (file)
@@ -1,30 +1,26 @@
 // $Id$
 
-/**************************************************************************
- * This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- *                                                                        *
- * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
- *                  for The ALICE HLT Project.                            *
- *                                                                        *
- * Permission to use, copy, modify and distribute this software and its   *
- * documentation strictly for non-commercial purposes is hereby granted   *
- * without fee, provided that the above copyright notice appears in all   *
- * copies and that both the copyright notice and this permission notice   *
- * appear in the supporting documentation. The authors make no claims     *
- * about the suitability of this software for any purpose. It is          *
- * provided "as is" without express or implied warranty.                  *
- **************************************************************************/
+///**************************************************************************
+// * This file is property of and copyright by the                          * 
+// * ALICE Experiment at CERN, All rights reserved.                         *
+// *                                                                        *
+// * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
+// *                  for The ALICE HLT Project.                            *
+// *                                                                        *
+// * Permission to use, copy, modify and distribute this software and its   *
+// * documentation strictly for non-commercial purposes is hereby granted   *
+// * without fee, provided that the above copyright notice appears in all   *
+// * copies and that both the copyright notice and this permission notice   *
+// * appear in the supporting documentation. The authors make no claims     *
+// * about the suitability of this software for any purpose. It is          *
+// * provided "as is" without express or implied warranty.                  *
+// **************************************************************************
 
-/** @file   AliHLTConsumerDescriptor.cxx
-    @author Matthias Richter
-    @date   
-    @brief  Helper class to describe a consumer component.
-*/
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
+/// @file   AliHLTConsumerDescriptor.cxx
+/// @author Matthias Richter
+/// @date   
+/// @brief  Helper class to describe a consumer component.
+///
 
 #include "AliHLTConsumerDescriptor.h"
 
@@ -75,7 +71,7 @@ int AliHLTConsumerDescriptor::CheckActiveDataSegment(AliHLTDataBuffer::AliHLTDat
   // see header file for function documentation
   int iResult=0;
   if (fSegments.size()>0) {
-    vector<AliHLTDataBuffer::AliHLTDataSegment>::iterator element=fSegments.begin();
+    AliHLTDataBuffer::AliHLTDataSegmentList::iterator element=fSegments.begin();
     while (element!=fSegments.end()) {
       if ((iResult=(segment==(*element)))>0) {
        break;
@@ -94,7 +90,7 @@ int AliHLTConsumerDescriptor::ReleaseActiveDataSegment(AliHLTDataBuffer::AliHLTD
   // see header file for function documentation
   int iResult=0;
   if (fSegments.size()>0) {
-    vector<AliHLTDataBuffer::AliHLTDataSegment>::iterator element=fSegments.begin();
+    AliHLTDataBuffer::AliHLTDataSegmentList::iterator element=fSegments.begin();
     while (element!=fSegments.end()) {
       if ((iResult=(segment==(*element)))>0) {
        fSegments.erase(element);
index 7c6691d..d4190ba 100644 (file)
@@ -3,7 +3,7 @@
 
 #ifndef ALIHLTCONSUMERDESCRIPTOR_H
 #define ALIHLTCONSUMERDESCRIPTOR_H
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //* See cxx source for full Copyright notice                               *
 
@@ -89,10 +89,10 @@ class AliHLTConsumerDescriptor : public TObject, public AliHLTLogging {
   AliHLTConsumerDescriptor& operator=(const AliHLTConsumerDescriptor&);
 
   /** consumer object */
-  AliHLTComponent* fpConsumer;                                     //! transient
+  AliHLTComponent* fpConsumer;                        //! transient
 
   /** list of data segments */
-  vector<AliHLTDataBuffer::AliHLTDataSegment> fSegments;           // see above
+  AliHLTDataBuffer::AliHLTDataSegmentList fSegments;  // list of data segments
 
   ClassDef(AliHLTConsumerDescriptor, 0)
 };
index adca21a..fead6e5 100644 (file)
@@ -1,7 +1,7 @@
 // $Id$
 
 //**************************************************************************
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //*                                                                        *
 //* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
 //* provided "as is" without express or implied warranty.                  *
 //**************************************************************************
 
-/** @file   AliHLTControlTask.cxx
-    @author Matthias Richter
-    @date   
-    @brief  Special task to produce the control events.
-*/
+/// @file   AliHLTControlTask.cxx
+/// @author Matthias Richter
+/// @date   
+/// @brief  Special task to produce the control events.
+///
 
 #include "AliHLTControlTask.h"
 #include "AliHLTComponentHandler.h"
@@ -35,22 +35,22 @@ AliHLTControlTask::AliHLTControlTask()
   , fpData(NULL)
   , fSize(0)
 {
-  // see header file for class documentation
-  // or
-  // refer to README to build package
-  // or
-  // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
+  // constructor
+  //
+  // This task is automatically added to the beginning of each chain and
+  // produces the special steering events. The first component in every
+  // branch get the special events from the task.
 }
 
 AliHLTControlTask::~AliHLTControlTask()
 {
-  // see header file for class documentation
+  // destructor
   ResetBlocks();
 }
 
 int AliHLTControlTask::CreateComponent(AliHLTConfiguration* /*pConf*/, AliHLTComponentHandler* pCH, AliHLTComponent*& pComponent) const
 {
-  // see header file for class documentation
+  // create component
   int iResult=0;
   if ((pComponent=new AliHLTControlEventComponent(this))) {
     const AliHLTAnalysisEnvironment* pEnv=pCH->GetEnvironment();
index 047fcf2..fd088cd 100644 (file)
@@ -2,15 +2,15 @@
 // $Id$
 #ifndef ALIHLTCONTROLTASK_H
 #define ALIHLTCONTROLTASK_H
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //* See cxx source for full Copyright notice                               *
 
-/** @file   AliHLTControlTask.h
-    @author Matthias Richter
-    @date   
-    @brief  Special task to produce the control events.
-*/
+/// @file   AliHLTControlTask.h
+/// @author Matthias Richter
+/// @date   
+/// @brief  Special task to produce the control events.
+///
 
 #include "AliHLTTask.h"
 #include "AliHLTDataSource.h"
index 629d4bf..4b6ffba 100644 (file)
@@ -1,7 +1,7 @@
 // $Id$
 
 //**************************************************************************
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //*                                                                        *
 //* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
 //  @brief  Handling of Data Buffers for HLT components.
 //  @note   Only used in the AliRoot framework
 
-// see header file for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
-
 #include "AliHLTDataBuffer.h"
 #include "AliHLTConsumerDescriptor.h"
 #include "AliHLTComponent.h"
@@ -41,9 +31,7 @@ using namespace std;
 //#include <string>
 //#include "AliHLTSystem.h"
 
-#define USE_ALIHLTRAWPAGE
-
-typedef vector<AliHLTDataBuffer::AliHLTDataSegment> AliHLTDataSegmentList;
+using std::cout;
 
 /** ROOT macro for the implementation of ROOT specific class methods */
 ClassImp(AliHLTDataBuffer)
@@ -136,7 +124,7 @@ int AliHLTDataBuffer::FindMatchingDataBlocks(const AliHLTComponent* pConsumer, A
 }
 
 int AliHLTDataBuffer::FindMatchingDataSegments(const AliHLTComponent* /*pConsumer*/,
-                                              vector<AliHLTDataBuffer::AliHLTDataSegment>& tgtList)
+                                              AliHLTDataSegmentList& tgtList)
 {
   // see header file for function documentation
   int iResult=0;
@@ -387,9 +375,7 @@ int AliHLTDataBuffer::SetSegments(AliHLTUInt8_t* pTgt, AliHLTComponentBlockData*
          }
        }
        // to be enabled if unit test is ready
-#ifdef USE_ALIHLTRAWPAGE
        iResult=SetRawBufferDataSize(fpBuffer, maxSize);        
-#endif //USE_ALIHLTRAWPAGE
       } else {
        HLTError("this data buffer (%p) does not match the internal data buffer %p of raw buffer %p", pTgt, fpBuffer->GetPointer(), fpBuffer);
        iResult=-EINVAL;
@@ -445,43 +431,10 @@ AliHLTDataBuffer::AliHLTRawBuffer* AliHLTDataBuffer::CreateRawBuffer(AliHLTUInt3
   // see header file for function documentation
   AliHLTRawBuffer* pRawBuffer=NULL;
   unsigned int reqSize=size+fgkSafetyPatternSize;
-#ifndef USE_ALIHLTRAWPAGE
-  AliHLTRawBufferPList::iterator buffer=fgFreeBuffers.begin();
-  while (buffer!=fgFreeBuffers.end() && pRawBuffer==NULL) {
-    if ((*buffer)->CheckSize(reqSize)) {
-      // assign this element
-      pRawBuffer=*buffer;
-      pRawBuffer->UseBuffer(size);
-      fgFreeBuffers.erase(buffer);
-      fgLogging.Logging(kHLTLogDebug, "AliHLTDataBuffer::CreateRawBuffer", "data buffer handling", "raw buffer container %p provided for request of %d bytes (total %d available in buffer %p)", pRawBuffer, size, pRawBuffer->GetTotalSize(), pRawBuffer->GetPointer());
-      fgActiveBuffers.push_back(pRawBuffer);
-      break;
-    }
-    buffer++;
-  }
-  if (pRawBuffer==NULL) {
-    // no buffer found, create a new one
-    pRawBuffer=new AliHLTRawBuffer(reqSize);
-    if (pRawBuffer) {
-      if (pRawBuffer->GetPointer()) {
-       pRawBuffer->UseBuffer(size);
-       fgActiveBuffers.push_back(pRawBuffer);
-       fgLogging.Logging(kHLTLogDebug, "AliHLTDataBuffer::CreateRawBuffer", "data buffer handling", "new raw buffer %p of size %d created (container %p)", pRawBuffer->GetPointer(), pRawBuffer->GetTotalSize(), pRawBuffer);
-      } else {
-       delete pRawBuffer;
-       pRawBuffer=NULL;
-       fgLogging.Logging(kHLTLogError, "AliHLTDataBuffer::CreateRawBuffer", "data buffer handling", "memory allocation failed");
-      } 
-    } else {
-      fgLogging.Logging(kHLTLogError, "AliHLTDataBuffer::CreateRawBuffer", "data buffer handling", "memory allocation failed");
-    }
-  }
-#else
   pRawBuffer=AliHLTDataBuffer::AliHLTRawPage::GlobalAlloc(reqSize);
   if (pRawBuffer) {
     pRawBuffer->UseBuffer(size);
   }
-#endif
   if (pRawBuffer!=NULL && fgkSafetyPatternSize>0) {
     //fgLogging.Logging(kHLTLogDebug, "AliHLTDataBuffer::CreateRawBuffer", "data buffer handling", "writing safety pattern to %p offset %d", (*buffer)->GetPointer(), (*buffer)->GetUsedSize());
     pRawBuffer->WritePattern(fgkSafetyPattern, fgkSafetyPatternSize);
@@ -504,7 +457,6 @@ int AliHLTDataBuffer::SetRawBufferDataSize(AliHLTRawBuffer* pBuffer, AliHLTUInt3
     }
   }
   // shrink the buffer and write new pattern at the end
-#ifdef USE_ALIHLTRAWPAGE
   AliHLTDataBuffer::AliHLTRawPage* rawpage=AliHLTDataBuffer::AliHLTRawPage::FindPage(pBuffer);
   if (rawpage) {
     pBuffer->UseBuffer(size);
@@ -518,9 +470,6 @@ int AliHLTDataBuffer::SetRawBufferDataSize(AliHLTRawBuffer* pBuffer, AliHLTUInt3
     fgLogging.Logging(kHLTLogError, "AliHLTDataBuffer::SetRawBufferDataSize", "data buffer handling", "can not find raw page for buffer %p", pBuffer);
     iResult=-ENOENT;
   }
-#else //!USE_ALIHLTRAWPAGE
-  pBuffer->UseBuffer(size);
-#endif //USE_ALIHLTRAWPAGE
   if (fgkSafetyPatternSize>0) {
     pBuffer->WritePattern(fgkSafetyPattern, fgkSafetyPatternSize);
   }
@@ -532,16 +481,8 @@ int AliHLTDataBuffer::ReleaseRawBuffer(AliHLTRawBuffer* pBuffer)
   // see header file for function documentation
   int iResult=0;
   if (pBuffer) {
-#ifdef USE_ALIHLTRAWPAGE
     AliHLTDataBuffer::AliHLTRawPage* rawpage=AliHLTDataBuffer::AliHLTRawPage::FindPage(pBuffer);
     if (rawpage)
-#else //!USE_ALIHLTRAWPAGE
-    AliHLTRawBufferPList::iterator buffer=fgActiveBuffers.begin();
-    while (buffer!=fgActiveBuffers.end() && (*buffer)!=pBuffer) {
-      buffer++;
-    }
-    if (buffer!=fgActiveBuffers.end())
-#endif //USE_ALIHLTRAWPAGE
     {
       if (fgkSafetyPatternSize>0) {
        //fgLogging.Logging(kHLTLogDebug, "AliHLTDataBuffer::ReleaseRawBuffer", "data buffer handling", "comparing safety pattern at %p offset %d", pBuffer->GetPointer(), reinterpret_cast<AliHLTUInt32_t>(pBuffer));
@@ -550,21 +491,12 @@ int AliHLTDataBuffer::ReleaseRawBuffer(AliHLTRawBuffer* pBuffer)
        }
       }
       pBuffer->Reset();
-#ifdef USE_ALIHLTRAWPAGE
       if (rawpage->Free(pBuffer)==0) {
       } else {
        fgLogging.Logging(kHLTLogError, "AliHLTDataBuffer::ReleaseRawBuffer", "data buffer handling", "failed to release raw buffer %p", pBuffer);
       }
-#else //!USE_ALIHLTRAWPAGE
-      fgFreeBuffers.push_back(pBuffer);
-      fgActiveBuffers.erase(buffer);
-#endif //USE_ALIHLTRAWPAGE
     } else {
-#ifdef USE_ALIHLTRAWPAGE
       fgLogging.Logging(kHLTLogError, "AliHLTDataBuffer::ReleaseRawBuffer", "data buffer handling", "can not find raw page for buffer %p", pBuffer);
-#else //!USE_ALIHLTRAWPAGE
-      fgLogging.Logging(kHLTLogWarning, "AliHLTDataBuffer::ReleaseRawBuffer", "data buffer handling", "can not find raw buffer container %p in the list of active containers", pBuffer);
-#endif //USE_ALIHLTRAWPAGE
       iResult=-ENOENT;
     }
   } else {
@@ -609,7 +541,6 @@ int AliHLTDataBuffer::PrintStatistics()
 {
   // see header file for function documentation
   int iResult=0;
-#ifdef USE_ALIHLTRAWPAGE
   int nofPages=0;
   AliHLTUInt32_t totalSize=0;
   for (AliHLTDataBuffer::AliHLTRawPage* rawpage=AliHLTDataBuffer::AliHLTRawPage::NextPage(NULL);
@@ -622,18 +553,6 @@ int AliHLTDataBuffer::PrintStatistics()
   //if (rawpage) rawpage->Print("global");
   fgLogging.Logging(kHLTLogInfo, "AliHLTDataBuffer::PrintStatistics", "data buffer handling", "total number of memory pages: %d   total size %d", nofPages, totalSize);
 
-#else //! USE_ALIHLTRAWPAGE
-  int iFree=0;
-  int iActive=0;
-  AliHLTRawBufferPList::iterator buffer;;
-  for (buffer=fgFreeBuffers.begin(); buffer!=fgFreeBuffers.end(); buffer++) {
-    iFree+=(*buffer)->GetTotalSize();
-  }
-  for (buffer=fgActiveBuffers.begin(); buffer!=fgActiveBuffers.end(); buffer++) {
-    iActive+=(*buffer)->GetTotalSize();
-  }
-  fgLogging.Logging(kHLTLogInfo, "AliHLTDataBuffer::PrintStatistics", "data buffer handling", "Total memory allocation: %d byte; %d free buffers (%d byte) - %d active buffers (%d byte) ", iFree+iActive, fgFreeBuffers.size(), iFree, fgActiveBuffers.size(), iActive);
-#endif // USE_ALIHLTRAWPAGE
   return iResult;
 }
 
@@ -916,8 +835,6 @@ AliHLTDataBuffer::AliHLTRawBuffer* AliHLTDataBuffer::AliHLTRawBuffer::Split(AliH
       fTotalSize=size;
     }
     return part2;
-  } else {
-    //cout << "can not split fTotalSize=" << fTotalSize << "  fSize=" << fSize << "  at size=" << size << endl; 
   }
   return NULL;
 }
index 55fedbf..067d022 100644 (file)
@@ -3,7 +3,7 @@
 
 #ifndef ALIHLTDATABUFFER_H
 #define ALIHLTDATABUFFER_H
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //* See cxx source for full Copyright notice                               *
 
 //  @brief  Handling of Data Buffers for HLT components.
 //  @note   The class is used in Offline (AliRoot) context
 
-// see below for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
-
 #include <vector>
 #include "TObject.h"
 #include "AliHLTLogging.h"
 #include "AliHLTDataTypes.h"
 #include "AliHLTComponent.h"
 
+using std::vector;
+
 class AliHLTConsumerDescriptor;
 class AliHLTTask;
 
@@ -393,6 +389,8 @@ class AliHLTDataBuffer : public TObject, public AliHLTLogging
     AliHLTTask* fParentTask;                                       //!transient
   };
 
+  typedef vector<AliHLTDataBuffer::AliHLTDataSegment> AliHLTDataSegmentList;
+
   class AliHLTRawBuffer;
   typedef vector<AliHLTRawBuffer*>  AliHLTRawBufferPList;
 
@@ -592,7 +590,7 @@ class AliHLTDataBuffer : public TObject, public AliHLTLogging
    *          -EINVAL       invalid parameter <br>
    */
   int FindMatchingDataSegments(const AliHLTComponent* pConsumer, 
-                              vector<AliHLTDataBuffer::AliHLTDataSegment>& tgtList);
+                              AliHLTDataSegmentList& tgtList);
 
  protected:
   // 2010-02-01 make function protected in order to be used from unit test
index 31fee56..03d4df6 100644 (file)
@@ -1,29 +1,26 @@
 // $Id$
 
-/**************************************************************************
- * This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- *                                                                        *
- * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
- *                  for The ALICE HLT Project.                            *
- *                                                                        *
- * Permission to use, copy, modify and distribute this software and its   *
- * documentation strictly for non-commercial purposes is hereby granted   *
- * without fee, provided that the above copyright notice appears in all   *
- * copies and that both the copyright notice and this permission notice   *
- * appear in the supporting documentation. The authors make no claims     *
- * about the suitability of this software for any purpose. It is          *
- * provided "as is" without express or implied warranty.                  *
- **************************************************************************/
+//**************************************************************************
+//* This file is property of and copyright by the                          * 
+//* ALICE Experiment at CERN, All rights reserved.                         *
+//*                                                                        *
+//* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
+//*                  for The ALICE HLT Project.                            *
+//*                                                                        *
+//* Permission to use, copy, modify and distribute this software and its   *
+//* documentation strictly for non-commercial purposes is hereby granted   *
+//* without fee, provided that the above copyright notice appears in all   *
+//* copies and that both the copyright notice and this permission notice   *
+//* appear in the supporting documentation. The authors make no claims     *
+//* about the suitability of this software for any purpose. It is          *
+//* provided "as is" without express or implied warranty.                  *
+//**************************************************************************
 
-/** @file   AliHLTDataSink.cxx
-    @author Matthias Richter
-    @date   
-    @brief  Base class implementation for HLT data source components. */
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
+/// @file   AliHLTDataSink.cxx
+/// @author Matthias Richter
+/// @date   
+/// @brief  Base class implementation for HLT data source components.
+///
 
 #include "AliHLTDataSink.h"
 
@@ -32,21 +29,21 @@ ClassImp(AliHLTDataSink)
 
 AliHLTDataSink::AliHLTDataSink()
 { 
-  // see header file for class documentation
-  // or
-  // refer to README to build package
-  // or
-  // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
+  // Base class of HLT data sink components.
+  // The class provides a common interface for the implementation of HLT data
+  // sink components.
+  // Sink components do not produce any output consequently the processing
+  // function is called 'DumpEvent'.
 }
 
 AliHLTDataSink::~AliHLTDataSink()
 { 
-  // see header file for class documentation
+  // destructor
 }
 
 AliHLTComponentDataType AliHLTDataSink::GetOutputDataType()
 {
-  // see header file for class documentation
+  // default method as sink components do not produce output
   AliHLTComponentDataType dt =
     {sizeof(AliHLTComponentDataType),
      kAliHLTVoidDataTypeID,
@@ -56,7 +53,7 @@ AliHLTComponentDataType AliHLTDataSink::GetOutputDataType()
 
 void AliHLTDataSink::GetOutputDataSize( unsigned long& constBase, double& inputMultiplier )
 {
-  // see header file for class documentation
+  // default method as sink components do not produce output
   constBase=0;
   inputMultiplier=0;
 }
@@ -66,10 +63,10 @@ int AliHLTDataSink::DoProcessing( const AliHLTComponentEventData& evtData,
                                  AliHLTComponentTriggerData& trigData,
                                  AliHLTUInt8_t* outputPtr, 
                                  AliHLTUInt32_t& size,
-                                 vector<AliHLTComponentBlockData>& outputBlocks,
+                                 AliHLTComponentBlockDataList& outputBlocks,
                                  AliHLTComponentEventDoneData*& edd )
 {
-  // see header file for class documentation
+  // Processing method, calls child's DumpEvent
   int iResult=0;
   if (outputPtr==NULL
       && size==0 
@@ -92,6 +89,7 @@ int AliHLTDataSink::DumpEvent( const AliHLTComponentEventData& evtData,
 
 int AliHLTDataSink::DumpEvent( const AliHLTComponentEventData& /*evtData*/, AliHLTComponentTriggerData& /*trigData*/)
 {
+  // default method: one of DumpEvent methods must be implemented
   HLTFatal("no processing method implemented");
   return -ENOSYS;
 }
index 38d93e4..ce9ce07 100644 (file)
@@ -1,23 +1,17 @@
 //-*- Mode: C++ -*-
-// @(#) $Id$
+// $Id$
 
 #ifndef ALIHLTDATASINK_H
 #define ALIHLTDATASINK_H
 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
  * See cxx source for full Copyright notice                               */
 
-/** @file   AliHLTDataSink.h
-    @author Matthias Richter
-    @date   
-    @brief  Base class declaration for HLT data sink components.
-    @note   The class is used in Offline (AliRoot) context
-*/
-
-// see below for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt   
+/// @file   AliHLTDataSink.h
+/// @author Matthias Richter
+/// @date   
+/// @brief  Base class declaration for HLT data sink components.
+/// @note   The class is used in Offline (AliRoot) context
+///
 
 #include "AliHLTComponent.h"
 
@@ -53,7 +47,7 @@ class AliHLTDataSink : public AliHLTComponent {
                    AliHLTComponentTriggerData& trigData,
                    AliHLTUInt8_t* outputPtr, 
                    AliHLTUInt32_t& size,
-                   vector<AliHLTComponentBlockData>& outputBlocks,
+                   AliHLTComponentBlockDataList& outputBlocks,
                    AliHLTComponentEventDoneData*& edd );
 
   // Information member functions for registration.
index 26ab2e3..229faba 100644 (file)
@@ -1,29 +1,26 @@
 // $Id$
 
-/**************************************************************************
- * This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- *                                                                        *
- * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
- *                  for The ALICE HLT Project.                            *
- *                                                                        *
- * Permission to use, copy, modify and distribute this software and its   *
- * documentation strictly for non-commercial purposes is hereby granted   *
- * without fee, provided that the above copyright notice appears in all   *
- * copies and that both the copyright notice and this permission notice   *
- * appear in the supporting documentation. The authors make no claims     *
- * about the suitability of this software for any purpose. It is          *
- * provided "as is" without express or implied warranty.                  *
- **************************************************************************/
+//**************************************************************************
+//* This file is property of and copyright by the                          * 
+//* ALICE Experiment at CERN, All rights reserved.                         *
+//*                                                                        *
+//* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
+//*                  for The ALICE HLT Project.                            *
+//*                                                                        *
+//* Permission to use, copy, modify and distribute this software and its   *
+//* documentation strictly for non-commercial purposes is hereby granted   *
+//* without fee, provided that the above copyright notice appears in all   *
+//* copies and that both the copyright notice and this permission notice   *
+//* appear in the supporting documentation. The authors make no claims     *
+//* about the suitability of this software for any purpose. It is          *
+//* provided "as is" without express or implied warranty.                  *
+//**************************************************************************
 
-/** @file   AliHLTDataSource.cxx
-    @author Matthias Richter
-    @date   
-    @brief  Base class implementation for HLT data source components. */
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
+/// @file   AliHLTDataSource.cxx
+/// @author Matthias Richter
+/// @date   
+/// @brief  Base class implementation for HLT data source components.
+///
 
 #include "AliHLTDataSource.h"
 
@@ -31,22 +28,22 @@ using namespace std;
 ClassImp(AliHLTDataSource)
 
 AliHLTDataSource::AliHLTDataSource()
-{ 
-  // see header file for class documentation
-  // or
-  // refer to README to build package
-  // or
-  // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
+{
+  // Base class of HLT data source components.
+  // The class provides a common interface for the implementation of HLT data
+  // source components.
+  // Source components do not consume any input consequently the processing
+  // function is called 'GetEvent'.
 }
 
 AliHLTDataSource::~AliHLTDataSource()
 { 
-  // see header file for class documentation
+  // destructor
 }
 
-void AliHLTDataSource::GetInputDataTypes( vector<AliHLTComponentDataType>& list)
+void AliHLTDataSource::GetInputDataTypes( AliHLTComponentDataTypeList& list)
 {
-  // see header file for class documentation
+  // default method as source components do not consume input
   list.clear(); // there are no input data types
 }
 
@@ -56,10 +53,10 @@ int AliHLTDataSource::DoProcessing( const AliHLTComponentEventData& evtData,
                                    AliHLTComponentTriggerData& trigData,
                                    AliHLTUInt8_t* outputPtr, 
                                    AliHLTUInt32_t& size,
-                                   vector<AliHLTComponentBlockData>& outputBlocks,
+                                   AliHLTComponentBlockDataList& outputBlocks,
                                    AliHLTComponentEventDoneData*& edd )
 {
-  // see header file for class documentation
+  // Processing method, calls child's GetEvent
   int iResult=0;
   if (evtData.fBlockCnt > 0) {
     int unknown=-1;
@@ -92,7 +89,7 @@ int AliHLTDataSource::GetEvent( const AliHLTComponentEventData& evtData,
                                AliHLTComponentTriggerData& trigData,
                                AliHLTUInt8_t* /*outputPtr*/, 
                                AliHLTUInt32_t& size,
-                               vector<AliHLTComponentBlockData>& /*outputBlocks*/ )
+                               AliHLTComponentBlockDataList& /*outputBlocks*/ )
 {
   // we just forward to the high level method, all other parameters already
   // have been stored internally
@@ -102,6 +99,7 @@ int AliHLTDataSource::GetEvent( const AliHLTComponentEventData& evtData,
 
 int AliHLTDataSource::GetEvent( const AliHLTComponentEventData& /*evtData*/, AliHLTComponentTriggerData& /*trigData*/)
 {
+  // default method: one of GetEvent methods must be implemented
   HLTFatal("no processing method implemented");
   return -ENOSYS;
 }
index b70225c..c9b8356 100644 (file)
@@ -1,24 +1,18 @@
 //-*- Mode: C++ -*-
-// @(#) $Id$
+// $Id$
 
 #ifndef ALIHLTDATASOURCE_H
 #define ALIHLTDATASOURCE_H
-/* This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- * See cxx source for full Copyright notice                               */
+///* This file is property of and copyright by the                          * 
+///* ALICE Experiment at CERN, All rights reserved.                         *
+///* See cxx source for full Copyright notice                               *
 
-/** @file   AliHLTDataSource.h
-    @author Matthias Richter
-    @date   
-    @brief  Base class declaration for HLT data source components.
-    @note   The class is used in Offline (AliRoot) context
-*/
-
-// see below for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt   
+/// @file   AliHLTDataSource.h
+/// @author Matthias Richter
+/// @date   
+/// @brief  Base class declaration for HLT data source components.
+/// @note   The class is used in Offline (AliRoot) context
+///
 
 #include "AliHLTComponent.h"
 
@@ -56,7 +50,7 @@ class AliHLTDataSource : public AliHLTComponent {
                    AliHLTComponentTriggerData& trigData,
                    AliHLTUInt8_t* outputPtr, 
                    AliHLTUInt32_t& size,
-                   vector<AliHLTComponentBlockData>& outputBlocks,
+                   AliHLTComponentBlockDataList& outputBlocks,
                    AliHLTComponentEventDoneData*& edd );
 
   // Information member functions for registration.
@@ -71,7 +65,7 @@ class AliHLTDataSource : public AliHLTComponent {
    * Default implementation for all data sources.
    * There are no input data types.
    */
-  void GetInputDataTypes( vector<AliHLTComponentDataType>& list);
+  void GetInputDataTypes( AliHLTComponentDataTypeList& list);
 
 protected:
 
@@ -91,7 +85,7 @@ protected:
                AliHLTComponentTriggerData& trigData,
                AliHLTUInt8_t* outputPtr, 
                AliHLTUInt32_t& size,
-               vector<AliHLTComponentBlockData>& outputBlocks );
+               AliHLTComponentBlockDataList& outputBlocks );
 
   /**
    * The high-level data processing method.
index fa7a099..1bab10e 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/** @file   AliHLTEventStatistics.cxx
-    @author Jochen Thaeder
-    @date   
-    @brief  Base class for event statistics, for all detectors
-*/
-
-// see header file for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt   
-
-#if __GNUC__ >= 3
-using namespace std;
-#endif
+/// @file   AliHLTEventStatistics.cxx
+/// @author Jochen Thaeder
+/// @date   
+/// @brief  Base class for event statistics, for all detectors
+///
 
 #include "AliHLTEventStatistics.h"
 
index 6eab8f4..3e2262e 100644 (file)
 // or
 // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
 
-#if __GNUC__>= 3
-   using namespace std;
-#endif
-
 #include "AliHLTHOMERBlockDesc.h"
 
 #include "AliHLTMessage.h"
@@ -37,7 +33,6 @@
 #include "TMath.h"
 #include "TClass.h"
 
-
 ClassImp(AliHLTHOMERBlockDesc)
 
 /*
index 18ad84e..d045b02 100644 (file)
 // or
 // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
 
-#if __GNUC__>= 3
-   using namespace std;
-#endif
-
 #define EVE_DEBUG 0
 
 #include "AliHLTHOMERManager.h"
@@ -44,6 +40,8 @@
 #include "AliHLTTriggerDecision.h"
 //---------------------------
 
+using std::cout;
+
 ClassImp(AliHLTHOMERManager)
 
 /*
index 203159f..73d837b 100644 (file)
 // or
 // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
 
-#if __GNUC__>= 3
-   using namespace std;
-#endif
-
 #include "TDOMParser.h"
 #include "TSocket.h"
 #include "TSystem.h"
index 5000844..26648ef 100644 (file)
 // or
 // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
 
-#if __GNUC__>= 3
-   using namespace std;
-#endif
-
 #include "AliHLTHOMERSourceDesc.h"
 
-
 ClassImp(AliHLTHOMERSourceDesc)
 
 //##################################################################################
index ed7fc8c..52ce3f0 100644 (file)
@@ -1,30 +1,26 @@
-// @(#) $Id$
-
-/**************************************************************************
- * This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- *                                                                        *
- * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
- *                  for The ALICE HLT Project.                            *
- *                                                                        *
- * Permission to use, copy, modify and distribute this software and its   *
- * documentation strictly for non-commercial purposes is hereby granted   *
- * without fee, provided that the above copyright notice appears in all   *
- * copies and that both the copyright notice and this permission notice   *
- * appear in the supporting documentation. The authors make no claims     *
- * about the suitability of this software for any purpose. It is          *
- * provided "as is" without express or implied warranty.                  *
- **************************************************************************/
-
-/** @file   AliHLTLogging.cxx
-    @author Matthias Richter, Timm Steinbeck
-    @date   
-    @brief  Implementation of HLT logging primitives.
-*/
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
+// $Id$
+
+///**************************************************************************
+///* This file is property of and copyright by the                          * 
+///* ALICE Experiment at CERN, All rights reserved.                         *
+///*                                                                        *
+///* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
+///*                  for The ALICE HLT Project.                            *
+///*                                                                        *
+///* Permission to use, copy, modify and distribute this software and its   *
+///* documentation strictly for non-commercial purposes is hereby granted   *
+///* without fee, provided that the above copyright notice appears in all   *
+///* copies and that both the copyright notice and this permission notice   *
+///* appear in the supporting documentation. The authors make no claims     *
+///* about the suitability of this software for any purpose. It is          *
+///* provided "as is" without express or implied warranty.                  *
+///**************************************************************************
+
+/// @file   AliHLTLogging.cxx
+/// @author Matthias Richter, Timm Steinbeck
+/// @date   
+/// @brief  Implementation of HLT logging primitives.
+///
 
 #include "AliHLTStdIncludes.h"
 #include "AliHLTLogging.h"
@@ -35,6 +31,10 @@ using namespace std;
 #include <sstream>
 #include <iostream>
 
+using std::cout;
+using std::cerr;
+using std::endl;
+
 /** ROOT macro for the implementation of ROOT specific class methods */
 ClassImp(AliHLTLogging);
 
index 364c997..b09858a 100644 (file)
@@ -3,15 +3,15 @@
 
 #ifndef ALIHLTLOGGING_H
 #define ALIHLTLOGGING_H
-/* This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- * See cxx source for full Copyright notice                               */
-
-/** @file   AliHLTLogging.h
-    @author Matthias Richter, Timm Steinbeck
-    @date   
-    @brief  HLT module logging primitives.
-*/
+///* This file is property of and copyright by the                          * 
+///* ALICE Experiment at CERN, All rights reserved.                         *
+///* See cxx source for full Copyright notice                               */
+
+/// @file   AliHLTLogging.h
+/// @author Matthias Richter, Timm Steinbeck
+/// @date   
+/// @brief  HLT module logging primitives.
+///
 
 #include "AliHLTDataTypes.h"
 #include "AliHLTStdIncludes.h"
index dd049fd..447c1a4 100644 (file)
@@ -32,7 +32,8 @@
 #include "TROOT.h"
 #include <sstream>
 #include <iomanip>
-using namespace std;
+
+using std::cout;
 
 /** ROOT macro for the implementation of ROOT specific class methods */
 ClassImp(AliHLTOUT)
index 6462a16..e621b8d 100644 (file)
@@ -26,6 +26,8 @@ class TTree;
 
 #define AliHLTOUTInvalidIndex (~(AliHLTUInt32_t)0)
 
+using std::vector;
+
 typedef vector<AliHLTUInt32_t> AliHLTOUTIndexList;
 
 /**
index 205c83a..b4bc388 100644 (file)
@@ -1,30 +1,27 @@
 // $Id$
 
-/**************************************************************************
- * This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- *                                                                        *
- * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
- *                  Timm Steinbeck <timm@kip.uni-heidelberg.de>           *
- *                  for The ALICE HLT Project.                            *
- *                                                                        *
- * Permission to use, copy, modify and distribute this software and its   *
- * documentation strictly for non-commercial purposes is hereby granted   *
- * without fee, provided that the above copyright notice appears in all   *
- * copies and that both the copyright notice and this permission notice   *
- * appear in the supporting documentation. The authors make no claims     *
- * about the suitability of this software for any purpose. It is          *
- * provided "as is" without express or implied warranty.                  *
- **************************************************************************/
+///**************************************************************************
+// * This file is property of and copyright by the                          * 
+// * ALICE Experiment at CERN, All rights reserved.                         *
+// *                                                                        *
+// * Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
+// *                  Timm Steinbeck <timm@kip.uni-heidelberg.de>           *
+// *                  for The ALICE HLT Project.                            *
+// *                                                                        *
+// * Permission to use, copy, modify and distribute this software and its   *
+// * documentation strictly for non-commercial purposes is hereby granted   *
+// * without fee, provided that the above copyright notice appears in all   *
+// * copies and that both the copyright notice and this permission notice   *
+// * appear in the supporting documentation. The authors make no claims     *
+// * about the suitability of this software for any purpose. It is          *
+// * provided "as is" without express or implied warranty.                  *
+// **************************************************************************
 
-/** @file   AliHLTProcessor.cxx
-    @author Matthias Richter, Timm Steinbeck
-    @date   
-    @brief  Base class implementation for HLT analysis components. */
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
+/// @file   AliHLTProcessor.cxx
+/// @author Matthias Richter, Timm Steinbeck
+/// @date   
+/// @brief  Base class implementation for HLT analysis components.
+///
 
 #include "AliHLTProcessor.h"
 #include <string.h>
@@ -38,16 +35,11 @@ AliHLTProcessor::AliHLTProcessor()
   : AliHLTComponent()
   , fpDebugCounters(NULL)
 { 
-  // see header file for class documentation
-  // or
-  // refer to README to build package
-  // or
-  // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
 }
 
 AliHLTProcessor::~AliHLTProcessor()
 { 
-  // see header file for class documentation
+  // destructor
   if (fpDebugCounters) delete fpDebugCounters;
   fpDebugCounters=NULL;
 }
@@ -55,10 +47,10 @@ AliHLTProcessor::~AliHLTProcessor()
 int AliHLTProcessor::DoProcessing( const AliHLTComponentEventData& evtData, const AliHLTComponentBlockData* blocks, 
                            AliHLTComponentTriggerData& trigData, AliHLTUInt8_t* outputPtr, 
                            AliHLTUInt32_t& size,
-                           vector<AliHLTComponentBlockData>& outputBlocks,
+                           AliHLTComponentBlockDataList& outputBlocks,
                            AliHLTComponentEventDoneData*& edd )
 {
-  // see header file for class documentation
+  // Processing method, calls child's DoEvent
   int iResult=0;
   ReleaseEventDoneData();
 
@@ -135,7 +127,7 @@ int AliHLTProcessor::DoEvent( const AliHLTComponentEventData& evtData,
                              AliHLTComponentTriggerData& trigData,
                              AliHLTUInt8_t* /*outputPtr*/, 
                              AliHLTUInt32_t& size,
-                             vector<AliHLTComponentBlockData>& /*outputBlocks*/ )
+                             AliHLTComponentBlockDataList& /*outputBlocks*/ )
 {
   // we just forward to the high level method, all other parameters already
   // have been stored internally
@@ -145,6 +137,7 @@ int AliHLTProcessor::DoEvent( const AliHLTComponentEventData& evtData,
 
 int AliHLTProcessor::DoEvent( const AliHLTComponentEventData& /*evtData*/, AliHLTComponentTriggerData& /*trigData*/)
 {
+  // default method: one of DoEvent methods must be implemented
   HLTFatal("no processing method implemented");
   return -ENOSYS;
 }
index d95c263..3bed152 100644 (file)
@@ -1,22 +1,17 @@
 //-*- Mode: C++ -*-
-// @(#) $Id$
+// $Id$
 
 #ifndef ALIHLTPROCESSOR_H
 #define ALIHLTPROCESSOR_H
-/* This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- * See cxx source for full Copyright notice                               */
+///* This file is property of and copyright by the                          * 
+///* ALICE Experiment at CERN, All rights reserved.                         *
+///* See cxx source for full Copyright notice                               *
 
-/** @file   AliHLTProcessor.h
-    @author Matthias Richter, Timm Steinbeck
-    @date   
-    @brief  Base class declaration for HLT analysis components. */
-
-// see below for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt   
+/// @file   AliHLTProcessor.h
+/// @author Matthias Richter, Timm Steinbeck
+/// @date   
+/// @brief  Base class declaration for HLT analysis components.
+///
 
 #include "AliHLTComponent.h"
 
index 2a7f5d2..430bf8a 100644 (file)
 // or
 // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt   
 
-#if __GNUC__ >= 3
-using namespace std;
-#endif
-
 #include "AliHLTRunStatistics.h"
 #include <iostream>
 #include <cerrno>
 
+using std::cout;
+
 ClassImp(AliHLTRunStatistics)
     
 AliHLTRunStatistics::AliHLTRunStatistics()
index f26006a..9a5f799 100644 (file)
@@ -1,6 +1,6 @@
 // $Id$
 //**************************************************************************
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //*                                                                        *
 //* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
 //* provided "as is" without express or implied warranty.                  *
 //**************************************************************************
 
-/** @file   AliHLTSystem.cxx
-    @author Matthias Richter
-    @date   
-    @brief  Implementation of HLT module management.
-*/
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
+/// @file   AliHLTSystem.cxx
+/// @author Matthias Richter
+/// @date   
+/// @brief  Implementation of HLT module management.
+///
 
 #include <cassert>
 #include "AliHLTStdIncludes.h"
index f25c687..8ee934e 100644 (file)
@@ -3,7 +3,7 @@
 
 #ifndef ALIHLTSYSTEM_H
 #define ALIHLTSYSTEM_H
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //* See cxx source for full Copyright notice                               *
 
index d766f55..849ffcf 100644 (file)
@@ -1,6 +1,6 @@
 // $Id$
 //**************************************************************************
-//* This file is property of and copyright by the ALICE HLT Project        * 
+//* This file is property of and copyright by the                          * 
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //*                                                                        *
 //* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no>        *
 /// @brief  Implementation of HLT tasks.
 ///
 
-// see header file for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
-
-#if __GNUC__>= 3
-using namespace std;
-#endif
-
 #include <cerrno>
 #include <cassert>
 #include <iostream>
@@ -44,6 +34,8 @@ using namespace std;
 #include "TList.h"
 #include "AliHLTErrorGuard.h"
 
+using std::cout;
+
 /** ROOT macro for the implementation of ROOT specific class methods */
 ClassImp(AliHLTTask)
 
index fe77275..65b01bc 100644 (file)
@@ -3,21 +3,15 @@
 
 #ifndef ALIHLTTASK_H
 #define ALIHLTTASK_H
-/* This file is property of and copyright by the ALICE HLT Project        * 
- * ALICE Experiment at CERN, All rights reserved.                         *
- * See cxx source for full Copyright notice                               */
-
-/** @file   AliHLTTask.h
-    @author Matthias Richter
-    @date   
-    @brief  base class for HLT tasks
-*/
-
-// see below for class documentation
-// or
-// refer to README to build package
-// or
-// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt   
+///* This file is property of and copyright by the                          * 
+///* ALICE Experiment at CERN, All rights reserved.                         *
+///* See cxx source for full Copyright notice                               *
+
+/// @file   AliHLTTask.h
+/// @author Matthias Richter
+/// @date   
+/// @brief  base class for HLT tasks
+///
 
 #include <vector>
 #include <TObject.h>
@@ -26,6 +20,8 @@
 #include "AliHLTLogging.h"
 #include "AliHLTDataBuffer.h"
 
+using std::vector;
+
 struct AliHLTComponentBlockData;
 class AliHLTComponent;
 class AliHLTComponentHandler;
index bf9edb6..628ac56 100644 (file)
 //  @note   This interface is deprecated, the new interface is defined
 //          in HLT/BASE/AliHLTExternalInterface
 
-#if __GNUC__>= 3
-using namespace std;
-#endif
-
 #include "AliHLT_C_Component_WrapperInterface.h"
 #include "AliHLTComponentHandler.h"
 #include "AliHLTComponent.h"
 #include "AliHLTMisc.h"
 #include <errno.h>
 
+using namespace std;
+
 static AliHLTComponentHandler *gComponentHandler_C = NULL;
 static AliHLTRunDesc gRunDesc=kAliHLTVoidRunDesc;
 static char* gRunType=NULL;