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

[John-Mark Gurney]

Warner Losh wrote this message on Fri, Jul 31, 2015 at 10:37 -0600:
> 
> > 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.

Ok, will do...

This adds another question, since _Static_assert is a C11 feature, we
should probably document that we provide compatibility for non-C11
compilers for this via sys/cdefs.h, correct?  Though then for gcc
and other pre-C11, _Static_assert isn't a built-in language feature..

Should we simplify the cdefs.h ifdef crazyness by assuming that anyone
w/ __STDC_VERSION__ == 201112 has it?

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

Thanks.

-- 
  John-Mark Gurney				Voice: +1 415 225 5579

     "All that I will do, has been done, All that I have, has not."