Let's look up help on how to write a function
:h function
Ok, that's wrong.
Let's look up vimscript then, that probably has function information
:h vimscript
Nope, that's not what we want. But obviously function is further down the list
/function
Oh dear.
Let's say we want to do something on opening a python file, and we see someone else using Bufenter
:h bufenter
Ok, no usage examples. What to do?
Eventually we find out about autocmd, by luck. What if we want to include multiple statements in an autocmd?
:h autocmd
Nothing
/multiple
Nothing
Let's say (when you get lucky, again) and find out about :cmd1 | cmd2, you want to learn about |
:h |
nope
:h pipe
not even close!
Ooooooooooh maybe we have to escape it?
:h \|
what?
ooooh wait, we're in command mode, DUH
:h :pipe
aw, shit.
Maybe we want to split an array in vimscript.
:h split
Nope.
:h arary
Nothing. Maybe it's a list?
:h list
Nope. No splitting today, I guess.
If you think :h i_ctrl-w is intuitive, then, well. Have you ever been treated for schizophrenia or psychosis?
Let's say on entering a ruby file we want to press enter.
:au bufenter *.rb <cr>
open rb file..
trailing characters: <cr>
Oh god what the shit?
:h bufenter
nothing
:h ... it's now impossible to look up help on this problem. It's also impossible to google for it
We want to change the background color
:h background
Uhhhhh
:h color
Ok, I get it, I'm not going to find help on this. Time to give up.
I want to figure out how to set guicursor
:h guicursor
Are you 98% serious right now? Why are the examples using :highlight Cursor? Jesus.
Vim has horrible help. I will wait patiently for you to upvote my answer as opposed to downvote it, and I'll consider us even.
:h function
Ok, that's wrong.
Let's look up vimscript then, that probably has function information
:h vimscript
Nope, that's not what we want. But obviously function is further down the list
/function
Oh dear.
Let's say we want to do something on opening a python file, and we see someone else using Bufenter
:h bufenter
Ok, no usage examples. What to do?
Eventually we find out about autocmd, by luck. What if we want to include multiple statements in an autocmd?
:h autocmd
Nothing
/multiple
Nothing
Let's say (when you get lucky, again) and find out about :cmd1 | cmd2, you want to learn about |
:h |
nope
:h pipe
not even close!
Ooooooooooh maybe we have to escape it?
:h \|
what?
ooooh wait, we're in command mode, DUH
:h :pipe
aw, shit.
Maybe we want to split an array in vimscript.
:h split
Nope.
:h arary
Nothing. Maybe it's a list?
:h list
Nope. No splitting today, I guess.
If you think :h i_ctrl-w is intuitive, then, well. Have you ever been treated for schizophrenia or psychosis?
Let's say on entering a ruby file we want to press enter.
:au bufenter *.rb <cr>
open rb file..
trailing characters: <cr>
Oh god what the shit?
:h bufenter
nothing
:h ... it's now impossible to look up help on this problem. It's also impossible to google for it
We want to change the background color
:h background
Uhhhhh
:h color
Ok, I get it, I'm not going to find help on this. Time to give up.
I want to figure out how to set guicursor
:h guicursor
Are you 98% serious right now? Why are the examples using :highlight Cursor? Jesus.
Vim has horrible help. I will wait patiently for you to upvote my answer as opposed to downvote it, and I'll consider us even.