https://gcc.gnu.org/bugzilla/show_bug.cgi?id=89915
Bug ID: 89915
Summary: clean up and canonicalize wording in params.def
Product: gcc
Version: 9.0
Status: UNCONFIRMED
Severity: normal
Priority: P3
Component: translation
Assignee: unassigned at gcc dot gnu.org
Reporter: roland.illig at gmx dot de
Target Milestone: ---
As of 2019-04-01, the params.def looks as if it has been written by many
different authors with no coordination:
* some parameter descriptions start with "The", others don't.
* some parameter descriptions contain long and helpful explanations, most
others don't.
* some parameter descriptions still contain redundant comments. I complained
about this one year ago in #79632, but nothing has happened since then.
* PARAM_LOGICAL_OP_NON_SHORT_CIRCUIT has "True if a non-short-circuit operation
is optimal." as a description. This differs in grammatical style from the other
descriptions. It's also not clear how to express "true", since "gcc -c --param
min-vect-loop-bound=true empty.c" results in "cc1: error: invalid --param value
'true'".
In summary, the writing style in params.def is inconsistent in many places and
on many levels.
This makes it hard to translate the strings in this file into proper and
understandable German. This in turn makes it really difficult for
German-speaking programmers to know what slang terms GCC is throwing at them,
and they will probably switch over to Clang to get better diagnostics.
Someone familiar with all the words mentioned in that file should explain each
of these words to an average programmer and rewrite the parameter descriptions
according to the needs of that average programmer.
