do you have a favourite man page?
Uncategorized
119
Posts
85
Posters
0
Views
-
I think my favourite man page example so far is this rsync man page (via @shnizmuffin) https://download.samba.org/pub/rsync/rsync.1
it gives examples BEFORE giving an exhaustive list of options!
the synopsis just says "rsync [OPTION...] SRC... [DEST]" instead of giving you an exhaustive list of options like "-ABCFGHILOPRSTUWabcdefghiklmnopqrstuvwxy1%"!
there's an "OPTION SUMMARY" section that gives you a 1-line summary of each option! (this feels SO SO much useful than the normal SYNOPSIS to me)
(2/?)
@b0rk @shnizmuffin if something needs a solid man page, it's probably rsync. :D
Destroyer of files.
With great power comes great responsibility. -
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@jvns.ca i often work offline, so i like long and elaborate man pages that go into every absurd detail but also note in-program help mechanisms
nvimbecause it provides a jump start to:Tutorand:help quickrefzshallbecause it explains All the syntax
-
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 In the attention to detail category, the BUG detailed in the NetBSD sleep(1) man page is a favourite:
-
@b0rk It leads with examples from most common to least common, and sorts its many options following similar logic.
It's basically ...
1. WTF am I looking at. (--verbose et al)
2. Sensible defaults (--archive)
3. How do I change one thing (--no-OPTION)
4. Filepath stuff
5. Link stuff
6. Permission stuff
7. File metadata stuff
8. Config stuff
9. Filter stuff
10. Shit one person needed once
11. --human-readable
12. please don't run forever
13. --version, --help@shnizmuffin i didn’t even notice the option sorting, that’s so good
-
-
@b0rk i always think
hier(7)is really neat -
@b0rk the one I've used the most is `man bash`, because it's not just a man page, it's the documentation for the whole scripting language!
-
@thatandromeda I have a hard time with them too, that's why I've been thinking about this
@b0rk @thatandromeda Often I pipe the output of `man` into `less`, then try to search for something like -n, which returns way too many results (e.g. mentions of that option before its definition). I wonder if a better `man` could be made that would let me search through an *index* of options instead of doing a full-text search.
-
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 Why were example usages shunned by many man pages I'll never understand.
-
@technicaladept @nabnux i think for bash specifically I might prefer to use the html bash reference manual to reference the docs https://www.gnu.org/software/bash/manual/bash.html (which I believe has the same content but with better formatting)
-
I think my favourite man page example so far is this rsync man page (via @shnizmuffin) https://download.samba.org/pub/rsync/rsync.1
it gives examples BEFORE giving an exhaustive list of options!
the synopsis just says "rsync [OPTION...] SRC... [DEST]" instead of giving you an exhaustive list of options like "-ABCFGHILOPRSTUWabcdefghiklmnopqrstuvwxy1%"!
there's an "OPTION SUMMARY" section that gives you a 1-line summary of each option! (this feels SO SO much useful than the normal SYNOPSIS to me)
(2/?)
@b0rk Special shout out to the official web address, since it's got hyperlinks on all the options:
-
I think my favourite man page example so far is this rsync man page (via @shnizmuffin) https://download.samba.org/pub/rsync/rsync.1
it gives examples BEFORE giving an exhaustive list of options!
the synopsis just says "rsync [OPTION...] SRC... [DEST]" instead of giving you an exhaustive list of options like "-ABCFGHILOPRSTUWabcdefghiklmnopqrstuvwxy1%"!
there's an "OPTION SUMMARY" section that gives you a 1-line summary of each option! (this feels SO SO much useful than the normal SYNOPSIS to me)
(2/?)
@b0rk @shnizmuffin Count on Apple to f*ck things up:
NAME
openrsync – synchronise local and remote filesSYNOPSIS
openrsync [-0468BCDEFHILOPRSTWVabcdefghiklmnopqrtuvxyz] [-e program]
[-f filter] [--address=sourceaddr] [--append]
[--backup-dir=directory] [--bwlimit=limit]
[--cache | --no-cache] [--etc.
-
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
false (8) is my favourite
-
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 grindr (SORRY)
-
I have a soft spot for "man ascii"
-
@d6 this is so cool, I've never looked at this before! makes me want to find out who wrote them.
-
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 man` flashed me recently
-
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 not sure, if I measure it by times I read it, it should be tar, but because of its number of options. Regarding the fun of reading it or the fact I'm confident I will find the information I need, none really qualify
-
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've always thought the jq man page is quite good. Lots of good examples
-
@thatandromeda I have a hard time with them too, that's why I've been thinking about this
Gli ultimi otto messaggi ricevuti dalla Federazione
-
@clayote I mean, there are still problems it can't solve, but that set is much smaller than you would think if you last looked at it seriously any time up until a few months ago. The models now can search the web, instrument software so they can test without human intervention, and plan quite large/complicated projects for implementation across several context windows.
When driven by an expert, there is very little it can't do, and it does it all very, very, rapidly.
-
@clayote it is quite wrong, as of October of last year, when the current crop of models arrived. As of Opus 4.5, Codex 5.2, and Gemini 3, when used in an agentic context (e.g. Claude Code), they're not limited to simple/repetitive code or code that is prominent in the training data.
The training data is "the entire internet and all of public Github", so it knows every language, every framework. Yeah, it's better at simple CRUD apps in TypeScript, but it also kicks my ass in my best languages.
-
@clayote @swelljoe I'd say that was true not that long ago, but not necessarily now. More likely to be true of those people who don't even look at the output, which I think is atrocious.
-
@noplasticshower yeah, I'm confident that many, if not all, of the major models have ingested the thousands of posts I've made to the forum I maintain for the OSS projects I work on. I feel ambivalent about that. On one hand, if someone is asking ChatGPT for help with my software, I'd rather it give reasonable answers than dangerous ones.
But, also, it sucks that the way it does that kind of thing is DDoSing my websites periodically and blatantly disregarding copyright or licenses.
-
@deadsuperhero so, here's my best bet. I can be wrong!
1. Get some servers to implement the API well.
2. Get some must-have clients that run on those servers. This shows the value of the API.
3. Our leading servers shift to supporting it.That may work; I don't know. It's my best bet right now!
I want to note that WordPress is working on the API!
-
I am heart to heart with you on this, friend.
-
@swelljoe As a non-user of AI (lucky), my impression was that in the areas it works well in -- repetitive codebases that resemble ones in the training dataset -- the productivity increase also incurs technical debt at a rate higher than if you'd gotten some junior coders to do it; is that wrong?
-
@swelljoe I learned a weird thing about my stuff and Anthropic https://berryvilleiml.com/2025/12/05/the-anthropic-copyright-settlement-is-telling/
