bug#34588: 27.0.50; Doc of write-contents-functions: arguments?

[Eli Zaretskii]

> From: Michael Heerdegen <michael_heerdegen@web.de>
> Date: Wed, 20 Feb 2019 04:55:49 +0100
> 
> I'm not sure why "write-contents-functions" isn't named "...-hook".

Because we need to call those functions with
run-hook-with-args-until-success, I guess.

> Anyway, since its named -functions, shouldn't we say what arguments the
> members should accept? (AFAIK the answer is: functions are called with
> no arguments).

I agree it would be good to say that in the doc string (yes, no
arguments is the right answer).

> You might argue that the thing is also called a "hook" in the docstring,
> but it also seems to call the members of the variable "hooks" later in
> the doc, as far as I understand it.  So for me it's all a bit unclear
> and confusing.

Is it less confusing now?