From fb9acc683155f0dc6f22d6b8eca7b835e1c6328f Mon Sep 17 00:00:00 2001 From: Tim Pope Date: Sat, 3 Aug 2019 20:32:27 -0400 Subject: [PATCH] Add a FAQ entry about remote passwords --- README.markdown | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.markdown b/README.markdown index cd30790..d754b19 100644 --- a/README.markdown +++ b/README.markdown @@ -82,6 +82,21 @@ Fugitive cares about the current file, not the current working directory. Edit a file from the repository. To avoid the blank window problem, favor commands like `:split` and `:tabedit` over commands like `:new` and `:tabnew`. +> Why can't I enter my password when I `:Gpush`? + +It is highly recommended to use SSH keys or [credentials caching][] to avoid +entering your password on every upstream interaction. If this isn't an +option, the official solution is to use the `core.askPass` Git option to +request the password via a GUI. Fugitive will configure this for you +automatically if you have `ssh-askpass` or `git-gui` installed; otherwise it's +your responsibility to set this up. + +As an absolute last resort, you can invoke `:Git --paginate push`. Fugitive +recognizes the pagination request and fires up a `:terminal`, which allows for +interactive password entry. + +[credentials caching]: https://help.github.com/en/articles/caching-your-github-password-in-git + ## Self-Promotion Like fugitive.vim? Follow the repository on