Documentation for the words I'm adding.
Small formatting changes.
Added  CFLAGS line with optimisation turned off, strip flag removed and generate symbold turned on, for debugging.  Commented out.
Ignore files that end with ~