Subject: bug#72526: Needs NEWS item and doc change

From: Michael Albinus <[email-masked]>
Date: Fri, 02 May 2025 15:27:21 +0200

Björn Bidar via "Bug reports for GNU Emacs, the Swiss army knife of text
editors" <[email-masked]> writes:

Hi Björn,

> --- a/etc/NEWS
> +++ b/etc/NEWS
> @@ -48,6 +48,31 @@ incorrectly in rare cases.
>  This allows to specify the directory where the user unit file for
>  systemd is installed; default is '${prefix}/usr/lib/systemd/user'.
>  
> +
> +* Incompatible Changes in Emacs 31.1
> +
> +** url-basic-auth no longer amends ports when search for credentials
> +url-basic-auth used to amend the port to the server when searching
> +for credentials in auth-source.
> +This happened so auth-source would partially emulate the classic netrc
> +format where there is no port field, i.e. as in Curl.
> +
> +The port has to be removed from the server. If the previously
> +specified port differs from the one specified in the port field
> +then this has to be adjusted too.
> +
> +So for example:
> +machine www.example.com:443 port https login foo password bar
> +Becomes:
> +machine www.example.com port https login foo password bar
> +
> +However in this example:
> +machine www.example.com:800 port https login foo password bar
> +The port has to removed and the https has to replaced with 800:
> +machine www.example.com port 800 login foo password bar
> +
> +(443 is the default port for HTTPS connections.)

To my taste, it is too long. We don't discuss any reasoning here, just
document how the format has changed.

Best regards, Michael.