diff --git a/doc/fugitive.txt b/doc/fugitive.txt index 0d186bf..a008385 100644 --- a/doc/fugitive.txt +++ b/doc/fugitive.txt @@ -220,32 +220,38 @@ that are part of Git repositories). :[range]Gblame [flags] Run git-blame on the given range. *fugitive-:Gbrowse* -:[range]Gbrowse If the remote for the current branch is on GitHub, - open the current file, blob, tree, commit, or tag - (with git-web--browse) on GitHub. Otherwise, open the - current file, blob, tree, commit, or tag in - git-instaweb (if you have issues, verify you can run - "git instaweb" from a terminal). If a range is given, - it is appropriately appended to the URL as an anchor. +:Gbrowse Open the current file, blob, tree, commit, or tag + in your browser at the upstream hosting provider + indicated by the "origin" remote. 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 - at a list of domains: -> - let g:fugitive_github_domains = ['https://example.com'] -~ -:[range]Gbrowse! Like :Gbrowse, but put the URL on the clipboard rather - than opening it. + Upstream providers can be added by installing an + appropriate Vim plugin. For example, GitHub can be + supported by installing rhubarb.vim, available at + . (Native + support for GitHub is currently included, but that is + slated to be removed.) -:[range]Gbrowse {revision} - Like :Gbrowse, but for a given |fugitive-revision|. A + If no upstream support is available, a local instance + 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 latest commit rather than a volatile branch. -:[range]Gbrowse [...]@{remote} - Force using the given remote rather than the remote +:Gbrowse [...]@{remote} Force using the given remote rather than the remote for the current branch. The remote is used 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* These maps are available everywhere.