install: Structure out the rest of the Handbook

12 files changed, 123 insertions, 21 deletions

diff --git a/src/install/1_begin.xml b/src/install/1_begin.xml
index a58893a..d3d78a8 100644
--- a/src/install/1_begin.xml
+++ b/src/install/1_begin.xml
@@ -2,10 +2,10 @@
 <chapter label="1" id="begin">
     <title>Before You Begin</title>
     <para>Welcome to the Adélie Linux 1.0 Installation Handbook.
-        This Handbook will inform you how to install Adélie Linux on your computer.</para>
+        This Handbook describes the process of installing Adélie Linux on your computer.</para>
     <para>If you are installing Adélie Linux on your main computer, you may use another device - such as a mobile phone or a friend's laptop, if available - to reference this Handbook.
-        Additionally, most of this Handbook is available for reading during installation.
-        Just choose "Help", or press the <keycap>F1</keycap> key, from any page in the System Installation wizard.</para>
+        Additionally, most of the contents of this Handbook are available for reading during the installation process.
+        Simply choose "Help", or press the <keycap>F1</keycap> key, from any System Installation screen.</para>
     <section>
         <title>Preparing for Installation</title>
         <para>Please back up all of your data before beginning installation.
@@ -22,10 +22,10 @@
             Most servers default to either 9600 or 115200 baud; Adélie Linux does not reconfigure the serial line, so you will need to know your firmware's default settings.</para>
         <para>If you plan on connecting to the Internet directly from your Adélie Linux computer without using a router (not common),
             ensure you have your Internet access credentials (typically a username and password) available before starting installation.
-            Adélie Linux supports connecting to most ADSL and dial-up Internet providers using PPP; and cable, T1, and fibre providers using Ethernet.
-            If you use a static IP address (not common), make sure you have your IP address, subnet, and default gateway and nameserver settings before starting installation.</para>
-        <para>If your computer came with recovery media, we recommend that you have it available in the very unlikely event you have an issue with Adélie Linux, or your hardware is incompatible.
-            Having your recovery media will allow you to quickly restore your computer to normal operation.</para>
+            Adélie Linux supports connecting to most ADSL providers using PPPoE; and most other Internet providers using Ethernet or Wi-Fi.
+            If you use a static IP address (not common), make sure you have your IP address, subnet, default gateway, and nameserver settings before starting installation.</para>
+        <para>If your computer came with recovery media, we recommend that you have it available in the very unlikely event you have an issue using the Adélie Linux system, or if your hardware is incompatible.
+            Having your recovery media will allow you to quickly restore your computer to its original state.</para>
     </section>
     <section id="media">
         <title>Creating the installation media</title>
@@ -34,8 +34,8 @@
             <listitem><para>a <hardware>CD drive</hardware> capable of writing (or "burning") a CD, and a blank CD; or</para></listitem>
             <listitem><para>a blank <hardware>USB flash drive</hardware>.</para></listitem>
         </itemizedlist>
-        <para>Download the installation media file from your local Adélie Linux mirror at <ulink url="https://distfiles.adelielinux.org/adelie/">https://distfiles.adelielinux.org/adelie/</ulink>.
-            Follow the instructions on the mirror's site to choose the media file appropriate for your computer.
+        <para>Download the installation media file from <ulink url="https://www.adelielinux.org/download">https://wwww.adelielinux.org/download</ulink>.
+            Follow the instructions to choose the media file appropriate for your computer.
             Then, follow the steps below for your current operating environment.</para>
         <section>
             <title>Using Windows</title>
diff --git a/src/install/2_req.xml b/src/install/2_req.xml
index 8f14692..e44b4a4 100644
--- a/src/install/2_req.xml
+++ b/src/install/2_req.xml
@@ -26,7 +26,7 @@
         </formalpara>
         <formalpara id="ppc64">
             <title>PowerPC (64-bit)</title>
-            <para>You will need a POWER4+, or 970/970fx, or later generation CPU.  You cannot use Adélie Linux on a POWER4 or earlier CPU.  The Freescale e5500/e6500 and SPE processors do not have the required AltiVec/VMX extensions, and therefore will also not be able to run the 64-bit Adélie Linux.</para>
+            <para>You will need a POWER4+, or 970/970fx, or later generation CPU.  You cannot use Adélie Linux on a POWER4 or earlier CPU.  Note that the Freescale e5500 processor does not have the AltiVec/VMX extension required to run Adélie Linux.</para>
         </formalpara>
         <formalpara id="aarch64">
             <title>AArch64 (64-bit ARM)</title>
diff --git a/src/install/4_options.xml b/src/install/4_options.xml
new file mode 100644
index 0000000..316f19f
--- /dev/null
+++ b/src/install/4_options.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter label="4" id="options">
+    <title>Selecting System Options</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</chapter>
diff --git a/src/install/5_commit.xml b/src/install/5_commit.xml
new file mode 100644
index 0000000..91d4edf
--- /dev/null
+++ b/src/install/5_commit.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter label="5" id="commit">
+    <title>Installing System Software</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</chapter>
diff --git a/src/install/6_notes.xml b/src/install/6_notes.xml
new file mode 100644
index 0000000..15ad5c9
--- /dev/null
+++ b/src/install/6_notes.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter label="6" id="notes">
+    <title>Post-Installation Notes</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</chapter>
diff --git a/src/install/7_scripts.xml b/src/install/7_scripts.xml
new file mode 100644
index 0000000..03f77d9
--- /dev/null
+++ b/src/install/7_scripts.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter label="7" id="scripts">
+    <title>Creating and Managing HorizonScripts</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</chapter>
diff --git a/src/install/8_network.xml b/src/install/8_network.xml
new file mode 100644
index 0000000..22903b0
--- /dev/null
+++ b/src/install/8_network.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter label="8" id="network">
+    <title>Deploying Adélie Linux Using a Network</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</chapter>
diff --git a/src/install/9_image.xml b/src/install/9_image.xml
new file mode 100644
index 0000000..f178334
--- /dev/null
+++ b/src/install/9_image.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter label="9" id="image">
+    <title>Creating Images</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</chapter>
diff --git a/src/install/a_arch.xml b/src/install/a_arch.xml
new file mode 100644
index 0000000..33b3314
--- /dev/null
+++ b/src/install/a_arch.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appendix label="a" id="arch">
+    <title>Architecture-Specific Information</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</appendix>
diff --git a/src/install/b_help.xml b/src/install/b_help.xml
new file mode 100644
index 0000000..0ead88f
--- /dev/null
+++ b/src/install/b_help.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appendix label="b" id="help">
+    <title>If You Need Help</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</appendix>
diff --git a/src/install/c_advanced.xml b/src/install/c_advanced.xml
new file mode 100644
index 0000000..93a76b9
--- /dev/null
+++ b/src/install/c_advanced.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appendix label="c" id="advanced">
+    <title>Installing Adélie Linux from a Command Line</title>
+    <section>
+        <title/>
+        <para/>
+    </section>
+</appendix>
diff --git a/src/install/installbook.xml b/src/install/installbook.xml
index 2074230..c3f9e8b 100644
--- a/src/install/installbook.xml
+++ b/src/install/installbook.xml
@@ -5,6 +5,15 @@
                <!ENTITY chap1 SYSTEM "1_begin.xml">
                <!ENTITY chap2 SYSTEM "2_req.xml">
                <!ENTITY chap3 SYSTEM "3_beginning.xml">
+               <!ENTITY chap4 SYSTEM "4_options.xml">
+               <!ENTITY chap5 SYSTEM "5_commit.xml">
+               <!ENTITY chap6 SYSTEM "6_notes.xml">
+               <!ENTITY chap7 SYSTEM "7_scripts.xml">
+               <!ENTITY chap8 SYSTEM "8_network.xml">
+               <!ENTITY chap9 SYSTEM "9_image.xml">
+               <!ENTITY appA SYSTEM "a_arch.xml">
+               <!ENTITY appB SYSTEM "b_help.xml">
+               <!ENTITY appC SYSTEM "c_advanced.xml">
 ]>
 <book>
     <bookinfo>
@@ -12,7 +21,7 @@
         <author>
             <personname><firstname>A.</firstname><surname>Wilcox</surname></personname>
         </author>
-        <copyright><year>2015</year><year>2018</year><year>2019</year><holder>Adélie Linux</holder></copyright>
+        <copyright><year>2015</year><year>2018</year><year>2019</year><year>2020</year><holder>Adélie Linux</holder></copyright>
     </bookinfo>
     <preface>
         <title>Preface</title>
@@ -22,14 +31,35 @@
         <para>– A. Wilcox, 2019</para>
 	&helping;
     </preface>
-    &chap1;
-    &chap2;
-    &chap3;
-    <!--
-    <xi:include href="4_options.xml" />
-    <xi:include href="5_commit.xml" />
-    <xi:include href="6_notes.xml" />
-    <xi:include href="a_arch.xml" />
-    <xi:include href="b_help.xml" />
-    <xi:include href="c_advanced.xml" /> -->
+    <part label="I" id="user">
+        <title>Installing to a Single Computer</title>
+        <partintro>
+            <para>The chapters in Part I describe how to install Adélie Linux to a single computer.  Most users will use this part.
+                You should refer to Part II if you are deploying Adélie Linux in a large environment using the Horizon system.</para>
+        </partintro>
+        &chap1;
+        &chap2;
+        &chap3;
+        &chap4;
+        &chap5;
+        &chap6;
+    </part>
+    <part label="II" id="deploy">
+        <title>Deploying Adélie Linux</title>
+        <partintro>
+            <para>The chapters in Part II describe how to use the Horizon system to deploy Adélie Linux, or another APK-based Linux distribution, to multiple systems.</para>
+        </partintro>
+        &chap7;
+        &chap8;
+        &chap9;
+    </part>
+    <part label="III" id="appendices">
+        <title>Appendices</title>
+        <partintro>
+            <para>These chapters contain ancillary information for users and administrators installing Adélie Linux.</para>
+        </partintro>
+        &appA;
+        &appB;
+        &appC;
+    </part>
 </book>