(no commit message)

diff --git a/docs/pypowersim.mdwn b/docs/pypowersim.mdwn
index 5499712d17633d15f94f04baded796186d484e18..4e9b3869502b319d61eb03bb29ca5973c4e90f7a 100644 (file)
--- a/docs/pypowersim.mdwn
+++ b/docs/pypowersim.mdwn
@@ -11,13 +11,17 @@ These are multimedia tests intended to cover the inner loops of various
 Audio/Video CODECs (such as MP3).
 
 **Note:** There's no GUI, UART, or console. To check that the tests ran
-succesfully, you need to dump the memory contents and inspect them.
+succesfully, you need to dump the memory contents and inspect the output.
 
 
 # Pypowersim - PowerISA Simulator
 
-Pypowersim is a PowerISA simulator written and Python.
-PowerISA binaries are decoded by a given ISA class instance.
+Pypowersim is a PowerISA simulator written in Python.
+PowerISA binaries are decoded by an
+[ISA class instance](https://git.libre-soc.org/?p=openpower-isa.git;a=blob;f=src/openpower/decoder/isa/caller.py;hb=HEAD).
+ISACaller utilises compiled machine-readable Power ISA 3.0
+pseudocode taken directly from the Power ISA Specification.
+
 SVP64 binaries are also supported. Simulation is managed cycle by cycle,
 for instruction and memory debugging.
 Use of QEMU as a co-simulator is also supported for verifying the
@@ -110,9 +114,11 @@ After execution 128 bytes are dumped from address 0x900000.
 
 As the SVP64 spec and Libre-SOC CPU is developing, the available opcodes
 will grow. Make sure to update the auto-generated Python functions
-simulating the instructions by calling:
+simulating the instructions. Also the audio data needs to be downloaded.
 
-* run "pywriter". This is an installed utility, so should be in your PATH
+* run "pywriter". This is an installed utility, so should be in your PATH.
+  It recompiles the machine-readable Power ISA pseudocode into
+  executable python.
 * Download audio data. Use the Makefile inside "openpower-isa/media" to 
  download the audio samples.