diff --git a/src/tree_data.h b/src/tree_data.h
index 098ec5f..c90add1 100644
--- a/src/tree_data.h
+++ b/src/tree_data.h
@@ -1574,7 +1574,7 @@
  * The diff tree is completely independent on the @p first and @p second trees, meaning all
  * the information about the change is stored in the diff and the trees are not needed.
  *
- * !! Caution !!
+ * __!! Caution !!__
  * The diff tree should never be validated because it may easily not be valid! For example,
  * when data from one case branch are deleted and data from another branch created - data from both
  * branches are then stored in the diff tree simultaneously.
@@ -1591,6 +1591,8 @@
 /**
  * @brief Learn the differences between 2 data trees including all the following siblings.
  *
+ * Details are mentioned in ::lyd_diff_tree().
+ *
  * @param[in] first First data tree.
  * @param[in] second Second data tree.
  * @param[in] options Bitmask of options flags, see @ref diffoptions.
@@ -1627,6 +1629,8 @@
 /**
  * @brief Apply the whole diff tree on a data tree.
  *
+ * Details are mentioned in ::lyd_diff_apply_module().
+ *
  * @param[in,out] data Data to apply the diff on.
  * @param[in] diff Diff to apply.
  * @return LY_SUCCESS on success,
@@ -1647,7 +1651,7 @@
 
 #define LYD_DIFF_MERGE_DEFAULTS   0x01 /**< Default nodes in the diffs are treated as possibly explicitly modified. */
 
-/** @} diffoptions */
+/** @} diffmergeoptions */
 
 /**
  * @brief Merge 2 diffs into each other but restrict the operation to one module.
@@ -1655,12 +1659,12 @@
  * The diffs must be possible to be merged, which is guaranteed only if the source diff was
  * created on data that had the target diff applied on them. In other words, this sequence is legal
  *
- * 1) diff1 from data1 and data2 -> data11 from apply diff1 on data1 -> diff2 from data11 and data3 ->
- *    -> data 33 from apply diff2 on data1
+ * 1) get diff1 from data1 and data2 -> get data11 from apply diff1 on data1 -> get diff2 from data11 and data3 ->
+ *    -> get data 33 from apply diff2 on data1
  *
  * and reusing these diffs
  *
- * 2) diff11 from merge diff1 and diff2 -> data33 from apply diff11 on data1
+ * 2) get diff11 from merge diff1 and diff2 -> get data33 from apply diff11 on data1
  *
  * @param[in,out] diff Target diff to merge into.
  * @param[in] src_diff Source diff.
@@ -1679,6 +1683,8 @@
 /**
  * @brief Merge 2 diff trees into each other.
  *
+ * Details are mentioned in ::lyd_diff_merge_module().
+ *
  * @param[in,out] diff_first Target diff first sibling to merge into.
  * @param[in] diff_parent Target diff parent to merge into.
  * @param[in] src_sibling Source diff sibling to merge.
@@ -1696,6 +1702,8 @@
 /**
  * @brief Merge 2 diffs into each other.
  *
+ * Details are mentioned in ::lyd_diff_merge_module().
+ *
  * @param[in,out] diff Target diff to merge into.
  * @param[in] src_diff Source diff.
  * @param[in] options Bitmask of options flags, see @ref diffmergeoptions.