Remove old "doc" directory

Remove obsolete files and open issues to keep track of proposals.

See issue #41.
Improve documentation
Improve documentation
Remove useless files
cmsMake: convert base_dir to an absolute path.
cmsMake: solve some (but not all) problems with different base_dir handling.
cmsMake: different base_dir handling also for Test.py.