You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@systemml.apache.org by du...@apache.org on 2016/01/26 02:13:19 UTC

[55/55] incubator-systemml git commit: [SYSTEMML-484] Create javadoc jar during build

[SYSTEMML-484] Create javadoc jar during build

Exclude selected packages from javadocs.
Ignore doclint warnings for javadocs on Java 8 until warnings fixed.

Closes #52.


Project: http://git-wip-us.apache.org/repos/asf/incubator-systemml/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-systemml/commit/ffcdf6ea
Tree: http://git-wip-us.apache.org/repos/asf/incubator-systemml/tree/ffcdf6ea
Diff: http://git-wip-us.apache.org/repos/asf/incubator-systemml/diff/ffcdf6ea

Branch: refs/heads/branch-0.9
Commit: ffcdf6ea37f0bc193397c78837eb3703b4258b4a
Parents: d766fbf
Author: Deron Eriksson <de...@us.ibm.com>
Authored: Mon Jan 25 16:38:15 2016 -0800
Committer: Deron Eriksson <de...@us.ibm.com>
Committed: Mon Jan 25 16:38:15 2016 -0800

----------------------------------------------------------------------
 pom.xml | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-systemml/blob/ffcdf6ea/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index ae654dd..4b7061c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -504,6 +504,17 @@
 		</profile>
 
 		<profile>
+			<!-- Need to ignore doclint warnings for javadocs generated on Java 8 until warnings are fixed -->
+			<id>ignore-doclint-warnings-for-javadocs-on-java-8</id>
+			<activation>
+				<jdk>[1.8,)</jdk>
+			</activation>
+			<properties>
+				<javadoc.opts>-Xdoclint:none</javadoc.opts>
+			</properties>
+		</profile>
+
+		<profile>
 			<!-- Profile to create binary distributions.
 				Execute with `mvn clean package -P distribution` -->
 			<id>distribution</id>
@@ -637,8 +648,24 @@
 						<artifactId>maven-javadoc-plugin</artifactId>
 						<version>2.10.3</version>
 						<configuration>
-							<maxmemory>1024m</maxmemory>
+							<!-- Need to include the following packages, so exclude others:
+								org.apache.sysml.api
+								org.apache.sysml.runtime.instructions.spark.utils (for RDDConverterUtils, etc)
+								org.apache.sysml.runtime.matrix (for MatrixCharacteristics, etc)
+								org.apache.sysml.runtime.matrix.data (for MatrixIndexes, MatrixBlock, etc)
+								org.apache.sysml.udf
+							-->
+							<excludePackageNames>org.apache.sysml.conf:org.apache.sysml.debug:org.apache.sysml.hops:org.apache.sysml.lops:org.apache.sysml.parser:org.apache.sysml.runtime.controlprogram:org.apache.sysml.runtime.functionobjects:org.apache.sysml.runtime.instructions.cp:org.apache.sysml.runtime.instructions.cpfile:org.apache.sysml.runtime.instructions.mr:org.apache.sysml.runtime.instructions.spark.data:org.apache.sysml.runtime.instructions.spark.functions:org.apache.sysml.runtime.io:org.apache.sysml.runtime.matrix.data.hadoopfix:org.apache.sysml.runtime.matrix.mapred:org.apache.sysml.runtime.matrix.operators:org.apache.sysml.runtime.matrix.sort:org.apache.sysml.runtime.transform:org.apache.sysml.runtime.util:org.apache.sysml.utils:org.apache.sysml.yarn</excludePackageNames>
+							<additionalparam>${javadoc.opts}</additionalparam>
 						</configuration>
+						<executions>
+							<execution>
+								<id>attach-javadocs</id>
+								<goals>
+									<goal>jar</goal>
+								</goals>
+							</execution>
+						</executions>
 					</plugin>
 				</plugins>
 			</build>