GNU bug report logs - #45437
27.1; make-temp-file parameter change in emacs 26 missing in documentation

Previous Next

Full log

View this message in rfc822 format

From: "Basil L. Contovounesios" <contovob <at> tcd.ie>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: Hendrik Tews <hendrik <at> askra.de>, 45437 <at> debbugs.gnu.org
Subject: bug#45437: 27.1; make-temp-file parameter change in emacs 26 missing in documentation
Date: Fri, 12 Feb 2021 18:14:01 +0000

Lars Ingebrigtsen <larsi <at> gnus.org> writes:

> Hendrik Tews <hendrik <at> askra.de> 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.

And is an imperfect heuristic based on searching NEWS files, hence
"probably".

>> 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).

See also: https://lists.gnu.org/r/emacs-devel/2020-12/msg00371.html

-- 
Basil

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.