 #
 # ## Events
 #
+# ### path-changed
+#
+# Essential: Emit when the buffer's path, and therefore title, has changed.
+#
+# ### title-changed
+#
+# Essential: Emit when the buffer's path, and therefore title, has changed.
+#
+# ### modified-status-changed
+#
+# Extended: Emit when the result of {::isModified} changes.
+#
+# ### soft-wrap-changed
+#
+# Extended: Emit when soft wrap was enabled or disabled.
+#
+# * `softWrap` {Boolean} indicating whether soft wrap is enabled or disabled.
+#
+# ### grammar-changed
+#
+# Extended: Emit when the grammar that interprets and colorizes the text has
+# been changed.
+#
+#
+#
+# ### contents-modified
+#
+# Essential: Emit when the buffer's contents change. It is emit asynchronously
+# 300ms after the last buffer change. This is a good place to handle changes to
+# the buffer without compromising typing performance.
+#
+# ### contents-conflicted
+#
+# Extended: Emitted when the buffer's underlying file changes on disk at a
+# moment when the result of {::isModified} is true.
+#
 # ### will-insert-text
 #
-# Emit before the text has been inserted.
+# Extended: Emit before the text has been inserted.
 #
 # * `event` event {Object}
 #   * `text` {String} text to be inserted

#
# ### did-insert-text
#
# Emit after the text has been inserted.
#
# * `event` event {Object}
#   * `text` {String} text to be inserted
module.exports =
class Editor extends Model
  Serializable.includeInto(this)

  ###

  # Public: For each selection, replace the selected text with the given text.
  #
  # * `text` A {String} representing the text to insert.
  # * `options` See {Selection::insertText}.
