Date: Fri, 31 Jul 2015 10:37:03 -0600 From: Warner Losh <imp@bsdimp.com> To: John-Mark Gurney <jmg@funkthat.com> Cc: Ed Schouten <ed@nuxi.nl>, src-committers <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: <9E180F45-B3B1-46C0-B02A-FFC3EB667A82@bsdimp.com> In-Reply-To: <20150731163110.GZ78154@funkthat.com> References: <201507310328.t6V3S3LC087650@repo.freebsd.org> <CABh_MKm45daZPYPNFBmmkdP32sNMCtu1w33kapcouPvxcfN8_Q@mail.gmail.com> <20150731163110.GZ78154@funkthat.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <jmg@funkthat.com> = 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?9E180F45-B3B1-46C0-B02A-FFC3EB667A82>