With doxygen it is enough to prefix a method with the right scope to get the right link in the manual. So we could write: "A vertex is always associated with a geometric entity, namely with an Arrangement_2::Point_2 object, which can be obtained by the Arrangement_2::Vertex::point() method."