I was preparing our internal release documentation with our tech writers, and
when reviewing the clang manual for the current release, we think the current
documentation of type safety attributes are inadequate in a few aspects:
- The arguments to these attributes are not described.
- Some of the MPI code examples seem incomplete as they miss declarations.
- Some references could be made more clear. For example, for the "type_tag_for_datatype" attribute, it is mentioned that its optional third argument determines "how the expression is compared to the type tag", but it is left unspecified what the "expression" is referring to.
We would like to share the edits we have made, both in hope that the edits are
useful to a wider audience, and also to gather some feedback that the new
documentation is still accurate.
Could you review?