ShuriZma
/
xemu
mirror of https://github.com/xemu-project/xemu.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

qom: update object_resolve_path*() documentation 

- update doc to reflect that @ambiguous is now set true or false on failure
- specify that @ambiguous is nullable
- use some gtk-doc annotations

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Link: https://lore.kernel.org/r/20241002080806.2868406-4-marcandre.lureau@redhat.com
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
This commit is contained in:
Marc-André Lureau 2024-10-02 12:08:06 +04:00 committed by Paolo Bonzini
parent d9e9867374
commit 7cca79fa52
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
include/qom/object.h
View File

@ -1569,8 +1569,8 @@ char *object_get_canonical_path(const Object *obj);
/** /**
* object_resolve_path: * object_resolve_path:
* @path: the path to resolve * @path: the path to resolve
* @ambiguous: returns true if the path resolution failed because of an * @ambiguous: (out) (optional): location to store whether the lookup failed
* ambiguous match * because it was ambiguous, or %NULL. Set to %false on success.
* *
* There are two types of supported paths--absolute paths and partial paths. * There are two types of supported paths--absolute paths and partial paths.
* *
@ -1587,7 +1587,7 @@ char *object_get_canonical_path(const Object *obj);
* only one match is found. If more than one match is found, a flag is * only one match is found. If more than one match is found, a flag is
* returned to indicate that the match was ambiguous. * returned to indicate that the match was ambiguous.
* *
* Returns: The matched object or NULL on path lookup failure. * Returns: The matched object or %NULL on path lookup failure.
*/ */
Object *object_resolve_path(const char *path, bool *ambiguous); Object *object_resolve_path(const char *path, bool *ambiguous);
@ -1595,10 +1595,10 @@ Object *object_resolve_path(const char *path, bool *ambiguous);
* object_resolve_path_type: * object_resolve_path_type:
* @path: the path to resolve * @path: the path to resolve
* @typename: the type to look for. * @typename: the type to look for.
* @ambiguous: returns true if the path resolution failed because of an * @ambiguous: (out) (optional): location to store whether the lookup failed
* ambiguous match * because it was ambiguous, or %NULL. Set to %false on success.
* *
* This is similar to object_resolve_path. However, when looking for a * This is similar to object_resolve_path(). However, when looking for a
* partial path only matches that implement the given type are considered. * partial path only matches that implement the given type are considered.
* This restricts the search and avoids spuriously flagging matches as * This restricts the search and avoids spuriously flagging matches as
* ambiguous. * ambiguous.