Re: Conventions for FreeBSD manual pages
- Reply: Sysadmin Lists : "Re: Conventions for FreeBSD manual pages"
- Reply: Kira : "Re: Conventions for FreeBSD manual pages"
- In reply to: Ralf Mardorf : "Re: Conventions for FreeBSD manual pages"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 20 Apr 2022 23:29:18 UTC
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 <http://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 >