Live data from Hacker News

Number in man page titles e.g. sleep(3)

lalitm.com

61–70 of 85 posts

Re: Number in man page titles e.g. sleep(3)

#61

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.

I hope this was just some over the top sarcasm.

Re: Number in man page titles e.g. sleep(3)

#62
Note that this is contrary to the convention used in the Erlang community, where the number is used to disambiguate function definitions with different parameter counts, e.g. in https://www.erlang.org/docs/18/man/supervisor.html we see definitions of `start_link/2` and `start_link/3`.

It 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)

#64
post #9
post #7

If 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.

It should make you wonder instead about the appropriateness of testing over man(1) output, I suppose unless you're actually generating the format for use as man(1) input, in which case congratulations on your functional tests doing their job!

Re: Number in man page titles e.g. sleep(3)

#65

Earlier 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.

No of course not. Why do you hope that?

Re: Number in man page titles e.g. sleep(3)

#66
post #19

Earlier 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?

Programs these old are controlled by people who are very strongly opposed to change, even if it improves things. They like living in the 80s.

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)

#67
post #60

Earlier 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)

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)

#68
post #26

Earlier 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.

So? That didn't stop `man -a`.

Re: Number in man page titles e.g. sleep(3)

#69
post #60

Earlier 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).

He said "khelpcenter", not "man".

Re: Number in man page titles e.g. sleep(3)

#70

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.

>If man was designed by someone with any taste at all

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?

Post reply on HN