Edits as per andy's feedback

10 files changed, 26 insertions, 26 deletions

diff --git a/FIRMWARE.textile b/FIRMWARE.textile
index f53518f..68e142c 100644
--- a/FIRMWARE.textile
+++ b/FIRMWARE.textile
@@ -1,4 +1,4 @@
-It is advised that you update your Versatile Express board firmware to the latest version. To update your VE board firmware, please follow the instructions below:
+Ensure that you update your Versatile Express board firmware to the latest version. To update your VE board firmware, please follow the instructions below:
 
 * Install the Recovery firmware from the v4.0b VE CD/DVD that came with your Versatile Express
 * Connect and mount your Versatile Express motherboard USB mass storage device to your PC
@@ -12,4 +12,4 @@ It is advised that you update your Versatile Express board firmware to the lates
 
 * Unmount the Versatile Express motherboard
 * Reboot the Versatile Express board
-** If the board is configured for UEFI, you will need to configure it to boot from the image that you've created.  See the "UEFI page":https://wiki.linaro.org/ARM/UEFI on the Linaro Wiki for more details on configuring UEFI.
+** If the board is configured for UEFI, you will need to configure it to boot from the image that you've created.  See the "UEFI page":https://wiki.linaro.org/ARM/UEFI#Configure_UEFI on the Linaro Wiki for more details on configuring UEFI.
diff --git a/HACKING.textile b/HACKING.textile
index 69eb0cb..4d41295 100644
--- a/HACKING.textile
+++ b/HACKING.textile
@@ -13,7 +13,7 @@ bc. sudo apt-get install build-essential git gcc-arm-linux-gnueabi
 
 h2. Get the source
 
-You can use GIT to obtain the source code:
+You can use GIT to obtain the kernel source code for this release:
 
 bc. git clone git://git.linaro.org/kernel/linux-linaro-tracking.git
 cd linux-linaro-tracking
diff --git a/HOWTO_flashfirmware.txt b/HOWTO_flashfirmware.txt
index f53518f..68e142c 100644
--- a/HOWTO_flashfirmware.txt
+++ b/HOWTO_flashfirmware.txt
@@ -1,4 +1,4 @@
-It is advised that you update your Versatile Express board firmware to the latest version. To update your VE board firmware, please follow the instructions below:
+Ensure that you update your Versatile Express board firmware to the latest version. To update your VE board firmware, please follow the instructions below:
 
 * Install the Recovery firmware from the v4.0b VE CD/DVD that came with your Versatile Express
 * Connect and mount your Versatile Express motherboard USB mass storage device to your PC
@@ -12,4 +12,4 @@ It is advised that you update your Versatile Express board firmware to the lates
 
 * Unmount the Versatile Express motherboard
 * Reboot the Versatile Express board
-** If the board is configured for UEFI, you will need to configure it to boot from the image that you've created.  See the "UEFI page":https://wiki.linaro.org/ARM/UEFI on the Linaro Wiki for more details on configuring UEFI.
+** If the board is configured for UEFI, you will need to configure it to boot from the image that you've created.  See the "UEFI page":https://wiki.linaro.org/ARM/UEFI#Configure_UEFI on the Linaro Wiki for more details on configuring UEFI.
diff --git a/HOWTO_getsourceandbuild.txt b/HOWTO_getsourceandbuild.txt
index 7ae3c20..3fadc6b 100644
--- a/HOWTO_getsourceandbuild.txt
+++ b/HOWTO_getsourceandbuild.txt
@@ -6,7 +6,7 @@ Run the "linaro_android_build_cmds.sh":http://releases.linaro.org/12.10/android/
 
 The pinned and source manifests can be found here:
 
-* "Pinned Manifest":http://releases.linaro.org/12.10/android/vexpress/pinned-manifest.xml
+* "Pinned Manifest":http://releases.linaro.org/12.10/android/vexpress/pinned-manifest.xml ("?":https://wiki.linaro.org/Platform/Android/ReproduceABuildExactly)
 * "Source Manifest":http://releases.linaro.org/12.10/android/vexpress/source-manifest.xml
 
 h2. Kernel Source Code
@@ -54,7 +54,7 @@ sudo linaro-android-media-create --mmc /dev/sdX --dev vexpress --boot boot.tar.b
 
 * Insert the SD card into your Versatile Express board and reboot it
 
-p. If UEFI is already configured to boot a Linaro Android image, it will boot from the SD card. If not, follow the instructions in the section: “Configure UEFI” found on the Linaro wiki "here":https://wiki.linaro.org/ARM/UEFI.
+p. If UEFI is already configured to boot a Linaro Android image, it will boot from the SD card. If not, follow the instructions in the section: “Configure UEFI”:https://wiki.linaro.org/ARM/UEFI#Configure_UEFI found on the Linaro wiki.
 
 h2. Compiling and installing your Kernel
 
diff --git a/HOWTO_install.txt b/HOWTO_install.txt
index 698b805..e2797b6 100644
--- a/HOWTO_install.txt
+++ b/HOWTO_install.txt
@@ -23,9 +23,9 @@ h3. Installation Steps
 
 bc. dmesg
 SDCARD=/dev/sdX # sdcard found from dmesg above
-sudo dd bs=64k if=vexpress.img of=$SDCARD
+zcat vexpress.img.bz2 | sudo dd bs=64k of=$SDCARD
 
-* Insert the SD card into the board
+* After the media create tool has finished executing, remove the SD card from your PC and insert it into the Versatile Express board
 * Reboot the board
 ** Wait until you are presented with the “Cmd>" prompt before pressing the red button
 
@@ -78,6 +78,6 @@ Or, if your machine uses @'/dev/mmcblkX'@, you may see a line line this:
 
 bc. linaro-android-media-create --mmc /dev/sdX --dev vexpress --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
 
-* Insert the SD card into the board
+* After the media create tool has finished executing, remove the SD card from your PC and insert it into the Versatile Express board
 * Reboot the board
 ** Wait until you are presented with the “Cmd>" prompt before pressing the red button
diff --git a/HOWTO_releasenotes.txt b/HOWTO_releasenotes.txt
index deb1d9e..a14d646 100644
--- a/HOWTO_releasenotes.txt
+++ b/HOWTO_releasenotes.txt
@@ -28,8 +28,7 @@ Cluster and asymmetric system support
 
 Platform Support. In addition to the big.LITTLE MP work the TC2 platform support includes
 ** CPUidle & CPUfreq support
-** hwmon driver allowing, amongst other things, TC2's power, current and
-energy measurements to be read through standard sysfs interfaces
+** hwmon driver allowing, amongst other things, TC2's power, current andepatnergy measurements to be read through standard sysfs interfaces
 ** Common clocks implementation
 ** Regulator driver
 ** Drivers for previously hard-coded configuration interfaces
diff --git a/HOWTO_rtsm.txt b/HOWTO_rtsm.txt
index 63ae8e5..77c1d7c 100644
--- a/HOWTO_rtsm.txt
+++ b/HOWTO_rtsm.txt
@@ -1,3 +1,5 @@
+This release was boot tested on RTSM A15x4 and A15x4-A7x4 models. No rigorous testing was carried out. This build is expected to run on other RTSM models.
+
 h2. Prerequisites
 
 * Install the RTSM model(s) you wish to run. You must have a valid license and the environment set up to run models
@@ -25,7 +27,7 @@ bc. wget http://releases.linaro.org/12.10/components/platform/linaro-image-tools
 
 h2. Create a 2GB image file
 
-RTSM will only deal with file systems up to 2GB in size, however the pre-built image for Android requires a 4GB filesystem. Therefore, we will build our own image using the pre-built artifacts (displayed above)
+RTSM will only deal with file systems up to 2GB in size, however the Linaro pre-built image for Android requires a 4GB filesystem. Therefore, we will build our own image using the pre-built artifacts (displayed above)
 
 The following command downloads all the Android OS components necessary to make up a complete Android image.
 
diff --git a/INSTALL.textile b/INSTALL.textile
index 3e58905..e6e8de9 100644
--- a/INSTALL.textile
+++ b/INSTALL.textile
@@ -15,7 +15,7 @@ h2. Using pre-built image
 
 h3. Prerequisites
 
-* Ubuntu 12.04 64 bit or newer on your desktop PC (www.ubuntu.com)
+* Ubuntu 12.04 64 bit or newer on your desktop PC ("www.ubuntu.com":http://www.ubuntu.com)
 * 4GB SD card or larger
 * Latest firmware installed onto the Versatile Express. Please see "Firmware Update" tab
 * This release pre-built image (vexpress-precise_ubuntu-desktop_20121021-377.img.gz), which you can downloaded from the above list of artifacts or from "here":http://releases.linaro.org/12.10/ubuntu/vexpress/vexpress-precise_ubuntu-desktop_20121021-377.img.gz
@@ -29,7 +29,7 @@ bc. dmesg
 SDCARD=/dev/sdX # sdcard found from dmesg above
 zcat vexpress-precise_ubuntu-desktop_20121021-377.img.gz | sudo dd bs=64k of=$SDCARD
 
-** Insert the SD card into the board
+** After the media create tool has finished executing, remove the SD card from your PC and insert it into the Versatile Express board
 ** Reboot the board
 *** When prompsed with “Cmd>" prompt, press the red reboot button
 
@@ -48,13 +48,11 @@ h3. Prerequisites
 * Ubuntu 12.04 64 bit or newer on your desktop PC ("www.ubuntu.com":http://www.ubuntu.com)
 * Download Artifacts from above or use the following command in your terminal
 
-* Download artifacts from above or use the following command in your terminal
-
 *Note:* The instructions above attempt to build an Ubuntu Desktop image. If you wish to create a small image, you can replace the ubuntu desktop tar ball with another root file system, which you can download from "here":http://releases.linaro.org/12.10/ubuntu/precise-images
 bc. wget http://releases.linaro.org/12.10/ubuntu/vexpress/hwpack_linaro-vexpress_20121021-377_armhf_supported.tar.gz
 wget http://releases.linaro.org/12.10/ubuntu/vexpress/linaro-precise-ubuntu-desktop-20121021-492.tar.gz
 
-* Get "Linaro image tools":https://wiki.linaro.org/Linaro-Image-Tools. There are multiple ways you can get the latest Linaro Image Tools:
+Get "Linaro image tools":https://wiki.linaro.org/Linaro-Image-Tools. There are multiple ways you can get the latest Linaro Image Tools:
 
 ** Method 1: Install them from the Linaro Image Tools "PPA":https://launchpad.net/~linaro-maintainers/+archive/tools
 
@@ -62,9 +60,9 @@ bc. sudo add-apt-repository ppa:linaro-maintainers/tools
 sudo apt-get update
 sudo apt-get install linaro-image-tools
 
-** Method 2: Building from source
+** Method 2: Building from source </LI>
 
-bc. wget http://releases.linaro.org/12.10/components/platform/linaro-image-tools/linaro-image-tools-2012.10.tar.gz
+bc. wget http://releases.linaro.org/12.10/components/platform/linaro-image-tools/linaro-image-tools-2012.10.tar.gz@
 
 * Insert SD card and note the assigned @'/dev/sdX'@ or @'/dev/mmcblk0'@
 
@@ -84,5 +82,5 @@ Or, if your machine uses '/dev/mmcblkX', you may see a line line this:
 
 bc. sudo linaro-media-create --mmc /dev/sdX --dev vexpress --hwpack hwpack_linaro-vexpress_20121021-377_armhf_supported.tar.gz --binary linaro-precise-ubuntu-desktop-20121021-492.tar.gz
 
-** Insert the SD card into the board
+** After the media create tool has finished executing, remove the SD card from your PC and insert it into the Versatile Express board
 ** Reboot the board. When presented with “Cmd>" prompt, press the red button
diff --git a/README.textile b/README.textile
index d9a5797..f4b51b1 100644
--- a/README.textile
+++ b/README.textile
@@ -28,8 +28,7 @@ Cluster and asymmetric system support
 
 Platform Support. In addition to the big.LITTLE MP work the TC2 platform support includes
 ** CPUidle & CPUfreq support
-** hwmon driver allowing, amongst other things, TC2's power, current and
-energy measurements to be read through standard sysfs interfaces
+** hwmon driver allowing, amongst other things, TC2's power, current andenergy measurements to be read through standard sysfs interfaces
 ** Common clocks implementation
 ** Regulator driver
 ** Drivers for previously hard-coded configuration interfaces
diff --git a/RTSM.textile b/RTSM.textile
index 5179068..d5d1f7f 100644
--- a/RTSM.textile
+++ b/RTSM.textile
@@ -1,3 +1,5 @@
+This release was boot tested on RTSM A15x4 and A15x4-A7x4 models. No rigorous testing was carried out. This build is expected to run on other RTSM models.
+
 h2. Prerequisites
 
 * Install the RTSM model(s) you wish to run. You must have a valid license and the environment set up to run models
@@ -26,11 +28,11 @@ bc. wget http://releases.linaro.org/12.10/components/platform/linaro-image-tools
 
 h2. Create a 2GB image file
 
-RTSM will only deal with file systems up to 2GB in size, however the pre-built image for Ubuntu requires a 4GB filesystem.  Therefore we will build our own image using the pre-built artifacts, as obtained in the Binary Image Installation tab on this page.
+RTSM will only deal with file systems up to 2GB in size, however the released pre-built image for Ubuntu Desktop requires a 4GB filesystem.  Therefore we will build our own Nano image using the pre-built artifacts as listed below.
 
-We use a "Nano":http://releases.linaro.org/12.10/ubuntu/precise-images RootFS for this example, however, you could use other RootFS types so long as you can install it to a 2GB file. Note, you will also need the @boot.tar.bz2@ file from the Android release.
+We use a "Nano":http://releases.linaro.org/12.10/ubuntu/precise-images RootFS for this example, however, you could use other RootFS types such as ALIP or Developer so long as you can install it to a 2GB file (Ubuntu Desktop doesn't fit the 2GB limit). Note, you will also need the @boot.tar.bz2@ file from the Android release.
 
-Using the following command, you will download the nano RootFS, the hardware back and the boot.tar.gz you need from the Android build.
+Using the following command, you will download the nano RootFS, the hardware pack and the boot.tar.gz you need from the Android build.
 
 bc. wget http://releases.linaro.org/12.10/ubuntu/precise-images/nano/linaro-precise-nano-20121021-473.tar.gz
 wget http://releases.linaro.org/12.10/ubuntu/precise-hwpacks/hwpack_linaro-vexpress_20121021-377_armhf_supported.tar.gz