[couscouspie]

To be fair, I presume learning a tool by manual is not very efficient. At least I personally find the manuals of most utilities lacking in detail and it hence difficult to understand what a certain thing is actually doing and how to use it just from reading the manual. Furthermore, reading about functionality feels like a waste of time, when you are not specifically needing it at the moment. I doubt anybody who is fluent in everything Vim has to offer learned that by reading through the manual once or twice.

[blueflow]

  Furthermore, reading about functionality feels like a waste of time

yeah, but simplified, this is how you end up with programmers that write an if statement 10 times because they don't know what a for loop is. The waste of time still happens elsewhere.

[t-3]

> I doubt anybody who is fluent in everything Vim has to offer learned that by reading through the manual once or twice.

The vim manual only explains the flags and how/where to access the documentation and tutorial. You don't read it to "become fluent" in using the TUI application, you read it to learn about how to run the program from the commandline.

[jonhohle]

If you haven’t, look at the FreeBSD man pages, when possible (most things in coreutils). They are infinitely better than the GNU versions.

[johnisgood]

I recommend OpenBSD man pages as well.

BTW on Linux, I have "man-all" aliased to "man -a", as I want to read all available man pages (e.g. POSIX, GNU, Linux).