sstart fitting the docs

CXX/yapa.hh

@@ -1,9 +1,24 @@
+/// @{
+
 #ifndef YAPA_HH
 #define YAPA_HH 1
 
 /**
-   Prolog operates over constants, called atoms
-   YAP, like lisp, associates properties with atoms.
+ *
+ *   @defgroup yap-cplus-interface An object oriented interface for YAP.
+ *
+ *   @ingroup ChYInterface
+ *    @tableofcontents
+ *
+ *
+ * Prolog operates over constants, called atoms. YAP's stores most data as a list
+ * of properties for atoms. Properties include functors, data-base tecords, predicates. operators,
+ * and more.
+ *
+ *
+ */
+/**
+   Tne different tgaas area represented through PropTag.
 */
 enum PropTag {
   /// predicate
@@ -97,3 +112,5 @@ virtual ~YAPProp() {};
 
 #endif /* YAPA_HH */
                                                                                                               
+/// @}
+

CXX/yapdb.hh

@@ -14,8 +14,8 @@
  *    @tableofcontents
  *
  *
- * Data-base component of C++ interface to YAP. It manipulates sets of
- * atoms, each one containing a number of props.
+ * These classes define the main data-structures stored in the Data-base component: atoms, functors
+ * and predicates.
  */
 
 class YAPTerm;
@@ -329,3 +329,5 @@ public:
 };
 
 #endif
+
+/// @}

CXX/yapi.hh

@@ -13,7 +13,7 @@
  *
  *   @defgroup yap-cplus-interface An object oriented interface for YAP.
  *
- *   @ingroup ChYInterface
+ *   @ingroup yap-cplus-interface
  *    @tableofcontents
  *
  *

CXX/yapie.hh

@@ -1,3 +1,17 @@
+/**
+ *   @{
+ *
+ *   @defgroup yap-cplus-error-hanadlinge Errir Handling in the YAP interface.
+ *
+ *   @ingroup yap-cplus-interface
+ *    @tableofcontents
+ *
+ *
+ * These classes define an object that we can then throw when an error
+ * or unexoected event interrupts YAP. Often, the object is built by
+ * YAP itself, but we may generate our own errors.
+ */
+
 
 #ifndef YAPIE_HH
 #define YAPIE_HH
@@ -36,3 +50,5 @@ public:
 };
 
 #endif
+
+/// @}

CXX/yapq.hh

@@ -1,3 +1,16 @@
+/**
+ *   @{
+ ^
+ *   @defgroup yap-cplus-query-hanadlinge Query Handling in the YAP interface.
+ *
+ *   @ingroup yap-cplus-interface
+ *    @tableofcontents
+ *
+ *
+ * These classes define the concepts of engine ana of query.Ann engine is an environment where we can rum 
+ * Prolog, that is, where we can run queries.
+ */
+
 #ifndef YAPQ_HH
 #define YAPQ_HH 1
 
@@ -217,3 +230,7 @@ public:
 };
 
 #endif /* YAPQ_HH */
+
+/// @}
+
+

CXX/yapt.hh

@@ -1,3 +1,17 @@
+/**
+ * @{
+ *   @defgroup yap-cplus-term-handling Term Handling in the YAP interface.
+ *
+ *   @ingroup yap-cplus-interface
+ *    @tableofcontents
+ *
+ *
+ * These classes define a term objectthat can be refined, Currently, all exported terms have an
+ * handle, in the SWI-Prolog style.
+ *
+ * Nottce that terms  are forcefully destroyed during backtracking.
+ */
+
 
 #ifndef YAPT_HH
 #define YAPT_HH 1
@@ -445,3 +459,5 @@ public:
   const char *text() { return (const char *)AtomOfTerm(gt())->StrOfAE; }
 };
 #endif /* YAPT_HH */
+
+/// @}