cabal icon indicating copy to clipboard operation
cabal copied to clipboard

External command system missing from 3.12.1.0 release notes

Open hasufell opened this issue 1 year ago • 3 comments

https://github.com/haskell/cabal/pull/9063/commits/b27fd21d17c229fb8b4bc6a6fef0f79207b90dce

https://github.com/haskell/cabal/blob/master/release-notes/cabal-install-3.12.1.0.md

hasufell avatar Jul 01 '24 08:07 hasufell

This is because #9063 was merged without a changelog.d file.

We can of course modify the release notes, but I wonder if this warrants more exposure.

ffaf1 avatar Jul 01 '24 08:07 ffaf1

I was under the impression this feature is still somewhat experimental, and its further evolution depends on what early adopters find they would benefit from. So it could go either way but probably the balance weighs toward encouraging said early adopters.

geekosaur avatar Jul 01 '24 16:07 geekosaur

It's already documented in the rtd manual, so it's not hidden anyway.

Mikolaj avatar Jul 02 '24 08:07 Mikolaj

@hasufell Let me understand, what if your expectation w.r.t. to fixing this issue? The cabal-install-3.12.1.0 tarball is out and cannot be changed. Do you think making a changelog entry for 3.12.2.0 is a good solution? Thanks.

andreabedini avatar Jul 10 '24 03:07 andreabedini

You can fix it in:

  • git
  • readthedocs
  • release announcements

Not sure how many people care about the tarball.

hasufell avatar Jul 10 '24 04:07 hasufell

We've already retroactively edited release notes: https://github.com/haskell/cabal/pull/10134 I also note that we (deliberately) point people to the changelog files in master in preference to pregenerated files, e.g. on Hackage. In fact, I think the files in the tarball just point you to https://github.com/haskell/cabal/blob/master/Cabal/ChangeLog.md and https://github.com/haskell/cabal/blob/master/cabal-install/changelog.

geekosaur avatar Jul 10 '24 04:07 geekosaur

If there's nothing to be done, then feel free to close.

hasufell avatar Jul 10 '24 04:07 hasufell