[Python-checkins] devguide: Move Misc/README.Emacs to here.

[brett.cannon]

brett.cannon pushed 46eb32c7368b to devguide:

http://hg.python.org/devguide/rev/46eb32c7368b
changeset:   157:46eb32c7368b
user:        Brett Cannon <brett at python.org>
date:        Thu Jan 20 11:30:28 2011 -0800
summary:
  Move Misc/README.Emacs to here.

files:
  emacs.rst
  index.rst

diff --git a/emacs.rst b/emacs.rst
new file mode 100644
--- /dev/null
+++ b/emacs.rst
@@ -0,0 +1,34 @@
+.. _emacs:
+
+=============
+Emacs support
+=============
+
+If you want to edit Python code in Emacs, you should download python-mode.el
+and install it somewhere on your load-path.  See the project page to download:
+
+    https://launchpad.net/python-mode
+
+While Emacs comes with a python.el file, it is not recommended.
+python-mode.el is maintained by core Python developers and is generally
+considered more Python programmer friendly.  For example, python-mode.el
+includes a killer feature called `pdbtrack` which allows you to set a pdb
+breakpoint in your code, run your program in an Emacs shell buffer, and do gud
+style debugging when the breakpoint is hit.
+
+python-mode.el is compatible with both GNU Emacs from the FSF, and XEmacs.
+
+For more information and bug reporting, see the above project page.  For help,
+development, or discussions, see the python-mode mailing list:
+
+    http://mail.python.org/mailman/listinfo/python-mode
+
+
+..
+   Local Variables:
+   mode: indented-text
+   indent-tabs-mode: nil
+   sentence-end-double-space: t
+   fill-column: 78
+   coding: utf-8
+   End:
diff --git a/index.rst b/index.rst
--- a/index.rst
+++ b/index.rst
@@ -82,6 +82,8 @@
 * Source code
     * `Browse online <http://svn.python.org/view/>`_
     * `Daily snapshot <http://svn.python.org/snapshots/>`_
+* Tool support
+    * :ref:`emacs`
 * Help with ...
     * :ref:`grammar`
     * :ref:`compiler`

--
Repository URL: http://hg.python.org/devguide