From 86b366c6c5e9ff3529eb1f51399ce7c7dd0165a1 Mon Sep 17 00:00:00 2001
From: Simon Quigley <tsimonq2@debian.org>
Date: Mon, 24 Feb 2025 19:15:55 -0600
Subject: [PATCH] Add a large warning at the top of mk-sbuild encouraging the
 use of the unshare backend. This is to provide ample warning to users.

---
 debian/changelog |  2 ++
 mk-sbuild        | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 40fe9a5..0405877 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -6,6 +6,8 @@ ubuntu-dev-tools (0.204) UNRELEASED; urgency=medium
   * Add my name to the copyright file.
   * Rename bitesize to lp-bitesize (Closes: #1076224).
   * Add a manpage for running-autopkgtests.
+  * Add a large warning at the top of mk-sbuild encouraging the use of the
+    unshare backend. This is to provide ample warning to users.
 
   [ Julien Plissonneau Duquène ]
   * Fix reverse-depends -b crash on packages that b-d on themselves
diff --git a/mk-sbuild b/mk-sbuild
index 9731362..7d8d4e6 100755
--- a/mk-sbuild
+++ b/mk-sbuild
@@ -303,6 +303,25 @@ if [ ! -w /var/lib/sbuild ]; then
     # Prepare a usable default .sbuildrc
     if [ ! -e ~/.sbuildrc ]; then
         cat > ~/.sbuildrc <<EOM
+# *** THIS COMMAND IS DEPRECATED ***
+#
+# In sbuild 0.87.0 and later, the unshare backend is available. This is
+# expected to become the default in a future release.
+#
+# This is the new preferred way of building Debian packages, making the manual
+# creation of schroots no longer necessary. To retain the default behavior,
+# you may remove this comment block and continue.
+#
+# To test the unshare backend while retaining the default settings, run sbuild
+# with --chroot-mode=unshare like this:
+# $ sbuild --chroot-mode=unshare --dist=unstable hello
+#
+# To switch to the unshare backend by default (recommended), uncomment the
+# following lines and delete the rest of the file (with the exception of the
+# last two lines):
+#\$chroot_mode = 'unshare';
+#\$unshare_mmdebstrap_keep_tarball = 1;
+
 # *** VERIFY AND UPDATE \$mailto and \$maintainer_name BELOW ***
 
 # Mail address where logs are sent to (mandatory, no default!)