Subject: Re: bug#45437: 27.1; make-temp-file parameter change in emacs 26 missing in documentation

From: Lars Ingebrigtsen <[email-masked]>
Date: Fri, 25 Dec 2020 22:56:21 +0100

Hendrik Tews <[email-masked]> writes:

> the function make-temp-file was extended in emacs 26 with the
> additional optional TEXT argument. However, describe-function
> says "Probably introduced at or before Emacs version 21.1.",
> leaving the impression that one can safely use the TEXT argument
> if one wants to write backward compatible code.

The "probably" only talks about the function itself; not about the
parameters.

> Please amend the documentation of make-temp-file to mention that
> the TEXT argument was added in emacs 26. Without such
> information, it is very difficult to write code that works in a
> variety of emacs major versions.

Sorry; we don't keep track of added parameters in a systematic way, so
that would be unfeasible.  You have to read the NEWS file to determine
this stuff (or use the VC functions, of you have a checked-out Emacs).

Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no