getcontext.3: Exemplar structure should use 'ucontext_t'.
commit0d4f6d6f889eb372ad76e6d456a6c3bf7031469a
authorCarlos O'Donell <carlos@redhat.com>
Thu, 29 Jun 2017 16:17:15 +0000 (29 12:17 -0400)
committerMichael Kerrisk <mtk.manpages@gmail.com>
Wed, 5 Jul 2017 08:29:59 +0000 (5 10:29 +0200)
tree45c9d90c516d20fdb8734680059b6870f067063a
parenta79107aefebc920ec273055e8278f6cd52fe8285
getcontext.3: Exemplar structure should use 'ucontext_t'.

In glibc we just finished a round of purging 'struct ucontext'
which is not in the POSIX reserved namespace of *_t tags. This has
some consequences to applications using the non-standard struct
ucontext:
https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
but it also fixes a namespace conformance issue which is always a
longterm pain for large portable programs.

It was noted by Peter Maydell
(https://sourceware.org/bugzilla/show_bug.cgi?id=21457) that the
linux man pages still had references to 'struct ucontext' but only
in the form of an exemplar structure.

The patch fixes the exemplar to match what is in glibc
and therefore it won't ever suggest users can use 'struct
ucontext'.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
man3/getcontext.3