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

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

Repository: incubator-systemml
Updated Branches:
  refs/heads/master f534dc466 -> 52e95f66e


[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/52e95f66
Tree: http://git-wip-us.apache.org/repos/asf/incubator-systemml/tree/52e95f66
Diff: http://git-wip-us.apache.org/repos/asf/incubator-systemml/diff/52e95f66

Branch: refs/heads/master
Commit: 52e95f66e132997ce57c12586c166d9a81c00f4c
Parents: f534dc4
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/52e95f66/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 8dd0bf5..b4144ee 100644
--- a/pom.xml
+++ b/pom.xml
@@ -505,6 +505,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>
@@ -638,8 +649,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>