libsmbconf: Document smbconf_transaction_start().

Signed-off-by: Michael Adam <obnox@samba.org>

1 files changed, 11 insertions, 0 deletions

diff --git a/lib/smbconf/smbconf.h b/lib/smbconf/smbconf.h
index 0268ad4bd48..c3cd2b34ed9 100644
--- a/lib/smbconf/smbconf.h
+++ b/lib/smbconf/smbconf.h
@@ -435,7 +435,18 @@ sbcErr smbconf_delete_includes(struct smbconf_ctx *ctx, const char *service);
  */
 sbcErr smbconf_delete_global_includes(struct smbconf_ctx *ctx);
 
+/**
+ * @brief Start a transaction on the configuration backend.
+ *
+ * This is to speed up writes to the registry based backend.
+ *
+ * @param[in] ctx       The smbconf context to start the transaction.
+ *
+ * @return              SBC_ERR_OK on success, a corresponding sbcErr if an
+ *                      error occured.
+ */
 sbcErr smbconf_transaction_start(struct smbconf_ctx *ctx);
+
 sbcErr smbconf_transaction_commit(struct smbconf_ctx *ctx);
 sbcErr smbconf_transaction_cancel(struct smbconf_ctx *ctx);