Earlier quoted context omitted.
... because if you do `man crontab` you get section 1, which does not document the crontab fields.
That is incredibly stupid. A documentation system designed by someone who doesn't understand how people use documentation. If man was designed by someone with any taste at all it would at least give you a menu to select (1) crontab command, (5) crontab file format. Maybe we need a rewrite in Rust to fix that.
Number in man page titles e.g. sleep(3)
61–70 of 85 posts
Re: Number in man page titles e.g. sleep(3)
#62It is a stylistic convention to always add this number to any reference to a function, even if there is only one definition.
Re: Number in man page titles e.g. sleep(3)
#63Thousands of keystrokes saved by not having to type “man syscall”… and millions of hours lost by confused folks like OP (and myself)
Re: Number in man page titles e.g. sleep(3)
#64If you like man trivia (and why else would you be reading this?) you could check out the top comment at https://unix.stackexchange.com/questions/405783/why-does-man... (discussed at https://news.ycombinator.com/item?id=27994194 )
Reading this makes me wonder if Easter eggs are ever appropriate for something as ubiquitous as man.
Re: Number in man page titles e.g. sleep(3)
#65Earlier quoted context omitted.
That is incredibly stupid. A documentation system designed by someone who doesn't understand how people use documentation. If man was designed by someone with any taste at all it would at least give you a menu to select (1) crontab command, (5) crontab file format. Maybe we need a rewrite in Rust to fix that.
I hope this was just some over the top sarcasm.
Re: Number in man page titles e.g. sleep(3)
#66Earlier quoted context omitted.
That is incredibly stupid. A documentation system designed by someone who doesn't understand how people use documentation. If man was designed by someone with any taste at all it would at least give you a menu to select (1) crontab command, (5) crontab file format. Maybe we need a rewrite in Rust to fix that.
Or a minor alteration to an existing program to support a good suggestion. Why is it that the Rust community thinks that the solution to every flaw in an application is a rewrite in Rust?
I absolutely guarantee if you propose this change the the GNU neckbeards who control man they will come up with some bullshit technical reason why it can't be done.
Re: Number in man page titles e.g. sleep(3)
#67Earlier quoted context omitted.
That is incredibly stupid. A documentation system designed by someone who doesn't understand how people use documentation. If man was designed by someone with any taste at all it would at least give you a menu to select (1) crontab command, (5) crontab file format. Maybe we need a rewrite in Rust to fix that.
It seems it has been done already a while ago without waiting for the rust community to do their usual churn. https://imgur.com/a/kEkmRxx (link shows a screenshot of khelpcenter showing the different manpages available for crontab)
Re: Number in man page titles e.g. sleep(3)
#68Earlier quoted context omitted.
That is incredibly stupid. A documentation system designed by someone who doesn't understand how people use documentation. If man was designed by someone with any taste at all it would at least give you a menu to select (1) crontab command, (5) crontab file format. Maybe we need a rewrite in Rust to fix that.
> If man was designed by someone with any taste at all it would at least give you a menu [...] My goodness. Man was written on a paper teletype.
Re: Number in man page titles e.g. sleep(3)
#69Earlier quoted context omitted.
It seems it has been done already a while ago without waiting for the rust community to do their usual churn. https://imgur.com/a/kEkmRxx (link shows a screenshot of khelpcenter showing the different manpages available for crontab)
Really? I can't see your image (thanks UK government) but if I type `man crontab` in a recent Ubuntu it just shows crontab(1).
Re: Number in man page titles e.g. sleep(3)
#70Earlier quoted context omitted.
... because if you do `man crontab` you get section 1, which does not document the crontab fields.
That is incredibly stupid. A documentation system designed by someone who doesn't understand how people use documentation. If man was designed by someone with any taste at all it would at least give you a menu to select (1) crontab command, (5) crontab file format. Maybe we need a rewrite in Rust to fix that.
man was designed at a time you likely can't conceive of.
Can you even imagine designing something that's being actively used and talked about a HALF CENTURY later?