accumulo-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Christopher Tubbs (JIRA)" <j...@apache.org>
Subject [jira] [Resolved] (ACCUMULO-1487) Package javadocs for monitor better, or not at all
Date Fri, 28 Mar 2014 00:55:15 GMT

     [ https://issues.apache.org/jira/browse/ACCUMULO-1487?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Christopher Tubbs resolved ACCUMULO-1487.
-----------------------------------------

    Resolution: Fixed

Removed javadocs from packaging with the monitor. Javadocs can be viewed on the project website,
a mirror, or from the javadoc jars.

> Package javadocs for monitor better, or not at all
> --------------------------------------------------
>
>                 Key: ACCUMULO-1487
>                 URL: https://issues.apache.org/jira/browse/ACCUMULO-1487
>             Project: Accumulo
>          Issue Type: Sub-task
>          Components: docs
>            Reporter: Christopher Tubbs
>            Assignee: Christopher Tubbs
>              Labels: Documentation
>             Fix For: 1.6.0
>
>
> Packaging javadocs are problematic for the monitor page because we need to do something
like:
> {code}mvn clean compile javadoc:aggregate package{code}
> so the classes are compiled prior to building the javadocs (for some reason, this is
a requirement), and the javadocs are available to be packaged when the monitor is packaged.
However, this essentially duplicates the build lifecycle between the initialize and compile
phase.
> Options:
> # Use maven-invoker-plugin to execute the "mvn compile javadoc:aggregate" separately,
with minimal plugins configured (not sure the effect this will have on maven-release-plugin
which also executes maven-invoker-plugin).
> # Make monitor depend on javadoc artifacts from other modules, and serve them (repackaging,
if necessary). This might require javadoc artifacts to be built whenever the monitor is built,
and not just during a release.
> # My preferred option: don't package javadocs with the monitor. Instead, link to the
Accumulo website (with a configurable base address, to support environments where javadocs
are mirrored, in case they can't directly access the Apache website).



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Mime
View raw message