From fc339122d69a85e5238d8bd7069d24ed4be4aed4 Mon Sep 17 00:00:00 2001 From: Rusty Russell Date: Fri, 19 Jun 2020 11:15:21 +0930 Subject: [PATCH] tal: document tal_steal(ctx, NULL) as OK. Signed-off-by: Rusty Russell --- ccan/tal/tal.h | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/ccan/tal/tal.h b/ccan/tal/tal.h index 8b7ffca5..20cd89c5 100644 --- a/ccan/tal/tal.h +++ b/ccan/tal/tal.h @@ -131,10 +131,11 @@ void *tal_free(const tal_t *p); /** * tal_steal - change the parent of a tal-allocated pointer. * @ctx: The new parent. - * @ptr: The tal allocated object to move. + * @ptr: The tal allocated object to move, or NULL. * * This may need to perform an allocation, in which case it may fail; thus - * it can return NULL, otherwise returns @ptr. + * it can return NULL, otherwise returns @ptr. If @ptr is NULL, this function does + * nothing. */ #if HAVE_STATEMENT_EXPR /* Weird macro avoids gcc's 'warning: value computed is not used'. */ -- 2.39.2