Added commentary about auto-indentation on newlines for python-mode.el users

1 files changed, 16 insertions, 1 deletions

diff --git a/lisp/progmodes/python.el b/lisp/progmodes/python.el
index aef559f8b74..a243f6cbe25 100644
--- a/lisp/progmodes/python.el
+++ b/lisp/progmodes/python.el
@@ -54,7 +54,7 @@
 ;; word.  Shell completion is implemented in a manner that if you
 ;; change the `python-shell-interpreter' to any other (for example
 ;; IPython) it should be easy to integrate another way to calculate
-;; completions.  You just need to especify your custom
+;; completions.  You just need to specify your custom
 ;; `python-shell-completion-setup-code' and
 ;; `python-shell-completion-strings-code'
 
@@ -78,6 +78,21 @@
 ;; might guessed you should run `python-shell-send-buffer' from time
 ;; to time to get better results too.
 
+;; If you used python-mode.el you probably will miss auto-indentation
+;; when inserting newlines.  To achieve the same behavior you have
+;; two options:
+
+;; 1) Use GNU/Emacs' standard binding for `newline-and-indent': C-j.
+
+;; 2) Add the following hook in your .emacs:
+
+;; (add-hook 'python-mode-hook
+;;   #'(lambda ()
+;;       (define-key python-mode-map "\C-m" 'newline-and-indent)))
+
+;; I'd recommend the first one since you'll get the same behavior for
+;; all modes out-of-the-box.
+
 ;;; Installation:
 
 ;; Add this to your .emacs: