From af2b2b2c32312cd7d2f848dbcef8be7d79f8d4b9 Mon Sep 17 00:00:00 2001
From: Birte Kristina Friesel <derf@finalrewind.org>
Date: Sun, 3 Dec 2023 13:50:05 +0100
Subject: README: Remove nightly builds; add APT repository

---
 README.md | 59 +++++++++++++++++++++++++++++++++++++++--------------------
 1 file changed, 39 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index a724464..7df83b6 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # db-iris - Commandline Client for DB IRIS Departure Monitor
 
-db-iris is a commandline client and Perl module for the DB IRIS departure
+**db-iris** is a commandline client and Perl module for the DB IRIS departure
 monitor located at iris.noncd.db.de. See the [Travel::Status::DE::IRIS
 homepage](https://finalrewind.org/projects/Travel-Status-DE-IRIS/) for details.
 
@@ -9,9 +9,10 @@ train stations via text and JSON output.
 
 ## Installation
 
-You have four installation options:
+You have five installation options:
 
-* Nightly `.deb` builds for Debian-based distributions
+* `.deb` releases for Debian-based distributions
+* finalrewind.org APT repository for Debian-based distributions
 * Installing the latest release from CPAN
 * Installation from source
 * Using a Docker image
@@ -20,43 +21,61 @@ Except for Docker, **db-iris** is available in your PATH after installation.
 You can run `db-iris --version` to verify this. Documentation is available via
 `man db-iris`.
 
-### Nightly Builds for Debian
+### Release Builds for Debian
 
 [lib.finalrewind.org/deb](https://lib.finalrewind.org/deb) provides Debian
-packages of both development and release versions. Note that these are not part
-of the official Debian repository and are not covered by its quality assurance
-process.
+packages of all release versions. Note that these are not part of the official
+Debian repository and are not covered by its quality assurance process.
 
 To install the latest release, run:
 
 ```
 wget https://lib.finalrewind.org/deb/libtravel-status-de-iris-perl_latest_all.deb
-sudo dpkg -i libtravel-status-de-iris-perl_latest_all.deb
-sudo apt --fix-broken install
+sudo apt install ./libtravel-status-de-iris-perl_latest_all.deb
 rm libtravel-status-de-iris-perl_latest_all.deb
 ```
 
-For a (possibly broken) development snapshot of the Git master branch, run:
+Uninstallation works as usual:
 
 ```
-wget https://lib.finalrewind.org/deb/libtravel-status-de-iris-perl_dev_all.deb
-sudo dpkg -i libtravel-status-de-iris-perl_dev_all.deb
-sudo apt --fix-broken install
-rm libtravel-status-de-iris-perl_dev_all.deb
+sudo apt remove libtravel-status-de-iris-perl
 ```
 
-Note that dpkg, unlike apt, does not automatically install missing
-dependencies. If a dependency is not satisfied yet, `dpkg -i` will complain
-about unmet dependencies and bail out. `apt --fix-broken install` installs
-these dependencies and also silently finishes the Travel::Status::DE::IRIS
-installation.
+### finalrewind.org APT repository
 
-Uninstallation works as usual:
+[lib.finalrewind.org/apt](https://lib.finalrewind.org/apt) provides an APT
+repository with Debian packages of the latest release versions. Note that this
+is not a Debian repository; it is operated under a best-effort SLA and if you
+use it you will have to trust me not to screw up your system with bogus
+packages. Also, note that the packages are not part of the official Debian
+repository and are not covered by its quality assurance process.
+
+To set up the repository and install the latest Travel::Status::DE::IRIS
+release, run:
+
+```
+curl -s https://finalrewind.org/apt.asc | sudo tee /etc/apt/trusted.gpg.d/finalrewind.asc
+echo 'deb https://lib.finalrewind.org/apt stable main' | sudo tee /etc/apt/sources.list.d/finalrewind.list
+sudo apt update
+sudo apt install libtravel-status-de-iris-perl
+```
+
+Afterwards, `apt update` and `apt upgrade` will automatically install new
+Travel::Status::DE::IRIS releases.
+
+Uninstallation of Travel::Status::DE::IRIS works as usual:
 
 ```
 sudo apt remove libtravel-status-de-iris-perl
 ```
 
+To remove the APT repository from your system, run:
+
+```
+sudo rm /etc/apt/trusted.gpg.d/finalrewind.asc \
+        /etc/apt/sources.list.d/finalrewind.list
+```
+
 ### Installation from CPAN
 
 Travel::Status::DE::IRIS releases are published on the Comprehensive Perl
-- 
cgit v1.2.3