doc FEATURE high level documentation including transition manual
diff --git a/src/set.h b/src/set.h
index 8db1b23..c3dbc2d 100644
--- a/src/set.h
+++ b/src/set.h
@@ -37,10 +37,10 @@
* added to the set and according to its knowledge about the set content, it can access objects via the members
* of the set union.
*
- * Until ly_set_rm() or ly_set_rm_index() is used, the set keeps the order of the inserted items as they
+ * Until ::ly_set_rm() or ::ly_set_rm_index() is used, the set keeps the order of the inserted items as they
* were added into the set, so the first added item is on array index 0.
*
- * To free the structure, use ly_set_free() function, to manipulate with the structure, use other
+ * To free the structure, use ::ly_set_free() function, to manipulate with the structure, use other
* ly_set_* functions.
*/
struct ly_set
@@ -57,7 +57,7 @@
/**
* @brief Create and initiate new ::ly_set structure.
*
- * @param[out] set Pointer to store the created ::ly_set structure.
+ * @param[out] set_p Pointer to store the created ::ly_set structure.
* @return LY_SUCCESS on success.
* @return LY_EINVAL in case of NULL @p set parameter.
* @return LY_EMEM in case of memory allocation failure.
@@ -71,7 +71,10 @@
* @param[in] duplicator Optional pointer to function that duplicates the objects stored
* in the original set. If not provided, the new set points to the exact same objects as
* the original set.
- * @return Duplication of the original set.
+ * @param[out] newset_p Pointer to return the duplication of the original set.
+ * @return LY_SUCCESS in case the data were successfully duplicated.
+ * @return LY_EMEM in case of memory allocation failure.
+ * @return LY_EINVAL in case of invalid parameters.
*/
LY_ERR ly_set_dup(const struct ly_set *set, void *(*duplicator)(void *obj), struct ly_set **newset_p);
@@ -161,7 +164,7 @@
void ly_set_free(struct ly_set *set, void (*destructor)(void *obj));
/**
- * @brief Alternative to the ly_set_free() for static ::ly_set objects - in contrast to ly_set_free()
+ * @brief Alternative to the ::ly_set_free() for static ::ly_set objects - in contrast to ::ly_set_free()
* it does not free the provided ::ly_set object.
*
* @param[in] set The set to be erased.