[ 
https://issues.apache.org/jira/browse/OAK-6150?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16021054#comment-16021054
 ] 

Davide Giannella commented on OAK-6150:
---------------------------------------

so I gave a deeper look. {{release:prepare}} still fails (without
patch) and by looking around and focusing on one error it looks like,
for the following,

{noformat}
[INFO] [ERROR] Failed to execute goal 
org.apache.maven.plugins:maven-javadoc-plugin:2.10.3:jar (attach-javadocs) on 
project oak-api: MavenReportException: Error while generating Javadoc:
[INFO] [ERROR] Exit code: 1 - 
/work/sources/apache/releases/oak-svn-trunk/oak-api/src/main/java/org/apache/jackrabbit/oak/api/PropertyState.java:63:
 error: reference not found
[INFO] [ERROR] * in the {@link 
org.apache.jackrabbit.oak.plugins.value.Conversions} class.
[INFO] [ERROR] ^
[INFO] [ERROR] 
/work/sources/apache/releases/oak-svn-trunk/oak-api/src/main/java/org/apache/jackrabbit/oak/api/PropertyState.java:65:
 warning: no description for @param
[INFO] [ERROR] * @param <T>
{noformat}

the problem is that oak-api includes a reference to a dependency on
oak-store-spi ({{o.a.j.o.p.value.Conversions}}). And indeed my
IntelliJ complains about it.

Played around with javadoc plugin and various configurations without
any luck and so far the approach in the patch (replace the {{@link}}
with {{@code}}) sounds the most reasonable.

I will try the {{release:prepare}} after applying the patch but so far
this is the only way to address this as far as I can see.

so [~alex.parvulescu] +1 for the patch.



> Javadoc plugin fails on Java 8
> ------------------------------
>
>                 Key: OAK-6150
>                 URL: https://issues.apache.org/jira/browse/OAK-6150
>             Project: Jackrabbit Oak
>          Issue Type: Bug
>          Components: doc
>            Reporter: Alex Parvulescu
>            Assignee: Alex Parvulescu
>            Priority: Blocker
>             Fix For: 1.7.0
>
>         Attachments: OAK-6150-release.patch
>
>
> As discussed on the mailing list (will provide link soon) the javadoc 
> generation fails on java 8. For next level complexity the release plugin also 
> fails.
> For javadocs:
> {noformat}
> mvn javadoc:javadoc
> {noformat}
> and for the more adventurous:
> {noformat}
> mvn release:prepare -DdryRun=true
> {noformat}
> I'm tentatively setting fix version 1.7.0 to try to resolve this in time for 
> the release (not sure when that is though).
> [~reschke] could you add the relevant errors here?



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Reply via email to