# rhubarb.vim

If [fugitive.vim][] is the Git, rhubarb.vim is the Hub.  Or at least it
could be.  One day.  Right now it's pretty stupid.  I almost named it
chubby.vim, but it just didn't feel right.

So far there's only one feature:  In Git commit messages, GitHub issues
can be omni-completed (`<C-X><C-O>`, see `:help compl-omni`).  This
makes inserting those `Closes #123` remarks slightly easier than copying
and pasting from the browser.

Maybe I'll extract `:Gbrowse` out of fugitive.vim and put it here
instead.  Or maybe I'll add some cool Gist stuff.  You never know with
rhubarb.vim.

[fugitive.vim]: https://github.com/tpope/vim-fugitive

## Installation

In addition to [fugitive.vim][], [Curl](http://curl.haxx.se/) is
required (included with OS X).  There are 5 ways you can tell
rhubarb.vim your GitHub credentials:

1. In a netrc:

        echo 'machine api.github.com login <user> password <password>'>>~/.netrc

2. In Git:

        git config --global github.user <user>
        git config --global github.password <password>

3. In your shell:

        export GITHUB_USER=<user>
        export GITHUB_PASSWORD=<password>

4. In Vim:

        let g:github_user = '<user>'
        let g:github_password = '<password>'

5. With an API token:

        let g:RHUBARB_TOKEN = '<token>'

If you don't have a preferred installation method, I recommend
installing [pathogen.vim](https://github.com/tpope/vim-pathogen), and
then simply copy and paste:

    cd ~/.vim/bundle
    git clone git://github.com/tpope/vim-rhubarb.git

Once help tags have been generated, you can view the manual with
`:help rhubarb`.

## FAQ

> How do I turn off that preview window that shows the issue body?

    set completeopt-=preview

## Self-Promotion

Like rhubarb.vim? Follow the repository on
[GitHub](https://github.com/tpope/vim-rhubarb).  And if
you're feeling especially charitable, follow [tpope](http://tpo.pe/) on
[Twitter](http://twitter.com/tpope) and
[GitHub](https://github.com/tpope).

## License

Copyright (c) Tim Pope.  Distributed under the same terms as Vim itself.
See `:help license`.