new installation guide work in progress

1 files changed, 77 insertions, 208 deletions

diff --git a/doc/official_installation_guide_en b/doc/official_installation_guide_en
index 88c936b..f1cba56 100644
--- a/doc/official_installation_guide_en
+++ b/doc/official_installation_guide_en
@@ -1,207 +1,68 @@
-[][1]
-
-   [1]: /index.php/Main_Page (Visit the main page [z])
-
-  * [Download][2]
-
-  * [AUR][3]
-
-  * [Bugs][4]
-
-  * [Wiki][5]
-
-  * [Forums][6]
-
-  * [Home][7]
-
-   [2]: http://www.archlinux.org/download/
-
-   [3]: http://aur.archlinux.org/
-
-   [4]: http://bugs.archlinux.org/
-
-   [5]: http://wiki.archlinux.org/
-
-   [6]: http://bbs.archlinux.org/
-
-   [7]: http://www.archlinux.org/
-
 # Official Arch Linux Install Guide
 
-### From ArchWiki
-
-Jump to: [navigation][8], [search][9]
-
-   [8]: #column-one
-
-   [9]: #searchInput
-
-
 **Article summary**
 
 General installation documentation for the Arch Linux distribution.
 
-**Available Languages**
-
-** English**
-
-[ 简体中文][10]
-
-   [10]:
-/index.php/Arch_Linux_%E5%AE%98%E6%96%B9%E5%AE%89%E8%A3%85%E6%8C%87%E5%8D%97
-(Arch Linux 官方安装指南)
-
-[ 正體中文][11]
-
-   [11]:
-/index.php/Arch_Linux_%E5%AE%98%E6%96%B9%E5%AE%89%E8%A3%9D%E6%8C%87%E5%8D%97
-(Arch Linux 官方安裝指南)
-
-[ Česky][12]
-
-   [12]: /index.php/Ofici%C3%A1ln%C3%AD_instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C
-4%8Dka_(%C4%8Cesky) (Oficiální instalační příručka (Česky))
-
-[ Русский][13]
-
-   [13]: /index.php/%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%
-B2%D0%BE_%D0%BF%D0%BE_%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B5
-(Руководство по установке)
-
-[ Español][14]
-
-   [14]: /index.php/Gu%C3%ADa_oficial_de_Instalaci%C3%B3n (Guía oficial de
-Instalación)
-
-[ Italiano][15]
-
-   [15]: /index.php/Official_Arch_Linux_Install_Guide_(Italiano) (Official
-Arch Linux Install Guide (Italiano))
-
 **Related articles**
 
-[Beginners Guide][16] (If you are new to Arch)
-
-   [16]: /index.php/Beginners_Guide (Beginners Guide)
-
+[Beginners Guide](http://wiki.archlinux.org/index.php/Beginners_Guide "Beginners Guide") (If you are new to Arch)
 
 ## Contents
 
-  * [1 Introduction][17]
-
-   [17]: #Introduction
-
-    * [1.1 What is Arch Linux?][18]
-
-    * [1.2 License][19]
-
-   [18]: #What_is_Arch_Linux.3F
-
-   [19]: #License
-
-  * [2 Installing Arch Linux][20]
-
-   [20]: #Installing_Arch_Linux
-
-    * [2.1 Pre-Installation][21]
-
-    * [2.2 Acquiring Arch Linux][22]
-
-    * [2.3 Preparing the Installation Media][23]
-
-    * [2.4 Using the Install Media][24]
-
-    * [2.5 Common Installation Procedure][25]
-
-   [21]: #Pre-Installation
-
-   [22]: #Acquiring_Arch_Linux
-
-   [23]: #Preparing_the_Installation_Media
-
-   [24]: #Using_the_Install_Media
-
-   [25]: #Common_Installation_Procedure
-
-      * [2.5.1 Login and Loading a non-US Keymap][26]
-
-      * [2.5.2 Running Setup][27]
-
-      * [2.5.3 Select Source][28]
-
-   [26]: #Login_and_Loading_a_non-US_Keymap
-
-   [27]: #Running_Setup
-
-   [28]: #Select_Source
-
-        * [2.5.3.1 CD-ROM or OTHER SOURCE][29]
-
-        * [2.5.3.2 FTP/HTTP][30]
-
-   [29]: #CD-ROM_or_OTHER_SOURCE
-
-   [30]: #FTP.2FHTTP
-
-          * [2.5.3.2.1 Setup Network][31]
-
-          * [2.5.3.2.2 Choose Mirror][32]
-
-   [31]: #Setup_Network
-
-   [32]: #Choose_Mirror
-
-      * [2.5.4 Set Clock][33]
-
-      * [2.5.5 Prepare Hard Drive][34]
-
-   [33]: #Set_Clock
-
-   [34]: #Prepare_Hard_Drive
-
-        * [2.5.5.1 Auto-Prepare][35]
-
-        * [2.5.5.2 Partition Hard Drives][36]
-
-        * [2.5.5.3 Set Filesystem Mountpoints][37]
-
-   [35]: #Auto-Prepare
-
-   [36]: #Partition_Hard_Drives
-
-   [37]: #Set_Filesystem_Mountpoints
-
-      * [2.5.6 Select Packages][38]
-
-      * [2.5.7 Install Packages][39]
-
-      * [2.5.8 Configure System][40]
-
-      * [2.5.9 Install Bootloader][41]
-
-      * [2.5.10 Exit Install][42]
-
-   [38]: #Select_Packages
-
-   [39]: #Install_Packages
-
-   [40]: #Configure_System
-
-   [41]: #Install_Bootloader
-
-   [42]: #Exit_Install
-
-  * [3 Package Management][43]
-
-  * [4 APPENDIX][44]
-
-   [43]: #Package_Management
-
-   [44]: #APPENDIX
+  * [1 Introduction](#Introduction)
+    * [1.1 What is Arch Linux?](#What_is_Arch_Linux)
+    * [1.2 License](#License)
+
+  * [2 Pre-Installation](#Pre-Installation)
+      * [2.1 Architectures](#Architectures)
+      * [2.2 Available images](#Available_images)
+      * [2.3 AIF, the installation tool](#Aif_the_installation_tool) # explain aif, normal and partial procedures (but not really useful for most people)
+      * [2.4 Acquiring Arch Linux](#Acquiring_Arch_Linux)
+      * [2.5 Preparing the Installation Media](#Preparing_the_Installation_Media)
+ 
+  * [3 Installing Arch Linux](#Installing_Arch_Linux)
+    * [3.1 Using the Install Media](#Using_the_Install_Media)
+      * [3.1.1 Pre-boot](#Pre_boot)
+      * [3.1.2 Post-boot](#Post_boot) #login, keymap/font, network settings. prefer aif
+      * partial procedures over raw commands so settings will be reused
+      * later the installation.  "for your convenience, aif offers
+      * somepartial procedures which wrap around some basic functionality"everything is in /arch
+    * [3.2 Performing the installation](#Perform_install) #shortly desc 2 procedures
+      * [3.2.1 Interactive Installation Procedure](#Interactive_Installation_Procedure) #explain running setup here
+      * [3.2.1.1 Select Source](#Select_Source)
+        * [3.2.1.1.1 CD-ROM or OTHER SOURCE](#CD-ROM_or_OTHER_SOURCE)
+        * [3.2.1.1.2 NET (FTP/HTTP)](#NET)
+          * [3.2.1.1.2.1 Setup Network](#Setup_Network)
+          * [3.2.1.1.2.2 Choose Mirror](#Choose_Mirror)
+      * [3.2.1.2 Set Clock](#Set_Clock) #timezone, ntp or manual, localtime/utc hardwareclock
+      * [3.2.1.3 Prepare Hard Disks](#Prepare_Hard_Drive)
+        * [2.5.5.1 Auto-Prepare](#Auto-Prepare)
+        * [2.5.5.2 Manual](#Manual)
+          * [2.5.5.2.1 Manually partition](#Manual_partition)
+          * [2.5.5.2.2 Manually partition](#Manual_configure)
+        * [2.5.5.3 Rollbacks (optional)](#Rollback)
+      * [3.2.1.4 Select Packages](#Select_Packages)
+      * [3.2.1.5 Install Packages](#Install_Packages)
+      * [3.2.1.6 Configure System](#Configure_System)
+      * [3.2.1.7 Install Bootloader](#Install_Bootloader)
+      * [3.2.1.8 Exit Install](#Exit_Install)
+
+    * [3.2.2 Automatic Installation Procedure](#Automatic_Installation_Procedure)
+    * #explain what it is + examples
+       
+    * [3.2.3 Customizing Installations](#Customizing) #custom procedures, base yourself on automatic/interactive etc. see aif README
+
+* [4 Your new system](#Your_new_system)
+  #explain root pass, initramfs hooks, decryption
+
+* [5 More information](#More_information)
+  * [5.1 Package Management](#Package_Management)
+  * [5.2 Appendix](#Appendix)
 
 ##  Introduction
 
-###  What is Arch Linux?
+###  What is Arch Linux? ### {#What_is_Arch_Linux}
 
 Arch Linux is an independently developed i686 and x86_64 optimized Linux
 distribution that was originally based on ideas from CRUX. Development is
@@ -219,43 +80,45 @@ Arch Linux and scripts are copyright
 
 and are licensed under the GNU General Public License (GPL).
 
-##  Installing Arch Linux
+##  Pre-Installation
 
-###  Pre-Installation
+### Architectures
 
 Arch Linux is optimized for i686 and x86_64 processors and therefore will not
 run on any lower or incompatible generations of x86 CPUs (i386,i486 or i586).
 A Pentium II or AMD K6-2 processor or higher is required. Before installing
 Arch Linux, you should decide which installation method you would like to use.
-Arch Linux provides bootable ISO and USB disk images, using the GRUB
-bootloader. The ISO images will work on almost any machine with a CD-ROM
-drive, and the USB images will work on any system capable of booting from a
-USB drive. For those having problems with GRUB not loading, ISOs with the
-ISOLINUX bootloader are offered as well. There are two variants of each
-installation medium which only differ in terms of supplied packages.
+
+### Available images
+
+Arch Linux provides bootable images for:
+
+* CD-rom drives ( ISO format): works on almost any machine with a CD-ROM drive
+* USB disk images (raw format): works on any system capable of booting from a usb drive.
+
+The GRUB bootloader is used, but for those having problems with GRUB not loading
+with certain CD-rom drives, ISO images with the ISOLINUX bootloader are offered as well.
+There are two variants of each installation medium which only differ in terms of supplied packages.
 
   * The "core" images contain a snapshot of the core packages. These images
 are best suited for people who have an internet connection which is slow or
 difficult to set up.
 
-  * The "ftp" images contain no packages at all, and will use the network to
+  * The "net" images contain no packages at all, and will use the network to
 install packages. These images are preferred since you will end up with an up-
 to-date system and they are best suited for people with fast internet
 connections.
 
-You can instruct the installer to obtain the packages via FTP using either of
-these images, and all images can also be used as fully functioning recovery
+You can instruct the installer to obtain the packages via the internet (or
+any network) using either of these images, and all images can also be used as fully functioning recovery
 environments. The images run like any regular installed Arch Linux system. In
 fact, they're exactly the same, just installed to a CD or USB image instead of
 a hard disk. They include the entire "base" package set, as well as various
 networking utilities and drivers. If there's something else you happen to need
 at runtime, just get your Internet connection up and install it using pacman.
-A short pacman command reference is available at the end of this document. The
-most common (and recommended) installation procedure is to use the install
-media to initially install only the "base" package set and whatever utilities
-and drivers you need to get online. Then once you've successfully booted the
-installed system, run a full system upgrade and install any other packages you
-want.
+A short pacman command reference is available at the end of this document.
+
+#### Installation tool
 
 ###  Acquiring Arch Linux
 
@@ -333,7 +196,13 @@ all, you'll probably want to use the quickinst script. You will have to
 configure the system afterwards since no form of auto-configuration takes
 place.
 
-###  Common Installation Procedure
+### Interactive Installation Procedure
+ The
+most common (and recommended) installation procedure is to use the install
+media to initially install only the "base" package set and whatever utilities
+and drivers you need to get online. Then once you've successfully booted the
+installed system, run a full system upgrade and install any other packages you
+want.
 
 **Installation Steps:**