Returning from a Common Lisp handler means declining

For each restart, which action does it permit, and which caller knows enough to pick it? The Java comparison is useful here. A checked declaration puts a compile-time obligation on the caller and still doesn't list every failure that can happen at run time.

Keep the logging handler as everyone's first guess. Then change only what it does, so it invokes a restart that supplies a value. If the wrapper calls both of those "handled", the example has found the missing distinction for you.

Those two traces could sit right next to the macro, with where execution resumes in each. Read that way, the abbreviation might be easier than expanding it every time, as long as the docs also cover a handler that declines.

Scheme splits this question into two procedures, which helps a wrapper say what it means. In R7RS, if a handler installed with with-exception-handler returns from a raise, a secondary exception is raised in the dynamic environment of the handler. With raise-continuable, the handler's return value becomes the value of the call and the parser carries on. So "the handler returned" has two different meanings depending on which one the parser used, and the macro's documentation should name which. Section 6.11 is short and worth reading whole.