Github user HyukjinKwon commented on the issue:

    https://github.com/apache/spark/pull/18396
  
    For warnings becoming errors, I described this in 
https://issues.apache.org/jira/browse/SPARK-20840 with my tests and 
observations. Given my investigation, the root cause is, Javadoc8 produces both 
warnings and errors into standard error and SBT gets confused of which one is 
warning. One possible approach (which was done in SBT I believe) is to manually 
parse the log output (in a similar way I proposed in the JIRA) but it looks 
gets a limitation. There are more information in the JIRA I investigated for a 
couple of weeks.
    
    For mismatching docs, I don't know the exact reason. My wild guess was it 
got confused by nested ones so I just tried to put `afterAll` to where I guess 
GenJavaDoc gets less confused.
    
    For not throwing errors for missing documentations in `StreamTest`, I guess 
because we disabled the doclint for miing documentation - 
https://github.com/apache/spark/blob/master/project/SparkBuild.scala#L233. For 
unknown reason, it appears the documentation went mixed with some functions 
that have no documentation and this threw errors for parameter mismatching that 
we check up to my knowledge.
    



---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to