From owner-svn-src-all@freebsd.org  Fri Jul 31 19:33:22 2015
Return-Path: <owner-svn-src-all@freebsd.org>
Delivered-To: svn-src-all@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 40FA59AF837;
 Fri, 31 Jul 2015 19:33:22 +0000 (UTC)
 (envelope-from bjkfbsd@gmail.com)
Received: from mail-wi0-x22b.google.com (mail-wi0-x22b.google.com
 [IPv6:2a00:1450:400c:c05::22b])
 (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
 (Client CN "smtp.gmail.com",
 Issuer "Google Internet Authority G2" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id CCF4F11A9;
 Fri, 31 Jul 2015 19:33:21 +0000 (UTC)
 (envelope-from bjkfbsd@gmail.com)
Received: by wibud3 with SMTP id ud3so44111316wib.0;
 Fri, 31 Jul 2015 12:33:20 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=mime-version:in-reply-to:references:date:message-id:subject:from:to
 :cc:content-type;
 bh=h1lO8wfUZ28urEAPgavBdZ8jZczFg15rDz4HX17ZnbM=;
 b=u6HBYWaE5iVikLM8o/Kmhh9+7f2g9WlHzdJGtxEK8mQOIjcxVDO1cKWPW7wVlX3kqs
 TZ6b1JeVmVPwKaW+GV31J+VPgChSDORRww33QOt+n5iojHILIGeO2yH0OVQwMtiD0v+g
 x3ycgOzBaZ5teMIHCrtVAcMe1CvWsLPafOPy2icJNpLGoPWrpO0mBAK+j8vIJi3ZKGLd
 u+jjci7DAztShsqom/KKr78a40H0SeBzgBN+42HMf2nM638H+3I7A7HzOqYik7vT6Bng
 JCHam+rL3SRtEXLelax3aovLXmTJhmEYgymNjrwvlioaxV2psY2E34A3BcG+S5540jYq
 g1ZQ==
MIME-Version: 1.0
X-Received: by 10.180.84.194 with SMTP id b2mr9751791wiz.24.1438371200250;
 Fri, 31 Jul 2015 12:33:20 -0700 (PDT)
Received: by 10.27.96.132 with HTTP; Fri, 31 Jul 2015 12:33:20 -0700 (PDT)
In-Reply-To: <9E180F45-B3B1-46C0-B02A-FFC3EB667A82@bsdimp.com>
References: <201507310328.t6V3S3LC087650@repo.freebsd.org>
 <CABh_MKm45daZPYPNFBmmkdP32sNMCtu1w33kapcouPvxcfN8_Q@mail.gmail.com>
 <20150731163110.GZ78154@funkthat.com>
 <9E180F45-B3B1-46C0-B02A-FFC3EB667A82@bsdimp.com>
Date: Fri, 31 Jul 2015 15:33:20 -0400
Message-ID: <CAJ5_RoAeb8_qMX3_V-E-yDTX8hJDOgoLjxo5P_eTmocMoPosRQ@mail.gmail.com>
Subject: Re: svn commit: r286103 - head/share/man/man9
From: Benjamin Kaduk <bjkfbsd@gmail.com>
To: Warner Losh <imp@bsdimp.com>
Cc: John-Mark Gurney <jmg@funkthat.com>,
 "svn-src-head@freebsd.org" <svn-src-head@freebsd.org>, 
 "svn-src-all@freebsd.org" <svn-src-all@freebsd.org>,
 src-committers <src-committers@freebsd.org>, Ed Schouten <ed@nuxi.nl>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
X-Content-Filtered-By: Mailman/MimeDel 2.1.20
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
 user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all/>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 31 Jul 2015 19:33:22 -0000

On Fri, Jul 31, 2015 at 12:37 PM, Warner Losh <imp@bsdimp.com> wrote:

>
> > On Jul 31, 2015, at 10:31 AM, John-Mark Gurney <jmg@funkthat.com> wrote=
:
> >
> > Do we support linking man pages between man3/man9? or should it just
> > be in a comment? and in one section?
>
> Put them in section 9 with a note saying they work for user land. There=
=E2=80=99s
> maybe
> a dozen that apply to both. We=E2=80=99ve historically not tried to share=
 them.
>

I want to say that I've seen a section 3 man page that just says "these
APIs act like their kernel counterparts; see foo(9)" .... or maybe the
other way around.  But I can't look right now.

-Ben