* HACKING: Document manual chroot fallback testing.

1 files changed, 35 insertions, 0 deletions

diff --git a/HACKING b/HACKING
index a07755a5..34cfe9a8 100644
--- a/HACKING
+++ b/HACKING
@@ -49,3 +49,38 @@ The following styles are used
 
 These are transformed into proper UTF-8 quotes with gettext.
 
+
+Releasing
+---------
+
+The code must pass the testsuite (make check).  It must also pass some
+tests which must be run by hand:
+
+Chdir fallback behaviour:
+
+  schroot [login shell]
+    CWD → CWD            Normal behaviour
+    CWD → $HOME          If CWD nonexistent and -p used
+    CWD → passwd pw_dir  If CWD nonexistent (or -p used and no $HOME exists)
+    CWD → /              None of the above exist
+    *FAIL*               If / nonexistent
+
+  schroot [command]
+    CWD → CWD            Normal behaviour
+    *FAIL*               If CWD nonexistent
+
+    No fallbacks should exist under any circumstances.
+
+  dchroot
+    CWD → passwd_pw dir  Normal behaviour (not if -d used)
+    CWD → CWD            If -d used
+    CWD → /              If CWD nonexistent and -d used
+    *FAIL*               If / nonexistent
+
+  dchroot-dsa
+    CWD → passwd_pw dir  Normal behaviour
+    CWD → /              If no passwd_pw dir
+    *FAIL*               If / nonexistent
+
+  Note that --debug=notice will show the internal fallback list
+  computed for the session.