--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/agent/src/share/classes/sun/jvm/hotspot/ui/EditorFactory.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,51 @@
+/*
+ * Copyright 2001 Sun Microsystems, Inc.  All Rights Reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.com if you need additional information or
+ * have any questions.
+ *
+ */
+
+package sun.jvm.hotspot.ui;
+
+import javax.swing.JComponent;
+
+/** An EditorFactory is the basis of pluggable editor components. One
+    can configure the debugger with a new EditorFactory, which
+    completely replaces how the debugger displays source code. */
+
+public interface EditorFactory {
+  /** Opens the given file in a new window. The debugger has already
+      taken care of ensuring that the file can be found. The debugger
+      will typically not create two Editor objects for the same source
+      file, as it keeps track of open files. The EditorCommands object
+      provided to the Editor by the debugger allows the Editor to
+      notify the debugger of events such as a breakpoint being set or
+      a window being closed. */
+  public Editor openFile(String filename, EditorCommands commands);
+
+  /** Retrieves the current topmost file of all of the Editors this
+      EditorFactory has opened. This is used for the debugger user
+      interface to request that a breakpoint be set. (Editors can also
+      request that breakpoints be set via the EditorCommands, but this
+      is intended to support external editors with their own
+      keystrokes for performing this operation.) Returns null if there
+      is no file currently being edited. */
+  public Editor getCurrentEditor();
+}