Devel, Install: fix up typos (thanks @dimitsos) and structure (thanks me)

5 files changed, 16 insertions, 29 deletions

diff --git a/src/devel/2_nonpkg.xml b/src/devel/2_nonpkg.xml
index c844be9..778d8b0 100644
--- a/src/devel/2_nonpkg.xml
+++ b/src/devel/2_nonpkg.xml
@@ -17,13 +17,13 @@
         </section>
         <section>
             <title>Configuring Your Environment</title>
-            <para>You will need to install the <package>xmlto</package> package to ensure your changes leave the documentation syntatically valid.  After making your changes, run the <command>xmlto</command> command on the primary file (for this guide, <filename>develguide.xml</filename>) and ensure there are no errors.</para>
+            <para>You will need to install the <package>xmlto</package> package to ensure your changes leave the documentation syntactically valid.  After making your changes, run the <command>xmlto</command> command on the primary file (for this guide, <filename>develguide.xml</filename>) and ensure there are no errors.</para>
         </section>
     </section>
     <section>
         <title>Spread the Word</title>
         <para>There are many ways to spread the word about Adélie Linux.
-            Talk to your friends about Adélie Linux and the benefits of libre software, including security, speed, and less need to purchase new computers every year.
+            Talk to your friends about Adélie Linux and the benefits of libre software, including security, speed, control, and ability to use the latest features without purchasing new computers every year.
             Have civil discussions on forums, newsgroups, and social media.
             If you're a student, talk to your school's Computer Science department and see if they are interested in a lab with Adélie Linux.
             By spreading the word, you're helping more people learn and spreading our ideas and goals worldwide.  Thank you!</para>
diff --git a/src/devel/3_git.xml b/src/devel/3_git.xml
index 73e3522..6124a78 100644
--- a/src/devel/3_git.xml
+++ b/src/devel/3_git.xml
@@ -48,7 +48,7 @@
         </itemizedlist>
         <section>
             <title>Using Branches</title>
-            <para>A <firstterm>branch</firstterm> is a self-contained copy of a project's files.  Using branches allow your changes to be reviewed quickly and, if approved, merged in to the Adélie Linux source quickly.
+            <para>A <firstterm>branch</firstterm> is a self-contained copy of a project's files.  Using branches allows your changes to be reviewed quickly and, if approved, merged in to the Adélie Linux source quickly.
                 A branch should be a single "unit of work".  That is, a branch should have a single goal in mind.  Sometimes a branch can contain many commits; for instance, your goal may be "update the Gnome Office packages".  In that case, you would have at least one commit for each Gnome Office package.
                 However, sometimes a branch only needs one commit.  This can be useful for simple bug fixes, or bumping a single package's version.</para>
             <para>Branches should have a name that reflects their goal.  A branch name such as <literal>bugfix</literal> or <literal>version</literal> is unclear and doesn't communicate the goal of the branch.  A branch name such as <literal>gnumeric-1.12.35-update</literal> or <literal>fix-boot-on-g3</literal> is clear and concisely states the branch goal.</para>
diff --git a/src/devel/develbook.xml b/src/devel/develbook.xml
index 26b4435..b5eefdb 100644
--- a/src/devel/develbook.xml
+++ b/src/devel/develbook.xml
@@ -21,7 +21,7 @@
     <preface>
         <title>Preface</title>
         <para>This Developer's Handbook is the official documentation for developing the Adélie Linux 1.0 system.  It is designed for developers interested in working on the distribution itself; for general information on programming your computer running the Adélie Linux system, see the User's Handbook chapter "Getting started with programming".</para>
-        <para>Many contributed to the final version of the Handbook.  This includes <personname><firstname>Natanael</firstname><surname>Copa</surname></personname> and <personname><firstname>Timo</firstname><surname>Teras</surname></personname> from Alpine Linux.</para>
+        <para>Many contributed to the final version of the Handbook.  This includes <personname><firstname>Natanael</firstname><surname>Copa</surname></personname> and <personname><firstname>Timo</firstname><surname>Teräs</surname></personname> from Alpine Linux.</para>
         <para>It is assumed that you, the reader, are familiar with using a terminal or command line interface, the use of Unix commands, and the compilation of software.  If you are not yet familiar with these concepts, start with our User's Handbook, which will assist you in learning them.</para>
         <para>Please also ensure that you are comfortable and properly rested before reading this handbook.  This will allow you to learn quicker, and be able to recall the information you have learned easier.</para>
         <para>It is hoped by the author that you find this handbook easy to understand and read.  Please feel free to contact me or the Adélie Linux community if you have any suggestions on how to make this handbook better.  We'd love to hear from you, and we hope you enjoy using our distribution.</para>
diff --git a/src/install/2_req.xml b/src/install/2_req.xml
index 0583943..fde3f00 100644
--- a/src/install/2_req.xml
+++ b/src/install/2_req.xml
@@ -7,40 +7,27 @@
     </para>
     <section>
         <title>Intel x86 (32-bit)</title>
-        <para>You will need at least a Pentium or Celeron CPU, with MMX extensions. Speeds of at least 500 MHz are highly recommended for running desktop applications, but speeds as low as 100 MHz may be usable in server mode.</para>
-        <para>At least 256 MB RAM is required to install the desktop version of Adélie Linux, and at least 512 MB RAM is highly recommended if you plan to run larger applications like Firefox and Thunderbird.
-            At least 40 MB RAM is required to install the server version of Adélie Linux.
-            <warning><para>Using less than 40 MB RAM may cause lock ups or crashes during package installation.</para></warning>
-        </para>
-        <para>At least 3 GB of disk space is required for a full desktop installation of Adélie Linux.
-            The base server installation of Adélie Linux requires about 300 MB of disk space, not counting additional packages and your data.
-            It is recommended that you have at least 1 GB of disk space for most server roles.</para>
+        <para>You will need at least a Pentium or Celeron compatible CPU, with MMX extensions.  This includes most AMD (K5+), Transmeta, VIA, and other x86-compatible CPUs.  Speeds of at least 500 MHz are highly recommended for running desktop applications, but speeds as low as 100 MHz may be usable in server mode.</para>
+        <para>At least 256 MB RAM is required to install the desktop version of Adélie Linux, and at least 512 MB RAM is highly recommended if you plan to run larger applications like Firefox and Thunderbird.  At least 40 MB RAM is required to install the server version of Adélie Linux.</para>
+        <warning><title>Warning</title><para>Using less than 40 MB RAM may cause lock ups or crashes during package installation.</para></warning>
+        <para>At least 3 GB of disk space is required for a full desktop installation of Adélie Linux.  The base server installation of Adélie Linux requires about 300 MB of disk space, not counting additional packages and your data.  It is recommended that you have at least 1 GB of disk space for most server roles.</para>
     </section>
     <section>
         <title>Intel x86_64 (64-bit)</title>
         <para>All Intel CPUs that have 64-bit extensions are supported by the Adélie Linux kernel and software distribution.</para>
-        <para>At least 256 MB RAM is required to install the desktop version of Adélie Linux, and at least 512 MB RAM is highly recommended if you plan to run larger applications like Firefox and Thunderbird.
-            At least 48 MB RAM is required to install the server version of Adélie Linux.
-            <warning><para>Using less than 48 MB RAM may cause lock ups or crashes during package installation.</para></warning>
-        </para>
-        <para>At least 3 GB of disk space is required for a full desktop installation of Adélie Linux.
-            The base server installation of Adélie Linux requires about 270 MB of disk space, not counting additional packages and your data.
-            It is recommended that you have at least 1 GB of disk space for most server roles.</para>
+        <para>At least 256 MB RAM is required to install the desktop version of Adélie Linux, and at least 512 MB RAM is highly recommended if you plan to run larger applications like Firefox and Thunderbird.  At least 48 MB RAM is required to install the server version of Adélie Linux.</para>
+        <warning><title>Warning</title><para>Using less than 48 MB RAM may cause lock ups or crashes during package installation.</para></warning>
+        <para>At least 3 GB of disk space is required for a full desktop installation of Adélie Linux.  The base server installation of Adélie Linux requires about 270 MB of disk space, not counting additional packages and your data.  It is recommended that you have at least 1 GB of disk space for most server roles.</para>
     </section>
     <section>
         <title>PowerPC (32-bit)</title>
-        <para>You will need at least a G3 CPU. The 603 series is not supported by this version of Adélie Linux.
-            Speeds of at least 600 MHz are highly recommended for running desktop applications, but all G3 and G4 CPUs are supported.</para>
-        <para>At least 3 GB of disk space is required for a full desktop installation of Adélie Linux.
-            The base server installation of Adélie Linux requires about 200 MB of disk space, not counting additional packages and your data.
-            It is recommended that you have at least 1 GB of disk space for most server roles.</para>
+        <para>You will need at least a G3 CPU.  The 603 series is not supported by this version of Adélie Linux.  Speeds of at least 600 MHz are highly recommended for running desktop applications, but all G3 and G4 CPUs are supported.  AltiVec/VMX is not required to run Adélie, but some packages may perform much better on systems that have these extensions.</para>
+        <para>At least 3 GB of disk space is required for a full desktop installation of Adélie Linux.  The base server installation of Adélie Linux requires about 200 MB of disk space, not counting additional packages and your data.  It is recommended that you have at least 1 GB of disk space for most server roles.</para>
     </section>
     <section>
         <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.</para>
-        <para>At least 3 GB of disk space is required for a full desktop installation of Adélie Linux.
-            The base server installation of Adélie Linux requires about 200 MB of disk space, not counting additional packages and your data.
-            It is recommended that you have at least 1 GB of disk space for most server roles.</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.  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>At least 3 GB of disk space is required for a full desktop installation of Adélie Linux.  The base server installation of Adélie Linux requires about 200 MB of disk space, not counting additional packages and your data.  It is recommended that you have at least 1 GB of disk space for most server roles.</para>
     </section>
     <section>
         <title>AArch64 (64-bit ARM)</title>
diff --git a/src/install/installbook.xml b/src/install/installbook.xml
index e7ebbf8..7556119 100644
--- a/src/install/installbook.xml
+++ b/src/install/installbook.xml
@@ -15,7 +15,7 @@
     <preface>
         <title>Preface</title>
         <para>This Installation Handbook is the full, official documentation for installing Adélie Linux 1.0 on a supported computer, including special architecture-specific notes and a bootstrap installation from another distribution.  It was initially drafted with a section outline in 2015, before the distribution itself was even created.  It is hoped by the author that you find this handbook easy to understand and read.</para>
-        <para>Many contributed to the final version of the Handbook.  This includes <personname><othername>[[sroracle]]</othername></personname> and <personname><othername>smauel</othername></personname> on the Adélie IRC channel, whom tested the instructions on their machines and reported omissions and corrections.  <!-- more.. --></para>
+        <para>Many contributed to the final version of the Handbook.  This includes <personname><othername>[[sroracle]]</othername></personname> and <personname><othername>smaeul</othername></personname> on the Adélie IRC channel, whom tested the instructions on their machines and reported omissions and corrections.  <!-- more.. --></para>
         <para>Please feel free to contact me or the Adélie Linux community if you have any suggestions on how to make this handbook better.  We'd love to hear from you, and we hope you enjoy using our distribution.</para>
         <para>– A. Wilcox, 2018</para>
     </preface>