summaryrefslogtreecommitdiff
path: root/doc/sources.list.5.xml
diff options
context:
space:
mode:
authorSimon McVittie <smcv@debian.org>2024-12-24 13:45:57 +0000
committerJulian Andres Klode <jak@debian.org>2025-05-19 16:07:34 +0000
commit8576438367416c87f38effe960d143d94ebac851 (patch)
tree9cffdbc47c221c546a4353d3073ce840a9c0197b /doc/sources.list.5.xml
parentc3c49939b75a05e0e4a8cc52ec807b4756ea2d5c (diff)
sources.list(5): Explicitly say what the precedence order is
The order of apt sources can matter, but this man page did not previously define whether /etc/apt/sources.list was parsed before or after the fragment files in sources.list.d. Giving a concrete example also provides a hint that numeric prefixes are a useful way to force a particular sort order, and clarifies that the .list or .sources extension is less important than lexicographic order. Signed-off-by: Simon McVittie <smcv@debian.org>
Diffstat (limited to 'doc/sources.list.5.xml')
-rw-r--r--doc/sources.list.5.xml14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml
index 63bede827..c55cdbd1c 100644
--- a/doc/sources.list.5.xml
+++ b/doc/sources.list.5.xml
@@ -41,6 +41,20 @@
configured sources is acquired by <command>apt-get update</command> (or
by an equivalent command from another APT front-end).
</para>
+ <para>
+ If multiple source lists are used,
+ the most-preferred sources are those listed in
+ <filename>/etc/apt/sources.list</filename>,
+ followed by each file in
+ <filename>/etc/apt/sources.list.d/</filename>
+ in lexicographic order:
+ for example,
+ <filename>00-high-preference.list</filename>
+ is more-preferred than
+ <filename>50-middle-preference.sources</filename>
+ which is more-preferred than
+ <filename>z-low-preference.list</filename>.
+ </para>
</refsect1>
<refsect1><title>sources.list.d</title>