Stability of project.el

Stability of project.el

[Philip Kaludercic]

The commentary section for project.el still begins with

--8<---------------cut here---------------start------------->8---
;; NOTE: The project API is still experimental and can change in major,
;; backward-incompatible ways.  Everyone is encouraged to try it, and
;; report to us any problems or use cases we hadn't anticipated, by
;; sending an email to emacs-devel, or `M-x report-emacs-bug'.
--8<---------------cut here---------------end--------------->8---

Is this still true, or would it be warranted to remove it just like we
did for Xref a few years ago (9a15694a45), perhaps even in time for
Emacs 29?

Re: Stability of project.el

[Dmitry Gutov]

Hi Philip,

On 10/07/2023 21:53, Philip Kaludercic wrote:
> The commentary section for project.el still begins with
> 
> --8<---------------cut here---------------start------------->8---
> ;; NOTE: The project API is still experimental and can change in major,
> ;; backward-incompatible ways.  Everyone is encouraged to try it, and
> ;; report to us any problems or use cases we hadn't anticipated, by
> ;; sending an email to emacs-devel, or `M-x report-emacs-bug'.
> --8<---------------cut here---------------end--------------->8---
> 
> Is this still true, or would it be warranted to remove it just like we
> did for Xref a few years ago (9a15694a45), perhaps even in time for
> Emacs 29?

I think that's a good idea. Even if there still some less-than-ideal 
bits, we need to maintain it backward-compatibly, given the age.

And documentation-only changes should still be good for Emacs 29.

Re: Stability of project.el

[Philip Kaludercic]

Dmitry Gutov <dmitry@gutov.dev> writes:

> Hi Philip,
>
> On 10/07/2023 21:53, Philip Kaludercic wrote:
>> The commentary section for project.el still begins with
>> --8<---------------cut here---------------start------------->8---
>> ;; NOTE: The project API is still experimental and can change in major,
>> ;; backward-incompatible ways.  Everyone is encouraged to try it, and
>> ;; report to us any problems or use cases we hadn't anticipated, by
>> ;; sending an email to emacs-devel, or `M-x report-emacs-bug'.
>> --8<---------------cut here---------------end--------------->8---
>> Is this still true, or would it be warranted to remove it just like
>> we
>> did for Xref a few years ago (9a15694a45), perhaps even in time for
>> Emacs 29?
>
> I think that's a good idea. Even if there still some less-than-ideal
> bits, we need to maintain it backward-compatibly, given the age.

Great.  Should the major version number also be bumped?

> And documentation-only changes should still be good for Emacs 29.

Eli, what do you say?

Re: Stability of project.el

[Eli Zaretskii]

> From: Philip Kaludercic <philipk@posteo.net>
> Cc: emacs-devel@gnu.org
> Date: Tue, 11 Jul 2023 05:26:35 +0000
> 
> Dmitry Gutov <dmitry@gutov.dev> writes:
> 
> > I think that's a good idea. Even if there still some less-than-ideal
> > bits, we need to maintain it backward-compatibly, given the age.
> 
> Great.  Should the major version number also be bumped?
> 
> > And documentation-only changes should still be good for Emacs 29.
> 
> Eli, what do you say?

This changes no code, so the decision is entirely up to Dmitry, and
AFAIU he already made the decision.

Re: Stability of project.el

[Dmitry Gutov]

On 11/07/2023 08:26, Philip Kaludercic wrote:
> Great.  Should the major version number also be bumped?

Let's not complicate things. We just declare the current versions in 
Emacs 29 and 30 as "stable". No code change - so no version change 
strictly necessary.

Though I suppose some of the users will only see the changed text after 
the next version bump.

Re: Stability of project.el

[Stefan Kangas]

Dmitry Gutov <dmitry@gutov.dev> writes:

> I think that's a good idea. Even if there still some less-than-ideal
> bits, we need to maintain it backward-compatibly, given the age.

This was apparently never done, so I've now made that change on the
emacs-29 branch (commit 8cbd4a02a2b).

Re: Stability of project.el

[Dmitry Gutov]

On 04/08/2023 13:35, Stefan Kangas wrote:
> Dmitry Gutov<dmitry@gutov.dev>  writes:
> 
>> I think that's a good idea. Even if there still some less-than-ideal
>> bits, we need to maintain it backward-compatibly, given the age.
> This was apparently never done, so I've now made that change on the
> emacs-29 branch (commit 8cbd4a02a2b).

Thanks!