From 12b30a3d0784578d4bf66a1dbe888d60a3814ca0 Mon Sep 17 00:00:00 2001
From: JC Staudt <24510452+jcstaudt@users.noreply.github.com>
Date: Sat, 23 Jun 2018 16:48:44 -0700
Subject: [PATCH] Minor doc formatting; fixed path

---
 SOFTWARE/A64-TERES/scripts/README.md | 50 +++++++++++++---------------
 1 file changed, 24 insertions(+), 26 deletions(-)

diff --git a/SOFTWARE/A64-TERES/scripts/README.md b/SOFTWARE/A64-TERES/scripts/README.md
index 0739c332..000feae3 100644
--- a/SOFTWARE/A64-TERES/scripts/README.md
+++ b/SOFTWARE/A64-TERES/scripts/README.md
@@ -1,9 +1,8 @@
-# A64-OLinuXino Build Instructions
+# Build Instructions
 
 ## Linux
 
 ### 1. Getting source code and helper scripts
-	
 ```bash
 cd ~/
 git clone https://github.com/OLIMEX/DIY-LAPTOP
@@ -11,9 +10,9 @@ cd DIY-LAPTOP/SOFTWARE/A64-TERES/
 ```
 ### 2. Setup toolchain
 ```bash
-	sudo apt install gcc-aarch64-linux-gnu
-        sudo apt install gcc-4.7-arm-linux-gnueabihf
-	sudo apt install kpartx bsdtar mtools dos2unix device-tree-compiler
+sudo apt install gcc-aarch64-linux-gnu
+sudo apt install gcc-4.7-arm-linux-gnueabihf
+sudo apt install kpartx bsdtar mtools dos2unix device-tree-compiler
 ```
 
 ### 3. Cross-compile sources
@@ -27,6 +26,7 @@ make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j4 LOCALVERSION= Image
 make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j4 LOCALVERSION= modules
 make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j4 LOCALVERSION= modules_install  INSTALL_MOD_PATH=out INSTALL_MOD_STRIP=1
 ```
+
 #### Allwinner Pack Tools 
 ```bash
 cd ../
@@ -37,18 +37,19 @@ make -C sunxi-pack-tools
 cd scripts/
 ./build_uboot.sh #A64-Teres
 ```
-or 
+or
+
 ```bash
 ./build_uboot_a64.sh #A64-OLinuXino
 ```
-### 4. Helper Scripts
-## Ramdisk
 
+### 4. Helper Scripts
+
+## Ramdisk
 Either make one with the steps below or download one from some other place.
-Make sure the initrd is for aarch64.
+Make sure the initrd is for `aarch64`.
 
 ### Get Busybox tree
-
 ```bash
 cd ../
 git clone --depth 1 --branch 1_24_stable --single-branch git://git.busybox.net/busybox busybox
@@ -67,49 +68,46 @@ make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j4
 ```
 
 ### Make initrd.gz
-
-Use the provided `make_initrd.sh` script to create a simple initrd based on
-the busybox binary compiled earlier.
+Use the `make_initrd.sh` script to create a simple initrd based on the busybox binary previously compiled.
 
 ```bash
 cd ../scripts
 ./make_initrd.sh
 ```
 ### Create bootable image
-
 Create kernel tarball :
 ```bash 
 ./make_kernel_tarball.sh . ../linux-a64 #This will produce file named linux-a64-xx.yy.zz.tar.xz 
 ```
 
-Create simple image structure :
+Create simple image structure:
 ```bash
 sudo ./make_simpleimage.sh teres.img 1000 ./linux-a64-3.10.104-1.tar.xz 
 sudo xz teres.img
 ```
 
-Build bootable image :
+Build a bootable image:
 ```bash
 sudo ./build_image.sh teres.img.xz ./linux-a64-3.10.104-1.tar.xz xenial
 ```
 
-if everything is successfully acomplished this command will create file named :
-xenial-teres-bspkernel-<date>.img
-use dd to write this image to Sd Card : 
+If successfully completed, this command will create file named `xenial-teres-bspkernel-<date>.img`.
+Use `dd` to write this image to an SD Card:
+
 ```bash
-dd if=xenial-teres-bspkernel-<date>.img of=/dev/sdX bs=1M
+dd if=xenial-teres-bspkernel-<date>.img of=/dev/sdX bs=1M status=progress
 ```
 
-After first boot you will able to login with : 
-user: olimex
-pass: olimex
+Use these credentials to log in after first boot:
+- User: `olimex`
+- Password: `olimex`
 
-Connection to internet can be enabled using nmtui tool:
+Connection to the internet can be enabled via command-line by running:
 ```bash
 nmtui
 ```
 
-Feel free to install everything you want, for ex. Graphical desktop : 
+Feel free to install everything you want, e.g., a graphical desktop environment: 
 ```bash
-./install_desktop.sh mate #will install mate 
+./platform-scripts/install_desktop.sh mate # installs mate desktop
 ```