From 27a325164faa2539ce9b713a250fc3c5a7f2e40d Mon Sep 17 00:00:00 2001 From: Ben Pfaff Date: Mon, 20 Jun 2011 14:11:14 -0700 Subject: [PATCH] ovsdb-idl: Improve comment. --- lib/ovsdb-idl.c | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/lib/ovsdb-idl.c b/lib/ovsdb-idl.c index 94784bda..f4daaed1 100644 --- a/lib/ovsdb-idl.c +++ b/lib/ovsdb-idl.c @@ -1640,7 +1640,11 @@ ovsdb_idl_txn_complete(struct ovsdb_idl_txn *txn, * been disabled (by calling ovsdb_idl_omit()). * * Usually this function is used indirectly through one of the "set" functions - * generated by ovsdb-idlc. */ + * generated by ovsdb-idlc. + * + * Takes ownership of what 'datum' points to (and in some cases destroys that + * data before returning) but makes a copy of 'datum' itself. (Commonly + * 'datum' is on the caller's stack.) */ void ovsdb_idl_txn_write(const struct ovsdb_idl_row *row_, const struct ovsdb_idl_column *column, -- 2.30.2