From owner-svn-src-head@freebsd.org Fri Jul 31 18:22:16 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 99FB69B0C60; Fri, 31 Jul 2015 18:22:16 +0000 (UTC) (envelope-from jmg@gold.funkthat.com) Received: from gold.funkthat.com (gate2.funkthat.com [208.87.223.18]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client CN "gold.funkthat.com", Issuer "gold.funkthat.com" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 6302A15B4; Fri, 31 Jul 2015 18:22:16 +0000 (UTC) (envelope-from jmg@gold.funkthat.com) Received: from gold.funkthat.com (localhost [127.0.0.1]) by gold.funkthat.com (8.14.5/8.14.5) with ESMTP id t6VIME9a050251 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 31 Jul 2015 11:22:14 -0700 (PDT) (envelope-from jmg@gold.funkthat.com) Received: (from jmg@localhost) by gold.funkthat.com (8.14.5/8.14.5/Submit) id t6VIMEmU050250; Fri, 31 Jul 2015 11:22:14 -0700 (PDT) (envelope-from jmg) Date: Fri, 31 Jul 2015 11:22:14 -0700 From: John-Mark Gurney To: Warner Losh Cc: Ed Schouten , src-committers , svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r286103 - head/share/man/man9 Message-ID: <20150731182214.GD78154@funkthat.com> References: <201507310328.t6V3S3LC087650@repo.freebsd.org> <20150731163110.GZ78154@funkthat.com> <9E180F45-B3B1-46C0-B02A-FFC3EB667A82@bsdimp.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <9E180F45-B3B1-46C0-B02A-FFC3EB667A82@bsdimp.com> X-Operating-System: FreeBSD 9.1-PRERELEASE amd64 X-PGP-Fingerprint: 54BA 873B 6515 3F10 9E88 9322 9CB1 8F74 6D3F A396 X-Files: The truth is out there X-URL: http://resnet.uoregon.edu/~gurney_j/ X-Resume: http://resnet.uoregon.edu/~gurney_j/resume.html X-TipJar: bitcoin:13Qmb6AeTgQecazTWph4XasEsP7nGRbAPE X-to-the-FBI-CIA-and-NSA: HI! HOW YA DOIN? can i haz chizburger? User-Agent: Mutt/1.5.21 (2010-09-15) X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (gold.funkthat.com [127.0.0.1]); Fri, 31 Jul 2015 11:22:14 -0700 (PDT) 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 18:22:16 -0000 Warner Losh wrote this message on Fri, Jul 31, 2015 at 10:37 -0600: > > > On Jul 31, 2015, at 10:31 AM, John-Mark Gurney wrote: > > > > 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? > >> > >> 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. > > > > I plan on documenting _Static_assert, and once that is documented > > for both userland and kernel, then we can mark this deprecated??? > > We generally don???t document built-in language features. Just add a note > to the CTASSERT man page that says use it instead. Ok, will do... This adds another question, since _Static_assert is a C11 feature, we should probably document that we provide compatibility for non-C11 compilers for this via sys/cdefs.h, correct? Though then for gcc and other pre-C11, _Static_assert isn't a built-in language feature.. Should we simplify the cdefs.h ifdef crazyness by assuming that anyone w/ __STDC_VERSION__ == 201112 has it? > > 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???s maybe > a dozen that apply to both. We???ve historically not tried to share them. Thanks. -- John-Mark Gurney Voice: +1 415 225 5579 "All that I will do, has been done, All that I have, has not."