gora-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Lewis John McGibbney (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (GORA-166) Substantiate Javadoc for Gora
Date Thu, 24 Jan 2013 04:19:13 GMT

    [ https://issues.apache.org/jira/browse/GORA-166?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13561413#comment-13561413

Lewis John McGibbney commented on GORA-166:

We can get the Javadoc looking much better by 
* specifying version 2.8 of the Maven Javadoc plugin in parent pom.xml
* {code}
    <!-- Apple's JVM sometimes requires more memory  -->
* adding the following to the '''release''' profile in parent pom
* Add a package.info similar to this one [0] at the base of every package we wish to annotate.

This will help us in rapidly improving the Javadoc for future releases.

I've not put this into a patch for the time being as I am not able to check out Gora source
(I'm on a new box)... I will need to wait until later.

[0] http://svn.apache.org/repos/asf/any23/trunk/api/src/main/java/org/apache/any23/configuration/package-info.java
> Substantiate Javadoc for Gora
> -----------------------------
>                 Key: GORA-166
>                 URL: https://issues.apache.org/jira/browse/GORA-166
>             Project: Apache Gora
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.2.1
>            Reporter: Lewis John McGibbney
>             Fix For: 0.4
> Having a look at the recently published apache-gora-0.2.1 Javadoc's [0] it becomes quite
clear that Javadoc's were something which never really caught on in Gora ;)
> This is a fairly substantial issue so incremental patches is probably the best way to
> [0] http://gora.apache.org/docs/current/apidocs-0.2.1/index.html

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

View raw message