summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPhilip Withnall <withnall@endlessm.com>2017-10-23 15:59:31 +0100
committerAtomic Bot <atomic-devel@projectatomic.io>2017-10-23 16:17:20 +0000
commit4c0f67be0cf0ad28c99bfdef0641af98a2a02d5e (patch)
treea99b5bf12ac3f83d83b8737128e2371dedac6f82
parent795a953a3605e7caab14ecda5d48d70276126bff (diff)
downloadostree-4c0f67be0cf0ad28c99bfdef0641af98a2a02d5e.tar.gz
lib/sysroot: Expand docs for ostree_sysroot_get_repo()
Add some missing annotations and clarify that it always returns an open repository on success. Signed-off-by: Philip Withnall <withnall@endlessm.com> Closes: #1300 Approved by: cgwalters
-rw-r--r--src/libostree/ostree-sysroot.c7
1 files changed, 5 insertions, 2 deletions
diff --git a/src/libostree/ostree-sysroot.c b/src/libostree/ostree-sysroot.c
index ac418486..f9d8fb8c 100644
--- a/src/libostree/ostree-sysroot.c
+++ b/src/libostree/ostree-sysroot.c
@@ -983,11 +983,14 @@ ostree_sysroot_get_deployment_origin_path (GFile *deployment_path)
/**
* ostree_sysroot_get_repo:
* @self: Sysroot
- * @out_repo: (out): Repository in sysroot @self
+ * @out_repo: (out) (transfer full) (optional): Repository in sysroot @self
* @cancellable: Cancellable
* @error: Error
*
- * Retrieve the OSTree repository in sysroot @self.
+ * Retrieve the OSTree repository in sysroot @self. The repo is guaranteed to be open
+ * (see ostree_repo_open()).
+ *
+ * Returns: %TRUE on success, %FALSE otherwise
*/
gboolean
ostree_sysroot_get_repo (OstreeSysroot *self,