Hacker News new | ask | show | jobs
by ravicious 3833 days ago
Maybe instead of creating something entirely new we could improve the existing thing, that is prepend man pages with some examples?
2 comments

There have been discussions in the past about "standardizing" on an Examples section. It is usually what I miss the most in any manual.
The man maintainers, at least from my own dealings with them, often don't like contributors. "Examples are nice, and I like your changes, but what if Paul Vixie doesn't?" It's easier to fork man completely and take it away from them, Xorg style.
"I've done this, to fix the problem." "Ah yeah, no need; that problem's been discussed in the past". "Ok, what happened" "IT...WAS...DISCUSSED!"
You're free to try to incorporate these into the man pages. The creators of this (brilliant idea, btw, just what I have desired so many times in the past) are under no obligation to do so.