///
/// Client code willing to get notified for a certain kind of node
/// during the IR traversal might want to define a visitor class that
-/// inherit ir_node_visitor, overload the ir_node_visitor::visit_begin
-/// or ir_node_visitor::visit_end method of its choice, and provide
-/// and implementation for it. Note that inside these two methods,the
-/// node_visitor_base::visiting() method returns false.
-
+/// inherit ir_node_visitor, overload the ir_node_visitor::visit_begin()
+/// or ir_node_visitor::visit_end() method of its choice, and provide
+/// and implementation for it. If either
+/// ir_node_visitor::visit_begin() or ir_node_visitor::visit_end()
+/// return false, it means the traversal has to stop immediately after
+/// the methods' return. If the methods return true, it means the
+/// traversal keeps going.
+///
/// That new visitor class would then be passed to e.g,
/// translation_unit::traverse or to the traverse method of any type
/// where the traversal is supposed to start from.
if (// NOT be an incomplete type that is being currently
// constructed.
!ctxt.is_wip_class_die_offset(dwarf_dieoffset(die))
- // And then do not early-canonicalize klass if it either:
- && (// - has got virtual member functions. This is because
- // the number of virtual member function might be
- // amended later, outside of the current DIE, by
- // cloned virtual functions that are clones of at
- // least one of the virtual functions declared in
- // the DIE.
+ // And not early-canonicalize klass if it either:
+ && (// - has got virtual member functions. This is
+ // because the number of virtual member function
+ // might be amended later, outside of the current
+ // DIE, by cloned virtual functions that are clones
+ // of at least one of the virtual functions declared
+ // in the DIE.
!klass->has_virtual_member_functions()
- // - or has got non-canonicalized sub types. In that case
- // the non-canonicalized sub-type needs to be
+ // - or has got non-canonicalized sub types. In that
+ // case the non-canonicalized sub-type needs to be
// canonicalized before this type is.
&& !type_has_non_canonicalized_subtype(klass)))
canonicalize(klass);