putting RST files into source dir
making good progress with docs.  Also fixing a few small bugs in code.