[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#44991: 27.1; Documentation mismatch for message-fetch-field
From: |
Lars Ingebrigtsen |
Subject: |
bug#44991: 27.1; Documentation mismatch for message-fetch-field |
Date: |
Wed, 02 Dec 2020 11:17:20 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) |
Vladimir Nikishkin <lockywolf@gmail.com> writes:
> Dear Emacs Developers,
>
> The docstring for `message-fetch-fiels' states:
> ```
> (message-fetch-field HEADER &optional NOT-ALL)
> The same as ‘mail-fetch-field’, only remove all newlines.
> ```
>
> The prototype is correct, but the documentation is wrong.
>
> Look at the prototype of `mail-fetch-field'.
> ```
> (mail-fetch-field FIELD-NAME &optional LAST ALL LIST DELETE)
> ```
>
> Firstly, the `message-fetch-field' cannot be used as a drop-in
> replacement for `mail-fetch-field' due to the difference in prototypes.
>
> Secondly, the ALL and NOT-ALL arguments are extremely easy to confuse.
I've now fixed the message-fetch-field doc string in Emacs 28 so that it
actually describes what it does. And renamed NOT-ALL to FIRST.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no