Added python.el NEWS entry

Fixes to previous python.el ChangeLog entry.

* lisp/progmodes/python.el: (python-indent, python-guess-indent,
  python-use-skeletons): New obsolete variable aliases.
  (python-indent-guess-indent-offset): Make interactive.

Added ChangeLog entry for python.el merge.

Migrated python-font-lock-syntactic-keywords to python-syntax-propertize-function

This is a backport of Stefan Monnier's migration to the new font-lock
machinery (introduced in 2010-09-10T23:13:42Z!monnier@iro.umontreal.ca).

New Vars:
 + python-syntax-propertize-function

Deleted Vars:
 + python-font-lock-syntactic-keywords

Copyright information update

Revert "Merge pull request #83 from tkf/empty-triple-quote"

This reverts commit f4d086427343eb0b8bc91355388d2437c568b1f6, reversing
changes made to 8f697fd2ef23a9e1d9a06ac8ca419d76ccedb27d.

While the fix worked with empty triple quoted strings it broke simpler cases
like these:

    """
    def someting(a, b, c):
        "
    """

    or

    '''
    def someting(a, b, c):
        '
    '''

Another approach is needed for giving triple quoted string the correct syntax.

Make `which-func-functions' defaults to '(python-info-current-defun)

Function documentation enhancements

New defun navigation machinery

`python-nav-beginning-of-defun' and
`python-beginning-of-defun-function' have changed and now they don't
handle decorators anymore.

`python-end-of-defun-function' is now smart enough to detect the real
ending of the current defun.

`python-shell-send-defun' always sends the outermost defun and
includes decorators. When called with prefix argument the decorators
are skipped.

`python-info-current-defun' has been modified to use the new defun
movement API.

New Functions:
  + python-info-looking-at-beginning-of-defun

Enhancements on `python-beginning-of-defun-function' for `mark-defun' behavior.

`mark-defun' was failing when point was right at the start of a defun.

`python-nav-list-defun-positions' now caches defuns positions (#75)

This is a simplified version of @dandavison pull request (thanks dan!)

`python-nav-list-defun-positions' now uses
`python-nav-list-defun-positions-cache' buffer local variable to store
cached values of defun positions.

`python-nav-jump-to-defun' now benefits from this new cache and if
called with prefix argument it will invalidate it so new defuns are
scanned.

New Vars:
 + `python-nav-list-defun-positions-cache'

Enhancements to `python-end-of-defun-function' so it's not blocked by top level assignments (fixes #64)

Variable name change

python-shell-enable-syntax-highlighting -> python-shell-enable-font-lock

Enhancements to `python-indent-post-self-insert-function'

Fixed case where the paren base indentation is not 0.

Enhanced closing block notification when line is indented or a colon is inserted.

`python-indent-line' and `python-indent-electric-colon' now uses the
new `python-info-closing-block-message' function that takes care of
messaging the block the current line is closing (if applicable).

New Functions:
 + `python-info-closing-block-message'

Readjust indentation automatically on lines with closing parens.

For this to work `python-indent-post-self-insert-function' is added to
the `post-self-insert-hook.' when python-mode is initialized.

New functions:
 + `python-indent-post-self-insert-function'

Removed tabs and fixed indentation in several parts.

Do not call `switch-to-buffer' in `python-shell-get-or-create-process'

For this to work properly `run-python' now calls
`python-shell-make-comint' with the POP argument set to nil.

Treat empty triple quote

Fix #70

Small fix in `python-shell-send-defun' (#69 thanks mafm-git!)

Customizable variable to control syntax highlighting in shell.

Default is on.

Don't send "if __name__ == '__main__':" to interpreter

Disregard leading whitespace when forming module completions

This allows an indented import line (e.g. in a function or method
body) to be completed.

Deactivate mark on python-shell-send-region

Use `completion-at-point` instead of `comint-dynamic-complete` in shell completion

Pass entire line of input to module completer

The module completer wants e.g. 'from xxx' as input, not just 'xxx'.

This change also causes all modules to be offered as completions to
'from ', whereas previously this was regarded as empty input.

Enhancements on ipython 0.10 setup documentation (thanks to @tkf for the hint)

Added missing dot in `python-completion-complete-at-point' error

Enhanced completion subject finding logic for `python-shell-completion--do-completion-at-point'

Make `python-shell-completion--do-completion-at-point' to return a list for `completion-at-point' do it's job instead of replicating completion logic.

Removed vars:
 + python-shell-completion-original-window-configuration

Make `python-shell-completion--do-completion-at-point' work for calls done via `python-completion-complete-at-point'.

The comint prompt retrieval logic was failing on
`python-shell-completion--do-completion-at-point' when calls to it
happened from outside the process buffer.

python-end-of-defun-function now works correctly when comments are not indented properly.

Calling `end-of-defun' on a python file will now do the correct thing,
even for cases like this:

    def fib(n):
        if n < 2:
    #       base cases
            return n
        else:
            return fib(n - 2) + fib(n - 1)

Enhancements on indentation for lines after a backslash continuation.

Backslashed continuations with parens in the middle are now handled
correctly. Things like this are now indented properly:

objects = Thing.objects.all() \
                       .filter(
                           type="toy",
                           status="bought"
                           subtype="car"
                       ) \
                       .aggregate(
                           Sum('amount')
                       ) \
                       .values_list()

New Functions:

    * `python-info-beginning-of-backlash' returns the point where a
      backslashed line start.

Added self to the list of font-lock-keywords

Updated `python-font-lock-keywords' to match latest Python 2.7 and 3.2 documentation.

Beautified code

  * All columns are now less that 79 chars.
  * Removed tabs that were beign used to indent code.
  * Reindented the whole file.

Enhancements on indentation code and related functions.

This commit includes:

    * A more robust implementation of `python-indent-calculate-indentation'.
    * enhancements on `python-indent-context' when dealing with backslashes
      and blocks.
    * Many changes, comments and enhancements to
      `python-indent-calculate-indentation'. Many of them especially focused
      to match pep8 guidelines, being this one the most important new one:
      http://mail.python.org/pipermail/python-dev/2011-June/111760.html
    * Better `python-info-line-ends-backslash-p' that would work as intended
      on narrowed buffers.
    * `python-info-continuation-line-p' now does what's supposed to do.
    * Enhanced implementation of `python-info-continuation-line-p',
      `python-info-block-continuation-line-p' and
      `python-info-assignment-continuation-line-p'

New Functions:

    * `python-util-forward-comment' a simple replacement `forward-comment'
      with some necessary enhancements.

`python-check' now can have named buffers on its own depending the command launched.

New vars:
  + python-check-buffer-name

Enhancements on python-check command.

Use pyflakes (PyChecker is dead) and run the process respecting
virtualenv rules.

Removed :safe attribute for dangerous variables

Changed vars:
 + python-shell-interpreter
 + python-shell-interpreter-args
 + python-shell-completion-setup-code
 + python-shell-completion-string-code
 + python-shell-completion-module-string-code
 + python-shell-completion-pdb-string-code
 + python-ffap-setup-code
 + python-ffap-string-code
 + python-check-command
 + python-eldoc-setup-code
 + python-eldoc-string-code

Fixed docstring typos

Enhanced shell setup for Windows.

Also added documentation explaining how to spawn the iPython process
on Windows.

Added compatibility with lastest CEDET.

Obsolete variables definitions:
  + python-buffer => python-shell-internal-buffer

Obsolete functions definitions:
  + python-proc => python-shell-internal-get-or-create-process
  + python-send-string => python-shell-internal-send-string

Improvements on completion code.

Do no complete when defining a code block (we can't do this until
finding some way of getting raw tabs to the interpreter correctly)

Improved completion support when in [i]pdb

`python-shell-completion--do-completion-at-point' has been modified in
order to support different completion contexts easily.

New vars:
 + python-shell-completion-pdb-string-code

Added `python-pdbtrack-activate' variable to allow users to activate/deactivate pdbtrack.

To keep in sync with the old behavior its default value is t.

Renamed stuff to keep "namespace" clean.

Renamed vars:
 + python-shell-module-completion-string-code => python-shell-completion-module-string-code
 + python-completion-original-window-configuration => python-shell-completion-original-window-configuration

Don't request completions for zero-length input

Fixes a bug in which incorrect completion output was displayed, for
example when point was after a closing paren.

Make `python-shell-send-string-no-output' delete trailing newlines from output.

Dismiss completions buffer when unique completion has been made

Documentation enhancements

Renamed indentity occurrences to identity in previous commmit

Enhancements to internal python shell naming.

The internal python shell now takes into account more shell settings
in order to generate the unique hash for its name.

Also `python-shell-setup-codes' has been simplified and is not allowed
to be a list of cons anymore.

Enhancements to pdbtrack.

pdbtrack now handles correctly the case where the stacktrace
information is on the second line.

All python buffers not opened by the user and used for tracking are
closed automatically when tracking process finishes.

Simplified code for keeping the tracked buffer.

Removed vars:
 + python-pdbtrack-tracking-buffers

Removed functions:
 + python-pdbtrack-get-or-add-tracking-buffers

New vars:
 + python-pdbtrack-tracked-buffer
 + python-pdbtrack-buffers-to-kill

New functions:
 + python-pdbtrack-set-tracked-buffer

Enhancements to pdbtrack

pdbtracking now autodetects the filename being tracked from the prompt
and not from the `inferior-python-mode-current-file' variable.

Removed vars:
  + `inferior-python-mode-current-file'

Documentation enhancements and other small fixes.

Removed vars:
  + python-shell-import-line-regexp

Complete module import lines in addition to variable names

Available when using ipython v0.11. Completions on lines starting with
"from " or "import " are supplied by
IPython.core.completerlib.module_completion

ipython v0.11 configuration:

(setq python-shell-interpreter "ipython"
      python-shell-completion-setup-code
      "from IPython.core.completerlib import module_completion\n"
      python-shell-module-completion-string-code
      "';'.join(module_completion('''%s'''))\n"
      python-shell-completion-string-code
      "';'.join(get_ipython().Completer.all_completions('''%s'''))\n")

Return appropriate value to comint-dynamic-complete

This avoids a "No completions for ..." message being issued when a
completion has been made. Also, reduces redundancy between the
inferior-python-mode and python-mode completion code.

Enhancements to `python-shell-calculate-process-environment'

The `python-shell-extra-pythonpaths' variable have been introduced as
simple way of adding paths to the PYTHONPATH without affecting
existing values.

Enhancements on `python-shell-calculate-process-environment' and `python-shell-calculate-exec-path'

Removed functions:
 + python-util-merge

Added simple way of jumping to current buffer's class/function definitions

The new `python-nav-jump-to-defun' function allows a user to jump fast
and easy to a function or class definition in the current buffer. For
this a entry in the menu and the C-c C-j keybinding have been
introduced.

New functions:
 + `python-nav-list-defun-positions'
 + `python-nav-read-defun'
 + `python-nav-jump-to-defun'

The new function `python-nav-list-defun-positions' does the same as a
relevant part of the `python-imenu-create-index' so the latter has
been refactored to use it.

Enhancements to python-shell-send-string-no-output to work OK with iPython 0.11

Also the documentation has been updated with info to make iPython 0.11
and 0.10 work with python.el's shell integration.

Make run-python-internal to set process-query-on-exit-flag to nil

Also python-shell-make-comint now returns the process buffer name.

Fixed indentation case for after beginning of block

Renamed python-clone-local-variables to python-util-clone-local-variables

New function python-clone-local-variables

Copied from org.el: it allows the `python-shell-make-comint' to be
simplified. It copies all local variables from a buffer to the
current.

Fix typo enviroment => environment

Removed function:
    * python-shell-calculate-process-enviroment

New function:
    * python-shell-calculate-process-environment

Make shells inherit variables from parent buffer and internal shells not show by default.

python-shell-make-comint now passes all parent buffer variables to the
comint buffer created ensuring local variables work as intended. Also,
this function now receives a third optional argument called POP that
establishes if the created comint buffer should be displayed or not
after its creation.

Use defcustom with :safe whenever is possible.

Refactored run-python and run-python-internal.

Created new function python-shell-make-comint that takes care of
creating comint processes.

New Function:
    * python-shell-make-comint

Fixed cornercase for normal lines when indentation was triggered in the middle of them

Make python-info-continuation-line-p to check context type matches

In order for a line to be continuation of another, they must be on the
same context.

New Function:
    * python-info-ppss-context-type

Implemented simple virtualenv setup via python-shell-virtualenv-path variable.

when set to a string, makes the values stored in
`python-shell-process-environment' and `python-shell-exec-path' to be
modified properly so shells are started with the specified virtualenv.

New Variables:
    * python-shell-virtualenv-path

New functions:
    * python-shell-calculate-process-environment
    * python-shell-calculate-exec-path

Implemented internal python shell.

This new kind of shell is intended to be used for generic
communication related to defined configurations. The main difference
with global or dedicated shells is that these ones are attached to a
configuration, not a buffer. This means that can be used for example
to retrieve the sys.path and other stuff, without messing with user
shells.

New Variables:
    * python-shell-internal-buffer-name,

New functions:
    * python-shell-internal-get-process-name
    * run-python-internal
    * python-shell-internal-get-or-create-process
    * python-shell-internal-send-string (makes python-send-receive obsolete)

Backported triple quote syntax from Emacs 24

Make package description separator contain 3 dashes (ELPA conformance)

Updated TODO

fixed font-lock-builtin-face regexp

Set local variable `mode-require-final-newline' to t

None, True, False, Ellipsis, __debug__, and NotImplemented now use font-lock-constant-face

Also copyright, license, credits, quit, exit are removed from
font-lock since they are added by the site module and only useful for
shell interaction and not programs.

See: http://docs.python.org/release/3.1.3/library/constants.html#constants-added-by-the-site-module

python-info-current-defun: fixed cornercase that caused imenu to break

Added package information for ELPA conformance

Fixed eldoc behavior.

      * python-eldoc-setup-code: The code to get help now uses the
        inspect element. When an object doesn't have documentation and
        if it is callable it returns the signature for it. Also when
        an object does contain documentation it only returns the first
        line.

      * python-eldoc-at-point: has been simplified to just message the
        doc header of objects.

      * python-info-current-defun: was not taking into account the
        current indentation so point was always inside a defun, even
        if the indentation was less or equal than the defun above.

Indentation enhancements on after-backslash

Multiline sentences beginning with "import", "from" or "return" are
indented correctly now.

fixed last paren indentation logic

Fixed weird cornercase behavior in python-indent-calculate-indentation.

Doing (setq python-indent-levels '(0)) was causing the value of
python-indent-levels to not be initialized correctly on next calls to
python-indent-calculate-indentation. Using (setq python-indent-levels
(list 0)) instead does the trick but I'm not sure why.

increased forward-comment COUNT variable value in all calls

docstring enhancements

indentation fixes on after backslash

Implemented python-nav-backward-sentence, python-nav-forward-sentence

Also small fixes to python-nav-sentence-start and
python-nav-sentence-end were added.

Added python-nav-sentence-start and python-nav-sentence-end functions

fixed CL related bytecompilation errors and set make-tree for imenu default

Implemented imenu support.

New variables:
 + python-imenu-include-defun-type
 + python-imenu-make-tree
 + python-imenu-subtree-root-label
 + python-imenu-index-alist

New Functions:
 + python-imenu-tree-assoc
 + python-imenu-make-element-tree
 + python-imenu-make-tree
 + python-imenu-create-index

API changes:
 + python-info-current-defun now supports an optional argument called
 INCLUDE-TYPE.

Documentation enhancements with regards to code checking. (thanks schickm)

Fixed python-info-current-defun for classes without bases

Fixed infinite loop on python-info-current-defun

For this python-beginning-of-defun-function has been modified to
return t or nil if a defun was found.

Docstrings enhancements

Small cornercase fix to python-info-current-defun.

Returned the bad defun name when point was at the beginning of defun.

Fixed python-info-current-defun to match new navigation code.

python-nav-beginning-of-defun and python-beginning-of-defun-function
now support a new extra optional argument called NODECORATORS.