apt/doc/sources.list.5.xml, branch 2.9.25

Release 2.9.22

2025-01-14T17:33:49Z

Change multi sources.list entry example from FTP to HTTPS

2025-01-05T22:16:09Z

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 removal

2025-01-05T22:16:09Z

References: fd3684cdbc165ceaa635ed19fcbd231f509b0179

Release 2.9.21

2025-01-01T21:52:23Z

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.org

2024-12-28T12:20:50Z

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 systems

2024-12-24T14:01:40Z

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

Release 2.9.17

2024-12-07T16:14:35Z

Remove the apt-key manual page and add documentation to apt-secure

2024-12-07T14:14:34Z

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 option

2023-05-02T13:23:14Z

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" release

2023-03-06T12:30:01Z