tez-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jeag...@apache.org
Subject tez git commit: TEZ-1907. Fix javadoc warnings in tez codebase (jeagles)
Date Tue, 06 Jan 2015 19:30:13 GMT
Repository: tez
Updated Branches:
  refs/heads/branch-0.6 a5db290bb -> 72ac2968c


TEZ-1907. Fix javadoc warnings in tez codebase (jeagles)


Project: http://git-wip-us.apache.org/repos/asf/tez/repo
Commit: http://git-wip-us.apache.org/repos/asf/tez/commit/72ac2968
Tree: http://git-wip-us.apache.org/repos/asf/tez/tree/72ac2968
Diff: http://git-wip-us.apache.org/repos/asf/tez/diff/72ac2968

Branch: refs/heads/branch-0.6
Commit: 72ac2968c5e14cfec45d869c3533f437424232a9
Parents: a5db290
Author: Jonathan Eagles <jeagles@gmail.com>
Authored: Tue Jan 6 13:29:59 2015 -0600
Committer: Jonathan Eagles <jeagles@gmail.com>
Committed: Tue Jan 6 13:29:59 2015 -0600

----------------------------------------------------------------------
 CHANGES.txt                                                  | 1 +
 .../main/java/org/apache/tez/dag/api/TaskLocationHint.java   | 2 +-
 .../main/java/org/apache/tez/common/TezUtilsInternal.java    | 2 +-
 .../org/apache/tez/mapreduce/examples/TezExampleBase.java    | 8 ++++----
 4 files changed, 7 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/tez/blob/72ac2968/CHANGES.txt
----------------------------------------------------------------------
diff --git a/CHANGES.txt b/CHANGES.txt
index a5fa0b2..0f47cb9 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -6,6 +6,7 @@ Release 0.6.0: Unreleased
 INCOMPATIBLE CHANGES
 
 ALL CHANGES:
+  TEZ-1907. Fix javadoc warnings in tez codebase
   TEZ-1891. Incorrect number of Javadoc warnings reported
   TEZ-1762. Lots of unit tests do not have timeout parameter set.
   TEZ-1886. remove deprecation warnings for tez-ui on the console.

http://git-wip-us.apache.org/repos/asf/tez/blob/72ac2968/tez-api/src/main/java/org/apache/tez/dag/api/TaskLocationHint.java
----------------------------------------------------------------------
diff --git a/tez-api/src/main/java/org/apache/tez/dag/api/TaskLocationHint.java b/tez-api/src/main/java/org/apache/tez/dag/api/TaskLocationHint.java
index 926b8fd..fef99f3 100644
--- a/tez-api/src/main/java/org/apache/tez/dag/api/TaskLocationHint.java
+++ b/tez-api/src/main/java/org/apache/tez/dag/api/TaskLocationHint.java
@@ -93,7 +93,7 @@ public class TaskLocationHint {
    * and not in while creating the dag using the DAG API.
    * @param vertexName
    * @param taskIndex
-   * @return
+   * @return the task location hint for the vertex name and task index
    */
   public static TaskLocationHint createTaskLocationHint(String vertexName, int taskIndex)
{
     return new TaskLocationHint(vertexName, taskIndex);

http://git-wip-us.apache.org/repos/asf/tez/blob/72ac2968/tez-common/src/main/java/org/apache/tez/common/TezUtilsInternal.java
----------------------------------------------------------------------
diff --git a/tez-common/src/main/java/org/apache/tez/common/TezUtilsInternal.java b/tez-common/src/main/java/org/apache/tez/common/TezUtilsInternal.java
index 2ca153c..9761b15 100644
--- a/tez-common/src/main/java/org/apache/tez/common/TezUtilsInternal.java
+++ b/tez-common/src/main/java/org/apache/tez/common/TezUtilsInternal.java
@@ -232,7 +232,7 @@ public class TezUtilsInternal {
    * Convert DAGPlan to text. Skip sensitive informations like credentials.
    *
    * @param dagPlan
-   * @return
+   * @return a string representation of the dag plan with sensitive information removed
    */
   public static String convertDagPlanToString(DAGProtos.DAGPlan dagPlan) throws IOException
{
     StringBuilder sb = new StringBuilder();

http://git-wip-us.apache.org/repos/asf/tez/blob/72ac2968/tez-tests/src/main/java/org/apache/tez/mapreduce/examples/TezExampleBase.java
----------------------------------------------------------------------
diff --git a/tez-tests/src/main/java/org/apache/tez/mapreduce/examples/TezExampleBase.java
b/tez-tests/src/main/java/org/apache/tez/mapreduce/examples/TezExampleBase.java
index 84a450c..912de6f 100644
--- a/tez-tests/src/main/java/org/apache/tez/mapreduce/examples/TezExampleBase.java
+++ b/tez-tests/src/main/java/org/apache/tez/mapreduce/examples/TezExampleBase.java
@@ -57,7 +57,7 @@ public abstract class TezExampleBase extends Configured implements Tool
{
    * @param tezClient an existing running {@link org.apache.tez.client.TezClient} instance
if one
    *                  exists. If no TezClient is specified (null), one will be created based
on the
    *                  provided configuration
-   * @return
+   * @return Zero indicates success, non-zero indicates failure
    * @throws IOException
    * @throws TezException
    */
@@ -73,7 +73,7 @@ public abstract class TezExampleBase extends Configured implements Tool
{
    * @param dag           the dag to execute
    * @param printCounters whether to print counters or not
    * @param logger        the logger to use while printing diagnostics
-   * @return
+   * @return Zero indicates success, non-zero indicates failure
    * @throws TezException
    * @throws InterruptedException
    * @throws IOException
@@ -147,7 +147,7 @@ public abstract class TezExampleBase extends Configured implements Tool
{
    * Validate the arguments
    *
    * @param otherArgs arguments, if any
-   * @return
+   * @return Zero indicates success, non-zero indicates failure
    */
   protected abstract int validateArgs(String[] otherArgs);
 
@@ -159,7 +159,7 @@ public abstract class TezExampleBase extends Configured implements Tool
{
    * @param tezClient the tez client instance to use to run the DAG if any custom monitoring
is
    *                  required. Otherwise the utility method {@link #runDag(org.apache.tez.dag.api.DAG,
    *                  boolean, org.apache.commons.logging.Log)} should be used
-   * @return
+   * @return Zero indicates success, non-zero indicates failure
    * @throws IOException
    * @throws TezException
    */


Mime
View raw message