* bug#45437: 27.1; make-temp-file parameter change in emacs 26 missing in documentation
@ 2020-12-25 21:51 Hendrik Tews
2020-12-25 21:56 ` Lars Ingebrigtsen
0 siblings, 1 reply; 3+ messages in thread
From: Hendrik Tews @ 2020-12-25 21:51 UTC (permalink / raw)
To: 45437
Hi,
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.
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.
Thanks,
Hendrik
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#45437: 27.1; make-temp-file parameter change in emacs 26 missing in documentation
2020-12-25 21:51 bug#45437: 27.1; make-temp-file parameter change in emacs 26 missing in documentation Hendrik Tews
@ 2020-12-25 21:56 ` Lars Ingebrigtsen
2021-02-12 18:14 ` Basil L. Contovounesios
0 siblings, 1 reply; 3+ messages in thread
From: Lars Ingebrigtsen @ 2020-12-25 21:56 UTC (permalink / raw)
To: Hendrik Tews; +Cc: 45437
Hendrik Tews <hendrik@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.
> 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
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#45437: 27.1; make-temp-file parameter change in emacs 26 missing in documentation
2020-12-25 21:56 ` Lars Ingebrigtsen
@ 2021-02-12 18:14 ` Basil L. Contovounesios
0 siblings, 0 replies; 3+ messages in thread
From: Basil L. Contovounesios @ 2021-02-12 18:14 UTC (permalink / raw)
To: Lars Ingebrigtsen; +Cc: Hendrik Tews, 45437
Lars Ingebrigtsen <larsi@gnus.org> writes:
> Hendrik Tews <hendrik@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
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2021-02-12 18:14 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-12-25 21:51 bug#45437: 27.1; make-temp-file parameter change in emacs 26 missing in documentation Hendrik Tews
2020-12-25 21:56 ` Lars Ingebrigtsen
2021-02-12 18:14 ` Basil L. Contovounesios
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).