Outdated inline documentation

[ftynse]

In multiple places the doxygen documentation dates back to the date when the dependence analysis was moved from CLooG, including references to CloogViolation and company.

One can use clang's -Wdocumentation option to see the list of most notable problems. I propose to update this documentation, grepping by cloog should suffice + clang should suffice and update the documentation style a little bit. The heading candl_function_name function: in each comment takes space and risks heavily to become outdated if the function is renamed. But the old name remains in the file, which is confusing for both Doxygen and someone who processes the file.