* Edited all makefiles to include some doxy comments.
* Fixed issue with includes, it wasn't an issue with absolute vs.
    relative paths, it was that the path variables were getting
    expanded at the lowest level, not where the makefiles live. So
    it was giving incorrect paths.
* Put some doxy comments in test file.