Hacker News new | past | comments | ask | show | jobs | submit login

What most manuals on the web get wrong is not offering a single-page version, so you're forced to use clumsy search engines (on-site or third party) to search through the document. With manpages, the whole manual is usually in one document. Some big programs split it, usually for the worse.



> Some big programs split it, usually for the worse.

For some reason ZSH provides split manpages and a concatenated manpage (zshall, iirc.) I personally just use the concatenated manpage


> What most manuals on the web get wrong is not offering a single-page version

Obligatory: https://blog.nawaz.org/posts/2025/Apr/an-appeal-to-documenta...


> Printing out the documentation

Big time. I don't do that very often anymore, but it used to be how I read all documentation. There is a lot to be said for being able to flip through physical pages with a highlighter in hand.




Consider applying for YC's Fall 2025 batch! Applications are open till Aug 4

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: