diff --git a/src/README.md b/src/README.md
index 12dffd2a..ba23ee53 100644
--- a/src/README.md
+++ b/src/README.md
@@ -1,14 +1,16 @@
-punk shell
-==============================
-
-
-Build Instructions
-------------------------------
-
-+ Use  tclsh|punk make.tcl to build .tm modules and rebuild the punk86 executable
-
-+ Then Use tclsh|punk build.tcl to run the 'kettle' system to build docs and/or standard tcl libraries with pkgIndex.tcl files,   
-or - use the `pmix KettleShell` command from within the punk shell to perform kettle operations.
-
-(The name 'build.tcl' is the standard name used by the [Kettle](https://chiselapp.com/user/andreas_kupries/repository/Kettle/home) system)
-
+punk shell
+==============================
+
+
+Build Instructions
+------------------------------
+
++ Use  tclsh|punk make.tcl to build .tm modules and rebuild the punk executable
+e.g tclsh make.tcl modules
+e.g tclsh make.tcl project
+
++ Then Use tclsh|punk build.tcl to run the 'kettle' system to build docs and/or standard tcl libraries with pkgIndex.tcl files,   
+or - use the `pmix KettleShell` command from within the punk shell to perform kettle operations.
+
+(The name 'build.tcl' is the standard name used by the [Kettle](https://chiselapp.com/user/andreas_kupries/repository/Kettle/home) system)
+