From 07865aab13e71e521a4ecd202b12437dc7a6b81c Mon Sep 17 00:00:00 2001
From: Rene Brun <Rene.Brun@cern.ch>
Date: Mon, 17 Dec 2007 14:15:59 +0000
Subject: [PATCH] From Valeri Fine: - Added missing class header docs.

git-svn-id: http://root.cern.ch/svn/root/trunk@21414 27541ba8-7e3a-0410-8455-c3a389f83636
---
 table/inc/TColumnView.h        | 12 ++++--------
 table/inc/TTableDescriptor.h   |  5 +++++
 table/inc/tableDescriptor.h    |  8 ++++++++
 table/src/TColumnView.cxx      | 16 +++++++---------
 table/src/TPoints3D.cxx        |  4 ++--
 table/src/TPointsArray3D.cxx   |  4 ++--
 table/src/TResponseTable.cxx   |  5 +++++
 table/src/TTableDescriptor.cxx |  5 +++++
 8 files changed, 38 insertions(+), 21 deletions(-)

diff --git a/table/inc/TColumnView.h b/table/inc/TColumnView.h
index de23431f3a7..6beadbf497f 100644
--- a/table/inc/TColumnView.h
+++ b/table/inc/TColumnView.h
@@ -12,16 +12,12 @@
 #ifndef ROOT_TColumnView
 #define ROOT_TColumnView
  
-//////////////////////////////////////////////////////////////////////////
-//                                                                      //
-//  TColumnView                                                         //
-//                                                                      //
-//  It is a helper class to present one column of the TTable object     //
-//                                                                      //
-//////////////////////////////////////////////////////////////////////////
- 
 #include "TChair.h"
  
+//______________________________________________________________________________
+//
+//  TColumnView - helper class to browse the TTable objects via ROOT TBrowser
+//______________________________________________________________________________
 class TColumnView : public TChair {
 
 public:
diff --git a/table/inc/TTableDescriptor.h b/table/inc/TTableDescriptor.h
index 93f33fc296b..4e1c71b0e0c 100644
--- a/table/inc/TTableDescriptor.h
+++ b/table/inc/TTableDescriptor.h
@@ -16,6 +16,11 @@
 #include "tableDescriptor.h"
 
 class TClass;
+//______________________________________________________________________________
+//
+// TTableDescriptor - run-time descriptor of the TTable object rows.
+//______________________________________________________________________________
+
 
 class TTableDescriptor : public TTable {
 protected:
diff --git a/table/inc/tableDescriptor.h b/table/inc/tableDescriptor.h
index 11aec7b3341..ea3ab7155c5 100644
--- a/table/inc/tableDescriptor.h
+++ b/table/inc/tableDescriptor.h
@@ -48,6 +48,14 @@
  *  To lift this restriction one has to provide -DNORESTRICTIONS CPP symbol and
  *  recompile code.
  */
+//______________________________________________________________________________
+//
+// Table descriptor tableDescriptor_st is internal descriptor of TTableDescriptor class 
+//
+// One should not use it directly. 
+// To access the TTable descriptor information use TTableDescriptor object instead
+//______________________________________________________________________________
+
 typedef struct tableDescriptor_st {
 #ifdef NORESTRICTIONS
     char         *fColumnName; /* The name of this data-member                                         */
diff --git a/table/src/TColumnView.cxx b/table/src/TColumnView.cxx
index da0a7d1d216..ad5cc1cb263 100644
--- a/table/src/TColumnView.cxx
+++ b/table/src/TColumnView.cxx
@@ -8,17 +8,15 @@
  * For the licensing terms see $ROOTSYS/LICENSE.                         *
  * For the list of contributors see $ROOTSYS/README/CREDITS.             *
  *************************************************************************/
-//////////////////////////////////////////////////////////////////////////
-//                                                                      //
-//  TColumnView                                                         //
-//                                                                      //
-//  It is a helper class to present TTable object view TBrowser         //
-//                                                                      //
-//////////////////////////////////////////////////////////////////////////
- 
+
 #include "TColumnView.h"
 #include "TVirtualPad.h"
-
+//______________________________________________________________________________
+//
+//  TColumnView
+//
+//  It is a helper class to present TTable object view TBrowser
+//______________________________________________________________________________
 ClassImp(TColumnView)
 
 //______________________________________________________________________________
diff --git a/table/src/TPoints3D.cxx b/table/src/TPoints3D.cxx
index ee467806b7d..5181a5edb6d 100644
--- a/table/src/TPoints3D.cxx
+++ b/table/src/TPoints3D.cxx
@@ -16,9 +16,8 @@
 #include "TPoints3D.h"
 #include "TPointsArray3D.h"
 
-ClassImp(TPoints3D)
-
 //______________________________________________________________________________
+//
 // TPoints3D is an abstract class of the array of 3-dimensional points.
 // It has 4 different constructors.
 //
@@ -54,6 +53,7 @@ ClassImp(TPoints3D)
 //                 TPoints3D pl1(150, xArray, yArray, zArray);
 //
 
+ClassImp(TPoints3D)
 
 //______________________________________________________________________________
 TPoints3D::TPoints3D(TPoints3DABC *points) : fPoints(points)
diff --git a/table/src/TPointsArray3D.cxx b/table/src/TPointsArray3D.cxx
index deeca12ebc5..88fe4837396 100644
--- a/table/src/TPointsArray3D.cxx
+++ b/table/src/TPointsArray3D.cxx
@@ -18,9 +18,8 @@
 #include "TROOT.h"
 #include "TMath.h"
 
-ClassImp(TPointsArray3D)
-
 //______________________________________________________________________________
+//
 // TPointsArray3D is an abstract class of the array of 3-dimensional points.
 // It has 4 different constructors.
 //
@@ -56,6 +55,7 @@ ClassImp(TPointsArray3D)
 //                 TPointsArray3D pl1(150, xArray, yArray, zArray);
 //
 
+ClassImp(TPointsArray3D)
 
 //______________________________________________________________________________
 TPointsArray3D::TPointsArray3D()
diff --git a/table/src/TResponseTable.cxx b/table/src/TResponseTable.cxx
index d10bb66ae55..c7cbe963c23 100644
--- a/table/src/TResponseTable.cxx
+++ b/table/src/TResponseTable.cxx
@@ -12,6 +12,11 @@
 
 #include "TResponseTable.h"
 
+//______________________________________________________________________________
+//
+// TResponseTable is an example of the custom version of the TGenericTable class
+//______________________________________________________________________________
+
 ClassImp(TResponseTable)
 TableClassStreamerImp(TResponseTable)
 
diff --git a/table/src/TTableDescriptor.cxx b/table/src/TTableDescriptor.cxx
index d1c54a9047e..555b32d7524 100644
--- a/table/src/TTableDescriptor.cxx
+++ b/table/src/TTableDescriptor.cxx
@@ -19,6 +19,11 @@
 #include "Ttypes.h"
 #include "TInterpreter.h"
 
+//______________________________________________________________________________
+//
+// TTableDescriptor - run-time descriptor of the TTable object rows.
+//______________________________________________________________________________
+
 TTableDescriptor *TTableDescriptor::fgColDescriptors = 0;
 // TString TTableDescriptor::fgCommentsName = TTableDescriptor::SetCommentsSetName();
 TString TTableDescriptor::fgCommentsName = ".comments";
-- 
GitLab