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

Reply via email to