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

[Warner Losh]

> On Jul 31, 2015, at 3:24 AM, Ed Schouten <ed at 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

-------------- 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-head/attachments/20150731/eb8731d7/attachment.bin>