Hi Bram,
On Mon, Dec 17, 2018 at 11:43 AM Bram Moolenaar
<[email protected]> wrote:
>
> We keep adding more features and complexity, making it difficult for
> someone who reads the help to understand what it's all for. In many
> cases it would help to add tags and tag references, so that the reader
> can find the relevant explanation.
>
I will add the additional tags and see whether we can enhance the help
text for the getqflist() and setqflist() functions.
Most of the recently added quickfix functionality is targeted at getting
and setting the various quickfix stack/list properties using the getqflist()
and setqflist() functions. Same for the location lists/stacks using the
getloclist() and setloclist() functions.
>
> > Add the 'idx' item to the {what} argument for the setqflist() and
> > setloclist() functions to set the current index.
>
> This uses the term "file window id". There currently is one place where
> 'filewinid' is mentioned, and the explanation is hard to understand.
> I think this deserves some more words to explain what it is and how to
> use it.
>
The "filewinid" is not related to this change and was introduced in 8.1.0345.
I forgot to add an example for showing how to get it in that patch.
I am adding an example in this patch.
>
> + idx index of the current entry in the list
>
> In what list? This is also unclear.
>
The setqflist() is modifying a particular quickfix list specified either by an
identifier (id) or by a number in the stack (nr). All the other attributes in
the {what} argument are applied to this list. In this case, the 'idx' changes
the index of the current selection in the list specified by {id} or {nr}.
Regards,
Yegappan
--
--
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
For more options, visit https://groups.google.com/d/optout.
