swift234

Hide some comments from -Wdocumentation to shut up warnings

Clang doesn't seem to treat variables of function pointer type as valid
functions (unlike e.g. typedefs of function types), so it was warning
about \param and \returns.  For now, just disable the warning in this
header.  I filed rdar://problem/24978538 to fix clang.