added some documentation, including machtoy.html to test and demonstrate the shockwave algoriths