Date: Fri, 31 Jul 2015 08:34:47 -0600 From: Warner Losh <imp@bsdimp.com> To: Ed Schouten <ed@nuxi.nl> Cc: John-Mark Gurney <jmg@freebsd.org>, src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r286103 - head/share/man/man9 Message-ID: <9F2F5DC0-660B-4831-BEE5-9E3A65A82122@bsdimp.com> In-Reply-To: <CABh_MKm45daZPYPNFBmmkdP32sNMCtu1w33kapcouPvxcfN8_Q@mail.gmail.com> References: <201507310328.t6V3S3LC087650@repo.freebsd.org> <CABh_MKm45daZPYPNFBmmkdP32sNMCtu1w33kapcouPvxcfN8_Q@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <ed@nuxi.nl> 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?9F2F5DC0-660B-4831-BEE5-9E3A65A82122>