unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable
@ 2023-11-05  9:37 Ihor Radchenko
  2023-11-05 14:23 ` Stefan Kangas
  0 siblings, 1 reply; 8+ messages in thread
From: Ihor Radchenko @ 2023-11-05  9:37 UTC (permalink / raw)
  To: 66946

Hi,

In Elisp manual, "17.4 Dynamic Loading of Individual Functions"
describes `byte-compile-dynamic' variable.

However, according to the docstring, this variable is no longer useful

    byte-compile-dynamic is a variable defined in bytecomp.el.
    
    This variable is obsolete since 27.1; not worthwhile any more.
    
    Value
    nil

It looks like the corresponding section of the manual is now obsolete
and should probably be removed.

In GNU Emacs 30.0.50 (build 30, x86_64-pc-linux-gnu, GTK+ Version
 3.24.38, cairo version 1.18.0) of 2023-10-28 built on localhost
Repository revision: b38c7d6e64423120ae1f1bc3ed01dce88c77b75e
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12101009
System Description: Gentoo Linux

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable
  2023-11-05  9:37 bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable Ihor Radchenko
@ 2023-11-05 14:23 ` Stefan Kangas
  2023-11-05 23:24   ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
  0 siblings, 1 reply; 8+ messages in thread
From: Stefan Kangas @ 2023-11-05 14:23 UTC (permalink / raw)
  To: Ihor Radchenko, 66946; +Cc: Stefan Monnier

Ihor Radchenko <yantar92@posteo.net> writes:

> In Elisp manual, "17.4 Dynamic Loading of Individual Functions"
> describes `byte-compile-dynamic' variable.
>
> However, according to the docstring, this variable is no longer useful
>
>     byte-compile-dynamic is a variable defined in bytecomp.el.
>
>     This variable is obsolete since 27.1; not worthwhile any more.
>
>     Value
>     nil
>
> It looks like the corresponding section of the manual is now obsolete
> and should probably be removed.

The manual says:

       _Experience shows that using dynamic function loading provides
    benefits that are hardly measurable, so this feature is deprecated
    since Emacs 27.1._

Stefan M, any comments here?  Is it time to actually mark this stuff
obsolete?





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable
  2023-11-05 14:23 ` Stefan Kangas
@ 2023-11-05 23:24   ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
  2023-11-06  0:21     ` Stefan Kangas
  0 siblings, 1 reply; 8+ messages in thread
From: Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2023-11-05 23:24 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: 66946, Ihor Radchenko

>> In Elisp manual, "17.4 Dynamic Loading of Individual Functions"
>> describes `byte-compile-dynamic' variable.
>>
>> However, according to the docstring, this variable is no longer useful
>>
>>     byte-compile-dynamic is a variable defined in bytecomp.el.
>>
>>     This variable is obsolete since 27.1; not worthwhile any more.
>>
>>     Value
>>     nil
>>
>> It looks like the corresponding section of the manual is now obsolete
>> and should probably be removed.
>
> The manual says:
>
>        _Experience shows that using dynamic function loading provides
>     benefits that are hardly measurable, so this feature is deprecated
>     since Emacs 27.1._
>
> Stefan M, any comments here?

Nothing specific, no.

> Is it time to actually mark this stuff obsolete?

Hmm... isn't it marked obsolete already?
Or did you mean to ask if it's time to throw away the corresponding code?


        Stefan






^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable
  2023-11-05 23:24   ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
@ 2023-11-06  0:21     ` Stefan Kangas
  2024-01-11 21:52       ` Stefan Kangas
  0 siblings, 1 reply; 8+ messages in thread
From: Stefan Kangas @ 2023-11-06  0:21 UTC (permalink / raw)
  To: Stefan Monnier; +Cc: 66946, Ihor Radchenko

Stefan Monnier <monnier@iro.umontreal.ca> writes:

>> The manual says:
>>
>>        _Experience shows that using dynamic function loading provides
>>     benefits that are hardly measurable, so this feature is deprecated
>>     since Emacs 27.1._
>>
>> Stefan M, any comments here?
>
> Nothing specific, no.
>
>> Is it time to actually mark this stuff obsolete?
>
> Hmm... isn't it marked obsolete already?
> Or did you mean to ask if it's time to throw away the corresponding code?

You're right.  Not sure how I missed that...

I guess then the only question is if it's worth keeping it in the manual.





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable
  2023-11-06  0:21     ` Stefan Kangas
@ 2024-01-11 21:52       ` Stefan Kangas
  2024-08-12  6:18         ` Ihor Radchenko
  0 siblings, 1 reply; 8+ messages in thread
From: Stefan Kangas @ 2024-01-11 21:52 UTC (permalink / raw)
  To: Stefan Monnier; +Cc: 66946, Ihor Radchenko

Stefan Kangas <stefankangas@gmail.com> writes:

> Stefan Monnier <monnier@iro.umontreal.ca> writes:
>
>>> The manual says:
>>>
>>>        _Experience shows that using dynamic function loading provides
>>>     benefits that are hardly measurable, so this feature is deprecated
>>>     since Emacs 27.1._
>>>
>>> Stefan M, any comments here?
>>
>> Nothing specific, no.
>>
>>> Is it time to actually mark this stuff obsolete?
>>
>> Hmm... isn't it marked obsolete already?
>> Or did you mean to ask if it's time to throw away the corresponding code?
>
> You're right.  Not sure how I missed that...

Taking another look at this.

Why not throw away the code if it's hardly measurable?  We could make it
a no-op in Emacs 30.1, and then just remove it from the manual.  It's
already been obsolete for three major versions by then.





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable
  2024-01-11 21:52       ` Stefan Kangas
@ 2024-08-12  6:18         ` Ihor Radchenko
  2024-08-17  9:39           ` Eli Zaretskii
  0 siblings, 1 reply; 8+ messages in thread
From: Ihor Radchenko @ 2024-08-12  6:18 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: 66946, Stefan Monnier

Stefan Kangas <stefankangas@gmail.com> writes:

> Why not throw away the code if it's hardly measurable?  We could make it
> a no-op in Emacs 30.1, and then just remove it from the manual.  It's
> already been obsolete for three major versions by then.

Just bumping this thread, so that it is not lost ahead of the release.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable
  2024-08-12  6:18         ` Ihor Radchenko
@ 2024-08-17  9:39           ` Eli Zaretskii
  2024-08-17 12:53             ` Stefan Kangas
  0 siblings, 1 reply; 8+ messages in thread
From: Eli Zaretskii @ 2024-08-17  9:39 UTC (permalink / raw)
  To: Ihor Radchenko; +Cc: 66946, stefankangas, monnier

> Cc: 66946@debbugs.gnu.org, Stefan Monnier <monnier@iro.umontreal.ca>
> From: Ihor Radchenko <yantar92@posteo.net>
> Date: Mon, 12 Aug 2024 06:18:18 +0000
> 
> Stefan Kangas <stefankangas@gmail.com> writes:
> 
> > Why not throw away the code if it's hardly measurable?  We could make it
> > a no-op in Emacs 30.1, and then just remove it from the manual.  It's
> > already been obsolete for three major versions by then.
> 
> Just bumping this thread, so that it is not lost ahead of the release.

I think we lost focus and context.  What exactly is being proposed now
for the upcoming Emacs 30 release?





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable
  2024-08-17  9:39           ` Eli Zaretskii
@ 2024-08-17 12:53             ` Stefan Kangas
  0 siblings, 0 replies; 8+ messages in thread
From: Stefan Kangas @ 2024-08-17 12:53 UTC (permalink / raw)
  To: Eli Zaretskii, Ihor Radchenko; +Cc: 66946-done, monnier

Eli Zaretskii <eliz@gnu.org> writes:

>> Cc: 66946@debbugs.gnu.org, Stefan Monnier <monnier@iro.umontreal.ca>
>> From: Ihor Radchenko <yantar92@posteo.net>
>> Date: Mon, 12 Aug 2024 06:18:18 +0000
>>
>> Stefan Kangas <stefankangas@gmail.com> writes:
>>
>> > Why not throw away the code if it's hardly measurable?  We could make it
>> > a no-op in Emacs 30.1, and then just remove it from the manual.  It's
>> > already been obsolete for three major versions by then.
>>
>> Just bumping this thread, so that it is not lost ahead of the release.
>
> I think we lost focus and context.  What exactly is being proposed now
> for the upcoming Emacs 30 release?

I think the idea was to remove the obsolete variable
`byte-compile-dynamic` from the manual.  This has already been done in
emacs-30.

The variable is still there but is marked obsolete and documented as
having no effect.  It will get removed in some future release of Emacs;
there is no particular rush with deleting it.

I'm therefore boldly closing this bug report.





^ permalink raw reply	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2024-08-17 12:53 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-11-05  9:37 bug#66946: 30.0.50; Elisp manual section 17.4 describes an obsolete variable Ihor Radchenko
2023-11-05 14:23 ` Stefan Kangas
2023-11-05 23:24   ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-11-06  0:21     ` Stefan Kangas
2024-01-11 21:52       ` Stefan Kangas
2024-08-12  6:18         ` Ihor Radchenko
2024-08-17  9:39           ` Eli Zaretskii
2024-08-17 12:53             ` Stefan Kangas

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