-struct trans *trans_open_rp(struct respool *rp);
-static inline struct trans *trans_open(void)
-{
- return trans_open_rp(NULL);
-}
-struct trans *trans_get_current(void);
-void trans_commit(void);
-void trans_rollback(void);
-void trans_dump(void);
+struct trans *trans_open(void); /** Creates a new transaction. Used inside `TRANS_TRY`. **/
+struct trans *trans_get_current(void); /** Get a pointer to the currently running transaction, or NULL if there is none. **/
+void trans_commit(void); /** Commits the current transaction. **/
+void trans_rollback(void); /** Rolls back the current transaction. **/
+void trans_fold(void); /** Folds the current transaction to its parent. **/
+void trans_dump(void); /** Prints out a debugging dump of the transaction stack to stdout. **/