From owner-svn-src-head@FreeBSD.ORG Fri Mar 14 16:47:44 2014 Return-Path: Delivered-To: svn-src-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id E84C6E37 for ; Fri, 14 Mar 2014 16:47:44 +0000 (UTC) Received: from mail-ig0-f172.google.com (mail-ig0-f172.google.com [209.85.213.172]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id AE8BF191 for ; Fri, 14 Mar 2014 16:47:44 +0000 (UTC) Received: by mail-ig0-f172.google.com with SMTP id uq10so20643275igb.5 for ; Fri, 14 Mar 2014 09:47:38 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:content-type:mime-version:subject:from :in-reply-to:date:cc:content-transfer-encoding:message-id:references :to; bh=KLWCM7LA7lbnuTDZQqnmyQLk+xNxSuJiyfoIMW6Q+zE=; b=IB1Dd8bgcB9xslak1e4K5B79NNuqn6lERSzUQkrvjlDG4OjYvOvz+FBbWgX/kZN9Wd tHWLSe0dk7njOAGm9U1bx33rXPZfIXerJoChdIVAJGHaGhUu14RoczdptFwrQyNFKtP9 gyKICnU5V2283K+CFB+DU16mCQNBMn/0hZE82kTZVnC23XyGj/8i5MSwCCE4o6nWC4ft JX6AlEKSqM1Wr7vUsT38AuenaaqqB5pnSBwelfMQ0wA1/AwCmksM2cO0d3erBM7dnmyy vS1pg1tjkdmymighieZrZVav3aS4U20kOUluDK0VTst5TQW/MJLoGpBzINF656b/Z+Ul pLOA== X-Gm-Message-State: ALoCoQlnILSXyKriq9c40CfDPdoDmWMhrUpS6gJtKN9NK7A4fqXZ2v4rgmzVmRtawRDi2CzQzwdM X-Received: by 10.43.65.145 with SMTP id xm17mr7728673icb.35.1394815658290; Fri, 14 Mar 2014 09:47:38 -0700 (PDT) Received: from netflix-mac.bsdimp.com (50-78-194-198-static.hfc.comcastbusiness.net. [50.78.194.198]) by mx.google.com with ESMTPSA id u1sm20862249igm.8.2014.03.14.09.47.37 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Fri, 14 Mar 2014 09:47:37 -0700 (PDT) Sender: Warner Losh Content-Type: text/plain; charset=windows-1252 Mime-Version: 1.0 (Mac OS X Mail 7.2 \(1874\)) Subject: Re: svn commit: r263110 - head/share/man/man4 From: Warner Losh In-Reply-To: <20140314164107.GS32089@funkthat.com> Date: Fri, 14 Mar 2014 10:47:32 -0600 Content-Transfer-Encoding: quoted-printable Message-Id: <933F8270-90C1-4AFE-9F39-A7ADBC05C772@bsdimp.com> References: <201403131619.s2DGJax1071196@svn.freebsd.org> <4D0B04BD-4EF6-4963-941E-012B81F8DFAB@jnielsen.net> <20140314015438.GO32089@funkthat.com> <5322C83F.6060109@FreeBSD.org> <20140314164107.GS32089@funkthat.com> To: John-Mark Gurney X-Mailer: Apple Mail (2.1874) Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org, John Nielsen , src-committers@freebsd.org, Christian Brueffer X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 14 Mar 2014 16:47:45 -0000 On Mar 14, 2014, at 10:41 AM, John-Mark Gurney 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 = 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 = 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=