X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/e2fa0aa64d2249129543f82a213043d96469be1c..866e9fadf892368fcb50e6a192bcdd350cfe8e5c:/doc/sources.list.5.xml
diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml
index 87fb4d71e..7a82bd4ce 100644
--- a/doc/sources.list.5.xml
+++ b/doc/sources.list.5.xml
@@ -76,22 +76,37 @@
code in the same form as the deb type.
A deb-src line is required to fetch source indexes.
-
The format for a sources.list entry using the
deb and deb-src types is:
- deb [ options ] uri distribution [component1] [component2] [...]
+ deb [ options ] uri suite [component1] [component2] [...]
+
+ Alternatively a rfc822 style format is also supported:
+
+ Type: deb
+ URI: http://example.com
+ Suite: stable
+ Section: component1 component2
+ [option1]: [option1-value]
+
+ Type: deb-src
+ URI: http://example.com
+ Suite: stable
+ Section: component1 component2
+ [option1]: [option1-value]
+
+
The URI for the deb type must specify the base of the
Debian distribution, from which APT will find the information it needs.
- distribution can specify an exact path, in which case the
- components must be omitted and distribution must end with
+ suite can specify an exact path, in which case the
+ components must be omitted and suite must end with
a slash (/). This is useful for the case when only a
particular sub-section of the archive denoted by the URI is of interest.
- If distribution does not specify an exact path, at least
+ If suite does not specify an exact path, at least
one component must be present.
- distribution may also contain a variable,
+ suite may also contain a variable,
$(ARCH)
which expands to the Debian architecture (such as amd64 or
armel) used on the system. This permits architecture-independent
@@ -99,17 +114,19 @@
of interest when specifying an exact path, APT will
automatically generate a URI with the current architecture otherwise.
- Since only one distribution can be specified per line it may be necessary
- to have multiple lines for the same URI, if a subset of all available
- distributions or components at that location is desired.
- APT will sort the URI list after it has generated a complete set
- internally, and will collapse multiple references to the same Internet
- host, for instance, into a single connection, so that it does not
- inefficiently establish an FTP connection, close it, do something else,
- and then re-establish a connection to that same host. This feature is
- useful for accessing busy FTP sites with limits on the number of
- simultaneous anonymous users. APT also parallelizes connections to
- different hosts to more effectively deal with sites with low bandwidth.
+ In the traditional style sources.list format since only one
+ distribution can be specified per line it may be necessary to have
+ multiple lines for the same URI, if a subset of all available
+ distributions or components at that location is desired. APT will
+ sort the URI list after it has generated a complete set internally,
+ and will collapse multiple references to the same Internet host,
+ for instance, into a single connection, so that it does not
+ inefficiently establish an FTP connection, close it, do something
+ else, and then re-establish a connection to that same host. This
+ feature is useful for accessing busy FTP sites with limits on the
+ number of simultaneous anonymous users. APT also parallelizes
+ connections to different hosts to more effectively deal with sites
+ with low bandwidth.
options is always optional and needs to be surrounded by
square brackets. It can consist of multiple settings in the form