From ffcd8f72340980fe36a04054b4face7f9e4399d4 Mon Sep 17 00:00:00 2001 From: ZyX Date: Thu, 19 Feb 2015 23:06:33 +0300 Subject: [PATCH 1/2] Add information about fish requirements --- docs/source/usage.rst | 8 ++++++++ docs/source/usage/shell-prompts.rst | 2 ++ 2 files changed, 10 insertions(+) diff --git a/docs/source/usage.rst b/docs/source/usage.rst index 5605c891..3ae5e8cc 100644 --- a/docs/source/usage.rst +++ b/docs/source/usage.rst @@ -22,6 +22,14 @@ Vim version 7.4 or newer is recommended for performance reasons, but Powerline is known to work on vim-7.0.112 (some segments may not work though as it was not actually tested). +Shell prompts requirements +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Due to fish having incorrect code for prompt width calculations up to version +2.1 and no way to tell that certain sequence of characters has no width +(``%{…%}`` in zsh and ``\[…\]`` in bash prompts serve exactly this purpose) +users that have fish versions below 2.1 are not supported.. + .. _usage-terminal-emulators: Terminal emulator requirements diff --git a/docs/source/usage/shell-prompts.rst b/docs/source/usage/shell-prompts.rst index f10beedd..c47d8399 100644 --- a/docs/source/usage/shell-prompts.rst +++ b/docs/source/usage/shell-prompts.rst @@ -65,6 +65,8 @@ the absolute path to the Powerline installation directory: set fish_function_path $fish_function_path "{repository_root}/powerline/bindings/fish" powerline-setup +.. warning:: Fish is supported only starting from version 2.1. + Rcsh prompt =========== From 98455c46cec7993fdb72723d6c9784c26fee7d93 Mon Sep 17 00:00:00 2001 From: ZyX Date: Thu, 19 Feb 2015 23:08:25 +0300 Subject: [PATCH 2/2] Update Vim version requirements --- docs/source/usage.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/source/usage.rst b/docs/source/usage.rst index 3ae5e8cc..6dca07f8 100644 --- a/docs/source/usage.rst +++ b/docs/source/usage.rst @@ -19,8 +19,7 @@ related Python headers to be installed. Please consult distribution’s documentation for details on how to compile and install packages. Vim version 7.4 or newer is recommended for performance reasons, but Powerline -is known to work on vim-7.0.112 (some segments may not work though as it was not -actually tested). +supports Vim 7.0.112 and higher. Shell prompts requirements ^^^^^^^^^^^^^^^^^^^^^^^^^^