[Bf-blender-cvs] [9000ec30133] blender-v2.83-release: Cleanup: clarify and update some flags descriptions in libquery code.

[Bastien Montagne]

Commit: 9000ec301337178595ee3230775bd00b1746c06e
Author: Bastien Montagne
Date:   Wed Apr 22 15:58:55 2020 +0200
Branches: blender-v2.83-release
https://developer.blender.org/rB9000ec301337178595ee3230775bd00b1746c06e

Cleanup: clarify and update some flags descriptions in libquery code.

===================================================================

M	source/blender/blenkernel/BKE_lib_query.h

===================================================================

diff --git a/source/blender/blenkernel/BKE_lib_query.h b/source/blender/blenkernel/BKE_lib_query.h
index f3e15529f77..3aa27bf557c 100644
--- a/source/blender/blenkernel/BKE_lib_query.h
+++ b/source/blender/blenkernel/BKE_lib_query.h
@@ -71,11 +71,15 @@ enum {
   IDWALK_CB_OVERRIDE_LIBRARY_REFERENCE = (1 << 5),
 
   /**
-   * Adjusts #ID.us reference-count.
-   * \note keep in sync with 'newlibadr_us' use in readfile.c
+   * This ID usage is fully refcounted.
+   * Callback is responsible to deal accordingly with #ID.us if needed.
    */
   IDWALK_CB_USER = (1 << 8),
-  /** Ensure #ID.us is at least 1 on use. */
+  /**
+   * This ID usage is not refcounted, but at least one user should be generated by it (to avoid
+   * e.g. loosing the used ID on save/reload).
+   * Callback is responsible to deal accordingly with #ID.us if needed.
+   */
   IDWALK_CB_USER_ONE = (1 << 9),
 };