From a8c1f2d0a5e072774bbdc09365e7214013a29e88 Mon Sep 17 00:00:00 2001
From: Nathan Sobo <nathan@github.com>
Date: Wed, 3 Sep 2014 16:35:54 -0600
Subject: [PATCH] Deprecate Workspace methods

---
 src/workspace.coffee | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/src/workspace.coffee b/src/workspace.coffee
index 65f1b1ddc..664dbb28b 100644
--- a/src/workspace.coffee
+++ b/src/workspace.coffee
@@ -153,6 +153,8 @@ class Workspace extends Model
   # Returns a subscription object with an `.off` method that you can call to
   # unregister the callback.
   eachEditor: (callback) ->
+    deprecate("Use Workspace::observeTextEditors instead")
+
     callback(editor) for editor in @getEditors()
     @subscribe this, 'editor-created', (editor) -> callback(editor)
 
@@ -160,12 +162,25 @@ class Workspace extends Model
   #
   # Returns an {Array} of {Editor}s.
   getEditors: ->
+    deprecate("Use Workspace::getTextEditors instead")
+
     editors = []
     for pane in @paneContainer.getPanes()
       editors.push(item) for item in pane.getItems() when item instanceof Editor
 
     editors
 
+  on: (eventName) ->
+    switch eventName
+      when 'editor-created'
+        deprecate("Use Workspace::onDidAddTextEditor or Workspace::observeTextEditors instead.")
+      when 'uri-opened'
+        deprecate("Use Workspace::onDidAddPaneItem instead.")
+      else
+        deprecate("Subscribing via ::on is deprecated. Use documented event subscription methods instead.")
+
+    super
+
   ###
   Section: Opening
   ###