Update docstrings for magic_edit (both the terminal version and the GUI version)

IPython/core/magic.py

@@ -2263,10 +2263,10 b' Currently the magic system has the following functions:\\n"""'
           %edit [options] [args]
 
         %edit runs IPython's editor hook.  The default version of this hook is
-        set to call the __IPYTHON__.rc.editor command.  This is read from your
-        environment variable $EDITOR.  If this isn't found, it will default to
-        vi under Linux/Unix and to notepad under Windows.  See the end of this
-        docstring for how to change the editor hook.
+        set to call the editor specified by your $EDITOR environment variable.
+        If this isn't found, it will default to vi under Linux/Unix and to
+        notepad under Windows. See the end of this docstring for how to change
+        the editor hook.
 
         You can also set the value of this editor via the 
         ``TerminalInteractiveShell.editor`` option in your configuration file. 
@@ -2327,7 +2327,7 b' Currently the magic system has the following functions:\\n"""'
         to load an editor exactly at the point where 'function' is defined,
         edit it and have the file be executed automatically.
 
-        If the object is a macro (see %macro for details), this opens up your
+        - If the object is a macro (see %macro for details), this opens up your
         specified editor with a temporary file containing the macro's data.
         Upon exit, the macro is reloaded with the contents of the file.
 

IPython/zmq/zmqshell.py

@@ -235,17 +235,9 b' class ZMQInteractiveShell(InteractiveShell):'
         Usage:
           %edit [options] [args]
 
-        %edit runs IPython's editor hook.  The default version of this hook is
-        set to call the __IPYTHON__.rc.dditor command.  This is read from your
-        environment variable $EDITOR.  If this isn't found, it will default to
-        vi under Linux/Unix and to notepad under Windows.  See the end of this
-        docstring for how to change the editor hook.
-
-        You can also set the value of this editor via the 
-        ``TerminalInteractiveShell.editor`` option in your configuration file. 
-        This is useful if you wish to use a different editor from your typical 
-        default with IPython (and for Windows users who typically don't set 
-        environment variables).
+        %edit runs an external text editor. You will need to set the command for
+        this editor via the ``TerminalInteractiveShell.editor`` option in your
+        configuration file before it will work.
 
         This command allows you to conveniently edit multi-line code right in
         your IPython session.
@@ -364,16 +356,7 b' class ZMQInteractiveShell(InteractiveShell):'
         Editing... done. Executing edited code...
         hello again
         Out[7]: "print 'hello again'n"
-
-
-        Changing the default editor hook:
-
-        If you wish to write your own editor hook, you can put it in a
-        configuration file which you load at startup time.  The default hook
-        is defined in the IPython.core.hooks module, and you can use that as a
-        starting example for further modifications.  That file also has
-        general instructions on how to set a new hook for use once you've
-        defined it."""
+        """
         
         opts,args = self.parse_options(parameter_s,'prn:')