Pick up the 2.1 doc

All  requested info should be integraded and also got rid of all the ??queries.

Also minor wording and punctuation changes to build.py, main.py, log.py and makespec.py.