d/arch-chroot.adoc, d/control, d/genfstab.adoc, d/manpages, d/rules: Write manpages for the scripts and use asciidoctor to generate final output.

1 files changed, 63 insertions, 0 deletions

diff --git a/debian/arch-chroot.adoc b/debian/arch-chroot.adoc
new file mode 100644
index 0000000..61ecdbb
--- /dev/null
+++ b/debian/arch-chroot.adoc
@@ -0,0 +1,63 @@
+arch-chroot(1)
+==============
+:doctype: manpage
+
+NAME
+----
+arch-chroot - script to mount API filesystems like /proc and make /etc/resolv.conf available in a chroot
+
+
+SYNOPSIS
+--------
+*arch-chroot* ['option'] 'chroot-dir' ['command']
+
+
+OPTIONS
+-------
+*-h*::
+ Print the help message
+
+*-u* '<user>[:group]'::
+ Specify non-root user and optional group to use
+
+
+DESCRIPTION
+-----------
+Before *arch-chroot* runs */usr/bin/chroot*, the script mounts API filesystems
+like '/proc' and makes '/etc/resolv.conf' available in a chroot.
+
+The Debian version of this script also sets up '/usr/sbin/policy-rc.d' to
+disable autostart of daemons.
+
+If 'command' is unspecified, arch-chroot will launch */bin/bash*.
+
+
+EXAMPLES
+--------
+=== Enter a chroot ===
+
+Run arch-chroot with the new root directory as first argument:
+
+```
+arch-chroot /location/of/new/root
+```
+
+To exit the chroot simply use:
+
+```
+exit
+```
+
+=== Run a single command and exit ===
+
+To run a command in the chroot and exit again, append the command to the end of the line:
+
+```
+arch-chroot /location/of/new/root command
+```
+
+For example, to run *dpkg-configure -a* for a chroot located at '/media/testing' do:
+
+```
+arch-chroot /media/testing dpkg-configure -a
+```