Improve docs for opening links in existing split: How to give [reuse] Argument to VimwikiSplitLink?

[kiedan]

Sometimes I would like to leave my index page open in a split and open links next to it. The help for VimwikiSplitLink states:

„If the argument 'reuse' is given and nonzero, the link is opened in a possibly existing split window instead of making a new split.“

That sounds perfect for this usecase, however I can‘t seem to figure out how to pass the reuse argument …

:VimwikiVSplitLink -reuse
:VimwikiVSplitLink -reuse=1

… and a few other things I tried did not work. (It opens a new split but always a new one for every link)
What is the correct syntax here?

—-
Wimwiki Version: 2023.05.12
NVIM v0.9.4

[kiedan]

PS: I think this the argument should be given directly, without a seperator, right?
So it should just be:
:VimwikiVSplitLink reuse
But still: I get a new split every time. Perhaps somebody can confirm if the command is correct this way?

[brennen]

Hmm, yeah, I couldn't seem to get this to work at first.

Looking at the start of follow_split():

function! vimwiki#base#follow_link(split, ...) abort
  " Jump to link target (Enter press, Exported)
  let reuse_other_split_window = a:0 >= 1 ? a:1 : 0
  let move_cursor_to_new_window = a:0 >= 2 ? a:2 : 1

reuse_other_split_window is getting set...

Finally realized that the string "reuse" is false, as far as Vim is concerned. What you need here is:

:VimwikiVSplitLink 1

This isn't super clear from the docs. We can fix that up.