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.

Replaced references from python-beginning-of-innermost-defun to python-beginning-of-defun-function

User customizable fill-paragraph behavior.

For this, four new variables which contain the symbol name of the
function that specifies the behavior of fill-paragraph on certain
conditions were added:

    * python-fill-comment-function: For comments
    * python-fill-string-function: For strings
    * python-fill-decorator-function: For decorators
    * python-fill-paren-function: For parens

All of these variables are safe local variables in the case the value
provided is a symbol. Out of the box, they default to these four new
functions respectively:

    * python-fill-comment
    * python-fill-string
    * python-fill-decorator
    * python-fill-paren

Corrected implementations for python-{beginning,end}-of-defun functions.

When point is at beginning-of-defun, end-of-defun moves to the end of
the defun, even if it contains nested defuns. When point is at any
inner defun end-of-defun moves to the end of it, if another inner
defun exists at the same level point is moved to it.

For beginning-of-defun things are funkier, it would move backwards
following nested defuns in order. This will be fixed soon.

Note: Decorators are considered part of defuns.

Removed:
    * python-use-beginning-of-innermost-defun
    * python-beginning-of-innermost-defun-regexp

Renamed:
    * python-beginning-of-defun => python-nav-beginning-of-defun
    * python-beginning-of-defun-regexp => python-nav-beginning-of-defun-regexp

New variable python-use-beginning-of-innermost-defun

Controls if beginning-of-defun function should go to outermost or
innermost defun.

Better indentation handling when inside parens.

Fixed indentation issue when indenting a python-indent-dedenter from end of line

new variables python-shell-process-environment and python-shell-exec-path

The main reason for these new variables is virtualenv support.

New variable python-shell-send-setup-max-wait

Controls the timeout for output just before sending the setup code.

Documentation enhancements

Better shell setup using the new python-shell-send-setup-codes function.

At the moment of shell setup, all the pending output is accepted so
the prompt is always displayed correctly.

Added indentation support for continuation of dotted expressions

Expressions like these are now supported and indented correctly:

    Object.objects.exclude(foo=1)\
                  .filter(bar=2)\
                  .values_list('baz')

Also added a small fix to python-info-assignment-continuation-line-p
to check the match for the operator is not inside some paren.

Enhancements to python-indent-electric-colon.

Only de-indent line if it really closes a block.

New function python-info-ppss-context

Use this function for most syntax-ppss related tasks. While in some
parts code could be longer it makes everything more readable.

This is the first step for a cleaner indentation machinery.

Added commentary about installing pyreadline on system that bundles Python without readline

Remove find-file-noselect invocation in python-shell-send-file

Use insert instead of insert-string

Better non-standard shell integration support

Added python-shell-prompt-output-regexp to match the prompts
added before output in shells like iPython. With the value of
this variable the output generated for
python-shell-send-string-no-ouput is cleaned up.

Moved completion variables and bindings setup for shell to
inferior-python-mode definition.

Renamed python-shell-completion-strings-code to
python-shell-completion-string-code.

improved python-shell-completion--get-completions string
splitting.

Cleaned up some unecessary messages.

Better code sending need test for python-shell-completion-setup
python-ffap-setup and python-eldoc-setup.

Added example for iPython integration in the commentary section.

Shell integration improvements and cleanups

Removed functions python-shell-clear-latest-output and
python-shell-send-and-clear-output in favor of
python-shell-send-string-no-output.

Also python-shell-send-string now supports multiline string statements
so you won't have to worry calling python-shell-send-file again.

All this changes should make integrations with other Python shells
than standard more robust.

python.el now bytecompiles without warnings

Implemented Skeletons after GNU/Emacs python.el

6 basic skeletons are defined: class, def, for, if, try and while.

While these skeletons are strongly based on GNU/Emacs' current
python.el a better definition macro, a generic template for
try/except/finally/else blocks and a cool menu display is included.

Explain we have python-indent-electric-colon

Don't deactivate mark after indenting commands

Small fix to python-indent-electric-colon

Check current indentation is greater than the current calculated
indentation.

Implemented python-indent-electric-colon

Fixed indentation of multi-line function call's closing parenthesis

Make inferior-python-mode-current-file be set via convert-standard-filename

Enhanced python-shell-send-file function

python-shell-send-file function now can be called interactively and
will do the right thing.

Also the python code that sent the file was improved so the shell
considers the correct path when evaluating the file.

Removed the inferior-python-mode-current-temp-file variable, after
this update inferior-python-mode-current-file is enough.

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

Use convert-standard-filename to fix temp files path

Fixed highlighting for dictionary assignments

Fixed pdb-track on Windows

make-temp-file is returning the temp file path with the wrong type of
slashes.

Fixed incorrect syntax highlighting for variable assignations

Fixed indentation guess logic to never accept 0 as a possible value

Implemented python-eldoc-at-point (python-describe-symbol replacement)

Implemented python-check

Small changes to ffap support

Added ffap support

Simplified python-eldoc-function using python-shell-send-and-clear-output

Implemeneted python-shell-clear-latest-output and python-shell-send-and-clear-output

Also Simplified python-shell-completion--get-completions using
python-shell-send-and-clear-output

Eldoc integration is now compatible with python 3

Make shell use completion-at-point for autocompletion.

Fixed called-interactively-p invocation.

Cleaned up TODO

Enhanced shell and code autocompletion.

python-shell-completion-complete-at-point and
python-completion-complete-at-point now share common code.

Also lots of fixes related to the cleanup of shell output has been
made so completion code is really robust now.

Fixes to shell completion at point