diff --git a/java/droidstubs.go b/java/droidstubs.go index 5ca6c256f..b32b754d3 100644 --- a/java/droidstubs.go +++ b/java/droidstubs.go @@ -1054,8 +1054,7 @@ func (d *Droidstubs) everythingOptionalCmd(ctx android.ModuleContext, cmd *andro } if !treatDocumentationIssuesAsErrors { - // Treat documentation issues as warnings, but error when new. - cmd.Flag("--error-when-new-category").Flag("Documentation") + treatDocumentationIssuesAsWarningErrorWhenNew(cmd) } // Add "check released" options. (Detect incompatible API changes from the last public release) @@ -1083,6 +1082,22 @@ func (d *Droidstubs) everythingOptionalCmd(ctx android.ModuleContext, cmd *andro } } +// HIDDEN_DOCUMENTATION_ISSUES is the set of documentation related issues that should always be +// hidden as they are very noisy and provide little value. +var HIDDEN_DOCUMENTATION_ISSUES = []string{ + "Deprecated", + "IntDef", + "Nullable", +} + +func treatDocumentationIssuesAsWarningErrorWhenNew(cmd *android.RuleBuilderCommand) { + // Treat documentation issues as warnings, but error when new. + cmd.Flag("--error-when-new-category").Flag("Documentation") + + // Hide some documentation issues that generated a lot of noise for little benefit. + cmd.FlagForEachArg("--hide ", HIDDEN_DOCUMENTATION_ISSUES) +} + // Sandbox rule for generating exportable stubs and other artifacts func (d *Droidstubs) exportableStubCmd(ctx android.ModuleContext, params stubsCommandConfigParams) { optionalCmdParams := stubsCommandParams{ @@ -1154,7 +1169,7 @@ func (d *Droidstubs) optionalStubCmd(ctx android.ModuleContext, params stubsComm } // Treat documentation issues as warnings, but error when new. - cmd.Flag("--error-when-new-category").Flag("Documentation") + treatDocumentationIssuesAsWarningErrorWhenNew(cmd) if params.stubConfig.generateStubs { rule.Command().