From a389a93cc7f3b793b64392b5e52df35204627682 Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@debian.org>
Date: Tue, 24 Dec 2024 13:45:21 +0000
Subject: sources.list(5): Suggest VENDOR.sources for new systems

This matches the filename used by default in Ubuntu since Ubuntu 24.04,
and in Debian cloud images and the Debian images provided by docker.io
since Debian 12 (although not currently used in new installations via
debian-installer).

Signed-off-by: Simon McVittie <smcv@debian.org>
---
 doc/sources.list.5.xml | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml
index 7d85629a1..454f00871 100644
--- a/doc/sources.list.5.xml
+++ b/doc/sources.list.5.xml
@@ -54,6 +54,16 @@
        Otherwise APT will print a notice that it has ignored a file, unless that
        file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal>
        configuration list - in which case it will be silently ignored.</para>
+     <para>
+       The suggested filename for new systems is
+       <filename>/etc/apt/sources.list.d/<replaceable>vendor</replaceable>.sources</filename>,
+       where <replaceable>vendor</replaceable> is the result of
+       <command>dpkg-vendor --query Vendor | tr A-Z a-z</command>,
+       in deb822-style format.
+       For example,
+       Ubuntu uses
+       <filename>/etc/apt/sources.list.d/ubuntu.sources</filename>.
+     </para>
  </refsect1>
 
  <refsect1><title>One-Line-Style Format</title>
-- 
cgit v1.2.3-70-g09d2