This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH] Linux: Implement membarrier function
- From: Joseph Myers <joseph at codesourcery dot com>
- To: Florian Weimer <fweimer at redhat dot com>
- Cc: <libc-alpha at sourceware dot org>
- Date: Wed, 5 Dec 2018 16:28:03 +0000
- Subject: Re: [PATCH] Linux: Implement membarrier function
- References: <8736rldyzm.fsf@oldenburg.str.redhat.com> <87in08hzzt.fsf@oldenburg2.str.redhat.com>
Are you going to open a bug report in Bugzilla for the lack of
documentation (discussing exactly what the issues are that need to be
clarified to document the function)?
If in any particular case there is sufficient justification for not
documenting a new function, I'd expect such a bug report as a minimum to
say what needs to be done to add documentation. (The most common case for
not adding documentation is probably that the function joins a whole
family of existing functions lacking documentation, in which case one bug
report for the whole family suffices, like bug 10891 covering all the *_l
functions missing documentation.)
--
Joseph S. Myers
joseph@codesourcery.com