From a56c9b0b50d5d16838f07724dc480c90501875a0 Mon Sep 17 00:00:00 2001 From: Julian Andres Klode Date: Thu, 9 Apr 2026 11:45:36 +0200 Subject: sources.list(5): Document Contact/Bugs/Description fields Document Contact, Bugs, and Description fields as the recommended way to inform users about a repository and how to contact upstream. Thanks: josch for the suggestion --- doc/sources.list.5.xml | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'doc') diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml index 09f824f25..b73a09f6f 100644 --- a/doc/sources.list.5.xml +++ b/doc/sources.list.5.xml @@ -442,7 +442,31 @@ Signed-By: however support additional types of IDs, and APT does not perform any checks so far. + + + + In the deb822 format, it can be useful to describe the sources in more detail. + The following options are not directly used by APT, + but suggested to be included by third-parties when providing .sources files to users. + + + + specifies the preferred addresses to reach the repository operators on one or more lines. + It should be a comma-separated list of RFC5322 email addresses or URLs. + + + + + specifies an HTTPS URL to a public bug tracker or instructions on how to report bugs. + + + + + specifies a description for the repository. This is a multi-line field, the first line is a summary, + the remaining lines may add more description. + + -- cgit v1.2.3-70-g09d2