diff --git a/src/multibody/geometry.hpp b/src/multibody/geometry.hpp
index 42c29d5996809993a5b4ff47c0fcbde54b3216f7..1726423b10acde1de67788a2eb047c5f2605be81 100644
--- a/src/multibody/geometry.hpp
+++ b/src/multibody/geometry.hpp
@@ -276,7 +276,22 @@ namespace se3
 
     ~GeometryData() {};
 #ifdef WITH_HPP_FCL
+
+    /// Activate a collision pair, for which collisions and distances would now be computed.
+    ///
+    /// A collision (resp distance) between to geometries of GeomModel::geometryObjects
+    /// is computed *iff* the corresponding pair has been added in GeomModel::collisionPairs *AND*
+    /// it is active, i.e. the corresponding boolean in GeomData::activePairs is true. The second
+    /// condition can be used to temporarily remove a pair without touching the model, in a versatile
+    /// manner. 
+    /// \param[in] pairId the index of the pair in GeomModel::collisionPairs vector.
+    /// \param[in] new value of the activation boolean (true by default).
     void activateCollisionPair(const Index pairId,const bool flag=true);
+
+    /// Deactivate a collision pair.
+    ///
+    /// Calls indeed GeomData::activateCollisionPair(pairId,false)
+    /// \sa activateCollisionPair
     void deactivateCollisionPair(const Index pairId);
 
     ///