Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [cbi-dev] Generating javadoc in CBI

On Thu, 11 Jul 2019 at 11:17, Geneviève Bastien <gbastien+lttng@xxxxxxxxxxxx> wrote:

May I ask another question on this topic? #


Sure :-) 
 

About the location where the javadoc is published, we have been using a configuration option in our pom.xml, then specify the <outputDirectory> and <reportOutputDirectory> in the maven-javadoc-plugin configuration to publish directly somewhere in download.eclipse.org.

I see you have a post-build that says "Publish Javadoc". Where does this publish the doc? Is there an official location for the javadoc of an Eclipse project?


It will add a link in your job that says "javadoc" on the left side once a build is successful.

However, there are still some problems with using it and frames, with some possible workarounds: see https://issues.jenkins-ci.org/browse/JENKINS-32619

This conversation reminded me that I got stalled on this part and have not come back to it since our switch to JIRO: https://bugs.eclipse.org/bugs/show_bug.cgi?id=537954 - so I will follow with interest how you solve it and work with you if you want.

HTH,
Jonah
 

Thanks,

Geneviève



On 7/10/19 4:22 PM, Jonah Graham wrote:
Wonderful, I am pleased that I was able to help!

Jonah 

On Wed., Jul. 10, 2019, 16:01 Geneviève Bastien, <gbastien+lttng@xxxxxxxxxxxx> wrote:

Hi,

Thanks! it worked by following the example of your job! Maybe it was the memory: I had a first step with 'mvn clean install' and then did another with 'mvn javadoc:aggregate'. Now, like you did, I have only one run with 'mvn clean package javadoc:aggregate' and it terminates correctly.

Thanks for the help,

Geneviève


On 7/10/19 2:40 PM, Jonah Graham wrote:
I am not sure, but this seemed very familiar to me - but I can't seem to remember exactly. I believe the problem I ran into was similar with CDT and the problem was running out of memory. If it is that, you should be able to replicate locally with JAVA_TOOL_OPTIONS env variable set to similar as the build machine (e.g. -Xmx2G)

FWIW, CDT does indeed build javadocs on Jenkins CI @ Eclipse. However it is currently not working for unrelated reasons*. The pre-JIRO job is archived here if it helps you to consult it: https://ci.eclipse.org/cdt/view/all/job/archive-cdt-master-javadoc/ - you should be able to see configuration and what the console and output from the last time we ran it.

* I haven't got the job working since upgrading to JIRO, but tracecompass is still running pre-JIRO.

HTH,
Jonah

~~~
Jonah Graham
Kichwa Coders
www.kichwacoders.com


On Wed, 10 Jul 2019 at 13:24, Geneviève Bastien <gbastien+lttng@xxxxxxxxxxxx> wrote:
Hi,

We are trying to automatically generate the javadoc for our projects
(TraceCompass and TraceCompass Incubator). Locally, I can run the
following maven command to generate the javadoc and it works fine:

mvn javadoc:aggregate


On Eclipse jenkins though, there are build errors at the very start of
this maven task. See the following task for example [1] with a console
output here [2]. The log file does not help me much, it just shows a
NullPointerException. Is there anything missing? Should it be possible
to generate javadoc on jenkins? I also tried a similar job in
ci-staging, with no difference.

[1]
https://hudson.eclipse.org/tracecompass/job/tracecompass-incubator-javadoc2/

[2]
https://hudson.eclipse.org/tracecompass/job/tracecompass-incubator-javadoc2/1/console


Thanks,

Geneviève

_______________________________________________
cbi-dev mailing list
cbi-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/cbi-dev

_______________________________________________
cbi-dev mailing list
cbi-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/cbi-dev
_______________________________________________
cbi-dev mailing list
cbi-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/cbi-dev

_______________________________________________
cbi-dev mailing list
cbi-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/cbi-dev
_______________________________________________
cbi-dev mailing list
cbi-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/cbi-dev

Back to the top