Javadoc fixes

5 files changed, 7 insertions, 13 deletions

diff --git a/org.eclipse.handly/src/org/eclipse/handly/model/Elements.java b/org.eclipse.handly/src/org/eclipse/handly/model/Elements.java
index c81fa3d0..2561e137 100644
--- a/org.eclipse.handly/src/org/eclipse/handly/model/Elements.java
+++ b/org.eclipse.handly/src/org/eclipse/handly/model/Elements.java
@@ -113,7 +113,6 @@ public class Elements
      *
      * @param element not <code>null</code>
      * @return the element's model (never <code>null</code>)
-     * @throws IllegalStateException if the model is no longer accessible
      */
     public static IModel getModel(IElement element)
     {
diff --git a/org.eclipse.handly/src/org/eclipse/handly/model/IModel.java b/org.eclipse.handly/src/org/eclipse/handly/model/IModel.java
index 4087ad28..29003ba1 100644
--- a/org.eclipse.handly/src/org/eclipse/handly/model/IModel.java
+++ b/org.eclipse.handly/src/org/eclipse/handly/model/IModel.java
@@ -36,15 +36,13 @@ public interface IModel
 {
     /**
      * Returns a context which provides information and services pertaining
-     * to the model as a whole. The context, as a set of bindings, is immutable.
+     * to this model. The context, as a set of bindings, is immutable.
      * <p>
      * Note that the relationship between a model and its context does not
      * change over the lifetime of a model.
      * </p>
      *
-     * @param model not <code>null</code>
-     * @return the model's context (never <code>null</code>)
-     * @throws IllegalStateException if the model is no longer accessible
+     * @return the model context (never <code>null</code>)
      */
     IContext getModelContext();
 
diff --git a/org.eclipse.handly/src/org/eclipse/handly/model/impl/IElementImpl.java b/org.eclipse.handly/src/org/eclipse/handly/model/impl/IElementImpl.java
index 8d80d13c..7cb76818 100644
--- a/org.eclipse.handly/src/org/eclipse/handly/model/impl/IElementImpl.java
+++ b/org.eclipse.handly/src/org/eclipse/handly/model/impl/IElementImpl.java
@@ -88,9 +88,7 @@ public interface IElementImpl
      * not change over the lifetime of an element.
      * </p>
      *
-     * @param element not <code>null</code>
      * @return the element's model (never <code>null</code>)
-     * @throws IllegalStateException if the model is no longer accessible
      */
     IModel hModel();
 
diff --git a/org.eclipse.handly/src/org/eclipse/handly/model/impl/IModelManager.java b/org.eclipse.handly/src/org/eclipse/handly/model/impl/IModelManager.java
index dcea60fb..767fe053 100644
--- a/org.eclipse.handly/src/org/eclipse/handly/model/impl/IModelManager.java
+++ b/org.eclipse.handly/src/org/eclipse/handly/model/impl/IModelManager.java
@@ -25,7 +25,6 @@ public interface IModelManager
      * Returns the managed model.
      *
      * @return the managed model (never <code>null</code>)
-     * @throws IllegalStateException if the model is not accessible
      */
     IModel getModel();
 
@@ -34,7 +33,6 @@ public interface IModelManager
      * the model. Typical implementations would answer a model-specific singleton.
      *
      * @return the element manager (never <code>null</code>)
-     * @throws IllegalStateException if the element manager is not accessible
      */
     ElementManager getElementManager();
 
diff --git a/org.eclipse.handly/src/org/eclipse/handly/snapshot/ISnapshotProvider.java b/org.eclipse.handly/src/org/eclipse/handly/snapshot/ISnapshotProvider.java
index 99280d30..e03eaeb1 100644
--- a/org.eclipse.handly/src/org/eclipse/handly/snapshot/ISnapshotProvider.java
+++ b/org.eclipse.handly/src/org/eclipse/handly/snapshot/ISnapshotProvider.java
@@ -35,10 +35,11 @@ public interface ISnapshotProvider
      * Returns the current snapshot of the underlying resource or buffer.
      * The returned snapshot may immediately become stale or expire.
      * <p>
-     * Note that it is possible to obtain a {@link NonExpiringSnapshot#
-     * NonExpiringSnapshot(ISnapshotProvider) non-expiring} snapshot from the
-     * provider, although protractedly holding on non-expiring snapshots is not
-     * recommended, as they may potentially consume large amount of space.
+     * Note that it is possible to obtain a {@link
+     * NonExpiringSnapshot#NonExpiringSnapshot(ISnapshotProvider) non-expiring}
+     * snapshot from the provider, although protractedly holding on non-expiring
+     * snapshots is not recommended as they may potentially consume large amount
+     * of space.
      * </p>
      *
      * @return the current snapshot (never <code>null</code>)