Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDoug Schaefer2004-11-21 22:45:18 -0500
committerDoug Schaefer2004-11-21 22:45:18 -0500
commit21342769d7cc4ad76f4f4081fce7fd0de4943014 (patch)
treedaa6c3ec59a3ebcddea6a98d697e2f4657875f19 /doc/org.eclipse.cdt.doc.isv
parent3fab76a13d7c85ad9220b9cd32301ebf18fa4405 (diff)
downloadorg.eclipse.cdt-21342769d7cc4ad76f4f4081fce7fd0de4943014.tar.gz
org.eclipse.cdt-21342769d7cc4ad76f4f4081fce7fd0de4943014.tar.xz
org.eclipse.cdt-21342769d7cc4ad76f4f4081fce7fd0de4943014.zip
Hooked up the DOM to the Core Model (kind of). Put in a little more docs.
Diffstat (limited to 'doc/org.eclipse.cdt.doc.isv')
-rw-r--r--doc/org.eclipse.cdt.doc.isv/guide/dom/index.html19
1 files changed, 18 insertions, 1 deletions
diff --git a/doc/org.eclipse.cdt.doc.isv/guide/dom/index.html b/doc/org.eclipse.cdt.doc.isv/guide/dom/index.html
index 6e01dc4bb8b..8626ae7459d 100644
--- a/doc/org.eclipse.cdt.doc.isv/guide/dom/index.html
+++ b/doc/org.eclipse.cdt.doc.isv/guide/dom/index.html
@@ -24,6 +24,12 @@ up to the entry rule in the grammer. This view fulfills the role of a
traditional Abstract Syntax Tree, and you'll see that the classes that
make up this view have AST in their name.<br>
</p>
+<p>The top node of the Syntactic View is <a
+ href="../../reference/api/org/eclipse/cdt/core/dom/ast/IASTTranslationUnit.html">IASTTranslationUnit</a>.
+The translation unit object can be accessed from the C Model's <a
+ href="../../reference/api/org/eclipse/cdt/core/model/ITranslationUnit.html">ITranslationUnit</a>
+object.<br>
+</p>
<h2>Semantic View</h2>
<p>The semantic view (which we sometimes call the logical view)
represent semantic elements in the program. These elements are
@@ -31,9 +37,20 @@ generally types, variables, and functions. The JDT calls these things
bindings, so we do to. However, the more general rule is that anything
that links sub-branches of the AST is a binding.<br>
</p>
+<p>The most common way to get from the Syntactic View is to navigate
+from an <a
+ href="../../reference/api/org/eclipse/cdt/core/dom/ast/IASTName.html">IASTName</a>
+view to the <a
+ href="../../reference/api/org/eclipse/cdt/core/dom/ast/IBinding.html">IBinding</a>
+that represents the Semantic object for that
+given name.<br>
+</p>
<h2>Workspace-Wide View</h2>
<p>Once you have a binding, it is possible to find all translation
-units that declare or refer to that binding.</p>
+units that declare or refer to that binding. From there you can
+navigate from the IASTTranslationUnit to the IASTNames that declare or
+refer to that binding.<br>
+</p>
<h2>Rewriting</h2>
<p>From the Syntactic view, you can ask the AST Rewriter to calculate
the TextEdits required to accomplish changes to the AST.<br>

Back to the top