libsmbconf: Document smbconf_transaction_commit().

[ira/wip.git] / lib / smbconf / smbconf.h

diff --git a/lib/smbconf/smbconf.h b/lib/smbconf/smbconf.h
index c3cd2b34ed9070f064e267e0d6d5fd50d9a00527..fffdd7613e30e5afc33bad03d365c6c4f27f6799 100644 (file)
--- a/lib/smbconf/smbconf.h
+++ b/lib/smbconf/smbconf.h
@@ -447,7 +447,20 @@ sbcErr smbconf_delete_global_includes(struct smbconf_ctx *ctx);
  */
 sbcErr smbconf_transaction_start(struct smbconf_ctx *ctx);
 
+/**
+ * @brief Commit a transaction on the configuration backend.
+ *
+ * This is to speed up writes to the registry based backend.
+ *
+ * @param[in] ctx       The smbconf context to commit the transaction.
+ *
+ * @return              SBC_ERR_OK on success, a corresponding sbcErr if an
+ *                      error occured.
+ *
+ * @see smbconf_transaction_start()
+ */
 sbcErr smbconf_transaction_commit(struct smbconf_ctx *ctx);
+
 sbcErr smbconf_transaction_cancel(struct smbconf_ctx *ctx);
 
 #endif /*  _LIBSMBCONF_H_  */