I recently submitted an edit to the tag-wiki excerpt for gcc-pedantic.
The original (and, since my edit was rejected, current) excerpt was:
The pedantic option to gcc to forces ANSI-compatibility of code.
As well as being grammatically incorrect, this was not completely accurate. The -pedantic
option does force a higher level of standards-compliance, but does not succeed in eliminating all cases of non-compliance. I attempted to address this:
The
-pedantic
option to gcc is intended to force near-perfect ANSI/ISO compliance in code.It causes compile-time warnings for almost all non-compliant code (or errors instead of warnings with
-pedantic-errors
.), and outright prevents compilation for some non-compliant extensions.However, even
-pedantic
cannot detect all possible cases of non-compliance, and so it cannot guarantee fully-standard-compliant code.
This was originally accepted by two out of the three reviewers, but was then retroactively un-accepted when a fourth reviewer added a second "Reject".
One of the "Reject" reviews gave this reason:
Simply defining what a [tag] is rarely helps those using it unless the tag's name itself is ambiguous. Excerpts should describe why and when a tag should be used. See the help center for more guidance.
Whether or not the tag name is ambiguous... I think that would depend on your knowledge of gcc and what the -pedantic
option is, and I think most people have a good idea of what it is/does. So I wouldn't say the name was ambiguous. As for adding information on why and when it should be used, I think it could be argued that my edit provided more relevant context to this. But the inaccuracy of the previous excerpt should IMO be the main issue here.
Based on the comments, would the following be an improvement, and an acceptable excerpt?
Use this tag for questions about using gcc with the
-pedantic
option (which rejects most non-standards-compliant code), as well for questions about the option itself.
Backticks
will be rendered as `Backticks`...