Merge branch 'feature/block-device-mounting'

4 files changed, 19 insertions, 5 deletions

diff --git a/man/prokit-build.8in b/man/prokit-build.8in
index 77ed078..5dc25de 100644
--- a/man/prokit-build.8in
+++ b/man/prokit-build.8in
@@ -5,12 +5,15 @@
 prokit-build \- Build a package
 
 .SH SYNOPSIS
-\fBprokit build\fP \fIroot-dir\fP [\fIoption\fP ...] \fIpkg-dir\fP
+\fBprokit build\fP \fIroot\fP [\fIoption\fP ...] \fIpkg-dir\fP
 
 .SH DESCRIPTION
 \fBprokit build\fP runs \fBopkbuild\fP to build a package in an isolated file
 system environment, temporarily installing any missing build dependencies.
 .P
+If \fIroot\fP is a block device node, the block device is mounted and
+\fBopkbuild\fP is run in its file system.
+.P
 \fIoption\fPs are \fBopkbuild\fP options.  Run \fIprokit build -h .\fP for more
 information.
 .P
diff --git a/man/prokit-install.8in b/man/prokit-install.8in
index ef5f68d..4f10d34 100644
--- a/man/prokit-install.8in
+++ b/man/prokit-install.8in
@@ -6,10 +6,13 @@ prokit-install \- Install a system into a directory
 
 .SH SYNOPSIS
 \fBprokit install\fP [\fB-a\fP \fIarch\fP] [\fB-p\fP \fIplat\fP]
-[\fB-m\fP \fImirror\fP] [\fB-F\fP] \fIsuite\fP \fIroot-dir\fP
+[\fB-m\fP \fImirror\fP] [\fB-F\fP] \fIsuite\fP \fIroot\fP
 
 .SH DESCRIPTION
-\fBprokit install\fP installs a basic system of \fIsuite\fP into \fIroot-dir\fP.
+\fBprokit install\fP installs a basic system of \fIsuite\fP into \fIroot\fP.
+.P
+If \fIroot\fP is a block device node, the block device is mounted and a system
+is installed into its file system.
 .P
 \fIsuite\fP can be a distribution like \fItrunk\fP; a channel and distribution
 like \fIdev/trunk\fP; a profile and distribution like \fIproteanos:trunk\fP; or
diff --git a/man/prokit-opkg.8in b/man/prokit-opkg.8in
index cfe8e9f..50b845a 100644
--- a/man/prokit-opkg.8in
+++ b/man/prokit-opkg.8in
@@ -5,12 +5,15 @@
 prokit-opkg \- Manage packages with opkg
 
 .SH SYNOPSIS
-\fBprokit opkg\fP \fIroot-dir\fP [\fIoption\fP ...] \fIsub-command\fP
+\fBprokit opkg\fP \fIroot\fP [\fIoption\fP ...] \fIsub-command\fP
 [\fIargument\fP ...]
 
 .SH DESCRIPTION
 \fBprokit opkg\fP runs \fBopkg\fP in an isolated file system environment.
 .P
+If \fIroot\fP is a block device node, the block device is mounted and \fBopkg\fP
+is run in its file system.
+.P
 \fIoption\fPs are \fBopkg\fP options and \fIsub-command\fP is an \fBopkg\fP
 sub-command.  See the usage information for \fBopkg\fP for more information.
 .P
diff --git a/man/prokit-shell.8in b/man/prokit-shell.8in
index f42b15a..bb98ae1 100644
--- a/man/prokit-shell.8in
+++ b/man/prokit-shell.8in
@@ -5,12 +5,15 @@
 prokit-shell \- Run a shell in an isolated environment
 
 .SH SYNOPSIS
-\fBprokit shell\fP \fIroot-dir\fP [\fIcommand\fP [\fIargument\fP ...]]
+\fBprokit shell\fP \fIroot\fP [\fIcommand\fP [\fIargument\fP ...]]
 
 .SH DESCRIPTION
 \fBprokit shell\fP starts a shell in an isolated file system environment (using
 \fBchroot\fP(8)) with basic file systems mounted.
 .P
+If \fIroot\fP is a block device node, the block device is mounted and a shell is
+started in its file system.
+.P
 If a \fIcommand\fP is given (with optional \fIargument\fPs), it is executed in a
 non-interactive shell.
 
@@ -20,6 +23,8 @@ non-interactive shell.
 # prokit shell $root echo Hello world
 .IP \[bu]
 # prokit shell $root 'opkg install build-essential-$(cat /etc/proteanos_arch)'
+.IP \[bu]
+# prokit shell /dev/sdb1
 
 .SH COPYRIGHT
 Copyright (C) 2014  Patrick "P. J." McDermott