Suggest using non-free-firmware in update for Debian

In an ideal world everyone would read release notes, but if the last
sources.list change is any indication a lot of people wont. This is
even more a problem in so far as apt isn't producing errors for
invalid repositories, but instead carries on as normal even through it
will not be able to install upgrades for the moved packages.

This commit implements two scenarios and prints a notice in those cases
pointing to the release notes:
a) User has 'non-free' but not 'non-free-firmware'
b) User has a firmware package which isn't available from anywhere

Both only happen if we are talking about a repository which identifies
itself as one of Debian and is for a release codenamed bookworm (or
sid). Note that as (usually) apt/oldstable is used to upgrade to the
new stable release these suggestions only show for users after they
have upgraded to bookworm on apt command line usage after that.

1 files changed, 5 insertions, 1 deletions

diff --git a/doc/examples/configure-index b/doc/examples/configure-index
index b3deccaaf..beafbbcd4 100644
--- a/doc/examples/configure-index
+++ b/doc/examples/configure-index
@@ -123,7 +123,11 @@ APT
      Update
      {
         InteractiveReleaseInfoChanges "<BOOL>";
-        SourceListWarnings "<BOOL>";
+        SourceListWarnings "<BOOL>"
+        {
+           APTAuth "<BOOL>";
+           NonFreeFirmware "<BOOL>";
+        };
      };
   };