Date: Wed, 20 Apr 2022 16:29:18 -0700 From: Dan Mahoney <freebsd@gushi.org> To: Ralf Mardorf <ralf-mardorf@riseup.net> Cc: questions@freebsd.org Subject: Re: Conventions for FreeBSD manual pages Message-ID: <72A65123-F19F-4644-8CC8-9BAD9E401BC2@gushi.org> In-Reply-To: <20220420165852.0c6fa0d4@archlinux> References: <3755196b-8803-ff72-364e-6b3b067f9702@gmail.com> <c9284898-d06a-a629-e324-1bb25178a6dd@aetern.org> <921cc7c2d2ce7811c7df5dec04fb0e357fc354fd.camel@riseup.net> <01d230da-0f1e-4bcb-bcde-fa6c28fdc8b1@aetern.org> <20220420165852.0c6fa0d4@archlinux>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] 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 > [-- Attachment #2 --] <html><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">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.<div class=""><br class=""></div><div class="">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.</div><div class=""><br class=""></div><div class="">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.</div><div class=""><br class=""></div><div class="">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).</div><div class=""><br class=""></div><div class="">Most linux man pages I find in google are on <a href="http://die.net" class="">die.net</a>, rather than being on the page for the distro, and not easily searchable.</div><div class=""><br class=""></div><div class="">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.</div><div class=""><br class=""></div><div class="">Best,</div><div class=""><br class=""></div><div class="">-Dan</div><div class=""><div><br class=""><blockquote type="cite" class=""><div class="">On Apr 20, 2022, at 7:58 AM, Ralf Mardorf <<a href="mailto:ralf-mardorf@riseup.net" class="">ralf-mardorf@riseup.net</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div class="">On Wed, 20 Apr 2022 14:04:06 +0300, Yuri wrote:<br class=""><blockquote type="cite" class="">You have taken my answer out of context.<br class=""></blockquote><br class="">My apologies,<br class=""><br class="">I missed the beginning of your reply, where you answered the OP's<br class="">question, hence my misinterpretation.<br class=""><br class="">Regards,<br class="">Ralf<br class=""><br class=""></div></div></blockquote></div><br class=""></div></body></html>home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?72A65123-F19F-4644-8CC8-9BAD9E401BC2>