From: Oleg Broytman <phd@phdru.name>
Date: Sun, 23 Aug 2015 15:53:57 +0000 (+0300)
Subject: Explain bash/zsh completion
X-Git-Url: https://git.phdru.name/?a=commitdiff_plain;h=76a62f1684e83e3a902c5f4baddf87046de87e5f;p=git-wiki.git

Explain bash/zsh completion
---

diff --git a/pep-git.txt b/pep-git.txt
index 5a4ec80..5aa0583 100644
--- a/pep-git.txt
+++ b/pep-git.txt
@@ -757,7 +757,7 @@ case the argument for such option must be spelled in sticky way:
 argument the latter means "use default value for option ``-O`` and
 pass ``arg`` further to the option parser". For example, ``git grep``
 has an option ``-O`` that passes found files to a program; default
-program for ``-O`` is pager (ususally ``less``), but you can use your
+program for ``-O`` is pager (usually ``less``), but you can use your
 editor::
 
     $ git grep -Ovim # but not -O vim
@@ -766,8 +766,26 @@ BTW, there is a difference between running ``git grep -O`` and ``git
 grep -Oless`` - in the latter case ``git grep`` passes ``+/pattern``
 option to less.
 
-TODO: bash/zsh completion, bash/zsh prompt.
-https://git.kernel.org/cgit/git/git.git/tree/contrib/completion
+bash/zsh completion
+-------------------
+
+It's a bit hard to type ``git rebase --interactive --preserve-merges
+HEAD~5`` manually even for those who are happy to use command-line,
+and this is where shell completion is of great help. Bash/zsh come
+with programmable completion, often automatically preinstalled and
+enabled, so if you have bash/zsh and git installed, chances are you
+are already done - just go and use it at the command-line.
+
+If you don't have necessary bits preinstalled, install and enable
+bash_completion package. If you want to upgrade your git completion to
+the latest and greatest download necessary file from `git contrib
+<https://git.kernel.org/cgit/git/git.git/tree/contrib/completion>`_.
+
+Git-for-windows comes with git-bash, bash completion is installed and
+enabled.
+
+
+TODO: bash/zsh prompt.
 
 
 git on server