diff --git a/README.md b/README.md
index 69854bec..30f892cc 100644
--- a/README.md
+++ b/README.md
@@ -67,7 +67,7 @@ The rv8 user mode simulator has the following features:
 The future goals of the rv8 project are:
 
 - Concise metadata representing the RISC-V ISA
-- Tools for metadata-based generation of source and documentation 
+- Tools for metadata-based generation of source and documentation
 - High performance emulation, sandboxing and binary translation
 - RISC-V-(n) → RISC-V-(n+1)
 - RISC-V-(n) → Intel i7 / AMD64 + AVX-512
@@ -148,7 +148,7 @@ make CXX=g++-6 CC=gcc-6
 
 ![ASCII map screenshot](/doc/images/screenshot-1.png)
 
-*Example ASCII map output from make map*
+*Example ASCII map output from make map (using `rv-meta` tool)*
 
 ![Histogram screenshot](/doc/images/screenshot-2.png)
 
@@ -170,7 +170,7 @@ See [RISC-V Instruction Set Listing](/doc/pdf/riscv-instructions.pdf) and
 
 Command                | Description
 ----                   | ---
-```make map```         | print a colour opcode map
+```make map```         | print a colour opcode map (using _`rv-meta`_ tool)
 ```make latex```       | output a LaTeX opcode tex
 ```make pdf```         | output a LaTeX opcode pdf
 ```make test-spike```  | run the ABI Proxy Simulator tests with _`spike`_