On Wed, Sep 05, 2012 at 09:08:56AM +0000, Emmanuel Dreyfus wrote: > On Wed, Sep 05, 2012 at 04:42:57PM +1000, matthew green wrote: > > the right place to document this is in the source code, not in the > > public documentation. please move or delete this.
Indeed. > The flags are documented in source code. However since we named the > field uc_flags and not _uc_flags, one could expect it to be public > interface, hence the motivation to state it is not. You may be reading too much into this. To shed some light on it, that structure member got named this way simply because the uc_ prefix is already reserved for <ucontext.h> use. No underscores required, none of the application's business, thus no mention in ucontext(2) (so why would anyone consider it public?). - Klaus
