-
Notifications
You must be signed in to change notification settings - Fork 9.1k
HADOOP-18229. Fix Hadoop-Common JavaDoc Error #4292
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
i had seen this myself and was thinking of having a go...you have made my life easier.
+1 pending jenkins being happy
|
@steveloughran Thanks for review the code, I tried to fix some compilation problems of Java Doc, including error and warn, but there are a lot of problems, I will submit another batch of fixes in the next JIRA |
This comment was marked as outdated.
This comment was marked as outdated.
GenericOptionsParser.java empty p tag and unexpected end tag: p Tool.java empty p tag RemoteIterators.java empty p tag FileSystem.java empty p tag MultipartUploaderBuilder.java no description for @param InodeTree.java reference not found JMXJsonServlet.java empty p tag and unexpected end tag CBZip2OutputStream.java no summary or caption for table
|
Thanks for taking this up, +1 (non-binding) assuming next QA results from Jenkins are good for Javadoc |
|
💔 -1 overall
This message was automatically generated. |
ConfigRedactor.java no description for @param Configuration.java warning: no @return, no description for @param, no @param for <U>, no @throws for java.io.IOException, no description for @throws etc. GenericOptionsParser.java unexpected end tag. IOStatisticsSnapshot.java warning: empty <p> tag. Writable.java no description for @throws.
Configured.java no @param for conf CryptoCodec.java no @throws for java.security.GeneralSecurityException Reconfigurable.java no @param for property, no @param for newVal, no @throws for org.apache.hadoop.conf.ReconfigurationException ReconfigurableBase.java no @param for conf,no @return,no @throws for java.io.IOException ReconfigurationException.java no @param for property, no @param for newVal, no @param for cause for property etc ReconfigurationTaskStatus.java no @return
CryptoInputStream.java no description for @throws, CryptoOutputStream.java no description for @throws, CryptoStreamUtils.java no @param for buffer, no @param for conf, no @return, no @param for codec, no @throws for java.io.IOException HasFileDescriptor.java no description for @throws, KeyProvider.java no description for @throws, OpensslCipher.java no description for @throws, Seekable.java no @param for pos, no @throws for java.io.IOException, no @param for targetPos
This comment was marked as outdated.
This comment was marked as outdated.
KeyProvider.java no @throws for java.security.NoSuchAlgorithmException, no @throws for java.io.IOException KeyProviderCryptoExtension.java warning: no description for @param, warning: no @throws for java.io.IOException DelegationTokenIssuer.java warning: no @return, warning: no @param for renewer, no @param for issuer etc KeyProviderDelegationTokenExtension.java no description for @throws, Tool.java warning: no description for @throws CommandShell.java warning: no @return, warning: no description for @param KeyShell.java warning: no description for @throws TokenRenewer.java warning: no description for @throws,warning: no @param for token
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
|
💔 -1 overall
This message was automatically generated. |
AbstractFileSystem.java no @param for f, no @param for opts etc Configuration.java warning: no @throws for java.lang.Exception CryptoStreamUtils.java: warning: no @param for buffer KeyProvider.java warning: no description for @throws DelegationTokenIssuer.java: no description for @param TokenRenewer.java: no @param for token ValueQueue.java: no description for @throws CryptoStreamUtils.java checkstyle KeyProvider.java checkstyle OpensslCipher.java checkstyle
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
Change Pom.xml Maven Support JDK1.8
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
@steveloughran @virajjasani @goiri I have completed the compilation and repair of hadoop-common under jdk11, please help to review the code. Thank you everyone. |
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
Hi,@steveloughran @virajjasani @goiri , I have fixed hadoop-common javadoc compilation problem in jdk11, please help to review the code. The java doc compilation will run twice, the first time it is compiled directly using the trunk branch, and the second time it will be compiled in merge pr. The error you see is the error after compiling the trunk branch, the problem is solved after merge pr. my changes are as follows: 1.modify the java doc configuration of the pom file, skip the proto file. 2.fix the warn and error problems, as follows: |
|
@steveloughran please help to review the code, I feel that this work is quite meaningful, for the code normative point of view, thanks! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lets get this in; if there are more issues we can follow up
|
now, can we get this cherrypicked into branch-3.3? |
Thank you very much for your help reviewing the code, I will push the changes to branch3.3. |
I fixed it in PR(#4327) |
Contributed by slfan1989
JIRA:HADOOP-18229. Fix Hadoop Common Java Doc Error
It is found that the JavaDoc Error problem blocks the merge of HADOOP-18222. HADOOP-18222 will cause the RM startup problem, which needs to be solved as soon as possible.