[
https://issues.apache.org/jira/browse/HBASE-12024?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14144855#comment-14144855
]
Anoop Sam John commented on HBASE-12024:
----------------------------------------
These are the latest javadocs from build
{noformat}
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-common/src/main/java/org/apache/hadoop/hbase/security/User.java:175:
warning - @return tag has no arguments.
[WARNING] Javadoc Warnings
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ConnectionFactory.java:56:
warning - End Delimiter } missing for possible See Tag in comment string: "A
non-instantiable class that manages creation of {@link Connection}s.
[WARNING] Managing the lifecycle of the {@link Connection}s to the cluster is
the responsibility of
[WARNING] the caller.
[WARNING] From this {@link Connection} {@link Table} implementations are
retrieved
[WARNING] with {@link Connection#getTable(TableName)}. Example:
[WARNING] <pre>
[WARNING] {@code
[WARNING] Connection connection = ConnectionFactory.createConnection(config);
[WARNING] Table table = connection.getTable(TableName.valueOf("table1"));
[WARNING] try {
[WARNING] // Use the table as needed, for a single operation and a single thread
[WARNING] } finally {
[WARNING] table.close();
[WARNING] connection.close();
[WARNING] }
[WARNING] </pre>
[WARNING]
[WARNING] Similarly, {@link Connection} also returns {@link RegionLocator}
implementations.
[WARNING] This class replaces {@link HConnectionManager}, which is now
deprecated."
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-client/src/main/java/org/apache/hadoop/hbase/client/HConnectionManager.java:144:
warning - End Delimiter } missing for possible See Tag in comment string:
"Create a new HConnection instance using the passed <code>conf</code> instance.
[WARNING] <p>Note: This bypasses the usual HConnection life cycle management
done by
[WARNING] {@link #getConnection(Configuration)}. The caller is responsible for
[WARNING] calling {@link HConnection#close()} on the returned connection
instance.
[WARNING] This is the recommended way to create HConnections.
[WARNING] {@code
[WARNING] HConnection connection = HConnectionManager.createConnection(conf);
[WARNING] HTableInterface table = connection.getTable("mytable");
[WARNING] try {
[WARNING] table.get(...);
[WARNING] ...
[WARNING] } finally {
[WARNING] table.close();
[WARNING] connection.close();
[WARNING] }"
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-client/src/main/java/org/apache/hadoop/hbase/client/UnmodifyableHTableDescriptor.java:67:
warning - @return tag has no arguments.
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-client/src/main/java/org/apache/hadoop/hbase/client/UnmodifyableHTableDescriptor.java:86:
warning - @return tag has no arguments.
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-client/src/main/java/org/apache/hadoop/hbase/client/UnmodifyableHTableDescriptor.java:95:
warning - @return tag has no arguments.
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-client/src/main/java/org/apache/hadoop/hbase/client/UnmodifyableHTableDescriptor.java:104:
warning - @return tag has no arguments.
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-client/src/main/java/org/apache/hadoop/hbase/client/UnmodifyableHTableDescriptor.java:113:
warning - @return tag has no arguments.
[WARNING]
/home/jenkins/jenkins-slave/workspace/PreCommit-HBASE-Build/hbase-client/src/main/java/org/apache/hadoop/hbase/client/UnmodifyableHTableDescriptor.java:122:
warning - @return tag has
{noformat}
> Fix javadoc warning
> -------------------
>
> Key: HBASE-12024
> URL: https://issues.apache.org/jira/browse/HBASE-12024
> Project: HBase
> Issue Type: Bug
> Components: documentation
> Affects Versions: 2.0.0
> Reporter: Matteo Bertozzi
> Priority: Trivial
> Fix For: 2.0.0
>
> Attachments: HBASE-12024-v0.patch
>
>
> There are a couple of javadoc warning
> {noformat}
> [WARNING]
> /home/th30z/asf/hbase/hbase-common/src/main/java/org/apache/hadoop/hbase/security/User.java:175:
> warning - @return tag has no arguments.
> [WARNING] Javadoc Warnings
> [WARNING]
> /home/th30z/asf/hbase/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ConnectionFactory.java:56:
> warning - End Delimiter } missing for possible See Tag in comment string: "A
> non-instantiable class that manages creation of {@link Connection}s.
> [WARNING] Managing the lifecycle of the {@link Connection}s to the cluster is
> the responsibility of
> [WARNING] the caller.
> [WARNING] From this {@link Connection} {@link Table} implementations are
> retrieved
> [WARNING] with {@link Connection#getTable(TableName)}. Example:
> [WARNING] <pre>
> [WARNING] {@code
> [WARNING] Connection connection = ConnectionFactory.createConnection(config);
> [WARNING] Table table = connection.getTable(TableName.valueOf("table1"));
> [WARNING] try {
> [WARNING] // Use the table as needed, for a single operation and a single
> thread
> [WARNING] } finally {
> [WARNING] table.close();
> [WARNING] connection.close();
> [WARNING] }
> [WARNING] </pre>
> [WARNING]
> [WARNING] Similarly, {@link Connection} also returns {@link RegionLocator}
> implementations.
> [WARNING] This class replaces {@link HConnectionManager}, which is now
> deprecated."
> [WARNING]
> /home/th30z/asf/hbase/hbase-client/src/main/java/org/apache/hadoop/hbase/client/HConnectionManager.java:144:
> warning - End Delimiter } missing for possible See Tag in comment string:
> "Create a new HConnection instance using the passed <code>conf</code>
> instance.
> [WARNING] <p>Note: This bypasses the usual HConnection life cycle management
> done by
> [WARNING] {@link #getConnection(Configuration)}. The caller is responsible for
> [WARNING] calling {@link HConnection#close()} on the returned connection
> instance.
> [WARNING] This is the recommended way to create HConnections.
> [WARNING] {@code
> [WARNING] HConnection connection = HConnectionManager.createConnection(conf);
> [WARNING] HTableInterface table = connection.getTable("mytable");
> [WARNING] try {
> [WARNING] table.get(...);
> [WARNING] ...
> [WARNING] } finally {
> [WARNING] table.close();
> [WARNING] connection.close();
> [WARNING] }"
> {noformat}
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
