Improved the comments and doxygen style to try and make the file
more readable.
The previous version can't be removed until we have the posix paths included
in the include paths. Once this is done the existsing version should be
removed as this is more up to date.
git-svn-id: file:///srv/svn/repos/haiku/trunk/current@67 a95241bf-73f2-0310-859d-f6bbb57e9c96
