svn commit: r286103 - head/share/man/man9

Warner Losh imp at bsdimp.com
Fri Jul 31 16:37:08 UTC 2015


> On Jul 31, 2015, at 10:31 AM, John-Mark Gurney <jmg at funkthat.com> 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.

> 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.

Warner

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 842 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://lists.freebsd.org/pipermail/svn-src-all/attachments/20150731/33e0cd5e/attachment.bin>


More information about the svn-src-all mailing list