From: William Manley <will@williammanley.net>
Date: Fri, 22 Jun 2018 11:00:29 +0000 (+0100)
Subject: OstreeMutableTree: Document ostree_mutable_tree_ensure_dir
X-Git-Tag: archive/raspbian/2022.1-3+rpi1~1^2~4^2~21^2~40
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=5190f1df424a52fe84944852760fdb5be448320e;p=ostree.git

OstreeMutableTree: Document ostree_mutable_tree_ensure_dir

Closes: #1645
Approved by: jlebon
---

diff --git a/src/libostree/ostree-mutable-tree.c b/src/libostree/ostree-mutable-tree.c
index f46e36db..e5e282d4 100644
--- a/src/libostree/ostree-mutable-tree.c
+++ b/src/libostree/ostree-mutable-tree.c
@@ -186,6 +186,16 @@ ostree_mutable_tree_replace_file (OstreeMutableTree *self,
   return ret;
 }
 
+/**
+ * ostree_mutable_tree_ensure_dir:
+ * @self: Tree
+ * @name: Name of subdirectory of self to retrieve/creates
+ * @out_subdir: (out) (transfer full): the subdirectory
+ * @error: a #GError
+ *
+ * Returns the subdirectory of self with filename @name, creating an empty one
+ * it if it doesn't exist.
+ */
 gboolean
 ostree_mutable_tree_ensure_dir (OstreeMutableTree *self,
                                 const char        *name,