do you have a favourite man page?
-
@rjbs i had no idea this was going to be the #1 most popular man page by far but I love it
@b0rk For funsies I ran "man unicode" and got… "This is an implementation in Tcl of the Unicode normalization forms."
Wow.
-
do you have a favourite man page? thinking of writing a short blog post exploring man pages and what makes a good one and I'd love some more examples
my contribution: I think it's cool that `man curl` includes an example for every single option
@b0rk @bagder I always really liked "man hier" on FreeBSD explaining the filesystem hierarchy. Such a good user experience for an OS. https://man.freebsd.org/cgi/man.cgi?hier(7)
When I was at Etsy on the team maintaining the developer VMs, we replicated it with info about what could be found on the VMs.
Also one of my best open source experiences ever was that my patch to a curl man page got accepted 😇😁 https://github.com/curl/curl/commit/1074cca8cd420eddf724e6e0b40e60e6a080ada1
-
do you have a favourite man page? thinking of writing a short blog post exploring man pages and what makes a good one and I'd love some more examples
my contribution: I think it's cool that `man curl` includes an example for every single option
@b0rk I'm so happy with "tldr". Never touched a manpage since. ^^
-
@arrjay @aredridel this is awesome, I love `perlcheat`, I've never seen anything like that in a man page
@b0rk Right!? It's _so good_. Gold standard.
-
do you have a favourite man page? thinking of writing a short blog post exploring man pages and what makes a good one and I'd love some more examples
my contribution: I think it's cool that `man curl` includes an example for every single option
@b0rk man cmus-tutorial. The format makes it really easy to read, and I have referred to it many times.
-
do you have a favourite man page? thinking of writing a short blog post exploring man pages and what makes a good one and I'd love some more examples
my contribution: I think it's cool that `man curl` includes an example for every single option
@b0rk hier(7)
I found it very early in my Unix career. I was exploring `/usr/spool/man/` to find out what there was. I stumbled on `hier.7` and it told me all the *other* places I should explore.
It might be how I found out about /etc/passwd.
-
i tried implementing this OUTPUT SUMMARY format for grep's man page, I can't tell if I like it or not but it's an interesting exercise to try to give a 1-line description of each item, categorize them, and then order them most-frequently-used-by-me first https://gist.github.com/jvns/9f5966633875a4758e0d947a5b4dbdcf
(probably some of the descriptions are wrong, I only thought about them for maybe 3 seconds each, also this is Mac grep)
(3/?)
@b0rk I am slightly embarrassed to admit that until I read this thread, and despite using grep for decades, I was somehow unaware that there was a "-w" option. thank you for making it obvious!
-
@b0rk I am slightly embarrassed to admit that until I read this thread, and despite using grep for decades, I was somehow unaware that there was a "-w" option. thank you for making it obvious!
@shayman I'd never heard of it either!
-
@shayman I'd never heard of it either!
@b0rk amazing how you can overlook things in a long man page. "man page fatigue" sets in after about the 4th screen. Thanks for what you're doing!
-
do you have a favourite man page? thinking of writing a short blog post exploring man pages and what makes a good one and I'd love some more examples
my contribution: I think it's cool that `man curl` includes an example for every single option
@b0rk my least favorite man pages were back when all the GNU tools man pages were just stubs telling you to use info. User hostility taken to a level only GNU could manage.