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>
next in thread | previous in thread | raw e-mail | index | archive | help
--Apple-Mail=_57D39970-9310-494D-A2E4-6C004B3A494E Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=us-ascii 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. =46rom 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: >=20 > On Wed, 20 Apr 2022 14:04:06 +0300, Yuri wrote: >> You have taken my answer out of context. >=20 > My apologies, >=20 > I missed the beginning of your reply, where you answered the OP's > question, hence my misinterpretation. >=20 > Regards, > Ralf >=20 --Apple-Mail=_57D39970-9310-494D-A2E4-6C004B3A494E Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset=us-ascii <html><head><meta http-equiv=3D"Content-Type" content=3D"text/html; = charset=3Dus-ascii"></head><body style=3D"word-wrap: break-word; = -webkit-nbsp-mode: space; line-break: after-white-space;" class=3D"">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=3D""><br= class=3D""></div><div class=3D"">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=3D""><br class=3D""></div><div = class=3D"">=46rom 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=3D""><br class=3D""></div><div class=3D"">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=3D""><br = class=3D""></div><div class=3D"">Most linux man pages I find in google = are on <a href=3D"http://die.net" class=3D"">die.net</a>, rather than = being on the page for the distro, and not easily searchable.</div><div = class=3D""><br class=3D""></div><div class=3D"">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=3D""><br class=3D""></div><div = class=3D"">Best,</div><div class=3D""><br class=3D""></div><div = class=3D"">-Dan</div><div class=3D""><div><br class=3D""><blockquote = type=3D"cite" class=3D""><div class=3D"">On Apr 20, 2022, at 7:58 AM, = Ralf Mardorf <<a href=3D"mailto:ralf-mardorf@riseup.net" = class=3D"">ralf-mardorf@riseup.net</a>> wrote:</div><br = class=3D"Apple-interchange-newline"><div class=3D""><div class=3D"">On = Wed, 20 Apr 2022 14:04:06 +0300, Yuri wrote:<br class=3D""><blockquote = type=3D"cite" class=3D"">You have taken my answer out of context.<br = class=3D""></blockquote><br class=3D"">My apologies,<br class=3D""><br = class=3D"">I missed the beginning of your reply, where you answered the = OP's<br class=3D"">question, hence my misinterpretation.<br class=3D""><br= class=3D"">Regards,<br class=3D"">Ralf<br class=3D""><br = class=3D""></div></div></blockquote></div><br = class=3D""></div></body></html>= --Apple-Mail=_57D39970-9310-494D-A2E4-6C004B3A494E--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?72A65123-F19F-4644-8CC8-9BAD9E401BC2>