Merged jpt_2_0_exp branch into Head.v20080202_Merged

1 files changed, 24 insertions, 13 deletions

diff --git a/jpa/plugins/org.eclipse.jpt.ui/src/org/eclipse/jpt/ui/internal/details/IJpaDetailsPage.java b/jpa/plugins/org.eclipse.jpt.ui/src/org/eclipse/jpt/ui/internal/details/IJpaDetailsPage.java
index ae78d2fc38..a370d5e440 100644
--- a/jpa/plugins/org.eclipse.jpt.ui/src/org/eclipse/jpt/ui/internal/details/IJpaDetailsPage.java
+++ b/jpa/plugins/org.eclipse.jpt.ui/src/org/eclipse/jpt/ui/internal/details/IJpaDetailsPage.java
@@ -1,28 +1,39 @@
 /*******************************************************************************
- *  Copyright (c) 2006, 2007 Oracle. All rights reserved. This
+ *  Copyright (c) 2006, 2008 Oracle. 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 http://www.eclipse.org/legal/epl-v10.html
- *  
+ *
  *  Contributors: Oracle. - initial API and implementation
  *******************************************************************************/
 package org.eclipse.jpt.ui.internal.details;
 
-import org.eclipse.jpt.core.internal.IJpaContentNode;
+import org.eclipse.jpt.core.internal.context.base.IJpaContextNode;
 import org.eclipse.swt.widgets.Control;
 
-public interface IJpaDetailsPage
+/**
+ * A details page is used to show the propery pane for a given context node. The
+ * <code>IJpaDetailsProvider</code> is responsible for creating the pane.
+ *
+ * @see IJpaDetailsProvider
+ *
+ * @version 2.0
+ * @since 2.0
+ */
+public interface IJpaDetailsPage<T extends IJpaContextNode>
 {
-	Control getControl();
-
 	/**
-	 * Set the content for the page and populate widgets
+	 * Returns this details' page's widget.
+	 *
+	 * @return The container of the widgets shown by this details page
 	 */
-	void populate(IJpaContentNode contentNode);
-	
-	
+	Control getControl();
+
 	/**
-	 * Perform any other disposal needed
+	 * Sets the subject for this details page.
+	 *
+	 * @param subject Either the new subject or <code>null</code> if the subject
+	 * needs to be removed
 	 */
-	void dispose();
-}
+	void setSubject(T subject);
+}
\ No newline at end of file