diff --git a/openfpm_devices b/openfpm_devices
index 4a065a934f1f6620385edfa717d93b90a8cedf02..5867ee86d4b3c47efa3fb40c04d262396d895bec 160000
--- a/openfpm_devices
+++ b/openfpm_devices
@@ -1 +1 @@
-Subproject commit 4a065a934f1f6620385edfa717d93b90a8cedf02
+Subproject commit 5867ee86d4b3c47efa3fb40c04d262396d895bec
diff --git a/openfpm_numerics b/openfpm_numerics
index 4192ec42c28ddfb106291ead7d9c471883da83d9..c5aac757e46c64ce8c4d6335755422c478e8cbb2 160000
--- a/openfpm_numerics
+++ b/openfpm_numerics
@@ -1 +1 @@
-Subproject commit 4192ec42c28ddfb106291ead7d9c471883da83d9
+Subproject commit c5aac757e46c64ce8c4d6335755422c478e8cbb2
diff --git a/src/Vector/vector_dist.hpp b/src/Vector/vector_dist.hpp
index d04cfec18fa2ea0e9922607ac7832a1c0f5e84e5..2623fa9c171880302a84e4de6fb4c7e9516fc538 100644
--- a/src/Vector/vector_dist.hpp
+++ b/src/Vector/vector_dist.hpp
@@ -1237,6 +1237,14 @@ public:
 		return dec;
 	}
 
+	/*! \brief Remove a set of elements from the distributed vector
+	 *
+	 * \warning keys must be sorted
+	 *
+	 * \param keys vector of elements to eliminate
+	 * \param start from where to eliminate
+	 *
+	 */
 	void remove(openfpm::vector<size_t> & keys, size_t start = 0)
 	{
 		v_pos.remove(keys, start);
@@ -1245,6 +1253,14 @@ public:
 		g_m -= keys.size();
 	}
 
+	/*! \brief Remove one element from the distributed vector
+	 *
+	 * \warning keys must be sorted
+	 *
+	 * \param keys vector of elements to eliminate
+	 * \param start from where to eliminate
+	 *
+	 */
 	void remove(size_t key)
 	{
 		v_pos.remove(key);