tpope / vim-projectionist

projectionist.vim: Granular project configuration
https://www.vim.org/scripts/script.php?script_id=4989
1.06k stars 67 forks source link

Navigation commands #179

Closed j-xella closed 1 year ago

j-xella commented 1 year ago

Hi, I am new to this plugin, and trying to get my head around it.

Could someone clarify the navigation commands? The documentation mentions:

In addition to any navigation commands provided by your projections (which take the form :Efoo, :Sfoo, :Vfoo, :Tfoo, :Dfoo, and :Ofoo)

tpope commented 1 year ago
  • What actually do those capital letters do? Some examples? How are they different from :A?

https://github.com/tpope/vim-projectionist/blob/3a088946adb24a2fac7b47f3dea97a3b99f52ddd/README.markdown?plain=1#L80-L81

(The help file in doc/ doesn't do as good of a job explaining this, but does explain those letters [Edit: link fixed] in passing.)

  • Is "foo" the value of type attribute?

Yes.

j-xella commented 1 year ago
  • What actually do those capital letters do? Some examples? How are they different from :A?

https://github.com/tpope/vim-projectionist/blob/3a088946adb24a2fac7b47f3dea97a3b99f52ddd/README.markdown?plain=1#L80-L81

(The help file in doc/ doesn't do as good of a job explaining this, but does explain those letters in passing.)

And D with O ?

tpope commented 1 year ago

I screwed up my "explain those letters" link, it was supposed to go here: https://github.com/tpope/vim-projectionist/blob/3a088946adb24a2fac7b47f3dea97a3b99f52ddd/doc/projectionist.txt#L144-L158

As you can probably imagine, D for reaD and O for drOp is a horrible accident of history, and combined with the fact they're both niche commands most users won't care about, I've deliberately omitted them from the README. But the help file should still be clearer, I'll look into fixing that.