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