diff --git a/core/src/main/java/com/google/errorprone/bugpatterns/argumentselectiondefects/ArgumentSelectionDefectChecker.java b/core/src/main/java/com/google/errorprone/bugpatterns/argumentselectiondefects/ArgumentSelectionDefectChecker.java index aeca8a804c1..113f1833c39 100644 --- a/core/src/main/java/com/google/errorprone/bugpatterns/argumentselectiondefects/ArgumentSelectionDefectChecker.java +++ b/core/src/main/java/com/google/errorprone/bugpatterns/argumentselectiondefects/ArgumentSelectionDefectChecker.java @@ -54,13 +54,13 @@ */ @BugPattern( name = "ArgumentSelectionDefectChecker", - summary = "Arguments to this method call may be in the wrong order", + summary = "Arguments are in the wrong order or could be commented for clarity.", explanation = "If permuting the arguments of a method call means that the argument names are a better " + "match for the parameter names than the original ordering then this might indicate " + "that they have been accidentally swapped. There are also legitimate reasons for the " + "names not to match such as when rotating an image (swap width and height). In this " - + "case we would recommend annotating the names with a comment to make the deliberate " + + "case we suggest annotating the names with a comment to make the deliberate " + "swap clear to future readers of the code. Argument names annotated with a comment " + "containing the parameter name will not generate a warning.", category = JDK,