data tree NEW position list instance addressing and creation
diff --git a/src/libyang.h.in b/src/libyang.h.in
index 2b47011..0ee6563 100644
--- a/src/libyang.h.in
+++ b/src/libyang.h.in
@@ -700,13 +700,15 @@
*
*
* A very small subset of this full XPath is recognized by lyd_new_path(). Basically, only a relative or absolute
- * path can be specified to identify a new data node. However, lists must be identified by all their keys and created
- * with all of them, so for those cases predicates are allowed. Predicates must be ordered the way the keys are ordered
- * and all the keys must be specified. Every predicate includes a single key with its value. Optionally, leaves and
- * leaf-lists can have predicates specifying their value in the path itself. All these paths are valid XPath
- * expressions. Example:
+ * path can be specified to identify a new data node. However, lists must be identified by either all their keys and created
+ * with all of them or using their relative position on their level starting from 1, so for those cases predicates are
+ * allowed. Key predicates must be ordered the way the keys are ordered and all the keys must be specified. Every
+ * predicate includes a single key with its value. If an instance with such particular set of keys or with such relative
+ * position does not exist or no predicate is specified, list instance is created. Optionally, leaves and leaf-lists can
+ * have predicates specifying their value in the path itself. All these paths are valid XPath expressions. Example:
*
* /ietf-yang-library:modules-state/module[name='ietf-yang-library'][revision='']/conformance[.='implement']
+ * /ietf-yang-library:modules-state/module[1]/conformance[.='implement']
*
* Almost the same XPath is accepted by ly_ctx_get_node(). The difference is that it is not used on data, but schema,
* which means there are no key values and only one node matches one path. In effect, lists do not have to have any