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
[-- Attachment #1 --] > On Jul 31, 2015, at 3:24 AM, Ed Schouten <ed@nuxi.nl> wrote: > > Hi John-Mark, > > 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. sys/deffs.h defines it, if needed, so maybe that’s 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’s maybe a dozen out of a hundred man pages that should get the note. We shouldn’t remove the man page. If the project decides to stop using it, we should note it as deprecated instead of leaving it undocumented. Warner [-- Attachment #2 --] -----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-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?9F2F5DC0-660B-4831-BEE5-9E3A65A82122>