Re: Conventions for FreeBSD manual pages

From: Sysadmin Lists <sysadmin.lists_at_mailfence.com>
Date: Thu, 21 Apr 2022 00:10:48 UTC 
That's a damn good rant, and well justified. Sadly, FreeBSD cannot avoid the brain-death creep that has consumed Linux. So don't be too proud just yet. (Don't forget there were calls for FreeBSD to adopt systemd, too!)

April 21, 2022 1:29:18 AM CEST Dan Mahoney <freebsd@gushi.org> wrote:I know that, back in the redhat 7.3 days, someone told me that ifconfig was deprecated and I should use the ip command instead.

Being a very generic term and hard to search google for, I looked at the man page.  "man ip" gave me a manpage that said something like "this command allows you to configure the network in various ways, for more details see this postscript document".  At the time, I was on a system that had a broken IP stack, and I was at a terminal login.  A postscript file was not at all useful in getting that system back up.  Oh, and it didn't exist, either.

From there, I found that linux had this thing called "info" where things were put instead of/in addition to manpages, and that sometimes those things were in sync and sometimes not.

And then I was aghast to find that there was something called "The linux documentation project" which in all rights should have been, but wasn't the same entity as "the linux project" (any linux project, pick one).

Most linux man pages I find in google are on die.net, rather than being on the page for the distro, and not easily searchable.

If you're complaining that the "see also" lines in Freebsd's man pages should be grouped alpabetically or by manpage section, rather than, perhaps, by relevance, and that's the worst thing you can find on FreeBSD's documentation, I think we're doing okay.

Best,

-Dan

On Apr 20, 2022, at 7:58 AM, Ralf Mardorf <ralf-mardorf@riseup.net> wrote:

On Wed, 20 Apr 2022 14:04:06 +0300, Yuri wrote:
You have taken my answer out of context.

My apologies,

I missed the beginning of your reply, where you answered the OP's
question, hence my misinterpretation.

Regards,
Ralf

-- Sent with https://mailfence.com  Secure and private email