     return Int(bitPattern: malloc_size(unsafeAddressOf(self)))
   }
   
-  /// The actual number of elements allocated for this object.  May be
-  /// nontrivial to compute; it may be a good idea to store this
-  /// information in the value area upon creation.
+  /// The actual number of elements that can be stored in this object.
+  ///
+  /// This value may be nontrivial to compute; it is usually a good
+  /// idea to store this information in the "value" area when
+  /// an instance is created.
   public final var allocatedElementCount : Int {
     return (
       _allocatedByteCount &- ManagedBuffer._elementOffset &+ sizeof(Element) &- 1

  }

  /// The stored `Value` instance.
  public final var value: Value {
    get {
      return withUnsafeMutablePointerToValue {

    return result
  }

  /// Make ordinary initialization unavailable
  internal init(_doNotCallMe: ()) {
    fatalError("Only initialize these by calling create")
  }
  
