3 ms·
Do you feel the same way about reading technical documentation or specifications vs. digested explanations and instructions in general? Most man pages are proba
by Delk 3y ago
Do you feel the same way about reading technical documentation or specifications vs. digested explanations and instructions in general? Most man pages are probably closer to the former in spirit.
- dfee 3y agoNope. I enjoy reading the official docs for languages like Python (narrative or API). For Java I'm fine reading signatures; it's OK. I've not found a lot of good docs in that language, TBH. Even TypeScript can be alright, though I find myself navigating to definition a lot. That said, it's highly proj. dependent. E.g. fp-ts is hard to parse, though perhaps rewarding and succinct when you make progress. I've written my fair share of documentation, too. E.g.: http://python-forge.readthedocs.io http://python-forge.readthedocs.io It might be that manpages lack links, and it's hard to hop back and forth, as I can't set markers like in vim, so my controls are just up/down.
- Delk 3y agoI've found the pager search function useful in some cases when navigating man pages. At least in less, '/' does forward search, and '?' does backward search. Navigating longer man pages does seem to be somewhat clumsy, though, and finding things in something massive such as the gcc man page takes work. I'm probably just used to it enough that I don't always even realize it.