Fixing Doxygen warnings
authorivana <ivana@f7af4fe6-9843-0410-8265-dc069ae4e863>
Fri, 15 May 2009 10:05:06 +0000 (10:05 +0000)
committerivana <ivana@f7af4fe6-9843-0410-8265-dc069ae4e863>
Fri, 15 May 2009 10:05:06 +0000 (10:05 +0000)
26 files changed:
MUON/AliMUONContourMaker.cxx
MUON/AliMUONContourMakerTest.h
MUON/AliMUONGlobalTrigger.h
MUON/AliMUONManuContourMaker.cxx
MUON/AliMUONManuContourMaker.h
MUON/AliMUONNode.h
MUON/AliMUONPointWithRef.cxx
MUON/AliMUONPointWithRef.h
MUON/AliMUONPolygon.h
MUON/AliMUONQAChecker.cxx
MUON/AliMUONQADataMakerRec.cxx
MUON/AliMUONRawStreamTrackerHP.h
MUON/AliMUONSegment.h
MUON/AliMUONSegmentTree.h
MUON/AliMUONTrackExtrap.cxx
MUON/AliMUONTrackerDataMaker.cxx
MUON/READMEmtrda.txt
MUON/READMEshuttle.txt
MUON/mapping/AliMpArea.cxx
MUON/mapping/AliMpArea.h
MUON/mapping/AliMpFastSegmentation.h
MUON/mapping/AliMpMotifPosition.h
MUON/mapping/AliMpMotifType.h
MUON/mapping/AliMpPad.h
MUON/mapping/AliMpTrigger.h
MUON/mapping/AliMpUID.h

index 73435cc2d073d1ef4b4924dfcfc6adddb6a2348c..5dc496e343af47325912aaef96a9ebcd2d9ae42d 100644 (file)
@@ -65,11 +65,14 @@ namespace
 //_____________________________________________________________________________
 AliMUONContourMaker::AliMUONContourMaker() 
 {
+/// Default constructor
 }
 
+
 //_____________________________________________________________________________
 AliMUONContourMaker::~AliMUONContourMaker()
 {
+/// Destructor
 }
 
 //_____________________________________________________________________________
index 1483de320432cd32b2f4582d4159f6532a73265c..f11e875d99fd238d1b43d61d25fc10b53d8bb8d9 100644 (file)
@@ -56,8 +56,6 @@ private:
   
   void GenerateTransformations(AliMpExMap*& real, AliMpExMap*& exploded);
 
-  TString NameIt(const AliMpMotifPosition& motifPosition) const;
-
   ClassDef(AliMUONContourMakerTest,1) // Test of AliMUONContourMaker
 };
 
index 9fdc49273ca8522b3759d9ac09f0a815712ea1b6..5b067bb69039a7c173eaf9bcb6002dd114b5b449 100644 (file)
@@ -37,6 +37,7 @@ class AliMUONGlobalTrigger : public TObject {
   void  SetFromGlobalResponse(UShort_t globalResponse);
   void  SetFromGlobalInput(const UInt_t *globalInput);
   UChar_t GetGlobalResponse() const;
+          /// Return global input to the global trigger board
   UInt_t *GetGlobalInput() { return fInput; }
 
   virtual void Print(Option_t* opt="") const;
index 538172af4b05c8ccfbdc9c8ba2dd4fb9a7fe69ba..6b530bddf09cf520e5119803ffb9650011b38245 100644 (file)
@@ -62,12 +62,15 @@ ClassImp(AliMUONManuContourMaker)
 AliMUONManuContourMaker::AliMUONManuContourMaker(AliMpExMap* deTransformations)
 : TObject(), fDETransformations(deTransformations), fLocalManuContours(222,1)
 {
+/// Standard constructor
+
   fLocalManuContours.SetOwnerKeyValue(kTRUE,kTRUE);  
 }
 
 //_____________________________________________________________________________
 AliMUONManuContourMaker::~AliMUONManuContourMaker()
 {
+/// Destructor
 }
 
 //_____________________________________________________________________________
index 0dbea02a2b313c80ffb8b7e57c8f8748ce49e298..3426fe06ac7ffa5b6f3cc7b83abcea4d186951fb 100644 (file)
@@ -47,10 +47,10 @@ private:
   TString NameIt(const AliMpMotifPosition& motifPosition) const;
 
 private:
-  AliMpExMap* fDETransformations; //< map<int,TGeoHMatrix> of detElemId to matrix
-  mutable TMap fLocalManuContours; //< map of local manu contours
+  AliMpExMap* fDETransformations;  ///< map<int,TGeoHMatrix> of detElemId to matrix
+  mutable TMap fLocalManuContours; ///< map of local manu contours
   
-  ClassDef(AliMUONManuContourMaker,1) // 
+  ClassDef(AliMUONManuContourMaker,1) // Maker of AliMUONContour objects for all the tracker manus
 };
 
 #endif
index eac51b4707e820cb0a8de85d01b794e781fa1da2..c9efd6cf53919e7f113e6a45bd9c6f260bff7f90 100644 (file)
@@ -61,17 +61,17 @@ private:
   AliMUONNode(const AliMUONNode& node); 
   /// not implemented
   AliMUONNode& operator=(const AliMUONNode& node);  
-  AliMUONNode* fLeftNode; //< left node
-  AliMUONNode* fRightNode; //< right node
+  AliMUONNode* fLeftNode; ///< left node
+  AliMUONNode* fRightNode; ///< right node
   
-  Double_t fMin; //< Min
-  Double_t fMax; //< Max
-  Double_t fMidPoint; //< (Min+Max)/2
+  Double_t fMin; ///< Min
+  Double_t fMax; ///< Max
+  Double_t fMidPoint; ///< (Min+Max)/2
   
-  Int_t fC; //< cardinality
-  Int_t fP; //< potent state
+  Int_t fC; ///< cardinality
+  Int_t fP; ///< potent state
   
-  ClassDef(AliMUONNode,0); // A node of a segment tree
+  ClassDef(AliMUONNode,0) // A node of a segment tree
 };
 
 #endif
index 2c38730034a04e8d2eb2da60c60177e3ad286437..d6b129c19daaa557a829b501342bf2cf3387b6d7 100644 (file)
@@ -36,22 +36,22 @@ ClassImp(AliMUONPointWithRef)
 //_____________________________________________________________________________
 AliMUONPointWithRef::AliMUONPointWithRef() : fX(), fY(), fRef(-1)
 {
-  /// ctor
+  /// default ctor
 }
 
 //_____________________________________________________________________________
 AliMUONPointWithRef::AliMUONPointWithRef(Double_t x, Double_t y, Int_t ref)
 : fX(x), fY(y), fRef(ref)
 {
-  /// dtor
+  /// ctor
 }
 
 //_____________________________________________________________________________
 Int_t  
 AliMUONPointWithRef::Compare(const TObject* obj) const
 {
-  // Should serve to sort the vertical edges in ascending order, first on absissa, 
-  // then on ordinate
+  /// Should serve to sort the vertical edges in ascending order, first on absissa, 
+  /// then on ordinate
   
   if ( this == obj ) return 0;
   
index 33fe4646fb6f8648b6242aeec12d051561c1d01c..c698601db10c35f00a61bfc9204f0f8f4949fb8d 100644 (file)
@@ -21,6 +21,7 @@ class AliMUONPointWithRef : public TObject
 public:
   AliMUONPointWithRef(Double_t x, Double_t y, Int_t ref);
   AliMUONPointWithRef();
+  /// Destructor
   virtual ~AliMUONPointWithRef() {}
   
   /// We are sortable
@@ -28,18 +29,21 @@ public:
 
   virtual Int_t        Compare(const TObject* obj) const;
 
+  /// Return x value
   Double_t X() const { return fX; }
   
+  /// Return y value
   Double_t Y() const { return fY; }
   
+  /// Return the index of the original point in some array
   Int_t Ref() const { return fRef; }
   
   void Print(Option_t* opt="") const;
   
 private:
-  Double_t fX; //< x value
-  Double_t fY; //< y value
-  Int_t fRef; //< index of the original point in some array
+  Double_t fX; ///< x value
+  Double_t fY; ///< y value
+  Int_t fRef; ///< index of the original point in some array
   
   ClassDef(AliMUONPointWithRef,1) // A point with an external integer reference
 };
index c49baddbf3514a6e5814cc4c49223bb63b9d7090..95184dad54797b9fa7cdfe3461a17e17b73d4fd3 100644 (file)
@@ -51,7 +51,7 @@ public:
   void Close();
   
 private:
-  Int_t fN; /// Number of vertices 
+  Int_t fN; ///< Number of vertices 
   Double_t* fX; //[fN]
   Double_t* fY; //[fN]
   
index d694a65dbaa53f8e1dc0a79e2002983b43096c15..a817eca516c4feab2a869ff966f7ddb67a3a768c 100644 (file)
@@ -241,7 +241,7 @@ AliMUONQAChecker::CheckRaws(TObjArray ** list)
 //______________________________________________________________________________
 void AliMUONQAChecker::Init(const AliQAv1::DETECTORINDEX_t det) 
 {
-  // intialises QA and QA checker settings
+  /// intialises QA and QA checker settings
   AliQAv1::Instance(det) ; 
   Float_t hiValue[AliQAv1::kNBIT] ; 
   Float_t lowValue[AliQAv1::kNBIT] ;
index 2ea6893ce39d21311495ca0a1469a9d18c7645fb..a247343450f96a66f0f49240370b578b504b44ea 100644 (file)
@@ -1394,6 +1394,7 @@ AliMUONQADataMakerRec::FillTriggerDCSHistos()
 //____________________________________________________________________________ 
 AliMUONVTrackerData* AliMUONQADataMakerRec::GetTrackerData() const
 { 
+/// Return tracker data
   
   return fTrackerDataMaker->Data(); 
   
index 6a0edec3dd06089d2c643de2808bfd6dfccab242..53644150b813465e6c2e1f69431db062cf3cff22 100644 (file)
@@ -544,7 +544,8 @@ private:
         /// Not implemented
        AliMUONRawStreamTrackerHP& operator = (const AliMUONRawStreamTrackerHP& stream);
        
-  Int_t GetMaxDDL() const { return fgkMaxDDL; }
+       /// Return max number of tracker DDLs
+       Int_t GetMaxDDL() const { return fgkMaxDDL; }
   
        /// This is the custom event handler (callback interface) class which
        /// unpacks raw data words and fills an internal buffer with decoded digits
index 4e987f95b9175a7cb66729b3ce84b22000208cdc..b17122684d5f7066a44937810d0da331c9c3ce94 100644 (file)
@@ -21,6 +21,7 @@ class AliMUONSegment : public TObject
 public:
   AliMUONSegment();
   AliMUONSegment(Double_t xstart, Double_t ystart, Double_t xend, Double_t yend);
+  /// dtor
   virtual ~AliMUONSegment() {}
   
   virtual Int_t        Compare(const TObject* obj) const;
@@ -71,18 +72,18 @@ public:
   void Set(Double_t xstart, Double_t ystart, Double_t xend, Double_t yend);
   
 private:
-  Double_t fStartX; /// x of start point
-  Double_t fStartY; /// y of start point
-  Double_t fEndX; /// x of end point
-  Double_t fEndY; /// y of end point
-  Double_t fSmallerY; /// Either StartY or EndY
-  Bool_t fIsHorizontal; /// Whether the segment is horizontal
-  Bool_t fIsVertical; /// Whether the segment is vertical
-  Bool_t fIsLeftEdge; /// Whether the segment is a left edge 
-  Bool_t fIsRightEdge; /// Whether the segment is a right edge
-  Bool_t fIsAPoint; /// Whether start==end
+  Double_t fStartX; ///< x of start point
+  Double_t fStartY; ///< y of start point
+  Double_t fEndX; ///< x of end point
+  Double_t fEndY; ///< y of end point
+  Double_t fSmallerY; ///< Either StartY or EndY
+  Bool_t fIsHorizontal; ///< Whether the segment is horizontal
+  Bool_t fIsVertical; ///< Whether the segment is vertical
+  Bool_t fIsLeftEdge; ///< Whether the segment is a left edge 
+  Bool_t fIsRightEdge; ///< Whether the segment is a right edge
+  Bool_t fIsAPoint; ///< Whether start==end
   
-  static const Double_t fgkPrecision; /// Floating point precision used in comparisons
+  static const Double_t fgkPrecision; ///< Floating point precision used in comparisons
   
   ClassDef(AliMUONSegment,1) // A basic line segment
 };
index b1d75c85c36348bdabcea6be969e858349c40a5a..991696e775f112d8777d609054cdc014324bf0a4 100644 (file)
@@ -51,8 +51,8 @@ private:
   /// not implemented
   AliMUONSegmentTree& operator=(const AliMUONSegmentTree& rhs);
   
-  AliMUONNode* fRoot; /// root of the tree
-  TObjArray fStack; /// array of AliMUONSegment objects
+  AliMUONNode* fRoot; ///< root of the tree
+  TObjArray fStack; ///< array of AliMUONSegment objects
   
   ClassDef(AliMUONSegmentTree,1) // Implementation of a segment tree
 };
index 97b3f8268cab2485a2cc5d877e39daa6c55470a8..9f97a2a763ff5448960f43f84c3126a6fd3a26fd 100644 (file)
@@ -51,8 +51,8 @@ const Double_t AliMUONTrackExtrap::fgkRungeKuttaMaxResidue = 0.002;
 //__________________________________________________________________________
 void AliMUONTrackExtrap::SetField()
 {
-  // set field on/off flag  
-  // set field at the centre of the dipole
+  /// set field on/off flag;  
+  /// set field at the centre of the dipole
   const Double_t x[3] = {50.,50.,fgkSimpleBPosition};
   Double_t b[3] = {0.,0.,0.};
   TGeoGlobalMagField::Instance()->Field(x,b);
index 827e32f4f4fc10bd99896328380661298b7beffd..eacfe109c495573e224beb47e4a75c7d7158a261 100644 (file)
@@ -63,6 +63,7 @@ fIsRunning(kFALSE),
 fIsOwnerOfRawReader(kFALSE),
 fIsEventByEvent(kFALSE)
 {
+/// Root IO ctor
 }
 
 //_____________________________________________________________________________
@@ -236,6 +237,8 @@ AliMUONTrackerDataMaker::Ctor(const AliMUONRecoParam* recoParam,
 //_____________________________________________________________________________
 AliMUONTrackerDataMaker::~AliMUONTrackerDataMaker()
 {
+/// dtor
+
   delete fOneEventData;
   delete fAccumulatedData;
   if ( fIsOwnerOfRawReader ) delete fRawReader;
index 830179604fc5c62c7ec95ababf1721e3fa6357ca..4810b7d08d8f270772b1ed6fa6447633c61aafe0 100644 (file)
@@ -19,10 +19,10 @@ In the current version, the DA will modify only the global crate configuration.
 
 The configuration files stored in the online DB are the following:
 
-- MtgGlobalCrate-<version>.dat:   contains the global crate information
-- MtgRegionalCrate-<version>.dat: contains the regional crate information
-- MtgLocalMask-<version>.dat:     contains the local mask
-- MtgLocalLut-<version>.dat:      contains the local LUT 
+- MtgGlobalCrate-[version].dat:   contains the global crate information
+- MtgRegionalCrate-[version].dat: contains the regional crate information
+- MtgLocalMask-[version].dat:     contains the local mask
+- MtgLocalLut-[version].dat:      contains the local LUT 
 - MtgCurrent.dat:                 contains the name list of the above files with 
                                   their version and the flag for master/slave
                                   status of the DA
index 602201313feebea569be121e29467de4220f4e55..1a327da952e00c45d59e5e8243513be7baaa753b 100644 (file)
@@ -134,7 +134,7 @@ per LDC, as will be used in real life), the latter ones being roughly 100 MB eac
 //
 
 The raw.date.LDC* files are then processed using the DA online program (which is not built by default, but must be made
- explicitely using make daqDA-MCH from $ALICE_ROOT, and requires some DATE setup..., see \ref READMEmchda.txt )
+ explicitely using make daqDA-MCH from $ALICE_ROOT, and requires some DATE setup..., see \ref README_mchda )
  
 <pre>
  MUONTRKda.exe -f raw.date.LCDi -a LDCi.ped (i=0,1,2,3)
index 9e5cb2a870f7b90f35979a579a59eed067538633..b9887ab3c5d7589f466553bf6a69288e142aeb74 100755 (executable)
@@ -271,7 +271,9 @@ AliMpArea::Print(Option_t* opt) const
 void      
 AliMpArea::GetParameters(Double_t& x, Double_t& y,
                          Double_t& dx, Double_t& dy) const
-{                         
+{
+/// Fill the parameters: x, y position and dimensions
+                         
   x = fPositionX;
   y = fPositionY;
   dx = fDimensionX;
index 3f5d2a21fb237be9f70bc77ff0176e8ddcdb7271..1c3d4b2009191085f135490150664d967f82701b 100755 (executable)
@@ -69,13 +69,13 @@ ostream& operator << (ostream &stream,const AliMpArea& area);
 
 // inline functions
 
-                 /// Return position
+                 /// Return position
 inline Double_t  AliMpArea::GetPositionX() const   { return fPositionX; }
-                 /// Return position
+                 /// Return position
 inline Double_t  AliMpArea::GetPositionY() const   { return fPositionY; }
-                 /// Return dimensions
+                 /// Return dimensions
 inline Double_t  AliMpArea::GetDimensionX() const { return fDimensionX; }    
-                 /// Return dimensions
+                 /// Return dimensions
 inline Double_t  AliMpArea::GetDimensionY() const { return fDimensionY; }    
                  /// Return validity
 inline Bool_t    AliMpArea::IsValid() const    { return fValidity; }
index 53b36021b51dc1143e1fb36c060ed50ee66d3ef3..bc02583397c53540fdcc9c6483a8b1fb77353712 100644 (file)
@@ -79,7 +79,9 @@ public:
   AliMp::StationType StationType() const { return fHelper->StationType(); }
   
 private:
+  /// Not implemented
   AliMpFastSegmentation(const AliMpFastSegmentation& rhs);
+  /// Not implemented
   AliMpFastSegmentation& operator=(const AliMpFastSegmentation& rhs);
 
   virtual AliMpMotifPosition* InternalMotifPosition(Int_t index) const;
index 223cab8f4fa3a13d67f59d3fdd2283a22d4517dd..4e14197b42e86c549900ef2637c4c6b37661cd45 100755 (executable)
@@ -73,17 +73,19 @@ inline Int_t  AliMpMotifPosition::GetID() const
 inline AliMpVMotif*  AliMpMotifPosition::GetMotif() const
 { return fMotif; }
  
-/// Return position
+/// Return position
 inline Double_t AliMpMotifPosition::GetPositionX() const
 { return fPositionX; }
 
+/// Return y position
 inline Double_t AliMpMotifPosition::GetPositionY() const
 { return fPositionY; }
 
-/// Return position
+/// Return x dimension
 inline Double_t AliMpMotifPosition::GetDimensionX() const
 { return fMotif->DimensionX(); }
 
+/// Return y dimension
 inline Double_t AliMpMotifPosition::GetDimensionY() const
 { return fMotif->DimensionY(); }
 
index 8be6b252f33504ec280646e722dcad6232f93c07..10bbfbb808574b9706de24e911eda45797ae4b4a 100755 (executable)
@@ -66,7 +66,7 @@ class AliMpMotifType : public TObject
     Int_t    GetNofPadsX() const  {return fNofPadsX;}
     /// Return number of pads in y direction
     Int_t    GetNofPadsY() const  {return fNofPadsY;}
-    
+    /// Return the total number of pads
     Int_t    GetNofPads() const   {return fNofPads;}
     
     // Other methods
@@ -83,6 +83,7 @@ class AliMpMotifType : public TObject
 
     Bool_t HasPadByManuChannel(Int_t manuChannel) const;
 
+    /// Return whether the pad with given manu channel exists
     Bool_t HasPadByGassiNum(Int_t gassiNum) const { return HasPadByManuChannel(gassiNum); }
     
     Bool_t IsFull() const;
index 8837f3fe2fb66436b7cec6e8fd0afefbef17b22f..d5f5d080d91c816f2d253da283518a73328f77e2 100755 (executable)
@@ -102,7 +102,8 @@ class AliMpPad : public TObject
                                           /// in the collection
   // data members
   UInt_t          fNofLocations;   ///<  number of locations in fLocations
-  MpPair_t*       fLLocations;     //[fNofLocations]  collection of pad locations - encoded pair (localBoardId, localBoardChannel) 
+  /// Collection of pad locations - encoded pair (localBoardId, localBoardChannel) 
+  MpPair_t*       fLLocations;     //[fNofLocations]
   MpPair_t        fLLocation;      ///<  pad location as encoded pair (manuId, manuChannel) 
   MpPair_t        fLIndices;       ///<  pad indices as encoded pair (ix, iy)  
   Double_t        fPositionX;      ///<  the pad x position (in cm)
index 99344b3ca2659409d56b18bca014daa697a3fda3..c84fc339672fb99b1d399ae59241421cf0423674 100644 (file)
@@ -71,9 +71,9 @@ public:
 
   AliMp::PlaneType PlaneType() const;
   
-  // Return the x dimension (half-sizes) of that slat (cm)
+  /// Return the x dimension (half-sizes) of that slat (cm)
   Double_t  GetDimensionX() const { return DX(); }
-  // Return the y dimension (half-sizes) of that slat (cm)
+  /// Return the y dimension (half-sizes) of that slat (cm)
   Double_t  GetDimensionY() const { return DY(); }
   
 private:
index 999f714d42de37905c09269f4f89d2778a489ec7..748ce1707286befd3e8eba4e01744fb056ad93f2 100644 (file)
@@ -32,6 +32,7 @@ public:
   AliMpUID(AliMp::CathodType cathodeType, const char* pathname);
   AliMpUID(const char* pathname);
   
+  /// dtor
   virtual ~AliMpUID() {}
   
   TString Name() const;
@@ -48,11 +49,17 @@ public:
   Bool_t IsValid() const;
   
   AliMp::CathodType CathodeId() const;
+  /// Return station Id
   Int_t StationId() const { return fStationId; }
+  /// Return chamber Id
   Int_t ChamberId() const { return fChamberId; }
+  /// Return detection element Id
   Int_t DetElemId() const { return fDetElemId; }
+  /// Return bus patch Id
   Int_t BusPatchId() const { return fBusPatchId; }
+  /// Return manu Id
   Int_t ManuId() const { return fManuId; }
+  /// Return PCB Id
   Int_t PCBId() const { return fPCBId; }
   
   virtual void Print(Option_t* opt="") const;
@@ -66,13 +73,13 @@ private:
   TString StripCathode(const char* name) const;
   
 private:
-  Int_t fCathodeId; // Cathode number
-  Int_t fStationId; // Station id
-  Int_t fChamberId; // Chamber id
-  Int_t fDetElemId; // Detection element id
-  Int_t fBusPatchId; // Bus patch id
-  Int_t fManuId; // Manu id
-  Int_t fPCBId; // PCB id
+  Int_t fCathodeId; ///< Cathode number
+  Int_t fStationId; ///< Station id
+  Int_t fChamberId; ///< Chamber id
+  Int_t fDetElemId; ///< Detection element id
+  Int_t fBusPatchId;///< Bus patch id
+  Int_t fManuId;    ///< Manu id
+  Int_t fPCBId;     ///< PCB id
   
   ClassDef(AliMpUID,1) // UID of a tracker channel 
 };