improve documentation

Author: abarisani

README.md

@@ -160,7 +160,7 @@ import (
 Build the [TamaGo compiler](https://github.com/usbarmory/tamago-go)
 (or use the [latest binary release](https://github.com/usbarmory/tamago-go/releases/latest)):
 
-```
+```sh
 wget https://github.com/usbarmory/tamago-go/archive/refs/tags/latest.zip
 unzip latest.zip
 cd tamago-go-latest/src && ./all.bash
@@ -170,7 +170,7 @@ cd ../bin && export TAMAGO=`pwd`/go
 Go applications can be compiled with the compiler built in the previous step,
 with the addition of a few flags/variables:
 
-```
+```sh
 # set this library as `runtime/goos` overlay
 export GOOSPKG=github.com/usbarmory/tamago
 
@@ -196,7 +196,7 @@ each specific target.
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramstart`: override `ramStart`
@@ -217,7 +217,7 @@ execution.
 An emulated run of the [example application](https://github.com/usbarmory/tamago-example)
 can be launched as follows:
 
-```
+```sh
 git clone https://github.com/usbarmory/tamago-example
 cd tamago-example && make qemu
 ```
@@ -248,7 +248,7 @@ Additional resources
 ====================
 
 * [Package API](https://pkg.go.dev/github.com/usbarmory/tamago)
-* [Runtime API](https://github.com/usbarmory/tamago-go/src/runtime/goos/README.md)
+* [Runtime API](https://github.com/usbarmory/tamago-go/blob/latest/src/runtime/goos/README.md)
 * [Compatibility](https://github.com/usbarmory/tamago/wiki/Compatibility)
 * [Internals](https://github.com/usbarmory/tamago/wiki/Internals)
 * [FAQ](https://github.com/usbarmory/tamago/wiki/Frequently-Asked-Questions-(FAQ))

amd64/README.md

@@ -50,7 +50,7 @@ Supported hardware
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramstart`: exclude `ramStart` from `mem.go`

arm/README.md

@@ -47,7 +47,7 @@ Supported hardware
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramstart`: exclude `ramStart` from `mem.go`

arm64/README.md

@@ -46,7 +46,7 @@ Supported hardware
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramstart`: exclude `ramStart` from `mem.go`

board/cloud_hypervisor/vm/README.md

@@ -67,7 +67,7 @@ import (
 Build the [TamaGo compiler](https://github.com/usbarmory/tamago-go)
 (or use the [latest binary release](https://github.com/usbarmory/tamago-go/releases/latest)):
 
-```
+```sh
 wget https://github.com/usbarmory/tamago-go/archive/refs/tags/latest.zip
 unzip latest.zip
 cd tamago-go-latest/src && ./all.bash
@@ -77,7 +77,7 @@ cd ../bin && export TAMAGO=`pwd`/go
 Go applications can be compiled as usual, using the compiler built in the
 previous step, but with the addition of the following flags/variables:
 
-```
+```sh
 GOOS=tamago GOOSPKG=github.com/usbarmory/tamago GOARCH=amd64 \
 	${TAMAGO} build -ldflags "-T 0x10010000 -R 0x1000" main.go
 ```
@@ -88,7 +88,7 @@ An example application, targeting the Cloud Hypervisor platform, is
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramsize`: exclude `ramSize` from `mem.go`
@@ -102,7 +102,7 @@ reference usage and a Makefile target for automatic creation of an ELF image
 which can be executed under paravirtualization with
 [cloud-hypervisor](https://www.cloudhypervisor.org/docs/prologue/quick-start/#firmware-booting):
 
-```
+```sh
 cloud-hypervisor --kernel example --cpus boot=1 --memory size=4096M --net "tap=tap0" --serial tty --console off
 ```
 

board/firecracker/microvm/README.md

@@ -67,7 +67,7 @@ import (
 Build the [TamaGo compiler](https://github.com/usbarmory/tamago-go)
 (or use the [latest binary release](https://github.com/usbarmory/tamago-go/releases/latest)):
 
-```
+```sh
 wget https://github.com/usbarmory/tamago-go/archive/refs/tags/latest.zip
 unzip latest.zip
 cd tamago-go-latest/src && ./all.bash
@@ -77,7 +77,7 @@ cd ../bin && export TAMAGO=`pwd`/go
 Go applications can be compiled as usual, using the compiler built in the
 previous step, but with the addition of the following flags/variables:
 
-```
+```sh
 GOOS=tamago GOOSPKG=github.com/usbarmory/tamago GOARCH=amd64 \
 	${TAMAGO} build -ldflags "-T 0x10010000 -R 0x1000" main.go
 ```
@@ -88,7 +88,7 @@ is [available](https://github.com/usbarmory/tamago-example).
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramsize`: exclude `ramSize` from `mem.go`
@@ -106,14 +106,14 @@ which can be executed under paravirtualization with
 Firectl
 -------
 
-```
+```sh
 firectl --kernel example --root-drive /dev/null --tap-device tap0/06:00:AC:10:00:01 -c 1 -m 4096
 ```
 
 Firecracker
 -----------
 
-```
+```sh
 firecracker --config-file vm_config.json
 ```
 

board/google/gcp/README.md

@@ -67,7 +67,7 @@ import (
 Build the [TamaGo compiler](https://github.com/usbarmory/tamago-go)
 (or use the [latest binary release](https://github.com/usbarmory/tamago-go/releases/latest)):
 
-```
+```sh
 wget https://github.com/usbarmory/tamago-go/archive/refs/tags/latest.zip
 unzip latest.zip
 cd tamago-go-latest/src && ./all.bash
@@ -77,7 +77,7 @@ cd ../bin && export TAMAGO=`pwd`/go
 Go applications can be compiled as usual, using the compiler built in the
 previous step, but with the addition of the following flags/variables:
 
-```
+```sh
 GOOS=tamago GOOSPKG=github.com/usbarmory/tamago GOARCH=amd64 \
 	${TAMAGO} build -ldflags "-T 0x10010000 -R 0x1000" main.go
 ```
@@ -88,7 +88,7 @@ is [available](https://github.com/usbarmory/tamago-example).
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramsize`: exclude `ramSize` from `mem.go`
@@ -111,7 +111,7 @@ T2D.
 QEMU
 ----
 
-```
+```sh
 qemu-system-x86_64 \
 	-machine q35,pit=off,pic=off \
 	-enable-kvm -cpu host,invtsc=on,kvmclock=on -no-reboot \

board/nxp/imx8mpevk/README.md

@@ -67,7 +67,7 @@ import (
 Build the [TamaGo compiler](https://github.com/usbarmory/tamago-go)
 (or use the [latest binary release](https://github.com/usbarmory/tamago-go/releases/latest)):
 
-```
+```sh
 wget https://github.com/usbarmory/tamago-go/archive/refs/tags/latest.zip
 unzip latest.zip
 cd tamago-go-latest/src && ./all.bash
@@ -77,7 +77,7 @@ cd ../bin && export TAMAGO=`pwd`/go
 Go applications can be compiled as usual, using the compiler built in the
 previous step, but with the addition of the following flags/variables:
 
-```
+```sh
 GOOS=tamago GOOSPKG=github.com/usbarmory/tamago GOARCH=arm64 \
 	${TAMAGO} build -ldflags "-T 0x40010000 -R 0x1000" main.go
 ```
@@ -88,7 +88,7 @@ is [available](https://github.com/usbarmory/tamago-example).
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramsize`: exclude `ramSize` from `mem.go`
@@ -106,7 +106,7 @@ QEMU
 
 The target can be executed under emulation as follows:
 
-```
+```sh
 qemu-system-aarch64 \
 	-machine imx8mp-evk -m 512M \
 	-nographic -monitor none -serial stdio -serial null \
@@ -118,7 +118,7 @@ The emulated target can be debugged with GDB by adding the `-S -s` flags to the
 previous execution command, this will make qemu waiting for a GDB connection
 that can be launched as follows:
 
-```
+```sh
 arm-none-eabi-gdb -ex "target remote 127.0.0.1:1234" example
 ```
 

board/nxp/mx6ullevk/README.md

@@ -64,7 +64,7 @@ import (
 Build the [TamaGo compiler](https://github.com/usbarmory/tamago-go)
 (or use the [latest binary release](https://github.com/usbarmory/tamago-go/releases/latest)):
 
-```
+```sh
 wget https://github.com/usbarmory/tamago-go/archive/refs/tags/latest.zip
 unzip latest.zip
 cd tamago-go-latest/src && ./all.bash
@@ -74,7 +74,7 @@ cd ../bin && export TAMAGO=`pwd`/go
 Go applications can be compiled as usual, using the compiler built in the
 previous step, but with the addition of the following flags/variables:
 
-```
+```sh
 GOOS=tamago GOOSPKG=github.com/usbarmory/tamago GOARM=7 GOARCH=arm \
 	${TAMAGO} build -ldflags "-T 0x80010000 -R 0x1000" main.go
 ```
@@ -85,7 +85,7 @@ is [available](https://github.com/usbarmory/tamago-example).
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramsize`: exclude `ramSize` from `mem.go`
@@ -109,7 +109,7 @@ Native hardware: imx image on microSD
 
 Copy the built `imx` image to a microSD as follows:
 
-```
+```sh
 sudo dd if=<path to imx file> of=/dev/sdX bs=1M conv=fsync
 ```
 *IMPORTANT*: /dev/sdX must be replaced with your microSD device (not eventual
@@ -132,7 +132,7 @@ Standard output
 The standard output can be accessed through the debug console found
 on micro USB connector J1901 and the following `picocom` configuration:
 
-```
+```sh
 picocom -b 115200 -eb /dev/ttyUSB0 --imap lfcrlf
 ```
 
@@ -150,7 +150,7 @@ set remote hardware-watchpoint-limit 4
 
 Example:
 
-```
+```sh
 # start openocd daemon
 openocd -f interface/ftdi/jtagkey.cfg -f target/imx6ul.cfg -c "adapter speed 1000"
 
@@ -173,7 +173,7 @@ QEMU
 
 The target can be executed under emulation as follows:
 
-```
+```sh
 qemu-system-arm \
 	-machine mcimx6ul-evk -cpu cortex-a7 -m 512M \
 	-nographic -monitor none -serial null -serial stdio \
@@ -185,7 +185,7 @@ The emulated target can be debugged with GDB by adding the `-S -s` flags to the
 previous execution command, this will make qemu waiting for a GDB connection
 that can be launched as follows:
 
-```
+```sh
 arm-none-eabi-gdb -ex "target remote 127.0.0.1:1234" example
 ```
 

board/qemu/microvm/README.md

@@ -67,7 +67,7 @@ import (
 Build the [TamaGo compiler](https://github.com/usbarmory/tamago-go)
 (or use the [latest binary release](https://github.com/usbarmory/tamago-go/releases/latest)):
 
-```
+```sh
 wget https://github.com/usbarmory/tamago-go/archive/refs/tags/latest.zip
 unzip latest.zip
 cd tamago-go-latest/src && ./all.bash
@@ -77,7 +77,7 @@ cd ../bin && export TAMAGO=`pwd`/go
 Go applications can be compiled as usual, using the compiler built in the
 previous step, but with the addition of the following flags/variables:
 
-```
+```sh
 GOOS=tamago GOOSPKG=github.com/usbarmory/tamago GOARCH=amd64 \
 	${TAMAGO} build -ldflags "-T 0x10010000 -R 0x1000" main.go
 ```
@@ -90,7 +90,7 @@ Two examples application, targeting the QEMU microvm platform, are available:
 Build tags
 ==========
 
-The following build tags allow application to override the package own
+The following build tags allow applications to override the package own
 definition for the `runtime/goos` overlay:
 
 * `linkramsize`: exclude `ramSize` from `mem.go`
@@ -106,7 +106,7 @@ well as paravirtualized execution.
 QEMU
 ----
 
-```
+```sh
 qemu-system-x86_64 \
 	-machine microvm,x-option-roms=on,pit=off,pic=off,rtc=on \
 	-global virtio-mmio.force-legacy=false \
@@ -120,7 +120,7 @@ The paravirtualized target can be debugged with GDB by adding the `-S -s` flags
 to the previous execution command, this will make qemu waiting for a GDB
 connection that can be launched as follows:
 
-```
+```sh
 gdb -ex "target remote 127.0.0.1:1234" example
 ```