The current help describes :Gdiffsplit! {object} as retaining focus on the current window and :Gvdiffsplit [object] as always splitting vertically, but it does not mention that the bang form with an argument also forces leftabove.
In practice, :Gvdiffsplit! {object} always opens the diff window on the left and then returns focus to the original window. That behavior appears intentional since commit c9aaf78541a02cd9e7a9a1f6fb77e525609cdadd ("Force :leftabove for :Gdiffsplit! with argument").
Would you be open to documenting this in :help fugitive? Even a short note under :Gdiffsplit! {object} or :Gvdiffsplit would help set expectations, because the current wording makes the left-side placement look surprising rather than deliberate.
The current help describes
:Gdiffsplit! {object}as retaining focus on the current window and:Gvdiffsplit [object]as always splitting vertically, but it does not mention that the bang form with an argument also forcesleftabove.In practice,
:Gvdiffsplit! {object}always opens the diff window on the left and then returns focus to the original window. That behavior appears intentional since commitc9aaf78541a02cd9e7a9a1f6fb77e525609cdadd("Force :leftabove for :Gdiffsplit! with argument").Would you be open to documenting this in
:help fugitive? Even a short note under:Gdiffsplit! {object}or:Gvdiffsplitwould help set expectations, because the current wording makes the left-side placement look surprising rather than deliberate.