doc/install/jail: Rename to doc/install/chroot

1 files changed, 45 insertions, 0 deletions

diff --git a/doc/install/chroot.mdwn b/doc/install/chroot.mdwn
new file mode 100644
index 0000000..35020b0
--- /dev/null
+++ b/doc/install/chroot.mdwn
@@ -0,0 +1,45 @@
+[[!meta title="Isolated File System Environment Installation"]]
+
+[[←_Back_to_Installing_ProteanOS|doc/install]]
+
+These instructions explain how to install ProteanOS into a directory on an
+existing host system to run under an isolated file system environment, or
+"jail", using prokit, the ProteanOS Development Kit.  prokit will run ProteanOS
+using the **chroot**(2) system call via the **chroot**(8) wrapper program.
+
+It is assumed that you have already
+[[built_and_optionally_installed_prokit|doc/install/prokit]].
+
+
+Installing ProteanOS
+====================
+
+First decide which "suite" of ProteanOS you wish to install.  Currently only one
+suite is available: `dev/trunk`.
+
+Next decide where to install ProteanOS.  Replace `$root` below with the path to
+which you want ProteanOS installed.
+
+If you installed prokit to your system, simply run:
+
+    $ sudo prokit install dev/trunk $root
+
+Otherwise, from your prokit build directory, run:
+
+    $ sudo src/prokit install dev/trunk $root
+
+Next Steps
+==========
+
+Familiarize yourself with the ProteanOS Development Kit Manual, if you haven't
+already.  The **prokit-shell**(8) and **prokit-opkg**(8) commands are used to
+manage installed ProteanOS systems.
+
+If you'd like to develop packages for ProteanOS, you need to install the
+`build-essential` package (again replacing `prokit` with `src/prokit` if you
+haven't installed prokit):
+
+    $ sudo prokit opkg $root install build-essential
+
+This may take a while, depending on your network connection.  Then you can start
+[[learning_how_to_prepare_packages|doc/pkg]]!