Date: Fri, 14 Mar 2014 10:47:32 -0600 From: Warner Losh <imp@bsdimp.com> To: John-Mark Gurney <jmg@funkthat.com> Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org, John Nielsen <john@jnielsen.net>, src-committers@freebsd.org, Christian Brueffer <brueffer@freebsd.org> Subject: Re: svn commit: r263110 - head/share/man/man4 Message-ID: <933F8270-90C1-4AFE-9F39-A7ADBC05C772@bsdimp.com> In-Reply-To: <20140314164107.GS32089@funkthat.com> References: <201403131619.s2DGJax1071196@svn.freebsd.org> <4D0B04BD-4EF6-4963-941E-012B81F8DFAB@jnielsen.net> <20140314015438.GO32089@funkthat.com> <5322C83F.6060109@FreeBSD.org> <C52AC38B-8430-4EE3-BE30-51A21B472B42@gmail.com> <20140314164107.GS32089@funkthat.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mar 14, 2014, at 10:41 AM, John-Mark Gurney <jmg@funkthat.com> wrote: > Warner Losh wrote this message on Fri, Mar 14, 2014 at 08:30 -0600: >> On Mar 14, 2014, at 3:13 AM, Christian Brueffer = <brueffer@FreeBSD.org> wrote: >>=20 >>> On 3/14/14 2:54 AM, John-Mark Gurney wrote: >>>> John Nielsen wrote this message on Thu, Mar 13, 2014 at 16:28 = -0600: >>>>> On Mar 13, 2014, at 10:19 AM, John-Mark Gurney <jmg@freebsd.org> = wrote: >>>>>=20 >>>>>> Author: jmg >>>>>> Date: Thu Mar 13 16:19:36 2014 >>>>>> New Revision: 263110 >>>>>> URL: http://svnweb.freebsd.org/changeset/base/263110 >>>>>>=20 >>>>>> Log: >>>>>> remove link to the missing AMD Geode LX SB man page... we can add = it >>>>>> back once someone cares enough to write one.. >>>>>=20 >>>>> You mean like this one? >>>>> = http://svnweb.freebsd.org/base/head/share/man/man4/man4.i386/glxsb.4 >>>>=20 >>>> The problems of checking on an amd64 box... :( >>>>=20 >>>> Actually, how are we suppose to handle links to arch dependant man >>>> pages in arch independant man pages? I did this check on an amd64 = box, >>>> so the page glxsb didn't get installed... Should we just always >>>> install these man pages on all arches then? Or are we fine w/ >>>> references to non-existant pages (on some arches)? >>>>=20 >>>> Or should glxsb.4 be moved to an arch independant dir? >>>>=20 >>>=20 >>> I wonder if it makes sense to keep arch-dependent man directories at >>> all. I.e., if I prepare an ARM disk image on my amd64 laptop, I = really >>> want to have the arm manpages available on that amd64 box. >>>=20 >>> Does anyone see a reason not to move man4/man4.${ARCH}/*.4 to man4? >>> We're talking about 60 manpages here, so space is not really an = issue. >>=20 >> Historically there was the separation because xp on one platform = might be >> radically different from xp on another platform. The other reason was = confusion >> because it wasn?t always clear if device foo actually worked on = platform X. >=20 > We have less of that issue now, but it could still be.. but issues = like > that can be addressed other ways, though kernel config, release notes, > etc.. I doubt people use manpages as a guage if a device worked on > their arch... Plus, if the device is shared and known not to work on > a specific arch, that should be listed in the BUGS section of the man > page.. :) Yea, kinda my point :) >> Do we have any collisions like that? If so, we need to resolve those = first. >=20 > Doesn't look like it... > $ grep ^_ Makefile | sed -e 's/.4.*//' | wc -l > 86 > $ grep ^_ Makefile | sed -e 's/.4.*//' | sort -u | wc -l > 86 >=20 > It's also telling that besides i386 and amd64 specific man pages, we > only have one mips specific man page in man4=85 True enough, I hadn=92t looked... > This won't address the other man pages for arch specific utilities > and libraries though, like sunlabel=85 True, but those are niche things, so it is less important :) >> Also, it would be good to tag the ones that are arm specific as such = somehow. >=20 > Should we just tag the pages w/ a section listing relevant = architectures, > or break the beauty of single digit section numbers and do 4.i386? Tag in the man page itself, either in its own unique section, or in = BUGS. > I just realized that we host man pages on FreeBSD.org, how do we make > sure we get all of them for all arches? Looks like we don't, as > glxsb.4 isn't available=85 I=92d move them all into man4, which will solve this problem. The ones = that are truly arch specific should have BUGS entries added for them. Warner=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?933F8270-90C1-4AFE-9F39-A7ADBC05C772>