Bug 161435 - [flex] Promote asynchronous viewer framework to API
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/IInternalTreeModelViewer.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/IInternalTreeModelViewer.java
old mode 100755
new mode 100644
index ab5d690..a0ed967
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/IInternalTreeModelViewer.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/IInternalTreeModelViewer.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2009, 2010 Wind River Systems and others.
+ * Copyright (c) 2011 Wind River Systems and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -25,7 +25,7 @@
* provider to update the viewer with information retrieved from the
* content, proxy, memento, and other element-based providers.
*
- * @since 3.5
+ * @since 3.8
*/
public interface IInternalTreeModelViewer extends ITreeModelViewer {
@@ -61,6 +61,7 @@
* @param parentOrTreePath Parent object, or a tree path of the parent element.
* @param index Index at which to set the new element.
* @param element Element object.
+ * @noreference This method is not intended to be referenced by clients.
*/
public void replace(Object parentOrTreePath, final int index, Object element);
@@ -74,6 +75,7 @@
*
* @param elementOrTreePath The element, or tree path.
* @param count new value
+ * @noreference This method is not intended to be referenced by clients.
*/
public void setChildCount(final Object elementOrTreePath, final int count);
@@ -87,6 +89,7 @@
*
* @param elementOrTreePath the element, or tree path
* @param hasChildren new value.
+ * @noreference This method is not intended to be referenced by clients.
*/
public void setHasChildren(final Object elementOrTreePath, final boolean hasChildren);
@@ -98,6 +101,7 @@
* </p>
*
* @param elementPath tree path to element to consider for expansion
+ * @noreference This method is not intended to be referenced by clients.
*/
public void autoExpand(TreePath elementPath);
@@ -113,6 +117,8 @@
* @param expanded
* <code>true</code> if the node is expanded, and
* <code>false</code> if collapsed
+ *
+ * @noreference This method is not intended to be referenced by clients.
*/
public void setExpandedState(Object elementOrTreePath, boolean expanded);
@@ -129,6 +135,8 @@
* @param level
* non-negative level, or <code>ALL_LEVELS</code> to expand all
* levels of the tree
+ *
+ * @noreference This method is not intended to be referenced by clients.
*/
public void expandToLevel(Object elementOrTreePath, int level);
@@ -139,6 +147,7 @@
* This method should only be called by the viewer framework.
* </p>
* @param elementOrTreePath the element, or the tree path to the element
+ * @noreference This method is not intended to be referenced by clients.
*/
public void remove(Object elementOrTreePath);
@@ -150,6 +159,7 @@
*
* @param parentOrTreePath the parent element, the input element, or a tree path to the parent element
* @param index child index
+ * @noreference This method is not intended to be referenced by clients.
*/
public void remove(Object parentOrTreePath, final int index);
@@ -166,6 +176,7 @@
* @param element the element
* @param position a 0-based position relative to the model, or -1 to indicate
* the last position
+ * @noreference This method is not intended to be referenced by clients.
*/
public void insert(Object parentOrTreePath, Object element, int position);
@@ -190,10 +201,11 @@
public boolean getExpandedState(Object elementOrTreePath);
/**
+ * Returns whether the node corresponding to the given element or tree path
+ * has any child elements.
+ *
* @param elementOrTreePath Path to element
* @return Returns whether the given element has children.
- *
- * @since 3.6
*/
public boolean getHasChildren(Object elementOrTreePath);
@@ -201,6 +213,7 @@
* Returns the child count of the element at the given path. <br>
* Note: The child count may be incorrect if the element is not
* expanded in the tree.
+ *
* @param path Path to get count for.
* @return The child count.
*/
@@ -209,6 +222,7 @@
/**
* Returns the element which is a child of the element at the
* given path, with the given index.
+ *
* @param path Path to parent element.
* @param index Index of child element.
* @return Child element.
@@ -216,7 +230,10 @@
public Object getChildElement(TreePath path, int index);
/**
- * @return Returns the tree path of the element that is at the top of the
+ * Returns the tree path of the element that is at the top of the
+ * viewer.
+ *
+ * @return the tree path of the element at the top of the
* viewer.
*/
public TreePath getTopElementPath();
@@ -237,8 +254,6 @@
*
* @param parentPath Path of parent element.
* @return true if all children realized
- *
- * @since 3.6
*/
public boolean getElementChildrenRealized(TreePath parentPath);
@@ -246,8 +261,6 @@
* Clears the selection in the viewer, if any, without firing
* selection change notification. This is only to be used by
* the platform.
- *
- * @since 3.6
*/
public void clearSelectionQuiet();
@@ -267,6 +280,7 @@
* <code>null</code>.
* @param backgrounds Array of RGB values for background colors, may be
* <code>null</code>.
+ * @noreference This method is not intended to be referenced by clients.
*/
public void setElementData(TreePath path, int numColumns, String[] labels, ImageDescriptor[] images, FontData[] fontDatas, RGB[] foregrounds, RGB[] backgrounds);
@@ -291,7 +305,7 @@
* Retrieves the element check state.
*
* @param path Path of element to return check state for.
- * @return checked
+ * @return the element checked state
*/
public boolean getElementChecked(TreePath path);
@@ -299,7 +313,7 @@
* Retrieves the element's check box grayed state.
*
* @param path Path of element to return grayed state for.
- * @return grayed
+ * @return the element grayed state
*/
public boolean getElementGrayed(TreePath path);
}
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/ViewerStateTracker.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/ViewerStateTracker.java
index 77a133b..fa71299 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/ViewerStateTracker.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/ViewerStateTracker.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2009 Wind River Systems and others.
+ * Copyright (c) 2011 Wind River Systems and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ICheckUpdate.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ICheckUpdate.java
index 55db372..7e31d35 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ICheckUpdate.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ICheckUpdate.java
@@ -1,5 +1,5 @@
/*****************************************************************
- * Copyright (c) 2009 Texas Instruments and others
+ * Copyright (c) 2009, 2011 Texas Instruments and others
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IChildrenUpdate.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IChildrenUpdate.java
index 35bf6d0..6edbd2f 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IChildrenUpdate.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IChildrenUpdate.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2006 IBM Corporation and others.
+ * Copyright (c) 2006, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IColumnPresentation.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IColumnPresentation.java
index 294f284..9917653 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IColumnPresentation.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IColumnPresentation.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2006, 2007 IBM Corporation and others.
+ * Copyright (c) 2006, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementContentProvider.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementContentProvider.java
index 14ea1e3..d3b6828 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementContentProvider.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementContentProvider.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2006, 2008 IBM Corporation and others.
+ * Copyright (c) 2006, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementEditor.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementEditor.java
index b5ec054..e1890aa 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementEditor.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementEditor.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2006, 2007 IBM Corporation and others.
+ * Copyright (c) 2006, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementLabelProvider.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementLabelProvider.java
index b5abcc3..90551a5 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementLabelProvider.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementLabelProvider.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2006, 2008 IBM Corporation and others.
+ * Copyright (c) 2006, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementMementoProvider.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementMementoProvider.java
index d3be721..4160721 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementMementoProvider.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IElementMementoProvider.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2006, 2008 IBM Corporation and others.
+ * Copyright (c) 2006, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ILabelUpdate.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ILabelUpdate.java
index c1db5f8..0c24414 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ILabelUpdate.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ILabelUpdate.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2006, 2008 IBM Corporation and others.
+ * Copyright (c) 2006, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelChangedListener.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelChangedListener.java
index dfa7015..98470bc 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelChangedListener.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelChangedListener.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2005, 2006 IBM Corporation and others.
+ * Copyright (c) 2005, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelDelta.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelDelta.java
index 5cc5f48..3fb1dd6 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelDelta.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelDelta.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2005, 2009 IBM Corporation and others.
+ * Copyright (c) 2005, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -26,10 +26,8 @@
* </ul>
* </p>
* <p>
- * Clients are not intended to implement this interface directly. Instead, clients
- * creating and firing model deltas should create instances of
- * {@link ModelDelta}.
- * </p>
+ * @noimplement Clients are not intended to implement this interface directly. Instead, clients
+ * creating and firing model deltas should create instances of {@link ModelDelta}.
* </p>
* @since 3.2
*/
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelSelectionPolicy.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelSelectionPolicy.java
index d3f914e..f672ade 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelSelectionPolicy.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IModelSelectionPolicy.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IStateUpdateListener.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IStateUpdateListener.java
index 134001c..49830e0 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IStateUpdateListener.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IStateUpdateListener.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2009 IBM Corporation and others.
+ * Copyright (c) 2009, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -20,6 +20,7 @@
/**
* Notification that a sequence of state saving updates are starting.
+ *
* @param input Input object for the state operation.
*/
public void stateSaveUpdatesBegin(Object input);
@@ -27,12 +28,14 @@
/**
* Notification that viewer updates are complete. Corresponds to
* a <code>viewerUpdatesBegin()</code> notification.
+ *
* @param input Input object for the state operation.
*/
public void stateSaveUpdatesComplete(Object input);
/**
* Notification that a sequence of viewer updates are starting.
+ *
* @param input Input object for the state operation.
*/
public void stateRestoreUpdatesBegin(Object input);
@@ -40,6 +43,7 @@
/**
* Notification that viewer updates are complete. Corresponds to
* a <code>viewerUpdatesBegin()</code> notification.
+ *
* @param input Input object for the state operation.
*/
public void stateRestoreUpdatesComplete(Object input);
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ITreeModelViewer.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ITreeModelViewer.java
old mode 100755
new mode 100644
index 217d64b..25a04bc
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ITreeModelViewer.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ITreeModelViewer.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2009, 2011 Wind River Systems and others.
+ * Copyright (c) 2011 Wind River Systems and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -41,6 +41,7 @@
* Returns the Display object that this viewer is in. The
* display object can be used by clients to access the display thread
* to call the viewer methods.
+ *
* @return The display.
*/
public Display getDisplay();
@@ -56,6 +57,7 @@
* Returns the current input of this viewer, or <code>null</code>
* if none. The viewer's input provides the "model" for the viewer's
* content.
+ *
* @return Input object
*/
public Object getInput();
@@ -64,12 +66,14 @@
* Sets the input of this viewer. Setting the input resets the
* viewer's contents and triggers an update starting at the input
* element.
+ *
* @param object Input element, or <code>null</code> if none.
*/
public void setInput(Object object);
/**
* Returns the current selection in viewer.
+ *
* @return selection object
*/
public ISelection getSelection();
@@ -146,38 +150,42 @@
/**
* Registers the specified listener for view update notifications.
+ *
* @param listener Listener to add
*/
public void addViewerUpdateListener(IViewerUpdateListener listener);
/**
* Removes the specified listener from update notifications.
+ *
* @param listener Listener to remove
*/
public void removeViewerUpdateListener(IViewerUpdateListener listener);
/**
* Registers the specified listener for state update notifications.
+ *
* @param listener Listener to add
- * @since 3.6
*/
public void addStateUpdateListener(IStateUpdateListener listener);
/**
* Removes the specified listener from state update notifications.
+ *
* @param listener Listener to remove
- * @since 3.6
*/
public void removeStateUpdateListener(IStateUpdateListener listener);
/**
* Registers the specified listener for view label update notifications.
+ *
* @param listener Listener to add
*/
public void addLabelUpdateListener(ILabelUpdateListener listener);
/**
* Removes the specified listener from view label update notifications.
+ *
* @param listener Listener to remove
*/
public void removeLabelUpdateListener(ILabelUpdateListener listener);
@@ -185,13 +193,15 @@
/**
* Registers the given listener for model delta notification.
* This listener is called immediately after the viewer processes
- * the delta.
+ * the delta.
+ *
* @param listener Listener to add
*/
public void addModelChangedListener(IModelChangedListener listener);
/**
* Removes the given listener from model delta notification.
+ *
* @param listener Listener to remove
*/
public void removeModelChangedListener(IModelChangedListener listener);
@@ -200,6 +210,7 @@
* Writes state information into a delta for the sub-tree at the given
* path. It adds delta nodes and IModelDelta.EXPAND and IModelDelta.SELECT
* as it parses the sub-tree.
+ *
* @param path Path where to start saving the state.
* @param delta The delta where the state is to be saved.
* @param flagsToSave The flags to preserve during the state save. The
@@ -208,8 +219,6 @@
* @return Returns whether the state was saved for the given path. Will
* return <code>false</code> if an element at the given path cannot
* be found.
- *
- * @since 3.6
*/
public boolean saveElementState(TreePath path, ModelDelta delta, int flagsToSave);
@@ -237,8 +246,9 @@
public void refresh();
/**
- * Returns the paths at which the given elment is found realized in viewer
+ * Returns the paths at which the given element is found realized in viewer
* or an empty array if not found.
+ *
* @param element Element to find.
* @return Array of paths for given element.
*/
@@ -246,18 +256,21 @@
/**
* Returns filters currently configured in viewer.
+ *
* @return filter array in viewer.
*/
public ViewerFilter[] getFilters();
/**
* Add a new filter to use in viewer.
+ *
* @param filter Filter to add.
*/
public void addFilter(ViewerFilter filter);
/**
* Sets viewer filters to the filters in array.
+ *
* @param filters New filter array to use.
*/
public void setFilters(ViewerFilter[] filters);
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IVirtualItemValidator.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IVirtualItemValidator.java
index 752cfd0..b4d6f50 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IVirtualItemValidator.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/IVirtualItemValidator.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2009 Wind River Systems and others.
+ * Copyright (c) 2011 Wind River Systems and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -22,6 +22,7 @@
/**
* Allows the validator to determine whether the given item is to be deemed
* visible in the virtual tree.
+ *
* @param item Item to be tested.
* @return returns true if the item should be considered visible.
*/
@@ -29,6 +30,7 @@
/**
* Indicates that the viewer requested to reveal the given item in viewer.
+ *
* @param item Item to show.
*/
public void showItem(VirtualItem item);
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ModelDelta.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ModelDelta.java
index b8df0f8..1f40522 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ModelDelta.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ModelDelta.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2005, 2009 IBM Corporation and others.
+ * Copyright (c) 2005, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -11,16 +11,14 @@
*******************************************************************************/
package org.eclipse.debug.internal.ui.viewers.model.provisional;
-
-
-
/**
* A model delta. Used to create model deltas.
* <p>
- * Clients may instantiate this class; not intended to be subclassed.
+ * Clients may instantiate this class; not intended to be sub-classed.
* </p>
* @see IModelDelta
* @since 3.2
+ * @noextend This class is not intended to be sub-classed by clients.
*/
public class ModelDelta implements IModelDelta {
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/PresentationContext.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/PresentationContext.java
index aae44d8..5749640 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/PresentationContext.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/PresentationContext.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2005, 2010 IBM Corporation and others.
+ * Copyright (c) 2005, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/TreeModelViewer.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/TreeModelViewer.java
index 6018e23..0c26078 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/TreeModelViewer.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/TreeModelViewer.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2006, 2010 IBM Corporation and others.
+ * Copyright (c) 2006, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ViewerInputService.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ViewerInputService.java
index 777d250..d06ff9a 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ViewerInputService.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/ViewerInputService.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2007, 2009 IBM Corporation and others.
+ * Copyright (c) 2007, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -18,9 +18,10 @@
* Service to compute a viewer input from a source object
* for a given presentation context.
* <p>
- * This class may be instantiated. Not intended to be subclassed.
+ * This class may be instantiated, but it not intended to be sub-classed.
* </p>
* @since 3.4
+ * @noinstantiate This class is not intended to be instantiated by clients.
*/
public class ViewerInputService {
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualItem.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualItem.java
old mode 100755
new mode 100644
index 4977818..f28f479
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualItem.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualItem.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * Copyright (c) 2011 Wind River Systems and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -104,7 +104,7 @@
private boolean fExpanded = false;
/**
- * The cound of child items. <code>-1</code> indicates that the count
+ * The count of child items. <code>-1</code> indicates that the count
* is not known.
*/
private int fItemCount = -1;
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualTree.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualTree.java
old mode 100755
new mode 100644
index ef9e07e..a670a30
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualTree.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualTree.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * Copyright (c) 2011 Wind River Systems and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualTreeModelViewer.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualTreeModelViewer.java
index fb50d76..1b57cb0 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualTreeModelViewer.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/internal/ui/viewers/model/provisional/VirtualTreeModelViewer.java
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2008, 2010 Wind River Systems and others.
+ * Copyright (c) 2008, 2011 Wind River Systems and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -31,7 +31,7 @@
* </ul>
* </p>
* @since 3.5
- * @noextend
+ * @noextend This class is not intended to be sub-classed by clients.
*/
public class VirtualTreeModelViewer extends InternalVirtualTreeModelViewer {
@@ -51,7 +51,7 @@
* Creates a virtual tree model viewer.
* @param display Display used by the viewer to call the data providers
* on the UI thread.
- * @param style Stlye flags.
+ * @param style style flags.
* @param context Viewer's presentation context.
* @param validator Optional validator that is used to determine which items should be
* considered visible when SWT.VIRTUAL style is used. If <code>null</code> then the
