diff --git a/src/libostree/ostree-deployment.c b/src/libostree/ostree-deployment.c
index db61c567..a555e056 100644
--- a/src/libostree/ostree-deployment.c
+++ b/src/libostree/ostree-deployment.c
@@ -155,6 +155,13 @@ ostree_deployment_hash (gconstpointer v)
     ostree_deployment_get_deployserial (d);
 }
 
+/**
+ * ostree_deployment_equal:
+ * @ap: (type OstreeDeployment): A deployment
+ * @bp: (type OstreeDeployment): A deployment
+ *
+ * Returns: %TRUE if deployments have the same osname, csum, and deployserial
+ */
 gboolean
 ostree_deployment_equal (gconstpointer ap, gconstpointer bp)
 {
diff --git a/src/libostree/ostree-sysroot.c b/src/libostree/ostree-sysroot.c
index 92d7b035..4839118b 100644
--- a/src/libostree/ostree-sysroot.c
+++ b/src/libostree/ostree-sysroot.c
@@ -762,7 +762,7 @@ ostree_sysroot_get_booted_deployment (OstreeSysroot       *self)
  * ostree_sysroot_get_deployments:
  * @self: Sysroot
  *
- * Returns: (element-type OstreeDeployment) (transfer full): Ordered list of deployments
+ * Returns: (element-type OstreeDeployment) (transfer container): Ordered list of deployments
  */
 GPtrArray *
 ostree_sysroot_get_deployments (OstreeSysroot  *self)