First go at documentation

Various files commented more fully.  Start made on updating readme.txt
etc.  Note: haven't started on howto.txt yet (may be too early to start
that yet); haven't said about being OO based.