From d26afd110f51154bc8474e69135e30cd43221ce1 Mon Sep 17 00:00:00 2001
From: Johannes Schauer Marin Rodrigues <josch@mister-muffin.de>
Date: Tue, 14 May 2024 07:32:09 +0200
Subject: [PATCH] add more docs to the tar-out special hook

---
 mmdebstrap | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/mmdebstrap b/mmdebstrap
index 6049cd4..e066843 100755
--- a/mmdebstrap
+++ b/mmdebstrap
@@ -7295,7 +7295,12 @@ B<--skip=tar-in/mknod>.
 =item B<tar-out> I<pathinside> I<outside.tar>
 
 Packs the path I<pathinside> from inside the chroot into a tarball, placing it
-into a certain location I<outside.tar> outside the chroot.
+into a certain location I<outside.tar> outside the chroot. To emulate behaviour
+of C<cp> and to provide control over the path which gets put into the tarball,
+a C<chdir()> is performed to the C<dirname()> of I<pathinside> and then the
+C<basename()> of I<pathinside> is packaged as a tarball. For example, if
+I<pathinside> is C</boot/.> then first a C<chdir()> into C</boot> will be
+performed before packing up the contents of C<.> inside C</boot>.
 
 =item B<download> I<fileinside> I<fileoutside>