Re: git: dfdc0baa01ad - main - UPDATING: Add a note for users of mail/oama < 0.15

On Fri 21 Mar 09:54, Nicola Vitale wrote:
> The branch main has been updated by nivit:
> 
> URL: https://cgit.FreeBSD.org/ports/commit/?id=dfdc0baa01ad99bea38bfa7edb389ae4d069a77e
> 
> commit dfdc0baa01ad99bea38bfa7edb389ae4d069a77e
> Author:     Nicola Vitale <nivit@FreeBSD.org>
> AuthorDate: 2025-03-21 09:46:00 +0000
> Commit:     Nicola Vitale <nivit@FreeBSD.org>
> CommitDate: 2025-03-21 09:54:03 +0000
> 
>     UPDATING: Add a note for users of mail/oama < 0.15
>     
>     Starting from version 0.15 oama saves credential files in the
>     $XDG_STATE_HOME/oama directory. This is a breaking change.
> ---
>  UPDATING | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
> diff --git a/UPDATING b/UPDATING
> index f00071876566..b39df4c2ff8a 10064
> --- a/UPDATING
> +++ b/UPDATING
> @@ -5,6 +5,18 @@ they are unavoidable.
>  You should get into the habit of checking this file for changes each time
>  you update your ports collection, before attempting any port upgrades.
>  
> +20250321:
> +  AFFECTS: users of mail/oama
> +  AUTHOR: nivit@FreeBSD.org
> +
> +  Starting from version 0.15, when the GPG backend is used the encrypted
> +  credentials are stored in the $XDG_STATE_HOME/oama directory.
> +  If the XDG_STATE_HOME environment variable is not set then it defaults to
> +  $HOME/.local/state.
> +
> +  That is a breaking change! If you use the GPG backend you need to manually
> +  move your credential ~/.local/var/oama/*.oama files into the new directory.
> +

This should not be an UPDATING entry, given most users won't read it, this is
should be an "upgrade" pkg-message on the apckage which are exactly design for
this.

Bapt