Modifiche alla documentazione

git-svn-id: svn://10.65.10.50/trunk@3510 c028cbd2-c16b-5b4b-a496-9718f37d4682

include/array.h

@@ -39,21 +39,21 @@ class TContainer : public TObject
   
 // @access:(INTERNAL) Private Member
 private:
-  // @cmember:(INTERNAL) Ultima condizione di ricerca/firltro (vedi <t CONDITION_FUNCTION>)
+  // @cmember:(INTERNAL) Ultima condizione di ricerca/filtro (vedi <t CONDITION_FUNCTION>)
   CONDITION_FUNCTION _last_condition;    
   
   // @access Public Member
 public:
   
-  // @cmember Ritorna l'indice del primo oggetto
+  // @cmember Ritorna un puntatore al primo oggetto del contenitore
   virtual TObject* first_item( ) pure;
-  // @cmember Ritorna l'indice dell'ultimo oggetto
+  // @cmember Ritorna un puntatore all'ultimo oggetto del contenitore
   virtual TObject* last_item( ) pure;
-  // @cmember Ritorna l'indice del primo oggetto dopo i
+  // @cmember Ritorna un puntatore all'oggetto successivo all'oggetto corrente
   virtual TObject* succ_item( ) pure;
-  // @cmember Ritorna l'indice del primo oggetto che precede i
+  // @cmember Ritorna un puntatore all'oggetto che precede l'oggetto corrente
   virtual TObject* pred_item( ) pure;
-  // @cmember Ritorna numero di oggetti nel container
+  // @cmember Ritorna il numero di oggetti nel contenitore
   virtual long objects( ) pure;
   
   // @cmember Cerca il successivo elemento che soddisfa la <t OPERATION_FUNCTION>
@@ -72,10 +72,10 @@ public:
   virtual TObject* pred_that( );
   // @cmember Ritorna il numero di elementi che soddisfano la condizione
   virtual long count( CONDITION_FUNCTION = NULL );
-  // @cmember Operatore di incremento di un elemento
+  // @cmember Ritorna l'oggetto successivo a quello corrente
   TObject* operator++ ()
   { return succ_item( ); };
-  // @cmember Operatore di dencremento di un elemento
+  // @cmember Ritorna l'oggetto che precede quello corrente
   TObject* operator-- ()
   { return pred_item( ); };
   
@@ -147,23 +147,23 @@ public:
   virtual TObject* first_item( );
   // @cmember Ritorna l'ultimo elemento dell'array
   virtual TObject* last_item( );
-  // @cmember Ritorna il successivo elemento dell'array
+  // @cmember Ritorna il successivo elemento dell'array rispetto all'elemento corrente
   virtual TObject* succ_item( );
-  // @cmember Ritorna il precedente elemento dell'array
+  // @cmember Ritorna il precedente elemento dell'array rispetto all'elemento corrente
   virtual TObject* pred_item( );
   
   // @cmember Ritorna l'indice del primo oggetto
   int first() const;
   // @cmember Ritorna l'indice dell'ultimo oggetto
   int last() const;
-  // @cmember Ritorna l'indice del primo oggetto dopo i
+  // @cmember Ritorna l'indice del primo oggetto dopo l'i-esimo
   int succ(int i) const;
-  // @cmember Ritorna l'indice del primo oggetto che precede i
+  // @cmember Ritorna l'indice del primo oggetto che precede l'i-esimo
   int pred(int i) const;
   
-  // @cmember Ritorna l'oggetto puntato da index
+  // @cmember Ritorna l'oggetto nella posizione index
   TObject& operator[] (int index) const ;
-  // @cmember Ritorna l'oggetto di posto index
+  // @cmember Ritorna l'oggetto nella posizione index
   TObject* objptr(int index) const ;
   // @cmember Assegna all'array l'oggetto passato
   TArray& operator= (const TArray& a);

include/assoc.cpp

@@ -9,7 +9,7 @@
 //        nuovo oggetto.
 THash_object* TAssoc_array::_lookup(
   const char* k,  // @parm Chiave da cercare
-  bool& isnew,    // @parm Viene asseganto TRUE se si tratta di una nuova chiave
+  bool& isnew,    // @parm Viene assegnato TRUE se si tratta di una nuova chiave
   bool insert)    // @parm Permette di inserire la chiave
 
   // @comm Ricerca all'interno della tabella hash l'oggetto con la chiave <p k>,

include/assoc.h

@@ -85,13 +85,13 @@ public:
   int items() const
   { return _cnt; }
   
-  // @cmember Ritorna l'indice del primo oggetto
+  // @cmember Ritorna un puntatore al primo oggetto
   virtual TObject* first_item( );
-  // @cmember Ritorna l'indice dell'ultimo oggetto
+  // @cmember Ritorna un puntatore all'ultimo oggetto
   virtual TObject* last_item( );
-  // @cmember Ritorna l'indice del primo oggetto dopo i
+  // @cmember Ritorna un puntatore all'oggetto successivo al quello corrente
   virtual TObject* succ_item( );
-  // @cmember Ritorna l'indice del primo oggetto che precede i
+  // @cmember Ritorna unpuntatore all'oggetto oggetto che precede quello corrente
   virtual TObject* pred_item( );
   // @cmember Ritorna il numero di elementi presenti come long  
   long objects( )

include/expr.h

@@ -231,7 +231,8 @@ public:
   void backtrace(int step = 1)
   { if (_ip > step) _ip -= step; else begin(); }
   // @cmember Costruttore. Crea un array di 50 elementi
-  TCodearray(int size = 50) : TArray(size), _ip(0) {}
+  TCodearray(int size = 50) : TArray(size), _ip(0) 
+  {}
   // @cmember Distruttore
   virtual ~TCodearray()
   {}

include/relation.cpp

@@ -1849,10 +1849,10 @@ bool TRecord_array::exist(int n) const
 
 // @doc EXTERNAL
 
-// @mfunc Ritorna la riga <p r>
+// @mfunc Ritorna la riga <p r>-esima; se tale riga non esiste e se <p create> assume il valore TRUE la riga viene creata
 //
 // @rdesc Ritorna un TRectype alla riga cercata o eventualemete il reference della nuova creata,
-//    NULL nes caso non esista e non venga creata.
+//    NULL nel caso non esista e non venga creata.
 TRectype& TRecord_array::row(
           int n,  // @parm Numero della riga da creare
           bool create)  // @parm Indica se creare una nuova riga se non esiste:
@@ -1860,7 +1860,7 @@ TRectype& TRecord_array::row(
       // @flag TRUE | Se la riga <p n> non esiste viene creata
       // @flag FALSE | Se la riga <p n> non esiste non viene creata
 
-// @comm Nel caso <p create> si TRUE e venga richiesta una riga non esistente si crea un nuovo
+// @comm Nel caso <p create> sia TRUE e venga richiesta una riga non esistente si crea un nuovo
 //   record copiando la chiave.
 {                    
   const int i = n >= 0 ? n - _offset : -1;

include/relation.h

@@ -251,10 +251,10 @@ public:
   int rows() const 
   { return items()-1; }
   
-  // @cmember Ritorna la riga successiva non vuota a prtire da <p r>
+  // @cmember Ritorna la riga successiva non vuota a partire da <p r>
   int succ_row(int r) const 
   { return succ(r - _offset) + _offset; }
-  // @cmember Ritorna la riga precedente non vuota a prtire da <p r>
+  // @cmember Ritorna la riga precedente non vuota a partire da <p r>
   int pred_row(int r) const 
   { return pred(r - _offset) + _offset; };
   // @cmember Ritorna l'ultma riga non vuota
@@ -270,12 +270,12 @@ public:
   
   // @cmember Controlla se esiste la riga <p r> (TRUE se esiste)
   bool exist(int r) const;
-  // @cmember Ritorna la riga <p r>
+  // @cmember Ritorna la riga <p r>-esima; se tale riga non esiste e se <p create> assume il valore TRUE la riga viene creata 
   TRectype& row(int r, bool create);
  
-  // @cmember Inserisce una riga alla posizione indicata nel record, sposta gli altri elementi se la poszione era gia' occupata
+  // @cmember Inserisce una riga alla posizione indicata nel record, sposta gli altri elementi se la posizione era gia' occupata
   virtual int insert_row(TRectype* r);
-  // @cmember Inserisce una riga alla posizione indicata nel record, sposta gli altri elementi se la poszione era gia' occupata
+  // @cmember Inserisce una riga alla posizione indicata nel record, sposta gli altri elementi se la posizione era gia' occupata
   int insert_row(const TRectype& r) 
   { return insert_row((TRectype*)r.dup()); }
 
@@ -359,7 +359,7 @@ class TCursor : public TContainer
   TFilename _filename;
   // @cmember:(INTERNAL) Filtro definito con la <mf TCursor::set_filter>
   TString _filter;
-  // @cmember:(INTERNAL) Nome della chive iniziale
+  // @cmember:(INTERNAL) Nome della chiave iniziale
   TString _keyfrom;
   // @cmember:(INTERNAL) Nome della chiave finale
   TString _keyto;
@@ -420,7 +420,7 @@ public:
   // @cmember Ritorna l'ultimo oggetto del cursor
   TObject* last_item( )
   { operator =( items( ) -1 );  return &curr( ); }
-  // @cmember Ritorna il n8umero di oggetti del cursor
+  // @cmember Ritorna il numero di oggetti del cursor
   long objects( ) 
   { return items( ); }
   

include/strings.cpp

@@ -65,13 +65,13 @@ inline bool is_space(char c)
 // Certified 99%
 // @doc EXTERNAL
 //
-// @mfunc Rialloca la stringa
+// @mfunc Cambia la dimensione della stringa eventualmente preservandone il contenuto iniziale
 void TString::resize(
   int size,  // @parm Nuova dimensione della stringa
   bool cpy)  // @parm Se TRUE mantiene il contenuto della stringa e alloca
   //       nuovo spazio
 
-  // @comm Non funzione con le stringhe static e per valori negativi di <p size>
+  // @comm Non funziona con le stringhe static e per valori negativi di <p size>
 {
   char* s = new char[size+1];
   if (cpy && _str) strcpy(s, _str);

include/strings.h

@@ -40,7 +40,7 @@ protected:
 
   // @access Public member
 public:
-  // @cmember Rialloca la stringa
+  // @cmember Cambia la dimensione della stringa eventualmente preservandone il contenuto iniziale
   virtual void resize(int size, bool cpy);
 
   // @cmember Costruttore