added some documentation

src/pe/ccd/ICCD.h

@@ -33,12 +33,14 @@ namespace ccd {
 
 class ICCD : private NonCopyable {
 public:
-   virtual ~ICCD() {};
+   virtual ~ICCD() {}
 
+   /// Generates a list of possible contact pairs.
+   /// This list is also stored in the member variable contacts_ for reuse lateron.
    virtual PossibleContacts& generatePossibleContacts( WcTimingTree* tt = NULL ) = 0;
    PossibleContacts& getPossibleContacts() {return contacts_;}
 
-   virtual void reloadBodies() {};
+   virtual void reloadBodies() {}
    virtual int  getObservedBodyCount() const = 0;
 protected:
    PossibleContacts contacts_;

src/pe/fcd/IFCD.h

@@ -37,7 +37,18 @@ class IFCD : private NonCopyable{
 public:
    virtual ~IFCD() {};
 
+   ///
+   /// \brief generates a list of actual collisions
+   ///
+   /// Takes a list of possible contacts (pair of BodyIDs) and checks them
+   /// for actual collision. All generated contacts are stored in the member variable
+   /// contacts_ for later reuse.
+   /// Returns a list containing all contact points detected.
+   /// \param possibleContacts list of possible contacts generated by coarse collision detection
+   /// \return list of actual contacts
+   ///
    virtual Contacts& generateContacts(PossibleContacts& possibleContacts) = 0;
+   /// returns saved list of contacts
    Contacts& getContacts() {return contacts_;}
 protected:
    Contacts contacts_;