Subject: Re: bug#52018: 28.0.60; Improve documentation for compilation-finish-functions

From: Eli Zaretskii <[email-masked]>
Date: Sun, 21 Nov 2021 21:25:59 +0200

> From: Thibault Polge <[email-masked]>
> Cc: [email-masked]
> Date: Sun, 21 Nov 2021 20:08:56 +0100
> 
>     (force-mode-line-update)
>     [...]
>     (run-hook-with-args 'compilation-finish-functions cur-buffer msg)))
> 
> So the msg that compilation-handle-exit receives is passed, unmodified,
> to all 'compilation-finish-functions`.

Maybe so, but I'm looking at the calls of compilation-handle-exit, and
the callers do all kinds of transformations with the original status,
so I think documenting what happens to be more-or-less correct now is
fragile.

Why do you think this addition is of such great importance to have it
spelled out in the doc string?