javadoc error on mvn install

[eis]

Tried to install this using "mvn clean install". First I encountered the issue described in #196 and after that, I get

[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 31.958s
[INFO] Finished at: Sun Feb 16 16:29:54 EET 2014
[INFO] Final Memory: 64M/1463M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:jar (attach-javadocs) on project google-play-services: MavenReportException: Error while creating archive:
[ERROR] Exit code: 1 - D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\
r\com\google\android\gms\R.java:89: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:90: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:91: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:98: error: no summary or caption for table
[ERROR] </table>
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:322: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:323: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:330: error: no summary or caption for table
[ERROR] </table>
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:397: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:398: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:414: error: no summary or caption for table
[ERROR] </table>
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:513: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:514: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:515: error: unknown tag: colgroup
[ERROR] <colgroup align="left" />
[ERROR] ^
[ERROR] D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\generated-sources\r\com\google\android\gms\R.java:522: error: no summary or caption for table
[ERROR] </table>
[ERROR] ^
[ERROR]
[ERROR] Command line was: "C:\Program Files\Java\jdk1.8.0\jre\..\bin\javadoc.exe" @options @packages
[ERROR]
[ERROR] Refer to the generated Javadoc files in 'D:\other\code\java\android\maven-android-sdk-deployer\extras\google-play-services\target\apidocs' dir.
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR]
[ERROR] After correcting the problems, you can resume the build with the command
[ERROR]   mvn <goals> -rf :google-play-services

Skipping using -Dmaven.javadoc.skip=true doesn't help either, as then it fails with missing javadocs.

[eis]

Apparently JDK 8 is not yet supported. Changed to JDK 7 and it works. As we're using enforcer-plugin for maven version, we should add a similar rule for JDK 8.

[eis]

It might be the general issue of javadoc tool in JDK 8 being more strict, see http://mail-archives.apache.org/mod_mbox/hadoop-common-issues/201311.mbox/%3CJIRA.12681661.1385586762252.48109.1385753855233@arcas%3E and http://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete. However, once I got the build to work once by using JDK 7, I seem to be unable to reproduce the problem anymore so I cannot verify if the SO solution will work. Also, it would need to be introduced in a way it doesn't impact building on older JDKs.

[ghost]

not sure if this is the best solution but adding

<configuration><additionalparam>-Xdoclint:none</additionalparam></configuration>

to maven-javadoc-plugin gets it building successfully