Bug#1128883: developers-reference: replace sources.list by debian.sources file format

Hi!

On Mon, 2026-02-23 at 22:35:30 +0100, Stéphane Blondon wrote:
> Package: developers-reference
> Severity: minor
> Tags: patch

> '*.list' files are now replaced by '*.sources' files. The provided
> patch (in attachment) replaces the example by the new file format. It
> also adds some highlights.
> 
> I don't know if the 'Signed-By' line is necessary. I added it based on
> '/etc/apt/sources.list.d/debian.sources' file on 'testing' system.

> diff --git i/source/pkgs.rst w/source/pkgs.rst
> index 2e7679f..74d048b 100644
> --- i/source/pkgs.rst
> +++ w/source/pkgs.rst
> @@ -2176,7 +2176,7 @@ quite easy:
>     ``Uploaders`` field in the first paragraph of the ``debian/control``
>     file.
>  
> -   ::
> +   .. code-block:: debcontrol
>  
>        Uploaders: John Buzz <[email protected]>, Adam Rex <[email protected]>

This change seems unrelated to this bug report?

> diff --git i/source/resources.rst w/source/resources.rst
> index d26b6c5..f636d42 100644
> --- i/source/resources.rst
> +++ w/source/resources.rst
> @@ -695,12 +695,15 @@ it nevertheless). Users who download and install packages from
>  ``experimental`` are expected to have been duly warned. In short, all
>  bets are off for the ``experimental`` distribution.
>  
> -These are the sources.list 5 lines for ``experimental``:
> +These are the debian.sources lines for ``experimental``:
>  
> -::
> +.. code-block:: debian.sources
>  
> -   deb http://deb.debian.org/debian/ experimental main
> -   deb-src http://deb.debian.org/debian/ experimental main
> +   Types: deb deb-src
> +   URIs: https://deb.debian.org/debian/
> +   Suites: experimental
> +   Components: main
> +   Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Please use the «.pgp» extension, as the «.gpg» one is currently a
symlink for backwards compatibility, that will eventually go away.
(And this is not a GnuPG artifact, but an OpenPGP one. :)

Thanks,
Guillem