From owner-svn-src-head@freebsd.org Fri Jul 31 16:37:13 2015 Return-Path: Delivered-To: svn-src-head@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 C354F9AF8A0 for ; Fri, 31 Jul 2015 16:37:13 +0000 (UTC) (envelope-from imp@bsdimp.com) Received: from mail-ig0-f182.google.com (mail-ig0-f182.google.com [209.85.213.182]) (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 9157A165F for ; Fri, 31 Jul 2015 16:37:13 +0000 (UTC) (envelope-from imp@bsdimp.com) Received: by iggf3 with SMTP id f3so20404704igg.1 for ; Fri, 31 Jul 2015 09:37:07 -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:subject:mime-version:content-type:from :in-reply-to:date:cc:message-id:references:to; bh=tPROH9YUjf9Z6/48m+Y9hoQX4Cusk3XogY9U1N6onBo=; b=VGBDbjNvXzSfnqEzwXB/5G3utv9r6pEQu9MI/bYBeivxLW6lBX7ZpBlm5/24pITUYY fpOY7bj8XsVwxpSvNeGUj9USRlOXf31Pfo3nO9hiWY5kZFzY54qsc/8Uy7iwDZ/7/U6s 6QZ8/N2czF3IL/WtRbj3AhK190FXoG42VFkbZoqfu75S53MRTBKEgmatbEOxguPLvf7l oBO1mXLg+p3uf/s+XHtylA4D7YKQa8i3MaypA7cgeugY/BM5dawuzdLxwNVrPkqKYZEY 01NOpLxQ7sGf1H1LDJuivx7TAyesvSl13MjVUtak3+mOCb/FlDGupJ7MarUODM1QhXMD SRDA== X-Gm-Message-State: ALoCoQluGzXmvX82W8TrQsO03GJDezEfn1nj9ct060srWDUj8CUmLdHUP9t4+xpu7xpjJmExwPYM X-Received: by 10.50.1.43 with SMTP id 11mr7727391igj.76.1438360627052; Fri, 31 Jul 2015 09:37:07 -0700 (PDT) Received: from netflix-mac-wired.bsdimp.com ([50.253.99.174]) by smtp.gmail.com with ESMTPSA id y6sm2590806igl.17.2015.07.31.09.37.06 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Fri, 31 Jul 2015 09:37:06 -0700 (PDT) Sender: Warner Losh Subject: Re: svn commit: r286103 - head/share/man/man9 Mime-Version: 1.0 (Mac OS X Mail 8.2 \(2102\)) Content-Type: multipart/signed; boundary="Apple-Mail=_38637613-EC09-4AC1-B5E6-AA4C269199B7"; protocol="application/pgp-signature"; micalg=pgp-sha512 X-Pgp-Agent: GPGMail 2.5 From: Warner Losh In-Reply-To: <20150731163110.GZ78154@funkthat.com> Date: Fri, 31 Jul 2015 10:37:03 -0600 Cc: Ed Schouten , src-committers , svn-src-all@freebsd.org, svn-src-head@freebsd.org Message-Id: <9E180F45-B3B1-46C0-B02A-FFC3EB667A82@bsdimp.com> References: <201507310328.t6V3S3LC087650@repo.freebsd.org> <20150731163110.GZ78154@funkthat.com> To: John-Mark Gurney X-Mailer: Apple Mail (2.2102) X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.20 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, 31 Jul 2015 16:37:14 -0000 --Apple-Mail=_38637613-EC09-4AC1-B5E6-AA4C269199B7 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 > On Jul 31, 2015, at 10:31 AM, John-Mark Gurney = wrote: >=20 > Ed Schouten wrote this message on Fri, Jul 31, 2015 at 11:24 +0200: >> Maybe it would make more sense to just remove this manual page? >>=20 >> It looks like there are already some pieces of code in our source = tree >> that use _Static_assert(), which is good. Maybe it would be better to >> to leave CTASSERT() undocumented, so that it becomes less likely that >> new code uses this interface. >=20 > I plan on documenting _Static_assert, and once that is documented > for both userland and kernel, then we can mark this deprecated=E2=80=A6 We generally don=E2=80=99t document built-in language features. Just add = a note to the CTASSERT man page that says use it instead. > 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. Warner --Apple-Mail=_38637613-EC09-4AC1-B5E6-AA4C269199B7 Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=signature.asc Content-Type: application/pgp-signature; name=signature.asc Content-Description: Message signed with OpenPGP using GPGMail -----BEGIN PGP SIGNATURE----- Comment: GPGTools - https://gpgtools.org iQIcBAEBCgAGBQJVu6QwAAoJEGwc0Sh9sBEAupQP/2i1zIFNkHxkO4ALlJoja0wA 41C6XsQaFKUWhipknStMCvxYE18cjd/BsJAPtnnfCA7FUpqzHIHycyBnc5eIRF92 vfnstgXLBeaox2pZROeVHlj1OlpjeO8UumtGWV4HUB3IT466J5raoUJ5qvqxFCVq kYA8ZUaweypx6bz+wc+X04PEbU1sTfklKwxtOhWADVoA+VuH20aKA9Y4Arhs+VMw s6U05ceFHqMsVnbkYIxHQziY3/h39udQIR+bLd7tTWCi9/BxKB+uEpxjbXUqsqPs 465SDD7lQMCT7ylHBOSTkBYd6N8SRTVogqIVUBIdqG2M4giHjm0w2mThM1nXhfUb R9M/JVXLotCPCKimehqcNv/UzukbkyMpwbeigTVFpr3g7P6/CilJX/i8JmLRDA4I LVIxvw3/lNd6Zgvb2bs6C6VYBTu/RqKUSsF9wH50lErksgSpx79/T4+QCNPPx8qL zj6mGbOvF7D4yFtGy/Ju3w17BP7h5rNwSN0ZhyVC3IEqWsF53IuWNuvEyIQANJ40 KlKgyVJKuvdsbIgk/2yycNjQsxkQvRy0p2Ul7CwgwtMx+avtQD47uNsMqzdU0lP4 goXtqL3ZDUboabw8zhrLj/G3T2p8qRvqP043Dl8YE9gLjE5Bpq46FNMD8QFv5pYR eZb1bfZntrVqradCVoKE =9O7V -----END PGP SIGNATURE----- --Apple-Mail=_38637613-EC09-4AC1-B5E6-AA4C269199B7--