From: Philip Withnall <withnall@endlessm.com>
Date: Wed, 4 Oct 2017 11:17:31 +0000 (+0100)
Subject: docs: Clarify %NULL argument to ostree_sysroot_new()
X-Git-Tag: archive/raspbian/2022.1-3+rpi1~1^2~4^2~30^2~86
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=43977dffdea5d2a640e9c0abd01c20b5d4a726f2;p=ostree.git

docs: Clarify %NULL argument to ostree_sysroot_new()

It’s equivalent to ostree_sysroot_new_default().

Signed-off-by: Philip Withnall <withnall@endlessm.com>

Closes: #1246
Approved by: cgwalters
---

diff --git a/src/libostree/ostree-sysroot.c b/src/libostree/ostree-sysroot.c
index fe61a12e..b49b4277 100644
--- a/src/libostree/ostree-sysroot.c
+++ b/src/libostree/ostree-sysroot.c
@@ -201,7 +201,12 @@ ostree_sysroot_init (OstreeSysroot *self)
 
 /**
  * ostree_sysroot_new:
- * @path: (allow-none): Path to a system root directory, or %NULL
+ * @path: (allow-none): Path to a system root directory, or %NULL to use the
+ *   current visible root file system
+ *
+ * Create a new #OstreeSysroot object for the sysroot at @path. If @path is %NULL,
+ * the current visible root file system is used, equivalent to
+ * ostree_sysroot_new_default().
  *
  * Returns: (transfer full): An accessor object for an system root located at @path
  */