[FIX,DOC] fix build with Clang and improve documentation