X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/4c482ac554e1b533d98661de8585d5861d9ac562..35d8bb14e1102f0231432c7ad33be414e07a15e6:/doc/sources.list.5.xml diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml index 297939a1c..dd057eb32 100644 --- a/doc/sources.list.5.xml +++ b/doc/sources.list.5.xml @@ -14,7 +14,7 @@ &apt-email; &apt-product; - 2015-11-26T00:00:00Z + 2016-11-25T00:00:00Z @@ -126,7 +126,7 @@ archive, distribution/component. The distribution is generally a suite name like stable or testing or a codename like - &stable-codename; or &testing-codename; + &debian-stable-codename; or &debian-testing-codename; while component is one of main, contrib or non-free. The deb-src type references a Debian distribution's source @@ -222,10 +222,12 @@ deb-src [ option1=value1 option2=value2 ] uri suite [component1] [component2] [. () is a multivalue option defining which download targets apt will try to acquire from this source. If not specified, the default set is defined by the - configuration scope. - Additionally, specific targets can be enabled or disabled by - using the identifier as field name instead of using this - multivalue option. + configuration scope + (targets are specified by their name in the + Created-By field). + Additionally, targets can be enabled or disabled by using the + Identifier field as an option with a boolean + value instead of using this multivalue option. () @@ -267,6 +269,14 @@ deb-src [ option1=value1 option2=value2 ] uri suite [component1] [component2] [. anomalies. + (), + () and + () + are boolean values which all default to no. + If set to yes they circumvent parts of &apt-secure; + and should therefore not be used lightly! + + () is a tri-state value which defaults to APT deciding if a source is considered trusted or if warnings should be raised before e.g. @@ -284,15 +294,17 @@ deb-src [ option1=value1 option2=value2 ] uri suite [component1] [component2] [. () is either an absolute path to a keyring file (has to be accessible and readable for the _apt user, - so ensure everyone has read-permissions on the file) or a - fingerprint of a key either in the - trusted.gpg keyring or in one of the + so ensure everyone has read-permissions on the file) or one or + more fingerprints of keys either in the + trusted.gpg keyring or in the keyrings in the trusted.gpg.d/ directory (see apt-key fingerprint). If the option is - set, only the key(s) in this keyring or only the key with this - fingerprint is used for the &apt-secure; verification of this - repository. Otherwise all keys in the trusted keyrings are - considered valid signers for this repository. + set, only the key(s) in this keyring or only the keys with these + fingerprints are used for the &apt-secure; verification of this + repository. Defaults to the value of the option with the same name + if set in the previously acquired Release file. + Otherwise all keys in the trusted keyrings are considered valid + signers for this repository. () @@ -429,16 +441,16 @@ Components: main contrib non-free The first line gets package information for the architectures in APT::Architectures while the second always retrieves amd64 and armel. - deb http://httpredir.debian.org/debian &stable-codename; main -deb [ arch=amd64,armel ] http://httpredir.debian.org/debian &stable-codename; main + deb http://deb.debian.org/debian &debian-stable-codename; main +deb [ arch=amd64,armel ] http://deb.debian.org/debian &debian-stable-codename; main Types: deb -URIs: http://httpredir.debian.org/debian -Suites: &stable-codename; +URIs: http://deb.debian.org/debian +Suites: &debian-stable-codename; Components: main Types: deb -URIs: http://httpredir.debian.org/debian -Suites: &stable-codename; +URIs: http://deb.debian.org/debian +Suites: &debian-stable-codename; Components: main Architectures: amd64 armel @@ -452,11 +464,11 @@ Suites: hamm Components: main Uses FTP to access the archive at ftp.debian.org, under the debian - directory, and uses only the &stable-codename;/contrib area. - deb ftp://ftp.debian.org/debian &stable-codename; contrib + directory, and uses only the &debian-stable-codename;/contrib area. + deb ftp://ftp.debian.org/debian &debian-stable-codename; contrib Types: deb URIs: ftp://ftp.debian.org/debian -Suites: &stable-codename; +Suites: &debian-stable-codename; Components: contrib Uses FTP to access the archive at ftp.debian.org, under the debian @@ -484,14 +496,14 @@ Suites: unstable/binary-$(ARCH)/ Uses HTTP to get binary packages as well as sources from the stable, testing and unstable suites and the components main and contrib. - deb http://httpredir.debian.org/debian stable main contrib -deb-src http://httpredir.debian.org/debian stable main contrib -deb http://httpredir.debian.org/debian testing main contrib -deb-src http://httpredir.debian.org/debian testing main contrib -deb http://httpredir.debian.org/debian unstable main contrib -deb-src http://httpredir.debian.org/debian unstable main contrib + deb http://deb.debian.org/debian stable main contrib +deb-src http://deb.debian.org/debian stable main contrib +deb http://deb.debian.org/debian testing main contrib +deb-src http://deb.debian.org/debian testing main contrib +deb http://deb.debian.org/debian unstable main contrib +deb-src http://deb.debian.org/debian unstable main contrib Types: deb deb-src -URIs: http://httpredir.debian.org/debian +URIs: http://deb.debian.org/debian Suites: stable testing unstable Components: main contrib @@ -499,8 +511,7 @@ Components: main contrib See Also - &apt-get;, &apt-conf; - + &apt-get;, &apt-conf;, &apt-acquire-additional-files; &manbugs;