Index: trunk/SophyaLib/HiStats/ntuple.cc
===================================================================
--- trunk/SophyaLib/HiStats/ntuple.cc	(revision 1371)
+++ trunk/SophyaLib/HiStats/ntuple.cc	(revision 1405)
@@ -16,4 +16,24 @@
    Simple NTuple class (a Table or 2-D data set) with floating value
    columns. 
+   \sa SOPHYA::ObjFileIO<NTuple>
+
+   \code
+   #include "ntuple.h"
+   // ...
+   char * names[3] = {"XPos", "YPos", "Val"};
+   // NTuple (Table) creation with 3 columns
+   NTuple  nt(3, names);
+   // Filling the NTuple
+   r_4 x[3];
+   for(int i=0; i<63; i++) {
+     x[0] = (i%9)-4.;  x[1] = (i/9)-3.;  x[2] = x[0]*x[0]+x[1]*x[1];
+     nt.Fill(x);
+   }
+   // Printing table info
+   cout << nt ;
+   // Saving object into a PPF file
+   POutPersist po("nt.ppf");
+   po << nt ;
+   \endcode
 */
 
@@ -32,4 +52,5 @@
 
 /* --Methode-- */
+//! Default constructor
 //++
 NTuple::NTuple()
@@ -46,4 +67,11 @@
 
 
+//! Constructor with specification of number of columns and column name
+/*!
+  \param nvar : Number of columns in the table 
+  \param noms : Array of column names (length(name) < 8 characters) 
+  \param blk : Optional argument specifying number of table lines
+  in a given data block
+ */
 //++
 NTuple::NTuple(int nvar, char** noms, int blk)
@@ -77,4 +105,5 @@
 }
 
+//! Copy constructor - Copies the table definition and associated data 
 //                                       cmv 8/10/99
 //++
@@ -108,4 +137,5 @@
 
 /* --Methode-- */
+//! Constructor with table initialized from a PPF file
 //++
 NTuple::NTuple(char *flnm)
@@ -131,4 +161,5 @@
 
 /* --Methode-- */
+//! Clear the data table definition and deletes the associated data
 void NTuple::Clean()
 {
@@ -149,4 +180,5 @@
 
 /* --Methode--        cmv 08/10/99 */
+//! = operator, copies the data table definition and its contents
 //++
 NTuple& NTuple::operator = (const NTuple& NT)
@@ -181,4 +213,8 @@
 
 /* --Methode-- */
+//! Adds an entry (a line) to the table
+/*!
+  \param x : content of the line to be appended to the table
+ */
 //++
 void  NTuple::Fill(r_4* x)
@@ -317,4 +353,5 @@
 
 /* --Methode-- */
+//! Prints table definition and number of entries 
 //++
 void  NTuple::Show(ostream& os)  const
@@ -339,4 +376,9 @@
 
 /* --Methode-- */
+//! Fills the table, reading lines from an ascii file
+/*!
+  \param fn : file name
+  \param defval : default value for empty cells in the ascii file 
+ */
 //++
 int  NTuple::FillFromASCIIFile(string const& fn, float defval)
@@ -544,4 +586,9 @@
 }
 
+/*!
+   \class SOPHYA::ObjFileIO<NTuple>
+   \ingroup HiStats
+   Persistence (serialisation) handler for class NTuple
+*/
 
 /* --Methode-- */ 
Index: trunk/SophyaLib/HiStats/ntuple.h
===================================================================
--- trunk/SophyaLib/HiStats/ntuple.h	(revision 1371)
+++ trunk/SophyaLib/HiStats/ntuple.h	(revision 1405)
@@ -97,9 +97,12 @@
 };
 
+/*! Prints table information on stream \b s (nt.Show(os)) */
 inline ostream& operator << (ostream& s, NTuple const & nt)
   {  nt.Show(s);  return(s);  }
 
+/*! Writes the object in the POutPersist stream \b os */
 inline POutPersist& operator << (POutPersist& os, NTuple & obj)
 { ObjFileIO<NTuple> fio(&obj);  fio.Write(os);  return(os); }
+/*! Reads the object from the PInPersist stream \b is */
 inline PInPersist& operator >> (PInPersist& is, NTuple & obj)
 { ObjFileIO<NTuple> fio(&obj);  fio.Read(is);  return(is); }
Index: trunk/SophyaLib/HiStats/xntuple.cc
===================================================================
--- trunk/SophyaLib/HiStats/xntuple.cc	(revision 1371)
+++ trunk/SophyaLib/HiStats/xntuple.cc	(revision 1405)
@@ -20,4 +20,30 @@
    columns with int, float or string type content. In addition, this class
    can handle large data sets, using swap space on disk.
+   \sa SOPHYA::ObjFileIO<XNTuple>
+
+   \code
+   #include "xntuple.h"
+   // ...
+   char * names[4] = {"X", "X2", "XInt","XStr"};
+   // XNTuple (Table) creation with 4 columns, of integer, 
+   // double(2) and string type
+   XNTuple  xnt(2,0,1,1, names);
+   // Filling the NTuple
+   r_8 xd[2];
+   int_4 xi[2];
+   char xss[2][32];
+   char * xs[2] = {xss[0], xss[1]} ;
+   for(int i=0; i<50; i++) {
+     xi[0] = i;  xd[0] = i+0.5;  xd[1] = xd[0]*xd[0];
+     sprintf(xs[0],"X=%g", xd[0]);
+     xnt.Fill(xd, NULL, xi, xs);
+   }
+   // Printing table info
+   cout << xnt ;
+   // Saving object into a PPF file
+   POutPersist po("xnt.ppf");
+   po << xnt ;
+   \endcode
+   
 */
 
@@ -218,4 +244,16 @@
 //--
 
+//! Constructor with specification colum types and names
+/*!
+  \param ndvar : Number of columns with type double (r_8)
+  \param nfvar : Number of columns with type float (r_4)
+  \param nivar : Number of columns with type integer (int_4)
+  \param nsvar : Number of columns with type string
+  \param vnames : Column names (in the order r_8 r_4 int_4 string)
+  (colum names are limited to 31 characters)
+  \param blk : data block size (in number of table lines)
+  \param maxblk : Maximum number of data block in memory
+  \param strsz : string length (for string type columns)
+ */
 XNTuple::XNTuple(int ndvar, int nfvar, int nivar, int nsvar, 
 		   char** vnames, 
@@ -249,4 +287,5 @@
 
 
+//! Constructor with table initialized from a PPF file
 XNTuple::XNTuple(string const& flnm) 
     : mNEnt(0), mNBlk(0), mNSwBlk(0), 
@@ -268,4 +307,5 @@
 
 
+//! Copy constructor - Copies the table definition and associated data 
 XNTuple::XNTuple(XNTuple const& nt) 
     : mNEnt(0), mNBlk(0), mNSwBlk(0), 
@@ -294,4 +334,5 @@
 
 
+//! Clear the data table definition and deletes the associated data
 void XNTuple::clean()
 {
@@ -341,4 +382,11 @@
 //	Opérateur égal (=) , copie "nt" dans le premier NTuple
 //--
+//! Appends an entry (line) to the table
+/*!
+  \param d_data : double (r_8) line elements
+  \param f_data : float (r_4) line elements
+  \param i_data : integer (int_4) line elements
+  \param s_data : string line elements
+ */
 void XNTuple::Fill(r_8* d_data, r_4* f_data, int_4* i_data, char** s_data) 
 {
@@ -552,4 +600,5 @@
 //--
 
+//! Returns the associated DVList object
 DVList&  XNTuple::Info()
 {
@@ -597,4 +646,5 @@
 
 
+//! Prints table definition and number of entries 
 void   XNTuple::Show(ostream& os) const 
 {
@@ -636,4 +686,5 @@
 }
 
+//! NOT YET IMPLEMENTED ! - Fills table from an ascii file
 int    XNTuple::FillFromASCIIFile(string const& fn, r_8 ddval,  r_4 dfval,
                                         int dival, const char * dsval)
@@ -646,4 +697,5 @@
 
 
+//! Defines swap file path for XNTuple objects (Default=/tmp)
 void  XNTuple::SetSwapPath(char* p) 
 {
@@ -843,4 +895,9 @@
 }
 
+/*!
+   \class SOPHYA::ObjFileIO<XNTuple>
+   \ingroup HiStats
+   Persistence (serialisation) handler for class XNTuple
+*/
 
 void   ObjFileIO<XNTuple>::WriteSelf(POutPersist& ppout) const 
Index: trunk/SophyaLib/HiStats/xntuple.h
===================================================================
--- trunk/SophyaLib/HiStats/xntuple.h	(revision 1371)
+++ trunk/SophyaLib/HiStats/xntuple.h	(revision 1405)
@@ -159,10 +159,12 @@
 }; 
 
-
+/*! Prints table information on stream \b s (nt.Show(os)) */
 inline ostream& operator << (ostream& s, XNTuple const & nt)
   {  nt.Show(s);  return(s);  }
 
+/*! Writes the object in the POutPersist stream \b os */
 inline POutPersist& operator << (POutPersist& os, XNTuple & obj)
 { ObjFileIO<XNTuple> fio(&obj);  fio.Write(os);  return(os); }
+/*! Reads the object from the PInPersist stream \b is */
 inline PInPersist& operator >> (PInPersist& is, XNTuple & obj)
 { ObjFileIO<XNTuple> fio(&obj);  fio.Read(is);  return(is); }
