[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16358554#comment-16358554
]
Konrad Windszus edited comment on SLING-6766 at 2/9/18 3:55 PM:
The error is definitely the classpath which is passed on to javadoc (located in
{{out/target/site/apidocs/options}}). The source for this is at
https://github.com/apache/maven-javadoc-plugin/blob/12dbbde29cf6277ca311cb8afffdf02dbfe0c9b4/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java#L2601.
The reason why the order is not always the same is that for transitive
dependencies a HashMap is being used internally
(https://github.com/apache/maven-javadoc-plugin/blob/12dbbde29cf6277ca311cb8afffdf02dbfe0c9b4/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java#L2605).
I opened MJAVADOC-513 for an improvement here.
[~rombert] For this time until we have a proper fix can I ask you to run the
script again and push the changes?
was (Author: kwin):
The error is definitely the classpath which is passed on to javadoc (located in
{{out/target/site/apidocs/options}}). I have not yet figured out how to
influence the order in that file. The source for this is at
https://github.com/apache/maven-javadoc-plugin/blob/12dbbde29cf6277ca311cb8afffdf02dbfe0c9b4/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java#L2601.
The reason why the order is not always the same is that for transitive
dependencies a HashMap is being used internally
(https://github.com/apache/maven-javadoc-plugin/blob/12dbbde29cf6277ca311cb8afffdf02dbfe0c9b4/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java#L2605).
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
> Attachments: Open_Type.png
>
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16358554#comment-16358554
]
Konrad Windszus edited comment on SLING-6766 at 2/9/18 3:43 PM:
The error is definitely the classpath which is passed on to javadoc (located in
{{out/target/site/apidocs/options}}). I have not yet figured out how to
influence the order in that file. The source for this is at
https://github.com/apache/maven-javadoc-plugin/blob/12dbbde29cf6277ca311cb8afffdf02dbfe0c9b4/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java#L2601.
The reason why the order is not always the same is that for transitive
dependencies a HashMap is being used internally
(https://github.com/apache/maven-javadoc-plugin/blob/12dbbde29cf6277ca311cb8afffdf02dbfe0c9b4/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java#L2605).
was (Author: kwin):
The error is definitely the classpath which is passed on to javadoc (located in
{{out/target/site/apidocs/options}}). I have not yet figured out how to
influence the order in that file. The source for this is at
https://github.com/apache/maven-javadoc-plugin/blob/12dbbde29cf6277ca311cb8afffdf02dbfe0c9b4/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java#L2601.
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
> Attachments: Open_Type.png
>
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16358554#comment-16358554
]
Konrad Windszus edited comment on SLING-6766 at 2/9/18 3:39 PM:
The error is definitely the classpath which is passed on to javadoc (located in
{{out/target/site/apidocs/options}}). I have not yet figured out how to
influence the order in that file. The source for this is at
https://github.com/apache/maven-javadoc-plugin/blob/12dbbde29cf6277ca311cb8afffdf02dbfe0c9b4/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java#L2601.
was (Author: kwin):
The error is definitely the classpath which is passed on to javadoc (located in
{{out/target/site/apidocs/options}}). I have not yet figured out how to
influence the order in that file.
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
> Attachments: Open_Type.png
>
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16358298#comment-16358298
]
Konrad Windszus edited comment on SLING-6766 at 2/9/18 1:25 PM:
The reason for this error is
{code}
[ERROR] Exit code: 1 - javadoc: warning - Multiple sources of package comments
found for package "org.osgi.framework"
[ERROR] javadoc: warning - Multiple sources of package comments found for
package "org.osgi.service.url"
{code}
Obviously we don't have a clean classpath but rather duplications in it.
The class {{org.osgi.service.component.annotations.Reference}} is provided by 7
different artifacts and 5 different artifact names!
As the order is kind of non-deterministic (or at least OS-specific) with Maven
I get the error. So the question is, why do we have multiple different
dependencies for the same class and how to force Maven to use the right one.
was (Author: kwin):
The reason for this error is
{code}
[ERROR] Exit code: 1 - javadoc: warning - Multiple sources of package comments
found for package "org.osgi.framework"
[ERROR] javadoc: warning - Multiple sources of package comments found for
package "org.osgi.service.url"
{code}
Obviously we don't have a clean classpath but rather duplications in it. As the
order is kind of non-deterministic (or at least OS-specific) with Maven I get
the error. So the question is, why do we have multiple different dependencies
for the same class and how to force Maven to use the right one.
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
> Attachments: Open_Type.png
>
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16358298#comment-16358298
]
Konrad Windszus edited comment on SLING-6766 at 2/9/18 1:25 PM:
The reason for this error is
{code}
[ERROR] Exit code: 1 - javadoc: warning - Multiple sources of package comments
found for package "org.osgi.framework"
[ERROR] javadoc: warning - Multiple sources of package comments found for
package "org.osgi.service.url"
{code}
Obviously we don't have a clean classpath but rather duplications in it.
The class {{org.osgi.service.component.annotations.Reference}} is provided by 7
different artifacts and 5 different artifact names!
!Open_Type.png!
As the order is kind of non-deterministic (or at least OS-specific) with Maven
I get the error. So the question is, why do we have multiple different
dependencies for the same class and how to force Maven to use the right one.
was (Author: kwin):
The reason for this error is
{code}
[ERROR] Exit code: 1 - javadoc: warning - Multiple sources of package comments
found for package "org.osgi.framework"
[ERROR] javadoc: warning - Multiple sources of package comments found for
package "org.osgi.service.url"
{code}
Obviously we don't have a clean classpath but rather duplications in it.
The class {{org.osgi.service.component.annotations.Reference}} is provided by 7
different artifacts and 5 different artifact names!
As the order is kind of non-deterministic (or at least OS-specific) with Maven
I get the error. So the question is, why do we have multiple different
dependencies for the same class and how to force Maven to use the right one.
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
> Attachments: Open_Type.png
>
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16358298#comment-16358298
]
Konrad Windszus edited comment on SLING-6766 at 2/9/18 11:58 AM:
-
The reason for this error is
{code}
[ERROR] Exit code: 1 - javadoc: warning - Multiple sources of package comments
found for package "org.osgi.framework"
[ERROR] javadoc: warning - Multiple sources of package comments found for
package "org.osgi.service.url"
{code}
Obviously we don't have a clean classpath but rather duplications in it. As the
order is kind of non-deterministic (or at least OS-specific) with Maven I get
the error. So the question is, why do we have multiple different dependencies
for the same class and how to force Maven to use the right one.
was (Author: kwin):
The reason for this error is
{code}
[ERROR] Exit code: 1 - javadoc: warning - Multiple sources of package comments
found for package "org.osgi.framework"
[ERROR] javadoc: warning - Multiple sources of package comments found for
package "org.osgi.service.url"
{code}
Obviously we don't have a clean classpath but rather duplications in it. As the
order is kind of non-deterministic (or at least OS-specific) with Maven I get
the error. So the question is, we do we have multiple different dependencies
for the same class and how to force Maven to use the right one.
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16358220#comment-16358220
]
Robert Munteanu edited comment on SLING-6766 at 2/9/18 10:38 AM:
-
I am not sure what the problem is then. Maybe you can try disabling some checks
with {{-Xdoclint=...}}? See
https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javadoc.html for
details.
_edit_: formatting
was (Author: rombert):
I am not sure what the problem is then. Maybe you can try disabling some checks
with {{-Xdoclint=...}? See
https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javadoc.html for
details.
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16357393#comment-16357393
]
Konrad Windszus edited comment on SLING-6766 at 2/8/18 6:58 PM:
[~rombert] I get 48 Errors with Java 8 and OOM or PermGen errors while doing
{{maven-remote-resources-plugin:1.5:process}} in {{Apache Sling I18N Support
2.5.12}} with Java 7. What do you use to run the script and succesfully build
the javadoc of all modules?
was (Author: kwin):
[~rombert] I get 48 Errors with Java 8 and OOM or PermGen errors with Java 7.
What do you use to run the script and succesfully build the javadoc of all
modules?
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16357393#comment-16357393
]
Konrad Windszus edited comment on SLING-6766 at 2/8/18 6:52 PM:
[~rombert] I get 48 Errors with Java 8 and OOM or PermGen errors with Java 7.
What do you use to run the script and succesfully build the javadoc of all
modules?
was (Author: kwin):
[~rombert] I get 48 Errors with Java 8 and OOM or PermGen errors with Java 7.
What do you use to run the script and succesfully build the javascript of all
modules?
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16357393#comment-16357393
]
Konrad Windszus edited comment on SLING-6766 at 2/8/18 6:49 PM:
[~rombert] I get 48 Errors with Java 8 and OOM or PermGen errors with Java 7.
What do you use to run the script and succesfully build the javascript of all
modules?
was (Author: kwin):
[~rombert] I get 48 Errors with Java 8 and OOM errors with Java 7. What do you
use to run the script and succesfully build the javascript of all modules?
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Robert Munteanu
>Priority: Major
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Comment Edited] (SLING-6766) Javadoc: Include package org.apache.sling.adapter.annotations in the Sling javadocs
[
https://issues.apache.org/jira/browse/SLING-6766?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16353984#comment-16353984
]
Konrad Windszus edited comment on SLING-6766 at 2/6/18 3:13 PM:
[~rombert] Any idea why this package does still not appear in
http://sling.apache.org/apidocs/sling10/index.html. Was I tweaking the wrong sh
file with
https://github.com/apache/sling-tooling-release/blob/master/generate_javadoc_for_release.sh?
was (Author: kwin):
[~rombert] Any idea why this package does still not appear in
http://sling.apache.org/apidocs/sling10/index.html. Was I tweaking the wrong sh
file?
> Javadoc: Include package org.apache.sling.adapter.annotations in the Sling
> javadocs
> ---
>
> Key: SLING-6766
> URL: https://issues.apache.org/jira/browse/SLING-6766
> Project: Sling
> Issue Type: Improvement
> Components: Commons, Site
>Reporter: Konrad Windszus
>Assignee: Konrad Windszus
>Priority: Major
>
> Currently the javadocs at https://sling.apache.org/apidocs/sling8/ do not
> include the package {{org.apache.sling.adapter.annotations}} (being added
> with SLING-2313).
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
