From owner-svn-src-head@freebsd.org Fri Jul 31 14:34:51 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 7A71D9AF081 for ; Fri, 31 Jul 2015 14:34:51 +0000 (UTC) (envelope-from imp@bsdimp.com) Received: from mail-ig0-f170.google.com (mail-ig0-f170.google.com [209.85.213.170]) (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 3DB5A1459 for ; Fri, 31 Jul 2015 14:34:50 +0000 (UTC) (envelope-from imp@bsdimp.com) Received: by igbij6 with SMTP id ij6so17533398igb.1 for ; Fri, 31 Jul 2015 07:34:50 -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=89w4W7e1vbfA0FdF9BAoLBbWN86ofAI0olfYy2EC4Ls=; b=a/mMJc7xazbuKUzLyiYH6LJ5E0ZqVx17hYn/YNgvBussUrDte6HNoYHWFVWZfgybw9 8anFS750NVwdPbZnWME9SzumxHqZ+ThlNcLhuSNWVu85Wv20qdBU0wtUjQibIc0P/9aM HYAp+1CsktiojZkNFVDR3b7TkeMdpMqZU7qeyM2j6GMwOjpA2xSp8ZqvokHugLPHhHyR UdxmmdOcTTJ/2Nq0TD9cBpOnx997gRa3twStUvvajmYWaccvW9nBLFnGmOF+T/jYKdIO 0kO9H6UUDzQC9Lks01OVHLCa2IyV8V8nWsSywaKxq/HMdpZHmXv62xT2KqHqaeb1SaP3 NcWA== X-Gm-Message-State: ALoCoQknuCceM79wN9vpEff6xN+IolQI251AZC/1Ut9OdCIeybhT6gtmOPI8ENy2lozrD+cYi00J X-Received: by 10.50.64.179 with SMTP id p19mr6572302igs.55.1438353290029; Fri, 31 Jul 2015 07:34:50 -0700 (PDT) Received: from netflix-mac-wired.bsdimp.com ([50.253.99.174]) by smtp.gmail.com with ESMTPSA id j3sm2352775ige.0.2015.07.31.07.34.49 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Fri, 31 Jul 2015 07:34:49 -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=_52065108-EBDB-4353-BFA0-CFE4FA66285D"; protocol="application/pgp-signature"; micalg=pgp-sha512 X-Pgp-Agent: GPGMail 2.5 From: Warner Losh In-Reply-To: Date: Fri, 31 Jul 2015 08:34:47 -0600 Cc: John-Mark Gurney , src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Message-Id: <9F2F5DC0-660B-4831-BEE5-9E3A65A82122@bsdimp.com> References: <201507310328.t6V3S3LC087650@repo.freebsd.org> To: Ed Schouten 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 14:34:51 -0000 --Apple-Mail=_52065108-EBDB-4353-BFA0-CFE4FA66285D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 > On Jul 31, 2015, at 3:24 AM, Ed Schouten wrote: >=20 > Hi John-Mark, >=20 > 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. sys/deffs.h defines it, if needed, so maybe that=E2=80=99s wise. Generally, foo(9) is relegated to the kernel. Only in cases where it can = be used in user land should it be mentioned, rather than the converse. = There=E2=80=99s maybe a dozen out of a hundred man pages that should get the note. We shouldn=E2=80=99t remove the man page. If the project decides to stop = using it, we should note it as deprecated instead of leaving it undocumented. Warner --Apple-Mail=_52065108-EBDB-4353-BFA0-CFE4FA66285D 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 iQIcBAEBCgAGBQJVu4eHAAoJEGwc0Sh9sBEAWiEQALC2S04EEfzd6E2myNrpo8f6 /FSnZR3kujjsAI5zBzAvZdCJEwh3krnaotDGOpTqezeRtkbLg5E48bI1DD7x2Qw0 Aln/QH3qLLmLMlvuW7bwHD0MjOtJgteMDy2yXZdOImU4MKxkgZokaCdCkVzFYVTe lJ2+PjAlMiKQX/AC19DiaMlFjbbN6CSaRGESVtTzRJk8XOKI1Wc/RFWw3iKl6JCj OyqNn991s2s2e25/T2yzh1OTr1baepPhCT4mm1rFzXEpd3O11Nwll+se6dBV3RW4 vnfsejO3ytphg5/Q+1uC7aOlN00474XuP/tv2qehJhPmoGXQBQCGrqRVcqlsmiR/ SGR2PVgiGq8fRFeVOHscquHgogELItK/rC9todnYxRjQBbAY1LAtiWtCNKgth/DN WJspZj3yFvMcommv05HUQTGiIj/jCxdxbosrrJjhDRUhBAo8Dr0EoVUbHrIoj4qk iLFMvV9exgXp+GQ82S7BLq1g3D6BPWBLXC3B+pyELvO3hovCA58uGdwcIFLEn9WE Fr4WKsZh8FbVsxvrjAgjQW5VkBVuc+cM/One7Ab9LpNEr6bvyv8/9JTyVCgRzA9a sQY7IfDSaPeK2AWhpB7PKstud84Q7U1KqVEvjAL8PlB6Ohlp0Wep5hcXL6XojLmK Zdjs48Je1uOG5YtKnQw2 =oCNb -----END PGP SIGNATURE----- --Apple-Mail=_52065108-EBDB-4353-BFA0-CFE4FA66285D--