update to documentation, defines, and other work.

This pull request, after testing, should be ready to merge.

1. Updates to documentation.
2. Some warnings fixes.
3. added TR1 build options.
4. more descriptive defines for compile.