From 08137c52c71d8d78d713a420fc27b0f63f699a07 Mon Sep 17 00:00:00 2001 From: Foo Date: Thu, 14 Jul 2016 01:04:26 +0300 Subject: [PATCH 1/3] Update documentation regarding IPython --- docs/source/usage/other.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/source/usage/other.rst b/docs/source/usage/other.rst index 72bff6d1..1215dd91 100644 --- a/docs/source/usage/other.rst +++ b/docs/source/usage/other.rst @@ -124,6 +124,22 @@ For IPython>=0.11 add the following line to 'powerline.bindings.ipython.post_0_11' ] +For IPython>=5.0 you may use the above set up, but it is deprecated. It is +suggested to use + +.. code-block:: Python + + from powerline.bindings.ipython.since_5 import PowerlinePrompts + c = get_config() + c.TerminalInteractiveShell.simple_prompt = False + c.TerminalInteractiveShell.prompts_class = PowerlinePrompts + +.. note:: + Setting ``simple_prompt`` to False after IPython-5.0 is required regardless + of whether you use ``c.InteractiveShellApp.extensions`` setting or + ``c.TerminalInteractiveShell.prompts_class``. But you probably already have + this line because IPython is not very useful without it. + IPython=0.11* is not supported and does not work. IPython<0.10 was not tested (not installable by pip). From dd58d5f4cd01ec00efea27514d2b5f05f2de5043 Mon Sep 17 00:00:00 2001 From: Foo Date: Thu, 14 Jul 2016 01:05:00 +0300 Subject: [PATCH 2/3] =?UTF-8?q?Fix=20underline=20of=20=E2=80=9Ci3wm=20list?= =?UTF-8?q?ers=E2=80=9D=20section?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/source/configuration/listers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/configuration/listers.rst b/docs/source/configuration/listers.rst index e6ba06e7..7aaaabc2 100644 --- a/docs/source/configuration/listers.rst +++ b/docs/source/configuration/listers.rst @@ -29,7 +29,7 @@ Pdb listers :members: i3wm listers ----------- +------------ .. automodule:: powerline.listers.i3wm :members: From ead3ff33f3b2984f16892e1fff0c494209b51b01 Mon Sep 17 00:00:00 2001 From: Foo Date: Thu, 14 Jul 2016 01:25:10 +0300 Subject: [PATCH 3/3] Add warning regarding segments that use cwd to tmux usage docs --- docs/source/configuration/reference.rst | 2 ++ docs/source/usage/other.rst | 23 +++++++++++++++++++++++ docs/source/usage/shell-prompts.rst | 2 ++ 3 files changed, 27 insertions(+) diff --git a/docs/source/configuration/reference.rst b/docs/source/configuration/reference.rst index 99b32be1..c93cc0ce 100644 --- a/docs/source/configuration/reference.rst +++ b/docs/source/configuration/reference.rst @@ -191,6 +191,8 @@ Common configuration is a subdictionary that is a value of ``ext`` key in ``{output : theme_name}`` that maps the ``xrandr`` output names to the local themes to use on that output. +.. _config-ext-components: + ``components`` Determines which extension components should be enabled. This key is highly extension-specific, here is the table of extensions and corresponding diff --git a/docs/source/usage/other.rst b/docs/source/usage/other.rst index 1215dd91..18d25d99 100644 --- a/docs/source/usage/other.rst +++ b/docs/source/usage/other.rst @@ -100,6 +100,29 @@ root `):: to :file:`.tmux.conf`. +.. warning:: + Segments which depend on current working directory (e.g. + :py:func:`powerline.segments.common.vcs.branch`) require also setting up + :ref:`shell bindings `. It is not required to use powerline + shell prompt, :ref:`components setting ` allows to + set up only powerline bindings for tmux without altering your prompt. + Without setting up shell bindings powerline will use current working + directory of *tmux server* which is probably not what you need. + + Segments which depend on environment like + :py:func:`powerline.segments.common.env.virtualenv` will not work at all + (i.e. they will use environment of the tmux server), tracking environment + changes is going to slow down shell a lot. + + In any case it is suggested to avoid both kinds of segments in tmux + :ref:`themes ` because even support for tracking current + directory is very limited: + + #. It works only in shell. Should you e.g. run Vim and run ``:cd`` there you + will get current working directory from shell. + #. It works only in local shell and requires configuring it. + #. Some shells are not supported at all. + IPython prompt ============== diff --git a/docs/source/usage/shell-prompts.rst b/docs/source/usage/shell-prompts.rst index 2ad85365..0a5c1f38 100644 --- a/docs/source/usage/shell-prompts.rst +++ b/docs/source/usage/shell-prompts.rst @@ -1,3 +1,5 @@ +.. _usage-shell: + ************* Shell prompts *************