From a0133a63936f02751b572af4f1964d8e843d32ee Mon Sep 17 00:00:00 2001
From: Johannes Schauer Marin Rodrigues <josch@mister-muffin.de>
Date: Thu, 26 Jan 2023 09:28:50 +0100
Subject: [PATCH] document maybe-merged-usr hook

---
 mmdebstrap | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/mmdebstrap b/mmdebstrap
index ae767f4..998071f 100755
--- a/mmdebstrap
+++ b/mmdebstrap
@@ -7480,6 +7480,15 @@ F</etc/unsupported-skip-usrmerge-conversion> inside the chroot and install the
 B<usr-is-merged> package to avoid the installation of the B<usrmerge> package
 and its dependencies.
 
+If you are using B<mmdebstrap> in a setup where you do not know upfront whether
+the chroot you are creating should be merged-/usr or not and you want to avoid
+installation of the B<usrmerge> package and it's dependencies, you can use:
+
+    --hook-dir=/usr/share/mmdebstrap/hooks/maybe-merged-usr
+
+That hook will use the availability of the B<usr-is-merged> package to decide
+whether to call the B<merged-usr> hook or not.
+
 =head1 COMPRESSION
 
 B<mmdebstrap> will choose a suitable compressor for the output tarball