diff --git a/org.eclipse.handly.examples.javamodel/src/org/eclipse/handly/examples/javamodel/ICompilationUnit.java b/org.eclipse.handly.examples.javamodel/src/org/eclipse/handly/examples/javamodel/ICompilationUnit.java
index d3c37bc..51c540a 100644
--- a/org.eclipse.handly.examples.javamodel/src/org/eclipse/handly/examples/javamodel/ICompilationUnit.java
+++ b/org.eclipse.handly.examples.javamodel/src/org/eclipse/handly/examples/javamodel/ICompilationUnit.java
@@ -225,8 +225,8 @@
      * unsaved changes if it has been modified by another client.
      * <p>
      * The client takes (potentially shared) ownership of the returned buffer
-     * and is responsible for disposing it when finished. The buffer will be
-     * closed only after it is disposed by every owner. The buffer must not
+     * and is responsible for releasing it when finished. The buffer will be
+     * disposed only after it is released by every owner. The buffer must not
      * be accessed by clients which don't own it.
      * </p>
      *
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 3fb2e73..8b491f2 100644
--- a/org.eclipse.handly/src/org/eclipse/handly/model/Elements.java
+++ b/org.eclipse.handly/src/org/eclipse/handly/model/Elements.java
@@ -454,8 +454,8 @@
      * changes if it has been modified by another client.
      * <p>
      * The client takes (potentially shared) ownership of the returned buffer
-     * and is responsible for disposing it when finished. The buffer will be
-     * closed only after it is disposed by every owner. The buffer must not
+     * and is responsible for releasing it when finished. The buffer will be
+     * disposed only after it is released by every owner. The buffer must not
      * be accessed by clients which don't own it.
      * </p>
      *
@@ -476,8 +476,8 @@
      * changes if it has been modified by another client.
      * <p>
      * The client takes (potentially shared) ownership of the returned buffer
-     * and is responsible for disposing it when finished. The buffer will be
-     * closed only after it is disposed by every owner. The buffer must not
+     * and is responsible for releasing it when finished. The buffer will be
+     * disposed only after it is released by every owner. The buffer must not
      * be accessed by clients which don't own it.
      * </p>
      * <p>
diff --git a/org.eclipse.handly/src/org/eclipse/handly/model/ISourceFileExtension.java b/org.eclipse.handly/src/org/eclipse/handly/model/ISourceFileExtension.java
index 332e8fa..564075c 100644
--- a/org.eclipse.handly/src/org/eclipse/handly/model/ISourceFileExtension.java
+++ b/org.eclipse.handly/src/org/eclipse/handly/model/ISourceFileExtension.java
@@ -95,8 +95,8 @@
      * changes if it has been modified by another client.
      * <p>
      * The client takes (potentially shared) ownership of the returned buffer
-     * and is responsible for disposing it when finished. The buffer will be
-     * closed only after it is disposed by every owner. The buffer must not
+     * and is responsible for releasing it when finished. The buffer will be
+     * disposed only after it is released by every owner. The buffer must not
      * be accessed by clients which don't own it.
      * </p>
      *
@@ -116,8 +116,8 @@
      * changes if it has been modified by another client.
      * <p>
      * The client takes (potentially shared) ownership of the returned buffer
-     * and is responsible for disposing it when finished. The buffer will be
-     * closed only after it is disposed by every owner. The buffer must not
+     * and is responsible for releasing it when finished. The buffer will be
+     * disposed only after it is released by every owner. The buffer must not
      * be accessed by clients which don't own it.
      * </p>
      * <p>
diff --git a/org.eclipse.handly/src/org/eclipse/handly/model/impl/ISourceFileImpl.java b/org.eclipse.handly/src/org/eclipse/handly/model/impl/ISourceFileImpl.java
index 4dbcd7d..beab860 100644
--- a/org.eclipse.handly/src/org/eclipse/handly/model/impl/ISourceFileImpl.java
+++ b/org.eclipse.handly/src/org/eclipse/handly/model/impl/ISourceFileImpl.java
@@ -103,8 +103,8 @@
      * changes if it has been modified by another client.
      * <p>
      * The client takes (potentially shared) ownership of the returned buffer
-     * and is responsible for disposing it when finished. The buffer will be
-     * closed only after it is disposed by every owner. The buffer must not
+     * and is responsible for releasing it when finished. The buffer will be
+     * disposed only after it is released by every owner. The buffer must not
      * be accessed by clients which don't own it.
      * </p>
      *
@@ -124,8 +124,8 @@
      * changes if it has been modified by another client.
      * <p>
      * The client takes (potentially shared) ownership of the returned buffer
-     * and is responsible for disposing it when finished. The buffer will be
-     * closed only after it is disposed by every owner. The buffer must not
+     * and is responsible for releasing it when finished. The buffer will be
+     * disposed only after it is released by every owner. The buffer must not
      * be accessed by clients which don't own it.
      * </p>
      * <p>