Document transition to rhubarb.vim

This commit is contained in:
Tim Pope 2015-11-30 22:25:50 -05:00
parent 23faeadc7c
commit d8ce8d1d03

View File

@ -220,32 +220,38 @@ that are part of Git repositories).
:[range]Gblame [flags] Run git-blame on the given range. :[range]Gblame [flags] Run git-blame on the given range.
*fugitive-:Gbrowse* *fugitive-:Gbrowse*
:[range]Gbrowse If the remote for the current branch is on GitHub, :Gbrowse Open the current file, blob, tree, commit, or tag
open the current file, blob, tree, commit, or tag in your browser at the upstream hosting provider
(with git-web--browse) on GitHub. Otherwise, open the indicated by the "origin" remote. If a range is
current file, blob, tree, commit, or tag in given, it is appropriately appended to the URL as an
git-instaweb (if you have issues, verify you can run anchor.
"git instaweb" from a terminal). If a range is given,
it is appropriately appended to the URL as an anchor.
To use with GitHub FI, point g:fugitive_github_domains Upstream providers can be added by installing an
at a list of domains: appropriate Vim plugin. For example, GitHub can be
> supported by installing rhubarb.vim, available at
let g:fugitive_github_domains = ['https://example.com'] <https://github.com/tpope/vim-rhubarb>. (Native
~ support for GitHub is currently included, but that is
:[range]Gbrowse! Like :Gbrowse, but put the URL on the clipboard rather slated to be removed.)
than opening it.
:[range]Gbrowse {revision} If no upstream support is available, a local instance
Like :Gbrowse, but for a given |fugitive-revision|. A of git-instaweb will be started and used instead.
:Gbrowse {revision} Like :Gbrowse, but for a given |fugitive-revision|. A
useful value here is -, which ties the URL to the useful value here is -, which ties the URL to the
latest commit rather than a volatile branch. latest commit rather than a volatile branch.
:[range]Gbrowse [...]@{remote} :Gbrowse [...]@{remote} Force using the given remote rather than the remote
Force using the given remote rather than the remote
for the current branch. The remote is used to for the current branch. The remote is used to
determine which GitHub repository to link to. determine which GitHub repository to link to.
:{range}Gbrowse [args] Appends an anchor to the URL that emphasizes the
selected lines. You almost certainly want to give a
"-" argument in this case to force the URL to include
an exact revision.
:[range]Gbrowse! [args] Like :Gbrowse, but put the URL on the clipboard rather
than opening it.
MAPPINGS *fugitive-mappings* MAPPINGS *fugitive-mappings*
These maps are available everywhere. These maps are available everywhere.