Improve errors and documentation for syscall.py

When test/syscall tests fail, it will not be apparent to the uninitiated on how to debug it.  Some improvement in internal documentation would help, as well as showing more information, like the two lines that are being compared.