summaryrefslogtreecommitdiffstats
path: root/src/abg-comparison.cc
diff options
context:
space:
mode:
Diffstat (limited to 'src/abg-comparison.cc')
-rw-r--r--src/abg-comparison.cc13
1 files changed, 12 insertions, 1 deletions
diff --git a/src/abg-comparison.cc b/src/abg-comparison.cc
index 71048ce2..cc5b9f6d 100644
--- a/src/abg-comparison.cc
+++ b/src/abg-comparison.cc
@@ -1917,7 +1917,10 @@ diff::end_traversing()
1917 priv_->traversing_ = false; 1917 priv_->traversing_ = false;
1918} 1918}
1919 1919
1920/// Finish the building of a given kind of a diff tree node. 1920/// Finish the insertion of a diff tree node into the diff graph.
1921///
1922/// This function might be called several times. It must perform the
1923/// insertion only once.
1921/// 1924///
1922/// For instance, certain kinds of diff tree node have specific 1925/// For instance, certain kinds of diff tree node have specific
1923/// children nodes that are populated after the constructor of the 1926/// children nodes that are populated after the constructor of the
@@ -2065,6 +2068,13 @@ diff::reported_once() const
2065/// without traversing it. But traversing a node without visiting it 2068/// without traversing it. But traversing a node without visiting it
2066/// is not possible. 2069/// is not possible.
2067/// 2070///
2071/// Note that the insertion of the "generic view" of the diff node
2072/// into the graph being traversed is done "on the fly". The
2073/// insertion of the "typed view" of the diff node into the graph is
2074/// done implicitely. To learn more about the generic and typed view
2075/// of the diff node, please read the introductory comments of the
2076/// @ref diff class.
2077///
2068/// Note that by default this traversing code visits a given class of 2078/// Note that by default this traversing code visits a given class of
2069/// equivalence of a diff node only once. This behaviour can been 2079/// equivalence of a diff node only once. This behaviour can been
2070/// changed by calling 2080/// changed by calling
@@ -2102,6 +2112,7 @@ diff::reported_once() const
2102bool 2112bool
2103diff::traverse(diff_node_visitor& v) 2113diff::traverse(diff_node_visitor& v)
2104{ 2114{
2115 // Insert the "generic view" of the diff node into its graph.
2105 finish_diff_type(); 2116 finish_diff_type();
2106 2117
2107 v.visit_begin(this); 2118 v.visit_begin(this);