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

Stéphane Blondon <[email protected]>
Newsgroups gmane.linux.debian.devel.policy
Message-ID <CAOy+up4cTA-TYAi2sH4BW-WzGFrf37Zne9S4XfjS9c8VLpW1Qg__24997.6201028161$1772361569$gmane$org@mail.gmail.com>
Hello,

Le mar. 24 févr. 2026 à 01:25, Guillem Jover <[email protected]> a écrit :
> On Mon, 2026-02-23 at 22:35:30 +0100, Stéphane Blondon wrote:
> > 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?

Yes. I removed it from the new patch (in attachment). I will write
another bug report dedicated to highlighting if I see other ones.


> > +   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.

I fixed it too.


Regards
-- 
Stéphane
debsources.diff (text/x-patch, 937 B)
diff --git i/source/resources.rst w/source/resources.rst
index d26b6c5..e450f60 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.pgp
 
 If there is a chance that the software could do grave damage to a
 system, it is likely to be better to put it into ``experimental``. For
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.