docs: Clarify that callback can be called more than once

real-or-random · real-or-random · commit 895f53d1cf97 · 2025-09-22T12:58:48.000+02:00
diff --git a/include/secp256k1.h b/include/secp256k1.h
@@ -340,9 +340,9 @@ SECP256K1_API void secp256k1_context_destroy(
  *
  *  On the other hand, during debug stage, one would want to be informed about
  *  such mistakes, and the default (crashing) may be inadvisable.
- *  When this callback is triggered, the API function called is guaranteed not
- *  to cause a crash, though its return value and output arguments are
- *  undefined.
+ *  Should this callback return instead of crashing, the return value and output
+ *  arguments of the API function call are undefined. Moreover, the same API
+ *  call may trigger the callback again in this case.
  *
  *  When this function has not been called (or called with fn==NULL), then the
  *  default handler will be used. The library provides a default handler which

Original file line number	Diff line number	Diff line change
`@@ -340,9 +340,9 @@ SECP256K1_API void secp256k1_context_destroy(`
`340`	`340`	`*`
`341`	`341`	`* On the other hand, during debug stage, one would want to be informed about`
`342`	`342`	`* such mistakes, and the default (crashing) may be inadvisable.`
`343`		`- * When this callback is triggered, the API function called is guaranteed not`
`344`		`- * to cause a crash, though its return value and output arguments are`
`345`		`- * undefined.`
	`343`	`+ * Should this callback return instead of crashing, the return value and output`
	`344`	`+ * arguments of the API function call are undefined. Moreover, the same API`
	`345`	`+ * call may trigger the callback again in this case.`
`346`	`346`	`*`
`347`	`347`	`* When this function has not been called (or called with fn==NULL), then the`
`348`	`348`	`* default handler will be used. The library provides a default handler which`