[Bug 194280] New: pthread_cleanup_push, pthread_cleanup_pop manual pages are missing critical usage information.

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=194280

            Bug ID: 194280
           Summary: pthread_cleanup_push, pthread_cleanup_pop manual pages
                    are missing critical usage information.
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: Needs Triage
          Severity: Affects Many People
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: dr2867.business at pacbell.net

The problem is that the man pages for pthread_cleanup_push(3) and
pthread_cleanup_pop(3) do not state the following facts:

They must be paired at the same lexicographical scope within code block within
the same function.

The macros, when expanded, adds a { for pthread_cleanup_push(3) and a } for
pthread_cleanup_pop(3) in the current implementation.  Failing to pair these
will cause compilation errors.

That last sentence should probably be highlighted.

This is on FreeBSD 9.3-RELEASE r270190.

-- 
You are receiving this mail because:
You are the assignee for the bug.