Improve comment

1 files changed, 6 insertions, 4 deletions

diff --git a/src/core/lib/iomgr/combiner.h b/src/core/lib/iomgr/combiner.h
index 3eb9f34638..57df8f0ba8 100644
--- a/src/core/lib/iomgr/combiner.h
+++ b/src/core/lib/iomgr/combiner.h
@@ -54,14 +54,16 @@ void grpc_combiner_destroy(grpc_exec_ctx *exec_ctx, grpc_combiner *lock);
 void grpc_combiner_execute(grpc_exec_ctx *exec_ctx, grpc_combiner *lock,
                            grpc_closure *closure, grpc_error *error);
 // Execute \a action within the lock just prior to unlocking.
-// if \a hint_async_break is additionally set, the combiner is tries to trip
-// through the workqueue between finishing the primary queue of combined
-// closures and executing the finally list.
+// if \a hint_async_break is true, the combiner is tries to hand execution to
+// another thread before finishing the primary queue of combined closures and
+// executing the finally list.
+// Deprecation warning: \a hint_async_break will be removed in a future version
 // Takes a very slow and round-about path if not called from a
-// grpc_combiner_execute closure
+// grpc_combiner_execute closure.
 void grpc_combiner_execute_finally(grpc_exec_ctx *exec_ctx, grpc_combiner *lock,
                                    grpc_closure *closure, grpc_error *error,
                                    bool hint_async_break);
+// Deprecated: force the finally list execution onto another thread
 void grpc_combiner_force_async_finally(grpc_combiner *lock);
 
 extern int grpc_combiner_trace;