On 26/05/2023 15:23, Ihor Radchenko wrote:
Max Nikulin writes:

I have realized that the command is specified in the README.org file, so
it is mentioned twice on https://elpa.gnu.org/packages/org.html

However prior to Emacs-29.1 built-in packages are filtered-out from
completion list and ignored by non-interactive command
Should `list-packages' recipe be used in the README.org file instead?

The first instance of M-x package-install <RET> org <RET> comes from
ELPA itself. Considering that ELPA is targeting various Emacs versions,
it should probably be corrected there first.

Generally agree, but I am skeptical concerning changes in ELPA since only minority of packages are affected.

The second instance in README.org may then be altered according to what
ELPA devs do.

Users may open README.org outside of ELPA. "To install a more recent version..." is is not enough even for coming Emacs-29 since the default value for `package-install-upgrade-built-in' is nil.

Another pitfall with install instruction in an .org file is that if the file is opened in Emacs < 29 then package.el generates mixed-versions .elc files. A precaution is necessary that `list-packages' should be run in a clean emacs session, not the one with README.org.

Reply via email to