- * Given a point given by its position 'pos' this method finds the set of node ids that are a a distance lower than eps.
- * Position 'pos' is expected to be of size getSpaceDimension()*nbOfNodes. If not the behabiour is not warranted.
- * This method throws an exception if no coordiantes are set.
+ * Finds nodes located at distances lower that \a eps from given points.
+ * \param [in] pos - pointer to coordinates of the points. This array is expected to
+ * be of length \a nbOfPoints * \a this->getSpaceDimension() at least, else the
+ * behavior is not warranted.
+ * \param [in] nbOfPoints - number of points whose coordinates are given by \a pos
+ * parameter.
+ * \param [in] eps - the lowest distance between (using infinite norm) a point and a node at which the node is
+ * not returned by this method.
+ * \param [out] c - array returning ids of nodes located closer than \a eps to the
+ * given points. The caller
+ * is to delete this array using decrRef() as it is no more needed.
+ * \param [out] cI - for each i-th given point, the array specifies tuples of \a c
+ * holding ids of nodes close to the i-th point. <br>The i-th value of \a cI is an
+ * index of tuple of \a c holding id of a first (if any) node close to the
+ * i-th given point. Difference between the i-th and (i+1)-th value of \a cI
+ * (i.e. \a cI[ i+1 ] - \a cI[ i ]) defines number of nodes close to the i-th
+ * point (that can be zero!). For example, the group of nodes close to the
+ * second point is described by following range of indices [ \a cI[1], \a cI[2] ).
+ * The caller is to delete this array using decrRef() as it is no more needed.
+ * \throw If the coordinates array is not set.
+ *
+ * \ref cpp_mcpointset_getnodeidsnearpoints "Here is a C++ example".<br>
+ * \ref py_mcpointset_getnodeidsnearpoints "Here is a Python example".