1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-04-23 14:42:11 +02:00

Documentation enhancement

This commit is contained in:
John Cortell 2009-09-23 04:32:37 +00:00
parent 57943f1c5d
commit 9500d9b90a
2 changed files with 21 additions and 11 deletions

View file

@ -516,6 +516,12 @@ abstract public class AbstractVMProvider implements IVMProvider, IVMEventListene
* processing of the update. For example the AbstractCachingVMProvider * processing of the update. For example the AbstractCachingVMProvider
* overrides this method to optionally return the results for an update from * overrides this method to optionally return the results for an update from
* a cache. * a cache.
*
* [node] represents the type of the child element, not of the parent. In
* other words, the update requests are asking if one or more model elements
* of a particular type (thread, e.g.) have children. But [node] does not
* represent that type. It represents the type of the potential children
* (frame, e.g.)
*/ */
public void updateNode(final IVMNode node, IHasChildrenUpdate[] updates) { public void updateNode(final IVMNode node, IHasChildrenUpdate[] updates) {
IHasChildrenUpdate[] updateProxies = new IHasChildrenUpdate[updates.length]; IHasChildrenUpdate[] updateProxies = new IHasChildrenUpdate[updates.length];

View file

@ -104,6 +104,14 @@ public class DefaultVMContentProviderStrategy implements IElementContentProvider
} }
} }
/**
* @param node
* the type of element (thread, variable, frame, e.g,) that's in
* the update requests. All the given requests contain the same
* type of element.
* @param updates
* the has-children requests
*/
private void updateNode(IVMNode node, final IHasChildrenUpdate[] updates) { private void updateNode(IVMNode node, final IHasChildrenUpdate[] updates) {
final IVMNode[] childNodes = getVMProvider().getChildVMNodes(node); final IVMNode[] childNodes = getVMProvider().getChildVMNodes(node);
if (childNodes.length == 0) { if (childNodes.length == 0) {
@ -120,16 +128,12 @@ public class DefaultVMContentProviderStrategy implements IElementContentProvider
} else { } else {
// Create a matrix of element updates: // Create a matrix of element updates:
// The first dimension "i" is the list of children updates that came // The first dimension "i" is the list of children updates that came
// from the viewer. // from the viewer. For each of these updates, there are "j" number
// For each of these updates, there are "j" number of elment updates // of element updates corresponding to the number of child nodes in
// corresponding // this node. Each children update from the viewer is complete when
// to the number of child nodes in this node. // all the child nodes fill in their elements update. Once the
// Each children update from the viewer is complete when all the child // matrix is constructed, the child nodes are given the list of
// nodes // updates equal to the updates requested by the viewer.
// fill in their elements update.
// Once the matrix is constructed, the child nodes are given the list of
// updates
// equal to the updates requested by the viewer.
VMHasChildrenUpdate[][] elementsUpdates = new VMHasChildrenUpdate[childNodes.length][updates.length]; VMHasChildrenUpdate[][] elementsUpdates = new VMHasChildrenUpdate[childNodes.length][updates.length];
for (int i = 0; i < updates.length; i++) { for (int i = 0; i < updates.length; i++) {
final IHasChildrenUpdate update = updates[i]; final IHasChildrenUpdate update = updates[i];