doc: bt_field_class...get_mapping_labels...(): clarify RV's validity

[babeltrace.git] / include / babeltrace2 / trace-ir / field-class.h

diff --git a/include/babeltrace2/trace-ir/field-class.h b/include/babeltrace2/trace-ir/field-class.h
index 0aab9682e0383d637775763fd3e65153153010b1..1f907b7ff9f22640d068709eb04f6598953064f1 100644 (file)
--- a/include/babeltrace2/trace-ir/field-class.h
+++ b/include/babeltrace2/trace-ir/field-class.h
@@ -2320,7 +2320,10 @@ On success, if there's no mapping ranges containing the value
     The number of labels in \bt_p{*labels} is \bt_p{*count}.
 
     The array is owned by \bt_p{field_class} and remains valid as long
-    as \bt_p{field_class} is not modified.
+    as:
+
+    - \bt_p{field_class} is not modified.
+    - You don't call this function again with \bt_p{field_class}.
     @endparblock
 @param[out] count
     <strong>On success</strong>, \bt_p{*count} is the number of labels
@@ -2582,7 +2585,10 @@ On success, if there's no mapping ranges containing the value
     The number of labels in \bt_p{*labels} is \bt_p{*count}.
 
     The array is owned by \bt_p{field_class} and remains valid as long
-    as \bt_p{field_class} is not modified.
+    as:
+
+    - \bt_p{field_class} is not modified.
+    - You don't call this function again with \bt_p{field_class}.
     @endparblock
 @param[out] count
     <strong>On success</strong>, \bt_p{*count} is the number of labels