summaryrefslogtreecommitdiff
path: root/doc/sources.list.5.xml
Commit message (Collapse)AuthorAgeFilesLines
* Release 3.3.03.3.0Julian Andres Klode2026-05-011-1/+1
|
* sources.list(5): Document Contact/Bugs/Description fieldsJulian Andres Klode2026-05-011-0/+24
| | | | | | | 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
* sources.list(5): th[r]ough typoнаб2026-04-241-1/+1
|
* Release 3.1.03.1.0Julian Andres Klode2025-05-191-1/+1
|
* sources.list(5): Explicitly say what the precedence order isSimon McVittie2025-05-191-0/+14
| | | | | | | | | | | 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>
* Add 'Include'/'Exclude' options to limit packages used from a repositoryJulian Andres Klode2025-05-191-0/+9
| | | | | | | | | | | | | 'Include' allows limiting a repository to a allowlist of packages, 'Exclude' allows removing packages from a repository. Implementation wise this is not the nicest as it goes via the IndexTarget options, so we first parse our option value into a vector, then we turn the vector into a string, and then vectorize it again. That said, we support both "," and " " as separators due to the construction (we split by "," then we join using " "). Gbp-Dch: full
* Release 2.9.342.9.34Julian Andres Klode2025-03-201-1/+1
|
* doc/sources.list.5.xml: snapshot infosChristopher Bock2025-03-141-17/+28
| | | | | * rephrase information about possible snapshot values * add snapshot example configurations
* Release 2.9.262.9.26Julian Andres Klode2025-01-281-1/+1
| | | | | This reflows the documentation po files now using the latest gettext.
* doc: Deprecate legacy one-line-style format harderJulian Andres Klode2025-01-281-1/+5
| | | | | | Schedule the removal not before 2029. Gbp-Dch: full
* Release 2.9.222.9.22Julian Andres Klode2025-01-141-1/+1
|
* Change multi sources.list entry example from FTP to HTTPSDavid Kalnischkies2025-01-051-7/+7
| | | | | | | | | As the FTP method is dropped it is probably better to use an example that actually works. We use https here as that requires no other text changes as there is a HTTPS session to reuse similar to FTP usage ~ that is the case for our HTTP, too, but the concept of a session isn't usually known there and servers who close the connection after every request are more common.
* Remove leftovers from ftp and rsh/ssh methods removalDavid Kalnischkies2025-01-051-24/+0
| | | | References: fd3684cdbc165ceaa635ed19fcbd231f509b0179
* Release 2.9.212.9.21Julian Andres Klode2025-01-011-1/+1
| | | | | | We updated po/ with libunistring 1.3 as before, but had no doc changes since the manual update with libunstring 1.2, so no churn there. Hooray.
* Remove obsolete references to ftp://ftp.debian.orgGuillem Jover2024-12-281-6/+6
| | | | | | | | Although Debian does not support FTP, this might still be used by other organizations, or local users, so replaced these instances with an example.org URL. Ref: https://lists.debian.org/debian-announce/2017/msg00001.html
* sources.list(5): Suggest VENDOR.sources for new systemsSimon McVittie2024-12-241-0/+10
| | | | | | | | | 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>
* Release 2.9.172.9.17Julian Andres Klode2024-12-071-1/+1
|
* Remove the apt-key manual page and add documentation to apt-secureJulian Andres Klode2024-12-071-2/+2
| | | | | | | We move the user configuration section to the top of the manual page as that is going to be what most are interested in and rewrite it to cover all the modern ways to configure keys in a succinct way.
* Initial support for snapshot servers, apt --snapshot optionJulian Andres Klode2023-05-021-0/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Provide snapshot support for offical Debian and Ubuntu archives. There are two ways to enable snapshots for sources: 1. Add Snapshot: yes to your sources file ([snapshot=yes]). This will allow you to specify a snapshot to use when updating or installing using the --snapshot,-S option. 2. Add Snapshot: ID to your sources files to request a specific snapshot for this source. Snapshots are discovered using Label and Origin fields in the Release file of the main source, hence you need to have updated the source at least once before you can use snapshots. The Release file may also declare a snapshots server to use, similar to Changelogs, it can contain a Snapshots field with the values: 1. `Snapshots: https://example.com/@SNAPSHOTID@` where `@SNAPSHOTID@` is a placeholder that is replaced with the requested snapshot id 2. `Snapshots: no` to disable snapshot support for this source. Requesting snapshots for this source will result in a failure to load the source. The implementation adds a SHADOWED option to deb source entries, and marks the main entry as SHADOWED when a snapshot has been requested, which will cause it to be updated, but not included in the generated cache. The concern here was that we need to keep generating the shadowed entries because the cleanup in `apt update` deletes any files not queued for download, so we gotta keep downloading the main source. This design is not entirely optimal, but avoids the pitfalls of having to reimplement list cleanup. Gaps: - Ubuntu Pro repositories and PPAs are not yet supported.
* Release 2.6.0, the "unhappy bookworm" release2.6.0Julian Andres Klode2023-03-061-1/+1
|
* Add non-free-firmware component in documentationDavid Kalnischkies2023-01-301-10/+10
| | | | | | This changes a lot of lines technically, but its easy enough to unfuzzy the translations as most of the mentions are examples to be copied literally in translations (sadly po4a isn't clever enough for this).
* Release 2.4.02.4.0Julian Andres Klode2022-02-221-1/+1
|
* Improve the documentation for /etc/apt/keyringsJulian Andres Klode2022-02-221-1/+4
|
* Release 2.3.102.3.10Julian Andres Klode2021-10-181-1/+1
|
* Add support for embedding PGP keys into Signed-By in deb822 sourcesJulian Andres Klode2021-10-181-0/+17
| | | | | | Extend the Signed-By field to handle embedded public key blocks, this allows shipping self-contained .sources files, making it substantially easier to provide third party repositories.
* Release 1.9.0 to experimental1.9.0Julian Andres Klode2019-06-171-1/+1
|
* Perform minor copy-editing on the docsMartin Michlmayr2019-04-041-3/+3
|
* Fix typos encountered while updating de translationChris Leick2018-10-301-1/+1
|
* Support multiple keyrings in sources.list Signed-ByDavid Kalnischkies2018-09-111-12/+17
| | | | | | | A user can specify multiple fingerprints for a while now, so its seems counter-intuitive to support only one keyring, especially if this isn't really checked or enforced and while unlikely mixtures of both should work properly, too, instead of a kinda random behaviour.
* Fix various typos reported by spellcheckersDavid Kalnischkies2018-05-051-1/+1
| | | | | Reported-By: codespell & spellintian Gbp-Dch: Ignore
* mention mirror method in sources.listDavid Kalnischkies2018-04-151-0/+11
| | | | Closes: 679580
* Release 1.6~rc11.6_rc1Julian Andres Klode2018-04-151-1/+1
|
* Revert "mention mirror method in sources.list"Julian Andres Klode2018-04-151-11/+0
| | | | This reverts commit 57a00c50b14a49ed91816e3f4467e0f2e57ee772.
* mention mirror method in sources.listDavid Kalnischkies2018-04-071-0/+11
| | | | Closes: 679580
* Release 1.6~beta11.6_beta1Julian Andres Klode2018-02-261-1/+1
|
* Check that Date of Release file is not in the futureJulian Andres Klode2018-02-191-0/+17
| | | | | | | | | | | | | By restricting the Date field to be in the past, an attacker cannot just create a repository from the future that would be accepted as a valid update for a repository. This check can be disabled by Acquire::Check-Date set to false. This will also disable Check-Valid-Until and any future date related checking, if any - the option means: "my computers date cannot be trusted." Modify the tests to allow repositories to be up to 10 hours in the future, so we can keep using hours there to simulate time changes.
* Release 1.6~alpha71.6_alpha7Julian Andres Klode2018-01-181-1/+1
|
* Introduce inrelease-path option for sources.listJulian Andres Klode2018-01-171-0/+9
| | | | | | | | | | | | | | Allow specifying an alternative path to the InRelease file, so you can have multiple versions of a repository, for example. Enabling this option disables fallback to Release and Release.gpg, so setting it to InRelease can be used to ensure that only that will be tried. We add two test cases: One for checking that it works, and another for checking that the fallback does not happen. Closes: #886745
* Release 1.6~alpha61.6_alpha6Julian Andres Klode2018-01-031-1/+1
|
* document https options in new apt-transport-https manpageDavid Kalnischkies2018-01-031-1/+1
| | | | | | Same reasoning as with the previous commit for http with the added benefit of moving the hard to discover and untranslated example config into a manpage which could be translated.
* document http options in new apt-transport-http manpageDavid Kalnischkies2018-01-031-9/+7
| | | | | | We had documentation for the http transport in our "catch-all" apt.conf manpage, but it seems benefitial to document transports in their own manpage instead of pushing them all into one.
* allow multivalue fields in deb822 sources to be foldedDavid Kalnischkies2017-11-191-3/+5
| | | | | | | | | | | | | | | The documentation said "spaces", but there is no real reason to be so strict and only allow spaces to separate values as that only leads to very long lines if e.g. multiple URIs are specified which are again hard to deal with from a user PoV which the deb822 format is supposed to avoid. It also deals with multiple consecutive spaces and strange things like tabs users will surely end up using in the real world. The old behviour on encountering folded lines is the generation of URIs which end up containing all these whitespace characters which tends to mess really bad with output and further processing. Closes: 881875
* Release 1.5~rc31.5_rc3Julian Andres Klode2017-09-101-1/+1
|
* Release 1.5~rc21.5_rc2Julian Andres Klode2017-09-091-1/+1
|
* Release 1.5~rc11.5_rc1Julian Andres Klode2017-08-241-1/+1
|
* Release 1.5~beta21.5_beta2Julian Andres Klode2017-08-171-1/+1
|
* update URI scheme descriptions in sources.list(5)David Kalnischkies2017-07-261-18/+43
|
* Release 1.4~beta11.4_beta1Julian Andres Klode2016-11-251-1/+1
|
* Release 1.3.11.3.1Julian Andres Klode2016-10-041-1/+1
|
* Release 1.31.3Julian Andres Klode2016-09-201-1/+1
|