clarify rules for subclassing
diff --git a/org.eclipse.wst.common.snippets/schema/SnippetContributions.exsd b/org.eclipse.wst.common.snippets/schema/SnippetContributions.exsd
index a34229a..9053de5 100644
--- a/org.eclipse.wst.common.snippets/schema/SnippetContributions.exsd
+++ b/org.eclipse.wst.common.snippets/schema/SnippetContributions.exsd
@@ -121,7 +121,7 @@
<attribute name="class" type="string">
<annotation>
<documentation>
- An implementor of org.eclipse.wst.common.snippets.core.ISnippetsInsertion, it controls most of the interaction between the Snippets view and the rest of the workbench. It may be asked to insert the item into an editor by itself or provide information to control the Snippets view's drag and drop behavior. When one is not specified, org.eclipse.wst.common.snippets.insertions.VariableInsertion will be used. It provides querying for user-supplied values for variables and a simple text preview pane when inserting text into an editor. For drag and drop, it provides a SWT Transfer type that is usually associated with org.eclipse.wst.common.snippets.dnd.VariableTextDropAction. This drop action class will open the same variable querying and preview capable dialog when the OS-level drag and drop operation is completed.
+ An implementor of org.eclipse.wst.common.snippets.ui.ISnippetsInsertion, it controls most of the interaction between the Snippets view and the rest of the workbench. It may be asked to insert the item into an editor by itself or provide information to control the Snippets view's drag and drop behavior. When one is not specified, org.eclipse.wst.common.snippets.insertions.VariableInsertion will be used. It provides querying for user-supplied values for variables and a simple text preview pane when inserting text into an editor. For drag and drop, it provides a SWT Transfer type that is usually associated with org.eclipse.wst.common.snippets.dnd.VariableTextDropAction. This drop action class will open the same variable querying and preview capable dialog when the OS-level drag and drop operation is completed.
</documentation>
</annotation>
</attribute>
diff --git a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetCategory.java b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetCategory.java
index aae417c..f69dbd4 100644
--- a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetCategory.java
+++ b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetCategory.java
@@ -12,7 +12,9 @@
/**
* Represents a category containing individual snippets.
- *
+ * <p>
+ * Clients are not intended to implement this interface.
+ * </p>
* @since 1.0
*/
public interface ISnippetCategory extends ISnippetsEntry {
diff --git a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetItem.java b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetItem.java
index beb20e0..b75d941 100644
--- a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetItem.java
+++ b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetItem.java
@@ -13,7 +13,9 @@
/**
* A snippet item is the actual object draggable from the Snippets view.
- *
+ * <p>
+ * Clients are not intended to implement this interface.
+ * </p>
* @since 1.0
*/
public interface ISnippetItem extends ISnippetsEntry {
diff --git a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetVariable.java b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetVariable.java
index 45461db..5fee195 100644
--- a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetVariable.java
+++ b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetVariable.java
@@ -13,7 +13,9 @@
/**
* A variable is a user-prompted value meant to be filled-in by the user
* during insertion.
- *
+ * <p>
+ * Clients are not intended to implement this interface.
+ * </p>
* @since 1.0
*/
public interface ISnippetVariable {
diff --git a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetsEntry.java b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetsEntry.java
index dce3724..3e902d8 100644
--- a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetsEntry.java
+++ b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/core/ISnippetsEntry.java
@@ -16,7 +16,9 @@
* A Snippets Entry is an abstract notion encapsulating the values used to
* represent Snippet Items and Containers. No object implements only this
* interface.
- *
+ * <p>
+ * Clients are not intended to implement this interface.
+ * </p>
* @since 1.0
*/
diff --git a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/ui/DefaultSnippetInsertion.java b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/ui/DefaultSnippetInsertion.java
index e30b31f..381034d 100644
--- a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/ui/DefaultSnippetInsertion.java
+++ b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/ui/DefaultSnippetInsertion.java
@@ -40,7 +40,9 @@
* An insertion implementation that supports ISnippetVariables. The content
* string of the item can contain markers, in the form ${+variable+}, that
* will be replaced with user-supplied values at insertion time.
- *
+ * <p>
+ * Clients may subclass this class.
+ * </p>
* @since 1.0
*/
public class DefaultSnippetInsertion implements ISnippetInsertion {
diff --git a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/ui/ISnippetInsertion.java b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/ui/ISnippetInsertion.java
index 18fbaa5..02bb5b7 100644
--- a/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/ui/ISnippetInsertion.java
+++ b/org.eclipse.wst.common.snippets/src/org/eclipse/wst/common/snippets/ui/ISnippetInsertion.java
@@ -20,7 +20,9 @@
* An insertion class is responsible for inserting a snippet item's contents
* into editors. Implementors are responsible for supporting the drag-and-drop
* mechanism and inserting the snippet's text into a given editor part.
- *
+ * <p>
+ * Clients may implement this interface.
+ * </p>
* @since 1.0
*/
public interface ISnippetInsertion {
