Add comments

lib/src/core/buffer/range.dart

@@ -20,10 +20,18 @@ abstract class BufferRange {
 
   BufferRange get normalized;
 
+  /// Convert this range to segments of single lines.
   Iterable<BufferSegment> toSegments();
 
+  /// Returns true if the given[position] is within this range.
   bool contains(CellOffset position);
+
+  /// Returns the smallest range that contains both this range and the given
+  /// [range].
   BufferRange merge(BufferRange range);
+
+  /// Returns the smallest range that contains both this range and the given
+  /// [position].
   BufferRange extend(CellOffset position);
 
   @override