* src/tgba/bddfactory.hh, src/tgba/statebdd.hh,

src/tgba/succiterconcrete.hh, src/tgba/tgbabddconcrete.hh,
src/tgba/tgbabddcoredata.hh, src/tgba/tgbabdddict.hh: Add
Doxygen comments.

src/tgba/succiterconcrete.hh

@@ -7,9 +7,18 @@
 
 namespace spot
 {
+  /// A concrete iterator over successors of a TGBA state.
   class tgba_succ_iterator_concrete: public tgba_succ_iterator
   {
   public:
+    /// \brief Build a spot::tgba_succ_iterator_concrete.
+    /// 
+    /// \param successors The set of successors with ingoing conditions
+    /// and promises, represented as a BDD.  The job of this iterator
+    /// will be to enumerate the satisfactions of that BDD and split
+    /// them into destination state, conditions, and promises.
+    /// \param d The core data of the automata.  These contains
+    /// sets of variables useful to split a BDD.
     tgba_succ_iterator_concrete(const tgba_bdd_core_data& d, bdd successors);
     virtual ~tgba_succ_iterator_concrete();
 
@@ -24,10 +33,10 @@ namespace spot
     bdd current_promise();
 
   private:
-    const tgba_bdd_core_data& data_;
-    bdd succ_set_;		// The set of successors.
-    bdd next_succ_set_;		// Unexplored successors (including current_).
-    bdd current_;		// Current successor.
+    const tgba_bdd_core_data& data_; ///< Core data of the automata.
+    bdd succ_set_;	///< The set of successors.
+    bdd next_succ_set_;	///< Unexplored successors (including current_).
+    bdd current_;	///< Current successor.
   };
 }