blob: 34464f51c3d59fd4adda702930683b9493852715 [file] [log] [blame]
Justin Hilemanfd37e372010-04-26 13:30:18 -04001git-flow-completion
2===================
3
Justin Hilemanf7390da2010-08-23 09:44:10 -04004Bash and Zsh completion support for [git-flow](http://github.com/nvie/gitflow)
Justin Hilemanfd37e372010-04-26 13:30:18 -04005
6The contained completion routines provide support for completing:
7
Justin Hileman2a7b91d2010-04-26 17:38:05 -04008 * git-flow init, feature, hotfix and release
Justin Hilemanfd37e372010-04-26 13:30:18 -04009 * feature, hotfix and release branches
10 * remote feature branch names (for `git-flow feature track`)
11
12
Justin Hilemanf7390da2010-08-23 09:44:10 -040013Installation for Bash
14---------------------
Justin Hilemanfd37e372010-04-26 13:30:18 -040015
16To achieve git-flow completion nirvana:
17
18 0. Install git-completion.
19
20 1. Install this file. Either:
21
Justin Hileman1da3cb72010-05-12 14:38:18 -040022 a. Place it in a `bash_completion.d` folder:
Justin Hilemanfd37e372010-04-26 13:30:18 -040023
Justin Hileman1da3cb72010-05-12 14:38:18 -040024 * /etc/bash_completion.d
25 * /usr/local/etc/bash_completion.d
26 * ~/bash_completion.d
Justin Hilemanfd37e372010-04-26 13:30:18 -040027
28 b. Or, copy it somewhere (e.g. ~/.git-flow-completion.sh) and put the following line in
29 your .bashrc:
30
31 source ~/.git-flow-completion.sh
32
Justin Hileman3e77edb2010-08-05 13:40:10 -040033 2. If you are using Git < 1.7.1: Edit git-completion.sh and add the following line to the giant
Justin Hilemand0173602010-08-05 13:18:12 -040034 $command case in _git:
Justin Hilemanfd37e372010-04-26 13:30:18 -040035
Justin Hilemand0173602010-08-05 13:18:12 -040036 flow) _git_flow ;;
Justin Hilemanfd37e372010-04-26 13:30:18 -040037
Zifei Tong5eda7412010-08-22 13:22:27 +080038
Justin Hilemanf7390da2010-08-23 09:44:10 -040039Installation for Zsh
40--------------------
41
42To achieve git-flow completion nirvana:
43
44 0. Update your zsh's git-completion module to the newest verion --
45 [available here](http://zsh.git.sourceforge.net/git/gitweb.cgi?p=zsh/zsh;a=blob_plain;f=Completion/Unix/Command/_git;hb=HEAD).
46
47 1. Install this file. Either:
48
49 a. Place it in your .zshrc:
50
51 b. Or, copy it somewhere (e.g. ~/.git-flow-completion.zsh) and put the following line in
52 your .zshrc:
53
54 source ~/.git-flow-completion.zsh
55
56 c. Or, use this file as an oh-my-zsh plugin.
57
Justin Hilemanfd37e372010-04-26 13:30:18 -040058
59The Fine Print
60--------------
61
62Copyright (c) 2010 [Justin Hileman](http://justinhileman.com)
63
64Distributed under the [MIT License](http://creativecommons.org/licenses/MIT/)