[Buildd-tools-devel] Bug#369633: schroot.conf(5) ambiguity, schroot(1) error and formatting

[Andreas Bombe]

Package: schroot
Version: 0.2.10-1
Severity: minor

schroot.conf(5) says:
| run-exec-scripts=true|false
|       Set  whether chroot execution scripts will be run.  The default
|       is are the same as for the run-setup-scripts key.  This option
|       was called run-setup-scripts  in releases up to version 0.2.5.

Aside from the "is are" I don't find it entirely clear whether the
default for run-exec-scripts is determined by the same rules as for
run-setup-scripts or if the default _is_ the value of the
run-setup-scripts key.  I'm leaning towards "determined in the same
way", maybe it's just "is are" being confusing here.


schroot(1) isn't documenting the session options correctly, here's a
diff showing how I think it should be, plus fixing the misplaced .TP.
Please verify:

--- schroot.1.orig	2006-05-31 01:31:30.000000000 +0200
+++ schroot.1	2006-05-31 01:30:34.000000000 +0200
@@ -55,8 +55,9 @@
 considered.
 .TP
 .B \-c, \-\-chroot=\fIchroot\fP
-Specify a chroot to use.  This option may be used multiple times to specify
-more than one chroot, in which case its effect is similar to \fB\-\-all\fP.
+Specify a chroot or active session to use.  This option may be used multiple
+times to specify more than one chroot, in which case its effect is similar to
+\fB\-\-all\fP.
 .TP
 .B \-u, \-\-user=\fIuser\fP
 Run as a different user.  The default is to run as the current user.  If
@@ -98,16 +99,18 @@
 Begin a session.  A unique session identifier (UUID) is returned on standard
 output.  The UUID is required to use the other session options.
 .TP
-.TP
 .B \-\-recover\-session
 Recover an existing session.  If an existing session has become unavailable,
 for example becoming unmounted due to a reboot, this option will make the
 session available for use again, for example by remounting it.
-.B \-r, \-\-run\-session=\fIUUID\fP
-Run an existing session.
 .TP
-.B \-e, \-\-end\-session=\fIUUID\fP
-End an existing session.
+.B \-r, \-\-run\-session
+Run an existing session.  The session UUID is specified with the
+\fB\-\-chroot\fP option.
+.TP
+.B \-e, \-\-end\-session
+End an existing session.  The session UUID is specified with the
+\fB\-\-chroot\fP option.
 .TP
 .B \-f, \-\-force
 Force a session operation, even if it would otherwise fail.  This may be used