From d8ce8d1d03a6bb2d04b187555859f62d0272702a Mon Sep 17 00:00:00 2001
From: Tim Pope <code@tpope.net>
Date: Mon, 30 Nov 2015 22:25:50 -0500
Subject: [PATCH] Document transition to rhubarb.vim
---
doc/fugitive.txt | 46 ++++++++++++++++++++++++++--------------------
1 file changed, 26 insertions(+), 20 deletions(-)
diff --git a/doc/fugitive.txt b/doc/fugitive.txt
index 0d186bff..a008385b 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.
-
- 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.
-
-:[range]Gbrowse {revision}
- Like :Gbrowse, but for a given |fugitive-revision|. A
+: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.
+
+ Upstream providers can be added by installing an
+ appropriate Vim plugin. For example, GitHub can be
+ supported by installing rhubarb.vim, available at
+ <https://github.com/tpope/vim-rhubarb>. (Native
+ support for GitHub is currently included, but that is
+ slated to be removed.)
+
+ 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.
--
GitLab