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+up7=8j6guSiVRT378_+pSQ=h7cEb5MWHeN8GgC76MENxKA__39964.2046586209$1771882647$gmane$org@mail.gmail.com>
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.

I can send a PR on salsa if you prefer.

Regards
-- 
Stéphane
debsources.diff (text/x-patch, 1.3 KB)
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]>
 
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
 
 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.