* HACKING: Document additional directory fallback checks.

* schroot/schroot.1.in, dchroot/dchroot.1.in,
  dchroot-dsa/dchroot-dsa.1.in: Document directory option.
* schroot/schroot-main-base.cc
  (run_impl): If a directory option was specified, set the auth wd
  member.
* schroot/schroot-options.cc, dchroot/dchroot-options.cc,
  dchroot-dsa/dchroot-dsa-options.cc:
  (add_options): Add directory option.
* schroot/schroot-options-base.h: Add directory member, used to
  specify the directory inside the chroot.

1 files changed, 22 insertions, 4 deletions

diff --git a/HACKING b/HACKING
index b2513e75..28c1da13 100644
--- a/HACKING
+++ b/HACKING
@@ -84,16 +84,34 @@ Chdir fallback behaviour:
 
     No fallbacks should exist under any circumstances.
 
-  dchroot
-    CWD → passwd_pw dir  Normal behaviour (not if -d used)
+  schroot [--directory used]
+    CWD → DIR            Normal behaviour
+    *FAIL*               If CWD nonexistent
+
+    No fallbacks should exist under any circumstances.
+
+  dchroot [login shell or command]
+    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
+  dchroot [--directory used]
+    CWD → DIR            Normal behaviour
+    *FAIL*               If CWD nonexistent
+
+    No fallbacks should exist under any circumstances.
+
+  dchroot-dsa [login shell or command]
+    CWD → passwd pw_dir  Normal behaviour
     CWD → /              If no passwd_pw dir
     *FAIL*               If / nonexistent
 
+  dchroot-dsa [--directory used]
+    CWD → DIR            Normal behaviour
+    *FAIL*               If CWD nonexistent
+
+    No fallbacks should exist under any circumstances.
+
   Note that --debug=notice will show the internal fallback list
   computed for the session.