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

Chanaka commented on GORA-623:
------------------------------

[~renato2099] I think with your comment we can agree that generated files 
should be excluded from javadocs. It made me investigate how generated files 
have been handled so far and realized that there are three ways we have used.
 # As mentioned previously, define generated packages as excludePackageNames in 
javadoc plugin of parent pom (Eg: gora-tutorial and goraci)
 # Keep generated files in a separate directory (eg: src/example) and using 
build-helper-maven-plugin:add-test-source to add them as test sources. (see 
gora-core)
 # Keep generated files in a separate directory (eg: src/example) and using 
build-helper-maven-plugin:add-source to add them as sources. (see 
gora-cassandra and gora-dynamodb)

Using the first 2 ways, we can avoid the generation of javadocs. 

I suggest the second way is better as we have used generated classes only for 
testing so far as well as we don't need to alter the parent pom. Any thoughts?

 

> Javadoc build fails with Gora master branch
> -------------------------------------------
>
>                 Key: GORA-623
>                 URL: https://issues.apache.org/jira/browse/GORA-623
>             Project: Apache Gora
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.9
>         Environment: commit ID: 9b1d297fc11f90850d0360c93b3bd65486a20834
>            Reporter: Lewis John McGibbney
>            Priority: Critical
>             Fix For: 1.0
>
>
> We should really add a _*mvn javadoc:aggregate*_ command to our master branch 
> build.
> {code}
> [INFO] 
> ------------------------------------------------------------------------
> [ERROR] Failed to execute goal 
> org.apache.maven.plugins:maven-javadoc-plugin:2.8.1:aggregate (default-cli) 
> on project gora: An error has occurred in JavaDocs report generation:
> [ERROR] Exit code: 1 - 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStore.java:144:
>  warning: no @throws for org.apache.gora.util.GoraException
> [ERROR]   boolean exists(K key) throws GoraException;
> [ERROR]           ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/Query.java:50:
>  warning: no @throws for org.apache.gora.util.GoraException
> [ERROR]   Result<K, T> execute() throws GoraException;
> [ERROR]                ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/persistency/impl/BeanFactoryImpl.java:62:
>  warning: no @throws for org.apache.gora.util.GoraException
> [ERROR]   public BeanFactoryImpl(Class<K> keyClass, Class<T> persistentClass) 
> throws GoraException {
> [ERROR]          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/persistency/impl/BeanFactoryImpl.java:82:
>  warning: no description for @param
> [ERROR]    * @param keyClass
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/persistency/impl/BeanFactoryImpl.java:85:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/persistency/Persistent.java:131:
>  warning: no description for @throws
> [ERROR]    * @throws CloneNotSupportedException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/persistency/ws/impl/PersistentWSBase.java:74:
>  warning: no @param for index
> [ERROR]   public String getField(int index) {
> [ERROR]                 ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/persistency/ws/impl/PersistentWSBase.java:82:
>  warning: no @param for field
> [ERROR]   public int getFieldIndex(String field) {
> [ERROR]              ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/PartitionWSQueryImpl.java:84:
>  warning: no description for @return
> [ERROR]    * @return
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/QueryWSBase.java:262:
>  warning: no description for @return
> [ERROR]    * @return
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/QueryWSBase.java:270:
>  warning: no description for @param
> [ERROR]    * @param auth
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/PartitionWSQueryImpl.java:64:
>  warning: no @param for baseQuery
> [ERROR]   public PartitionWSQueryImpl(Query<K, T> baseQuery, K startKey, K 
> endKey,
> [ERROR]          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/PartitionWSQueryImpl.java:64:
>  warning: no @param for startKey
> [ERROR]   public PartitionWSQueryImpl(Query<K, T> baseQuery, K startKey, K 
> endKey,
> [ERROR]          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/PartitionWSQueryImpl.java:64:
>  warning: no @param for endKey
> [ERROR]   public PartitionWSQueryImpl(Query<K, T> baseQuery, K startKey, K 
> endKey,
> [ERROR]          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/PartitionWSQueryImpl.java:64:
>  warning: no @param for locations
> [ERROR]   public PartitionWSQueryImpl(Query<K, T> baseQuery, K startKey, K 
> endKey,
> [ERROR]          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/PartitionWSQueryImpl.java:57:
>  warning: no @param for baseQuery
> [ERROR]   public PartitionWSQueryImpl(Query<K, T> baseQuery, String... 
> locations) {
> [ERROR]          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/PartitionWSQueryImpl.java:57:
>  warning: no @param for locations
> [ERROR]   public PartitionWSQueryImpl(Query<K, T> baseQuery, String... 
> locations) {
> [ERROR]          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/QueryWSBase.java:80:
>  warning: no description for @param
> [ERROR]    * @param dataStore
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/ResultWSBase.java:122:
>  warning: no @return
> [ERROR]   protected boolean isLimitReached() {
> [ERROR]                     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/ResultWSBase.java:168:
>  warning: no @return
> [ERROR]   protected abstract boolean nextInner() throws Exception;
> [ERROR]                              ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/ResultWSBase.java:168:
>  warning: no @throws for java.lang.Exception
> [ERROR]   protected abstract boolean nextInner() throws Exception;
> [ERROR]                              ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/ResultWSBase.java:173:
>  warning: no description for @return
> [ERROR]    * @return
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/ResultWSBase.java:174:
>  warning: no description for @throws
> [ERROR]    * @throws Exception
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/ResultWSBase.java:175:
>  warning: no description for @throws
> [ERROR]    * @throws IOException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/ResultWSBase.java:62:
>  warning: no description for @param
> [ERROR]    * @param dataStore
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/query/ws/impl/ResultWSBase.java:63:
>  warning: no description for @param
> [ERROR]    * @param query
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/mapreduce/GoraRecordWriter.java:84:
>  warning: no description for @param
> [ERROR]    * @param key
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/mapreduce/GoraRecordWriter.java:85:
>  warning: no description for @throws
> [ERROR]    * @throws IOException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/spark/GoraSparkEngine.java:106:
>  warning: no @param for <K>
> [ERROR]     public <K, V extends Persistent> Configuration 
> generateOutputConf(DataStore<K, V> dataStore)
> [ERROR]                                                    ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/spark/GoraSparkEngine.java:106:
>  warning: no @param for <V>
> [ERROR]     public <K, V extends Persistent> Configuration 
> generateOutputConf(DataStore<K, V> dataStore)
> [ERROR]                                                    ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/spark/GoraSparkEngine.java:131:
>  warning: no @param for <K>
> [ERROR]     public <K, V extends Persistent> Configuration 
> generateOutputConf(Job job,
> [ERROR]                                                    ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/spark/GoraSparkEngine.java:131:
>  warning: no @param for <V>
> [ERROR]     public <K, V extends Persistent> Configuration 
> generateOutputConf(Job job,
> [ERROR]                                                    ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/spark/GoraSparkEngine.java:147:
>  warning: no @param for <K>
> [ERROR]     public <K, V extends Persistent> Configuration 
> generateOutputConf(Job job,
> [ERROR]                                                    ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/spark/GoraSparkEngine.java:147:
>  warning: no @param for <V>
> [ERROR]     public <K, V extends Persistent> Configuration 
> generateOutputConf(Job job,
> [ERROR]                                                    ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/impl/DataStoreMetadataAnalyzer.java:50:
>  warning: no @throws for org.apache.gora.util.GoraException
> [ERROR]   public abstract void initialize() throws GoraException ;
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/impl/DataStoreMetadataAnalyzer.java:66:
>  warning: no @throws for org.apache.gora.util.GoraException
> [ERROR]   public abstract List<String> getTablesNames() throws GoraException;
> [ERROR]                                ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/impl/DataStoreMetadataAnalyzer.java:74:
>  warning: no @param for tableName
> [ERROR]   public abstract Object getTableInfo(String tableName) throws 
> GoraException ;
> [ERROR]                          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/impl/DataStoreMetadataAnalyzer.java:74:
>  warning: no @throws for org.apache.gora.util.GoraException
> [ERROR]   public abstract Object getTableInfo(String tableName) throws 
> GoraException ;
> [ERROR]                          ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:258:
>  warning: no @param for dataStoreClass
> [ERROR]   public static <K, T extends Persistent> DataStore<K, T> 
> getDataStore(
> [ERROR]                                                           ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:412:
>  warning: no @param for properties
> [ERROR]   public static String findProperty(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:412:
>  warning: no @param for store
> [ERROR]   public static String findProperty(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:412:
>  warning: no @param for baseKey
> [ERROR]   public static String findProperty(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:412:
>  warning: no @param for defaultValue
> [ERROR]   public static String findProperty(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:453:
>  warning: no @param for properties
> [ERROR]   public static String findPropertyOrDie(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:453:
>  warning: no @param for store
> [ERROR]   public static String findPropertyOrDie(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:453:
>  warning: no @param for baseKey
> [ERROR]   public static String findPropertyOrDie(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:453:
>  warning: no @throws for java.io.IOException
> [ERROR]   public static String findPropertyOrDie(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:476:
>  warning: no @param for properties
> [ERROR]   public static String getInputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:476:
>  warning: no @param for store
> [ERROR]   public static String getInputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:476:
>  warning: no @return
> [ERROR]   public static String getInputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:483:
>  warning: no @param for properties
> [ERROR]   public static String getOutputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:483:
>  warning: no @param for store
> [ERROR]   public static String getOutputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:483:
>  warning: no @return
> [ERROR]   public static String getOutputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/DataStoreFactory.java:573:
>  warning: no @return
> [ERROR]   public static String getDefaultSchemaName(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSBackedDataStoreBase.java:67:
>  warning: no @param for query
> [ERROR]   protected abstract Result<K,T> executeQuery(Query<K,T> query)
> [ERROR]                                  ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSBackedDataStoreBase.java:67:
>  warning: no @return
> [ERROR]   protected abstract Result<K,T> executeQuery(Query<K,T> query)
> [ERROR]                                  ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSBackedDataStoreBase.java:67:
>  warning: no @throws for java.io.IOException
> [ERROR]   protected abstract Result<K,T> executeQuery(Query<K,T> query)
> [ERROR]                                  ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreBase.java:127:
>  warning: no @param for auth
> [ERROR]   public void setConf(Object auth) {
> [ERROR]               ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreBase.java:134:
>  warning: no description for @throws
> [ERROR]    * @throws Exception
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreBase.java:142:
>  warning: no description for @throws
> [ERROR]    * @throws Exception
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreBase.java:173:
>  warning: no @return
> [ERROR]   protected String getSchemaName(String mappingSchemaName, Class<?> 
> persistentClass) {
> [ERROR]                    ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:105:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:108:
>  warning: no @param for <D>
> [ERROR]   D createDataStore(Class<D> dataStoreClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:108:
>  warning: no @param for <K>
> [ERROR]   D createDataStore(Class<D> dataStoreClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:108:
>  warning: no @param for <T>
> [ERROR]   D createDataStore(Class<D> dataStoreClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:122:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:125:
>  warning: no @param for <D>
> [ERROR]   D createDataStore(Class<D> dataStoreClass , Class<K> keyClass,
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:125:
>  warning: no @param for <K>
> [ERROR]   D createDataStore(Class<D> dataStoreClass , Class<K> keyClass,
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:125:
>  warning: no @param for <T>
> [ERROR]   D createDataStore(Class<D> dataStoreClass , Class<K> keyClass,
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:140:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:144:
>  warning: no @param for <D>
> [ERROR]   D createDataStore(Class<D> dataStoreClass, Class<K> keyClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:144:
>  warning: no @param for <K>
> [ERROR]   D createDataStore(Class<D> dataStoreClass, Class<K> keyClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:144:
>  warning: no @param for <T>
> [ERROR]   D createDataStore(Class<D> dataStoreClass, Class<K> keyClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:173:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:176:
>  warning: no @param for <D>
> [ERROR]   D createDataStore(Class<D> dataStoreClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:176:
>  warning: no @param for <K>
> [ERROR]   D createDataStore(Class<D> dataStoreClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:176:
>  warning: no @param for <T>
> [ERROR]   D createDataStore(Class<D> dataStoreClass
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:190:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:193:
>  warning: no @param for <D>
> [ERROR]   D getDataStore( Class<D> dataStoreClass, Class<K> keyClass,
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:193:
>  warning: no @param for <K>
> [ERROR]   D getDataStore( Class<D> dataStoreClass, Class<K> keyClass,
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:193:
>  warning: no @param for <T>
> [ERROR]   D getDataStore( Class<D> dataStoreClass, Class<K> keyClass,
> [ERROR]     ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:207:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:210:
>  warning: no @param for <K>
> [ERROR]   public static <K, T extends Persistent> DataStore<K, T> 
> getDataStore(
> [ERROR]                                                           ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:210:
>  warning: no @param for <T>
> [ERROR]   public static <K, T extends Persistent> DataStore<K, T> 
> getDataStore(
> [ERROR]                                                           ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:232:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:235:
>  warning: no @param for <K>
> [ERROR]   public static <K, T extends Persistent> DataStore<K, T> 
> getDataStore(
> [ERROR]                                                           ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:235:
>  warning: no @param for <T>
> [ERROR]   public static <K, T extends Persistent> DataStore<K, T> 
> getDataStore(
> [ERROR]                                                           ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:259:
>  warning: no description for @throws
> [ERROR]    * @throws GoraException
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:262:
>  warning: no @param for <K>
> [ERROR]   public static <K, T extends Persistent> DataStore<K, T> 
> getDataStore(
> [ERROR]                                                           ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:262:
>  warning: no @param for <T>
> [ERROR]   public static <K, T extends Persistent> DataStore<K, T> 
> getDataStore(
> [ERROR]                                                           ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:331:
>  warning: no @throws for java.io.IOException
> [ERROR]   public static String findPropertyOrDie(Properties properties
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:376:
>  warning: no @param for properties
> [ERROR]   public static String getInputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:376:
>  warning: no @param for store
> [ERROR]   public static String getInputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:376:
>  warning: no @return
> [ERROR]   public static String getInputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:383:
>  warning: no @param for properties
> [ERROR]   public static String getOutputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:383:
>  warning: no @param for store
> [ERROR]   public static String getOutputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:383:
>  warning: no @return
> [ERROR]   public static String getOutputPath(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:394:
>  warning: no description for @return
> [ERROR]    * @return
> [ERROR]      ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:440:
>  warning: no @param for properties
> [ERROR]   public static String getDefaultSchemaName(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-core/src/main/java/org/apache/gora/store/ws/impl/WSDataStoreFactory.java:440:
>  warning: no @param for store
> [ERROR]   public static String getDefaultSchemaName(Properties properties, 
> DataStore<?,?> store) {
> [ERROR]                        ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraKey.java:118:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraKey.java:142:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraKey.java:316:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraKey.java:339:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:173:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:197:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:221:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:245:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:269:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:293:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:317:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:341:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:365:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:389:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:413:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:437:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:461:
>  error: @param name not found
> [ERROR]    * @param value the value to set.
> [ERROR]             ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:976:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:999:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1022:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1045:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1068:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1091:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1114:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1137:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1160:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1183:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1206:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1229:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR] 
> /Users/lmcgibbn/Downloads/gora/gora-cassandra/src/examples/java/org/apache/gora/cassandra/example/generated/AvroSerialization/CassandraRecord.java:1252:
>  error: @param name not found
> [ERROR]          * @param value the value to set.
> [ERROR]                   ^
> [ERROR]
> [ERROR] Command line was: 
> /Library/Java/JavaVirtualMachines/jdk1.8.0_221.jdk/Contents/Home/bin/javadoc 
> @options @packages
> [ERROR]
> [ERROR] Refer to the generated Javadoc files in 
> '/Users/lmcgibbn/Downloads/gora/target/site/apidocs' dir.
> [ERROR]
> [ERROR] -> [Help 1]
> [ERROR]
> [ERROR] To see the full stack trace of the errors, re-run Maven with the -e 
> switch.
> [ERROR] Re-run Maven using the -X switch to enable full debug logging.
> [ERROR]
> [ERROR] For more information about the errors and possible solutions, please 
> read the following articles:
> [ERROR] [Help 1] 
> http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
> {code}



--
This message was sent by Atlassian Jira
(v8.3.2#803003)

Reply via email to