cldoc odd behavior

[rhl-]

In the typedefs section the red 'type' is a bit misplaced. Also, the bit to the right explaining what the typedef is, is incorrect. A layout similar to: http://en.cppreference.com/w/cpp/container/vector
is preferable.

Then in the functions, the return types need not be translated at all. Since we are presenting the typedefs, they should be well defined tokens. e.g. iterator not Abstract_simplex< T>::iterator for the begin() function. Also note the odd formatting of the () in the begin function.

[jessevdk]

The type thing would be easy to change, but avoiding the explode of the template arguments is actually not currently possible in a reliable way due to how clang doesn't provide this information. I agree this is pretty ugly and not helpful. I'd be glad to hear about a solution to this issue.