From b5238b6c8d8b69f28d2ce43971aeb6e7e64a05a0 Mon Sep 17 00:00:00 2001
From: David Harris <david_harris@hmc.edu>
Date: Thu, 23 Mar 2023 09:05:37 -0700
Subject: [PATCH] README updates

---
 README.md                       | 4 ++++
 bin/wally-tool-chain-install.sh | 9 +++++++--
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 64243248..b93a5fc5 100644
--- a/README.md
+++ b/README.md
@@ -65,10 +65,14 @@ This section describes the open source toolchain installation.  The
 current version of the toolchain has been tested on Ubuntu and Red
 Hat/Rocky 8 Linux.  Ubuntu works more smoothly and is recommended
 unless you have a compelling need for RedHat.  
+
 Ubuntu users can install the tools by running
 
 	$ sudo $WALLY/bin/wally-tool-chain-install.sh
 
+See wally-tool-chain-install.sh for a detailed description of each component,
+or to issue the commands one at a time to install on the command line.
+
 ### Download Synthesis Libraries
 
 For logic synthesis, we need a synthesis tool (see Section 3.XREF) and a cell library.  Clone the OSU 12-track cell library for the Skywater 130 nm process:
diff --git a/bin/wally-tool-chain-install.sh b/bin/wally-tool-chain-install.sh
index 7def9685..2f058c46 100755
--- a/bin/wally-tool-chain-install.sh
+++ b/bin/wally-tool-chain-install.sh
@@ -34,18 +34,19 @@ export PATH=$PATH:$RISCV/bin
 set -e # break on error
 
 # Modify accordingly for your machine
+# Increasing NUM_THREADS will speed up parallel compilation of the tools
 NUM_THREADS=1 # for low memory machines > 16GiB
 #NUM_THREADS=8  # for >= 32GiB
 #NUM_THREADS=16  # for >= 64GiB
 
 sudo mkdir -p $RISCV
 
-# Update and Upgrade (see https://itsfoss.com/apt-update-vs-upgrade/)
+# Update and Upgrade tools (see https://itsfoss.com/apt-update-vs-upgrade/)
 apt update
 apt upgrade
 
 # INSTALL 
-apt install -y git gawk make texinfo bison flex build-essential python3 libz-dev libexpat-dev autoconf device-tree-compiler ninja-build libpixman-1-dev build-essential ncurses-base ncurses-bin libncurses5-dev dialog curl wget ftp libgmp-dev
+apt install -y git gawk make texinfo bison flex build-essential python3 libz-dev libexpat-dev autoconf device-tree-compiler ninja-build libpixman-1-dev ncurses-base ncurses-bin libncurses5-dev dialog curl wget ftp libgmp-dev libglib2.0-dev
 
 # needed for Ubuntu 22.04, gcc cross compiler expects python not python2 or python3.
 if ! command -v python &> /dev/null
@@ -55,6 +56,10 @@ then
 fi
 
 # gcc cross-compiler (https://github.com/riscv-collab/riscv-gnu-toolchain)
+# To install GCC from source can take hours to compile. 
+#This configuration enables multilib to target many flavors of RISC-V.   
+# This book is tested with GCC 12.2 (tagged 2023.01.31), but will likely work with newer versions as well. 
+
 cd $RISCV
 git clone https://github.com/riscv/riscv-gnu-toolchain
 cd riscv-gnu-toolchain