]> git.cworth.org Git - notmuch/commitdiff
doc/lib: clarify ownership for notmuch_database_get_revision
authorDavid Bremner <david@tethera.net>
Mon, 29 May 2023 11:01:40 +0000 (08:01 -0300)
committerDavid Bremner <david@tethera.net>
Sun, 9 Jul 2023 15:08:28 +0000 (12:08 -0300)
The ownership is implicit in the const declaration (I think!), but
that does not show up in the doxygen generated API docs.

lib/notmuch.h

index 7615617877504ff81e9b4dee005218ab7a8d023c..4e2b0fa48d3daf46dc75f51ded735a95424e9477 100644 (file)
@@ -722,7 +722,8 @@ notmuch_database_end_atomic (notmuch_database_t *notmuch);
  *
  * The UUID is a NUL-terminated opaque string that uniquely identifies
  * this database.  Two revision numbers are only comparable if they
- * have the same database UUID.
+ * have the same database UUID. The string 'uuid' is owned by notmuch
+ * and should not be freed or modified by the user.
  */
 unsigned long
 notmuch_database_get_revision (notmuch_database_t *notmuch,