diff --git a/java/droidstubs.go b/java/droidstubs.go
index b94ad1669..5ca6c256f 100644
--- a/java/droidstubs.go
+++ b/java/droidstubs.go
@@ -1153,6 +1153,9 @@ 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")
+
 	if params.stubConfig.generateStubs {
 		rule.Command().
 			BuiltTool("soong_zip").