From acf144717bd85d2486cc33fbb0e3622b06c66717 Mon Sep 17 00:00:00 2001
From: Duo Zhang <zhangduo@apache.org>
Date: Tue, 19 Jul 2022 09:59:22 +0800
Subject: [PATCH] HBASE-27220 Apply the spotless format change in HBASE-27208
 to our code base

Signed-off-by: Andrew Purtell <apurtell@apache.org>
---
 .../hbase/io/asyncfs/AsyncFSOutput.java       |   4 +-
 .../hbase/util/RecoverLeaseFSUtils.java       |   4 +-
 .../balancer/FavoredStochasticBalancer.java   |   4 +-
 .../hadoop/hbase/CatalogFamilyFormat.java     |   4 +-
 .../hadoop/hbase/ClientMetaTableAccessor.java |   4 +-
 .../org/apache/hadoop/hbase/ClusterId.java    |   8 +-
 .../apache/hadoop/hbase/ClusterMetrics.java   |  32 ++---
 .../hadoop/hbase/CoprocessorEnvironment.java  |  14 +--
 .../hadoop/hbase/HBaseServerException.java    |   4 +-
 .../apache/hadoop/hbase/RegionMetrics.java    |  92 ++++----------
 .../apache/hadoop/hbase/ServerMetrics.java    |  48 ++------
 .../java/org/apache/hadoop/hbase/Size.java    |   4 +-
 .../org/apache/hadoop/hbase/UserMetrics.java  |  24 +---
 .../org/apache/hadoop/hbase/client/Admin.java |   8 +-
 .../apache/hadoop/hbase/client/Append.java    |   4 +-
 .../hadoop/hbase/client/AsyncAdmin.java       |  24 +---
 .../hadoop/hbase/client/CheckAndMutate.java   |  36 ++----
 .../hbase/client/CheckAndMutateResult.java    |   8 +-
 .../hbase/client/ClientIdGenerator.java       |   4 +-
 .../hbase/client/ColumnFamilyDescriptor.java  |  96 ++++-----------
 .../hadoop/hbase/client/Connection.java       |   8 +-
 .../client/ConnectionRegistryFactory.java     |   4 +-
 .../hbase/client/CoprocessorDescriptor.java   |  14 +--
 .../apache/hadoop/hbase/client/Increment.java |   4 +-
 .../hadoop/hbase/client/MultiResponse.java    |   8 +-
 .../hbase/client/MutableRegionInfo.java       |  20 ++-
 .../apache/hadoop/hbase/client/Mutation.java  |  24 +---
 .../hadoop/hbase/client/NonceGenerator.java   |   4 +-
 .../org/apache/hadoop/hbase/client/Query.java |  12 +-
 .../hadoop/hbase/client/RegionInfo.java       |  66 +++-------
 .../hbase/client/RegionReplicaUtil.java       |   4 +-
 .../hbase/client/RequestController.java       |   8 +-
 .../apache/hadoop/hbase/client/Result.java    |   4 +-
 .../hadoop/hbase/client/ResultScanner.java    |   4 +-
 .../org/apache/hadoop/hbase/client/Row.java   |   4 +-
 .../apache/hadoop/hbase/client/RowAccess.java |   8 +-
 .../hadoop/hbase/client/RowMutations.java     |   4 +-
 .../org/apache/hadoop/hbase/client/Scan.java  |  68 +++-------
 .../hadoop/hbase/client/TableDescriptor.java  |  12 +-
 .../hbase/client/TableDescriptorBuilder.java  |  20 +--
 .../hadoop/hbase/client/TableState.java       |  28 ++---
 .../client/backoff/ClientBackoffPolicy.java   |   4 +-
 .../PreemptiveFastFailException.java          |  20 +--
 .../hbase/filter/BigDecimalComparator.java    |   4 +-
 .../hadoop/hbase/filter/BinaryComparator.java |   4 +-
 .../filter/BinaryComponentComparator.java     |   4 +-
 .../hbase/filter/BinaryPrefixComparator.java  |   4 +-
 .../hadoop/hbase/filter/BitComparator.java    |   8 +-
 .../hbase/filter/ColumnCountGetFilter.java    |   4 +-
 .../hbase/filter/ColumnPaginationFilter.java  |   4 +-
 .../hbase/filter/ColumnPrefixFilter.java      |   4 +-
 .../hbase/filter/ColumnRangeFilter.java       |  28 ++---
 .../hbase/filter/ColumnValueFilter.java       |  16 +--
 .../hadoop/hbase/filter/CompareFilter.java    |   8 +-
 .../hbase/filter/DependentColumnFilter.java   |  16 +--
 .../hadoop/hbase/filter/FamilyFilter.java     |   4 +-
 .../hadoop/hbase/filter/FilterList.java       |   4 +-
 .../hbase/filter/FirstKeyOnlyFilter.java      |   8 +-
 .../hadoop/hbase/filter/FuzzyRowFilter.java   |   4 +-
 .../hbase/filter/InclusiveStopFilter.java     |   4 +-
 .../hadoop/hbase/filter/KeyOnlyFilter.java    |   4 +-
 .../hadoop/hbase/filter/LongComparator.java   |   4 +-
 .../hbase/filter/MultiRowRangeFilter.java     |  12 +-
 .../filter/MultipleColumnPrefixFilter.java    |   4 +-
 .../hadoop/hbase/filter/NullComparator.java   |   4 +-
 .../hadoop/hbase/filter/PageFilter.java       |   4 +-
 .../hadoop/hbase/filter/PrefixFilter.java     |   4 +-
 .../hadoop/hbase/filter/QualifierFilter.java  |   4 +-
 .../hadoop/hbase/filter/RandomRowFilter.java  |   8 +-
 .../hbase/filter/RegexStringComparator.java   |   4 +-
 .../apache/hadoop/hbase/filter/RowFilter.java |   4 +-
 .../SingleColumnValueExcludeFilter.java       |   4 +-
 .../hbase/filter/SingleColumnValueFilter.java |  16 +--
 .../hadoop/hbase/filter/SkipFilter.java       |   4 +-
 .../hbase/filter/SubstringComparator.java     |   4 +-
 .../hadoop/hbase/filter/TimestampsFilter.java |   8 +-
 .../hadoop/hbase/filter/ValueFilter.java      |   4 +-
 .../hadoop/hbase/filter/WhileMatchFilter.java |   4 +-
 .../hadoop/hbase/ipc/HBaseRpcController.java  |  12 +-
 .../hbase/ipc/HBaseRpcControllerImpl.java     |   4 +-
 .../org/apache/hadoop/hbase/ipc/IPCUtil.java  |   8 +-
 .../hbase/ipc/RemoteWithExtrasException.java  |  16 +--
 .../hadoop/hbase/protobuf/ProtobufMagic.java  |   4 +-
 .../hadoop/hbase/quotas/QuotaFilter.java      |  12 +-
 .../hbase/quotas/SpaceQuotaSnapshot.java      |   4 +-
 .../hbase/quotas/SpaceQuotaSnapshotView.java  |   4 +-
 .../hbase/security/access/Permission.java     |   2 +-
 .../security/visibility/CellVisibility.java   |   4 +-
 .../hbase/shaded/protobuf/ProtobufUtil.java   |   8 +-
 .../shaded/protobuf/RequestConverter.java     |   4 +-
 .../snapshot/HBaseSnapshotException.java      |   4 +-
 .../hadoop/hbase/zookeeper/ZNodePaths.java    |  12 +-
 .../apache/hadoop/hbase/ArrayBackedTag.java   |  16 +--
 .../hadoop/hbase/ByteBufferExtendedCell.java  |  40 ++----
 .../java/org/apache/hadoop/hbase/Cell.java    |  36 ++----
 .../apache/hadoop/hbase/CellScannable.java    |   4 +-
 .../org/apache/hadoop/hbase/CellScanner.java  |   4 +-
 .../org/apache/hadoop/hbase/CellUtil.java     |  12 +-
 .../org/apache/hadoop/hbase/ChoreService.java |  20 +--
 .../org/apache/hadoop/hbase/ExtendedCell.java |  12 +-
 .../hadoop/hbase/HBaseConfiguration.java      |   4 +-
 .../hadoop/hbase/HDFSBlocksDistribution.java  |  20 +--
 .../org/apache/hadoop/hbase/KeyValue.java     |  94 ++++----------
 .../apache/hadoop/hbase/PrivateCellUtil.java  |  16 +--
 .../java/org/apache/hadoop/hbase/RawCell.java |   4 +-
 .../hadoop/hbase/RawCellBuilderFactory.java   |   4 +-
 .../apache/hadoop/hbase/ScheduledChore.java   |  24 +---
 .../org/apache/hadoop/hbase/ServerName.java   |   4 +-
 .../org/apache/hadoop/hbase/Stoppable.java    |   4 +-
 .../org/apache/hadoop/hbase/TableName.java    |   8 +-
 .../java/org/apache/hadoop/hbase/Tag.java     |  16 +--
 .../java/org/apache/hadoop/hbase/TagUtil.java |   8 +-
 .../apache/hadoop/hbase/codec/CellCodec.java  |   4 +-
 .../hadoop/hbase/codec/CellCodecWithTags.java |   4 +-
 .../hbase/conf/ConfigurationManager.java      |   8 +-
 .../hbase/filter/ByteArrayComparable.java     |   4 +-
 .../hbase/io/ByteArrayOutputStream.java       |   8 +-
 .../hbase/io/ImmutableBytesWritable.java      |   4 +-
 .../org/apache/hadoop/hbase/io/TimeRange.java |   8 +-
 .../io/encoding/BufferedDataBlockEncoder.java |   4 +-
 .../hbase/io/encoding/DataBlockEncoder.java   |   4 +-
 .../hbase/io/encoding/DataBlockEncoding.java  |   8 +-
 .../hbase/io/encoding/EncodedDataBlock.java   |   2 +-
 .../encoding/HFileBlockDecodingContext.java   |   4 +-
 .../encoding/HFileBlockEncodingContext.java   |  16 +--
 .../hadoop/hbase/io/hfile/BlockType.java      |   4 +-
 .../hadoop/hbase/io/hfile/HFileContext.java   |   4 +-
 .../org/apache/hadoop/hbase/nio/ByteBuff.java |  20 +--
 .../hadoop/hbase/nio/MultiByteBuff.java       |  12 +-
 .../apache/hadoop/hbase/security/User.java    |   4 +-
 .../hadoop/hbase/security/UserProvider.java   |   4 +-
 .../hadoop/hbase/util/AbstractByteRange.java  |   4 +-
 .../apache/hadoop/hbase/util/ByteRange.java   |   4 +-
 .../org/apache/hadoop/hbase/util/Bytes.java   |   4 +-
 .../hadoop/hbase/util/ExceptionUtil.java      |   8 +-
 .../org/apache/hadoop/hbase/util/HashKey.java |   4 +-
 .../org/apache/hadoop/hbase/util/Sleeper.java |   4 +-
 .../hbase/util/WindowMovingAverage.java       |   8 +-
 .../hadoop/hbase/net/BoundSocketMaker.java    |   4 +-
 .../MetricsAssignmentManagerSource.java       |  32 ++---
 .../hbase/master/MetricsMasterSource.java     |   4 +-
 .../MetricsRegionServerWrapper.java           |  46 ++-----
 .../regionserver/MetricsRegionWrapper.java    |  32 ++---
 .../MetricsTableWrapperAggregate.java         |  24 +---
 .../metrics2/lib/DynamicMetricsRegistry.java  |   4 +-
 .../apache/hadoop/hbase/util/JSONBean.java    |   4 +-
 .../hbase/IntegrationTestBackupRestore.java   |   4 +-
 .../hbase/IntegrationTestMobCompaction.java   |   4 +-
 .../hadoop/hbase/mapred/TableSplit.java       |  10 +-
 .../hadoop/hbase/mapreduce/CellCreator.java   |   4 +-
 .../hadoop/hbase/PerformanceEvaluation.java   |   8 +-
 .../TestRoundRobinTableInputFormat.java       |   4 +-
 .../hadoop/hbase/procedure2/LockAndQueue.java |  12 +-
 .../hadoop/hbase/procedure2/Procedure.java    |  28 ++---
 .../hbase/procedure2/ProcedureEvent.java      |   2 +-
 .../hbase/procedure2/ProcedureExecutor.java   |  12 +-
 .../hbase/procedure2/ProcedureMetrics.java    |  10 +-
 .../hbase/procedure2/ProcedureScheduler.java  |   4 +-
 .../procedure2/store/ProcedureStore.java      |   8 +-
 .../procedure2/store/wal/BitSetNode.java      |  20 +--
 .../store/wal/ProcedureStoreTracker.java      |   4 +-
 .../hbase/procedure2/util/DelayedUtil.java    |   8 +-
 .../hbase/rest/ProtobufMessageHandler.java    |   4 +-
 .../apache/hadoop/hbase/rest/RESTServlet.java |   8 +-
 .../hadoop/hbase/rest/TableResource.java      |   6 +-
 .../hadoop/hbase/rest/client/Client.java      |   8 +-
 .../hadoop/hbase/rest/client/Cluster.java     |   4 +-
 .../hadoop/hbase/rest/client/Response.java    |  20 +--
 .../hadoop/hbase/rest/model/CellModel.java    |  16 +--
 .../hadoop/hbase/rest/model/CellSetModel.java |   4 +-
 .../hbase/rest/model/ColumnSchemaModel.java   |  36 ++----
 .../rest/model/NamespacesInstanceModel.java   |   4 +-
 .../hbase/rest/model/NamespacesModel.java     |   4 +-
 .../hadoop/hbase/rest/model/RowModel.java     |   8 +-
 .../hadoop/hbase/rest/model/ScannerModel.java |  52 ++------
 .../rest/model/StorageClusterStatusModel.java |  96 ++++-----------
 .../model/StorageClusterVersionModel.java     |   4 +-
 .../hbase/rest/model/TableInfoModel.java      |   8 +-
 .../hbase/rest/model/TableListModel.java      |   4 +-
 .../hadoop/hbase/rest/model/TableModel.java   |   4 +-
 .../hbase/rest/model/TableRegionModel.java    |  20 +--
 .../hbase/rest/model/TableSchemaModel.java    |  28 ++---
 .../hadoop/hbase/rest/model/VersionModel.java |  20 +--
 .../apache/hadoop/hbase/HBaseServerBase.java  |  24 +---
 .../hadoop/hbase/LocalHBaseCluster.java       |  16 +--
 .../hadoop/hbase/MetaRegionLocationCache.java |   4 +-
 .../hadoop/hbase/MetaTableAccessor.java       |   8 +-
 .../java/org/apache/hadoop/hbase/Server.java  |  16 +--
 .../apache/hadoop/hbase/TableDescriptors.java |   8 +-
 .../hadoop/hbase/backup/HFileArchiver.java    |  16 +--
 .../example/TableHFileArchiveTracker.java     |   4 +-
 .../hadoop/hbase/client/VersionInfoUtil.java  |   4 +-
 .../hbase/client/locking/EntityLock.java      |   4 +-
 .../SplitLogManagerCoordination.java          |  16 +--
 .../SplitLogWorkerCoordination.java           |   8 +-
 .../ZkSplitLogWorkerCoordination.java         |   4 +-
 .../hbase/coprocessor/BaseEnvironment.java    |   4 +-
 .../hbase/coprocessor/HasMasterServices.java  |   4 +-
 .../coprocessor/HasRegionServerServices.java  |   4 +-
 .../MasterCoprocessorEnvironment.java         |   4 +-
 .../RegionCoprocessorEnvironment.java         |  14 +--
 .../RegionServerCoprocessorEnvironment.java   |   8 +-
 .../WALCoprocessorEnvironment.java            |   2 +-
 .../hadoop/hbase/executor/EventHandler.java   |   4 +-
 .../hbase/executor/ExecutorService.java       |   2 +-
 .../hadoop/hbase/executor/ExecutorType.java   |   4 +-
 .../hadoop/hbase/filter/FilterWrapper.java    |   4 +-
 .../hbase/io/FSDataInputStreamWrapper.java    |   4 +-
 .../org/apache/hadoop/hbase/io/FileLink.java  |  12 +-
 .../org/apache/hadoop/hbase/io/HFileLink.java |  12 +-
 .../hadoop/hbase/io/hfile/BlockCache.java     |   8 +-
 .../hadoop/hbase/io/hfile/BlockCacheKey.java  |   4 +-
 .../hadoop/hbase/io/hfile/BlockCacheUtil.java |  24 +---
 .../hadoop/hbase/io/hfile/CacheConfig.java    |  22 +---
 .../hadoop/hbase/io/hfile/Cacheable.java      |   4 +-
 .../apache/hadoop/hbase/io/hfile/HFile.java   |   2 +-
 .../hadoop/hbase/io/hfile/HFileBlock.java     |  28 ++---
 .../hbase/io/hfile/HFileBlockIndex.java       |  28 ++---
 .../hbase/io/hfile/HFileDataBlockEncoder.java |   2 +-
 .../hbase/io/hfile/HFileReaderImpl.java       |  12 +-
 .../hadoop/hbase/io/hfile/HFileScanner.java   |  12 +-
 .../hbase/io/hfile/HFileWriterImpl.java       |   4 +-
 .../hbase/io/hfile/InlineBlockWriter.java     |   4 +-
 .../hadoop/hbase/io/hfile/LruCachedBlock.java |   4 +-
 .../hbase/io/hfile/LruCachedBlockQueue.java   |   8 +-
 .../io/hfile/bucket/CachedEntryQueue.java     |   8 +-
 .../hbase/io/hfile/bucket/IOEngine.java       |   4 +-
 .../hadoop/hbase/io/util/MemorySizeUtil.java  |   4 +-
 .../ipc/FastPathBalancedQueueRpcExecutor.java |   4 +-
 .../hadoop/hbase/ipc/QueueBalancer.java       |   4 +-
 .../org/apache/hadoop/hbase/ipc/RpcCall.java  |  44 ++-----
 .../hadoop/hbase/ipc/RpcCallContext.java      |  12 +-
 .../apache/hadoop/hbase/ipc/RpcHandler.java   |   4 +-
 .../apache/hadoop/hbase/ipc/RpcServer.java    |   4 +-
 .../hbase/master/ActiveMasterManager.java     |   8 +-
 .../apache/hadoop/hbase/master/HMaster.java   |  48 ++------
 .../hadoop/hbase/master/MasterFileSystem.java |  20 +--
 .../hbase/master/MasterRpcServices.java       |   4 +-
 .../hadoop/hbase/master/MasterServices.java   | 108 ++++------------
 .../hadoop/hbase/master/MasterWalManager.java |   6 +-
 .../master/MetricsAssignmentManager.java      |  32 ++---
 .../hadoop/hbase/master/MetricsMaster.java    |   4 +-
 .../master/RegionPlacementMaintainer.java     |   4 +-
 .../hadoop/hbase/master/ServerManager.java    |  18 +--
 .../hadoop/hbase/master/SnapshotSentinel.java |   8 +-
 .../master/assignment/AssignmentManager.java  |   4 +-
 .../MergeTableRegionsProcedure.java           |   4 +-
 .../master/assignment/RegionStateStore.java   |   2 +-
 .../hbase/master/assignment/RegionStates.java |  20 +--
 .../master/assignment/UnassignProcedure.java  |   2 +-
 .../hadoop/hbase/master/hbck/HbckChore.java   |   2 +-
 .../hbase/master/janitor/CatalogJanitor.java  |   4 +-
 .../master/janitor/CatalogJanitorReport.java  |   4 +-
 .../master/janitor/ReportMakingVisitor.java   |   8 +-
 .../master/normalizer/NormalizationPlan.java  |   4 +-
 .../normalizer/SimpleRegionNormalizer.java    |   4 +-
 .../AbstractStateMachineRegionProcedure.java  |   4 +-
 .../procedure/EnableTableProcedure.java       |   4 +-
 .../procedure/ServerCrashProcedure.java       |   4 +-
 .../procedure/ServerProcedureInterface.java   |   8 +-
 .../procedure/TableProcedureInterface.java    |   4 +-
 .../replication/ReplicationPeerManager.java   |   4 +-
 .../master/snapshot/SnapshotFileCache.java    |   4 +-
 .../master/snapshot/SnapshotManager.java      |   4 +-
 .../hbase/master/zksyncer/ClientZKSyncer.java |   4 +-
 .../hadoop/hbase/procedure/Procedure.java     |   2 +-
 .../hbase/procedure/ProcedureCoordinator.java |   8 +-
 .../hbase/quotas/MasterQuotaManager.java      |   4 +-
 .../hadoop/hbase/quotas/OperationQuota.java   |   2 +-
 .../hadoop/hbase/quotas/QuotaLimiter.java     |   6 +-
 .../hadoop/hbase/quotas/QuotaState.java       |   4 +-
 .../hadoop/hbase/quotas/RateLimiter.java      |   6 +-
 .../quotas/RegionServerSpaceQuotaManager.java |   4 +-
 .../hadoop/hbase/quotas/UserQuotaState.java   |   4 +-
 .../hbase/regionserver/AbstractMemStore.java  |  10 +-
 .../regionserver/ChangedReadersObserver.java  |   4 +-
 .../hadoop/hbase/regionserver/Chunk.java      |   4 +-
 .../hbase/regionserver/CompactSplit.java      |  12 +-
 .../CompositeImmutableSegment.java            |  20 +--
 .../ConstantSizeRegionSplitPolicy.java        |   4 +-
 .../FlushNonSloppyStoresFirstPolicy.java      |   4 +-
 .../hbase/regionserver/FlushPolicy.java       |   4 +-
 .../hadoop/hbase/regionserver/HRegion.java    |  78 ++++--------
 .../hbase/regionserver/HRegionFileSystem.java |  14 +--
 .../hbase/regionserver/HRegionServer.java     |  34 ++---
 .../hadoop/hbase/regionserver/HStore.java     |  20 +--
 .../hadoop/hbase/regionserver/HStoreFile.java |   4 +-
 .../hbase/regionserver/HeapMemoryManager.java |   4 +-
 ...creasingToUpperBoundRegionSplitPolicy.java |   4 +-
 .../hbase/regionserver/KeyValueHeap.java      |   4 +-
 .../hbase/regionserver/KeyValueScanner.java   |   4 +-
 .../hbase/regionserver/LeaseManager.java      |   6 +-
 .../hadoop/hbase/regionserver/MemStore.java   |   4 +-
 .../hbase/regionserver/MemStoreFlusher.java   |  16 +--
 .../hbase/regionserver/MemStoreSizing.java    |   8 +-
 .../hbase/regionserver/MemStoreSnapshot.java  |  16 +--
 .../regionserver/MetricsUserAggregate.java    |   4 +-
 .../MiniBatchOperationInProgress.java         |   4 +-
 .../hbase/regionserver/RSRpcServices.java     |  16 +--
 .../hadoop/hbase/regionserver/Region.java     |  42 +++----
 .../regionserver/RegionCoprocessorHost.java   |   2 +-
 .../hbase/regionserver/RegionScanner.java     |   8 +-
 .../hbase/regionserver/RegionScannerImpl.java |  12 +-
 .../regionserver/RegionServerAccounting.java  |  16 +--
 .../regionserver/RegionServerServices.java    |  72 +++--------
 .../hbase/regionserver/RegionSplitPolicy.java |   8 +-
 .../hbase/regionserver/ScannerContext.java    |  12 +-
 .../hadoop/hbase/regionserver/Segment.java    |   8 +-
 .../hbase/regionserver/SegmentScanner.java    |   4 +-
 .../hbase/regionserver/SplitLogWorker.java    |   4 +-
 .../hadoop/hbase/regionserver/Store.java      | 116 +++++-------------
 .../regionserver/StoreConfigInformation.java  |   8 +-
 .../hbase/regionserver/StoreEngine.java       |  16 +--
 .../hadoop/hbase/regionserver/StoreFile.java  |  36 ++----
 .../hbase/regionserver/StoreFileInfo.java     |  18 ++-
 .../hbase/regionserver/StoreFileManager.java  |   4 +-
 .../hbase/regionserver/StoreFlushContext.java |   4 +-
 .../hbase/regionserver/StoreScanner.java      |   8 +-
 .../regionserver/StripeStoreFileManager.java  |   4 +-
 .../hbase/regionserver/TimeRangeTracker.java  |  12 +-
 .../compactions/CompactionConfiguration.java  |  28 ++---
 .../compactions/CompactionPolicy.java         |   4 +-
 .../compactions/CompactionProgress.java       |  12 +-
 .../compactions/CompactionRequest.java        |  28 ++---
 .../DateTieredCompactionPolicy.java           |   2 +-
 .../compactions/OffPeakHours.java             |   8 +-
 .../compactions/StripeCompactionPolicy.java   |  16 +--
 .../handler/OpenRegionHandler.java            |   8 +-
 .../querymatcher/ColumnCount.java             |  12 +-
 .../querymatcher/ColumnTracker.java           |   4 +-
 .../querymatcher/DeleteTracker.java           |   4 +-
 .../querymatcher/ScanQueryMatcher.java        |  16 +--
 .../hbase/regionserver/wal/AbstractFSWAL.java |  14 +--
 .../hadoop/hbase/regionserver/wal/FSHLog.java |  16 +--
 .../hbase/regionserver/wal/FSWALEntry.java    |   8 +-
 .../hbase/regionserver/wal/ReaderBase.java    |  16 +--
 .../regionserver/wal/RingBufferTruck.java     |   4 +-
 .../replication/ReplicationEndpoint.java      |   4 +-
 .../regionserver/ReplicationSink.java         |   4 +-
 .../ReplicationSourceInterface.java           |  36 ++----
 .../ReplicationSourceWALReader.java           |   4 +-
 .../regionserver/WALEntryBatch.java           |  36 ++----
 .../regionserver/WALEntryStream.java          |  12 +-
 .../hbase/rsgroup/RSGroupInfoManagerImpl.java |   8 +-
 .../security/access/AccessControlFilter.java  |   4 +-
 .../hbase/security/access/AuthResult.java     |   4 +-
 .../security/token/FsDelegationToken.java     |   8 +-
 .../visibility/VisibilityLabelsCache.java     |   4 +-
 .../hbase/snapshot/RestoreSnapshotHelper.java |  20 +--
 .../hadoop/hbase/snapshot/SnapshotInfo.java   |  40 +++---
 .../hadoop/hbase/tool/BulkLoadHFiles.java     |   4 +-
 .../apache/hadoop/hbase/tool/CanaryTool.java  |   4 +-
 .../hadoop/hbase/util/BloomFilterBase.java    |  12 +-
 .../hadoop/hbase/util/BloomFilterFactory.java |  20 +--
 .../hadoop/hbase/util/ConnectionCache.java    |   4 +-
 .../hadoop/hbase/util/DirectMemoryUtils.java  |   8 +-
 .../org/apache/hadoop/hbase/util/FSUtils.java |   8 +-
 .../apache/hadoop/hbase/util/HBaseFsck.java   |  16 +--
 .../hadoop/hbase/util/HbckTableInfo.java      |   4 +-
 .../hadoop/hbase/util/JVMClusterUtil.java     |   4 +-
 .../hadoop/hbase/util/RegionSplitter.java     |   4 +-
 .../hbase/util/RollingStatCalculator.java     |   8 +-
 .../hbase/util/ServerRegionReplicaUtil.java   |  16 +--
 .../hbase/util/YammerHistogramUtils.java      |   6 +-
 .../util/hbck/HFileCorruptionChecker.java     |  32 ++---
 .../hbase/wal/AbstractFSWALProvider.java      |   4 +-
 .../wal/AbstractRecoveredEditsOutputSink.java |   4 +-
 .../hadoop/hbase/wal/AbstractWALRoller.java   |   4 +-
 .../apache/hadoop/hbase/wal/EntryBuffers.java |   4 +-
 .../apache/hadoop/hbase/wal/OutputSink.java   |  12 +-
 .../java/org/apache/hadoop/hbase/wal/WAL.java |   4 +-
 .../org/apache/hadoop/hbase/wal/WALEdit.java  |   4 +-
 .../org/apache/hadoop/hbase/wal/WALKey.java   |  20 +--
 .../apache/hadoop/hbase/wal/WALKeyImpl.java   |  16 +--
 .../apache/hadoop/hbase/wal/WALProvider.java  |   4 +-
 .../io/hfile/TestHFileDataBlockEncoder.java   |   4 +-
 .../assignment/TestRaceBetweenSCPAndDTP.java  |   4 +-
 .../hbase/master/procedure/TestHBCKSCP.java   |   4 +-
 .../hbase/regionserver/TestHRegion.java       |   4 +-
 .../regionserver/TestRecoveredEdits.java      |   4 +-
 .../wal/TestLogRollingNoCluster.java          |   4 +-
 .../TestMetaRegionReplicaReplication.java     |   4 +-
 .../TestReplicationSourceManager.java         |   4 +-
 .../hbase/util/HFileArchiveTestingUtil.java   |   4 +-
 .../hbase/util/MultiThreadedAction.java       |   2 +-
 .../util/test/LoadTestDataGenerator.java      |   4 +-
 .../hbase/client/AbstractTestShell.java       |   8 +-
 .../hbase/HBaseCommonTestingUtility.java      |   8 +-
 .../hadoop/hbase/HBaseZKTestingUtility.java   |   4 +-
 .../apache/hadoop/hbase/MiniHBaseCluster.java |  16 +--
 .../hadoop/hbase/StartMiniClusterOption.java  |   4 +-
 .../apache/hadoop/hbase/thrift/ImplType.java  |   4 +-
 .../thrift/ThriftHBaseServiceHandler.java     |   2 +-
 .../hadoop/hbase/thrift/TestThriftServer.java |   4 +-
 .../hbase/thrift/ThriftServerRunner.java      |   4 +-
 .../hbase/zookeeper/ClusterStatusTracker.java |   4 +-
 .../hbase/zookeeper/MiniZooKeeperCluster.java |   4 +-
 .../hadoop/hbase/zookeeper/ZKListener.java    |   4 +-
 .../apache/hadoop/hbase/zookeeper/ZKUtil.java |  20 +--
 .../hadoop/hbase/zookeeper/ZKWatcher.java     |   4 +-
 400 files changed, 1225 insertions(+), 3365 deletions(-)

diff --git a/hbase-asyncfs/src/main/java/org/apache/hadoop/hbase/io/asyncfs/AsyncFSOutput.java b/hbase-asyncfs/src/main/java/org/apache/hadoop/hbase/io/asyncfs/AsyncFSOutput.java
index b88b32bdb81..cd186f904a9 100644
--- a/hbase-asyncfs/src/main/java/org/apache/hadoop/hbase/io/asyncfs/AsyncFSOutput.java
+++ b/hbase-asyncfs/src/main/java/org/apache/hadoop/hbase/io/asyncfs/AsyncFSOutput.java
@@ -89,8 +89,6 @@ public interface AsyncFSOutput extends Closeable {
   @Override
   void close() throws IOException;
 
-  /**
-   * @return byteSize success synced to underlying filesystem.
-   */
+  /** Returns byteSize success synced to underlying filesystem. */
   long getSyncedLength();
 }
diff --git a/hbase-asyncfs/src/main/java/org/apache/hadoop/hbase/util/RecoverLeaseFSUtils.java b/hbase-asyncfs/src/main/java/org/apache/hadoop/hbase/util/RecoverLeaseFSUtils.java
index e4a410aa9c3..0014185b85c 100644
--- a/hbase-asyncfs/src/main/java/org/apache/hadoop/hbase/util/RecoverLeaseFSUtils.java
+++ b/hbase-asyncfs/src/main/java/org/apache/hadoop/hbase/util/RecoverLeaseFSUtils.java
@@ -186,9 +186,7 @@ public final class RecoverLeaseFSUtils {
     return recovered;
   }
 
-  /**
-   * @return Detail to append to any log message around lease recovering.
-   */
+  /** Returns Detail to append to any log message around lease recovering. */
   private static String getLogMessageDetail(final int nbAttempt, final Path p,
     final long startWaiting) {
     return "attempt=" + nbAttempt + " on file=" + p + " after "
diff --git a/hbase-balancer/src/main/java/org/apache/hadoop/hbase/master/balancer/FavoredStochasticBalancer.java b/hbase-balancer/src/main/java/org/apache/hadoop/hbase/master/balancer/FavoredStochasticBalancer.java
index 3b91bec03ec..fbe91a921da 100644
--- a/hbase-balancer/src/main/java/org/apache/hadoop/hbase/master/balancer/FavoredStochasticBalancer.java
+++ b/hbase-balancer/src/main/java/org/apache/hadoop/hbase/master/balancer/FavoredStochasticBalancer.java
@@ -87,9 +87,7 @@ public class FavoredStochasticBalancer extends StochasticLoadBalancer
     return fnPickers;
   }
 
-  /**
-   * @return any candidate generator in random
-   */
+  /** Returns any candidate generator in random */
   @Override
   protected CandidateGenerator getRandomGenerator() {
     return candidateGenerators.get(ThreadLocalRandom.current().nextInt(candidateGenerators.size()));
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/CatalogFamilyFormat.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/CatalogFamilyFormat.java
index 6ad1a18e83d..d714c47359b 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/CatalogFamilyFormat.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/CatalogFamilyFormat.java
@@ -398,9 +398,7 @@ public class CatalogFamilyFormat {
     return false;
   }
 
-  /**
-   * @return True if the column in <code>cell</code> matches the regex 'info:merge.*'.
-   */
+  /** Returns True if the column in <code>cell</code> matches the regex 'info:merge.*'. */
   public static boolean isMergeQualifierPrefix(Cell cell) {
     // Check to see if has family and that qualifier starts with the merge qualifier 'merge'
     return CellUtil.matchingFamily(cell, HConstants.CATALOG_FAMILY)
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/ClientMetaTableAccessor.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/ClientMetaTableAccessor.java
index e948048325f..b75398dd1cf 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/ClientMetaTableAccessor.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/ClientMetaTableAccessor.java
@@ -382,9 +382,7 @@ public final class ClientMetaTableAccessor {
 
     abstract void add(Result r);
 
-    /**
-     * @return Collected results; wait till visits complete to collect all possible results
-     */
+    /** Returns Collected results; wait till visits complete to collect all possible results */
     List<T> getResults() {
       return this.results;
     }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/ClusterId.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/ClusterId.java
index e769e80847f..9b7a5de19bd 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/ClusterId.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/ClusterId.java
@@ -45,9 +45,7 @@ public class ClusterId {
     this.id = uuid;
   }
 
-  /**
-   * @return The clusterid serialized using pb w/ pb magic prefix
-   */
+  /** Returns The clusterid serialized using pb w/ pb magic prefix */
   public byte[] toByteArray() {
     return ProtobufUtil.prependPBMagic(convert().toByteArray());
   }
@@ -74,9 +72,7 @@ public class ClusterId {
     }
   }
 
-  /**
-   * @return A pb instance to represent this instance.
-   */
+  /** Returns A pb instance to represent this instance. */
   public ClusterIdProtos.ClusterId convert() {
     ClusterIdProtos.ClusterId.Builder builder = ClusterIdProtos.ClusterId.newBuilder();
     return builder.setClusterId(this.id).build();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/ClusterMetrics.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/ClusterMetrics.java
index e36010c424c..7c4f2c823d1 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/ClusterMetrics.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/ClusterMetrics.java
@@ -69,38 +69,26 @@ import org.apache.yetus.audience.InterfaceAudience;
 @InterfaceAudience.Public
 public interface ClusterMetrics {
 
-  /**
-   * @return the HBase version string as reported by the HMaster
-   */
+  /** Returns the HBase version string as reported by the HMaster */
   @Nullable
   String getHBaseVersion();
 
-  /**
-   * @return the names of region servers on the dead list
-   */
+  /** Returns the names of region servers on the dead list */
   List<ServerName> getDeadServerNames();
 
-  /**
-   * @return the names of region servers on the decommissioned list
-   */
+  /** Returns the names of region servers on the decommissioned list */
   List<ServerName> getDecommissionedServerNames();
 
-  /**
-   * @return the names of region servers on the live list
-   */
+  /** Returns the names of region servers on the live list */
   Map<ServerName, ServerMetrics> getLiveServerMetrics();
 
-  /**
-   * @return the number of regions deployed on the cluster
-   */
+  /** Returns the number of regions deployed on the cluster */
   default int getRegionCount() {
     return getLiveServerMetrics().entrySet().stream()
       .mapToInt(v -> v.getValue().getRegionMetrics().size()).sum();
   }
 
-  /**
-   * @return the number of requests since last report
-   */
+  /** Returns the number of requests since last report */
   default long getRequestCount() {
     return getLiveServerMetrics().entrySet().stream()
       .flatMap(v -> v.getValue().getRegionMetrics().values().stream())
@@ -114,9 +102,7 @@ public interface ClusterMetrics {
   @Nullable
   ServerName getMasterName();
 
-  /**
-   * @return the names of backup masters
-   */
+  /** Returns the names of backup masters */
   List<ServerName> getBackupMasterNames();
 
   @InterfaceAudience.Private
@@ -147,9 +133,7 @@ public interface ClusterMetrics {
 
   List<ServerName> getServersName();
 
-  /**
-   * @return the average cluster load
-   */
+  /** Returns the average cluster load */
   default double getAverageLoad() {
     int serverSize = getLiveServerMetrics().size();
     if (serverSize == 0) {
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/CoprocessorEnvironment.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/CoprocessorEnvironment.java
index edbc5f479d6..94909f1c14e 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/CoprocessorEnvironment.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/CoprocessorEnvironment.java
@@ -28,19 +28,19 @@ import org.apache.yetus.audience.InterfaceStability;
 @InterfaceStability.Evolving
 public interface CoprocessorEnvironment<C extends Coprocessor> {
 
-  /** @return the Coprocessor interface version */
+  /** Returns the Coprocessor interface version */
   int getVersion();
 
-  /** @return the HBase version as a string (e.g. "0.21.0") */
+  /** Returns the HBase version as a string (e.g. "0.21.0") */
   String getHBaseVersion();
 
-  /** @return the loaded coprocessor instance */
+  /** Returns the loaded coprocessor instance */
   C getInstance();
 
-  /** @return the priority assigned to the loaded coprocessor */
+  /** Returns the priority assigned to the loaded coprocessor */
   int getPriority();
 
-  /** @return the load sequence number */
+  /** Returns the load sequence number */
   int getLoadSequence();
 
   /**
@@ -49,8 +49,6 @@ public interface CoprocessorEnvironment<C extends Coprocessor> {
    */
   Configuration getConfiguration();
 
-  /**
-   * @return the classloader for the loaded coprocessor instance
-   */
+  /** Returns the classloader for the loaded coprocessor instance */
   ClassLoader getClassLoader();
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/HBaseServerException.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/HBaseServerException.java
index 2e4ebbd0baa..3484995c1bf 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/HBaseServerException.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/HBaseServerException.java
@@ -63,9 +63,7 @@ public class HBaseServerException extends HBaseIOException {
     this.serverOverloaded = serverOverloaded;
   }
 
-  /**
-   * @return True if server was considered overloaded when exception was thrown
-   */
+  /** Returns True if server was considered overloaded when exception was thrown */
   public boolean isServerOverloaded() {
     return serverOverloaded;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/RegionMetrics.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/RegionMetrics.java
index d873c4bc1cb..88527e86442 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/RegionMetrics.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/RegionMetrics.java
@@ -28,44 +28,28 @@ import org.apache.yetus.audience.InterfaceAudience;
 @InterfaceAudience.Public
 public interface RegionMetrics {
 
-  /**
-   * @return the region name
-   */
+  /** Returns the region name */
   byte[] getRegionName();
 
-  /**
-   * @return the number of stores
-   */
+  /** Returns the number of stores */
   int getStoreCount();
 
-  /**
-   * @return the number of storefiles
-   */
+  /** Returns the number of storefiles */
   int getStoreFileCount();
 
-  /**
-   * @return the total size of the storefiles
-   */
+  /** Returns the total size of the storefiles */
   Size getStoreFileSize();
 
-  /**
-   * @return the memstore size
-   */
+  /** Returns the memstore size */
   Size getMemStoreSize();
 
-  /**
-   * @return the number of read requests made to region
-   */
+  /** Returns the number of read requests made to region */
   long getReadRequestCount();
 
-  /**
-   * @return the number of write requests made to region
-   */
+  /** Returns the number of write requests made to region */
   long getWriteRequestCount();
 
-  /**
-   * @return the number of coprocessor service requests made to region
-   */
+  /** Returns the number of coprocessor service requests made to region */
   public long getCpRequestCount();
 
   /**
@@ -76,16 +60,12 @@ public interface RegionMetrics {
     return getReadRequestCount() + getWriteRequestCount() + getCpRequestCount();
   }
 
-  /**
-   * @return the region name as a string
-   */
+  /** Returns the region name as a string */
   default String getNameAsString() {
     return Bytes.toStringBinary(getRegionName());
   }
 
-  /**
-   * @return the number of filtered read requests made to region
-   */
+  /** Returns the number of filtered read requests made to region */
   long getFilteredReadRequestCount();
 
   /**
@@ -96,29 +76,19 @@ public interface RegionMetrics {
    */
   Size getStoreFileIndexSize();
 
-  /**
-   * @return The current total size of root-level indexes for the region
-   */
+  /** Returns The current total size of root-level indexes for the region */
   Size getStoreFileRootLevelIndexSize();
 
-  /**
-   * @return The total size of all index blocks, not just the root level
-   */
+  /** Returns The total size of all index blocks, not just the root level */
   Size getStoreFileUncompressedDataIndexSize();
 
-  /**
-   * @return The total size of all Bloom filter blocks, not just loaded into the block cache
-   */
+  /** Returns The total size of all Bloom filter blocks, not just loaded into the block cache */
   Size getBloomFilterSize();
 
-  /**
-   * @return the total number of cells in current compaction
-   */
+  /** Returns the total number of cells in current compaction */
   long getCompactingCellCount();
 
-  /**
-   * @return the number of already compacted kvs in current compaction
-   */
+  /** Returns the number of already compacted kvs in current compaction */
   long getCompactedCellCount();
 
   /**
@@ -127,29 +97,19 @@ public interface RegionMetrics {
    */
   long getCompletedSequenceId();
 
-  /**
-   * @return completed sequence id per store.
-   */
+  /** Returns completed sequence id per store. */
   Map<byte[], Long> getStoreSequenceId();
 
-  /**
-   * @return the uncompressed size of the storefiles
-   */
+  /** Returns the uncompressed size of the storefiles */
   Size getUncompressedStoreFileSize();
 
-  /**
-   * @return the data locality of region in the regionserver.
-   */
+  /** Returns the data locality of region in the regionserver. */
   float getDataLocality();
 
-  /**
-   * @return the timestamp of the oldest hfile for any store of this region.
-   */
+  /** Returns the timestamp of the oldest hfile for any store of this region. */
   long getLastMajorCompactionTimestamp();
 
-  /**
-   * @return the reference count for the stores of this region
-   */
+  /** Returns the reference count for the stores of this region */
   int getStoreRefCount();
 
   /**
@@ -164,9 +124,7 @@ public interface RegionMetrics {
    */
   float getDataLocalityForSsd();
 
-  /**
-   * @return the data at local weight of this region in the regionserver
-   */
+  /** Returns the data at local weight of this region in the regionserver */
   long getBlocksLocalWeight();
 
   /**
@@ -175,13 +133,9 @@ public interface RegionMetrics {
    */
   long getBlocksLocalWithSsdWeight();
 
-  /**
-   * @return the block total weight of this region
-   */
+  /** Returns the block total weight of this region */
   long getBlocksTotalWeight();
 
-  /**
-   * @return the compaction state of this region
-   */
+  /** Returns the compaction state of this region */
   CompactionState getCompactionState();
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/ServerMetrics.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/ServerMetrics.java
index 38286afa2d1..e0c408781f8 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/ServerMetrics.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/ServerMetrics.java
@@ -33,48 +33,32 @@ public interface ServerMetrics {
 
   ServerName getServerName();
 
-  /**
-   * @return the version number of a regionserver.
-   */
+  /** Returns the version number of a regionserver. */
   default int getVersionNumber() {
     return 0;
   }
 
-  /**
-   * @return the string type version of a regionserver.
-   */
+  /** Returns the string type version of a regionserver. */
   default String getVersion() {
     return "0.0.0";
   }
 
-  /**
-   * @return the number of requests per second.
-   */
+  /** Returns the number of requests per second. */
   long getRequestCountPerSecond();
 
-  /**
-   * @return total Number of requests from the start of the region server.
-   */
+  /** Returns total Number of requests from the start of the region server. */
   long getRequestCount();
 
-  /**
-   * @return total Number of read requests from the start of the region server.
-   */
+  /** Returns total Number of read requests from the start of the region server. */
   long getReadRequestsCount();
 
-  /**
-   * @return total Number of write requests from the start of the region server.
-   */
+  /** Returns total Number of write requests from the start of the region server. */
   long getWriteRequestsCount();
 
-  /**
-   * @return the amount of used heap
-   */
+  /** Returns the amount of used heap */
   Size getUsedHeapSize();
 
-  /**
-   * @return the maximum allowable size of the heap
-   */
+  /** Returns the maximum allowable size of the heap */
   Size getMaxHeapSize();
 
   int getInfoServerPort();
@@ -97,14 +81,10 @@ public interface ServerMetrics {
   @Nullable
   ReplicationLoadSink getReplicationLoadSink();
 
-  /**
-   * @return region load metrics
-   */
+  /** Returns region load metrics */
   Map<byte[], RegionMetrics> getRegionMetrics();
 
-  /**
-   * @return metrics per user
-   */
+  /** Returns metrics per user */
   Map<byte[], UserMetrics> getUserMetrics();
 
   /**
@@ -113,14 +93,10 @@ public interface ServerMetrics {
    */
   Set<String> getCoprocessorNames();
 
-  /**
-   * @return the timestamp (server side) of generating this metrics
-   */
+  /** Returns the timestamp (server side) of generating this metrics */
   long getReportTimestamp();
 
-  /**
-   * @return the last timestamp (server side) of generating this metrics
-   */
+  /** Returns the last timestamp (server side) of generating this metrics */
   long getLastReportTimestamp();
 
   /**
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/Size.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/Size.java
index c248849e363..99062635f77 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/Size.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/Size.java
@@ -69,9 +69,7 @@ public final class Size implements Comparable<Size> {
     this.unit = Preconditions.checkNotNull(unit);
   }
 
-  /**
-   * @return size unit
-   */
+  /** Returns size unit */
   public Unit getUnit() {
     return unit;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/UserMetrics.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/UserMetrics.java
index 2710aa9be27..05108c70e74 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/UserMetrics.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/UserMetrics.java
@@ -40,19 +40,13 @@ public interface UserMetrics {
     long getFilteredReadRequestsCount();
   }
 
-  /**
-   * @return the user name
-   */
+  /** Returns the user name */
   byte[] getUserName();
 
-  /**
-   * @return the number of read requests made by user
-   */
+  /** Returns the number of read requests made by user */
   long getReadRequestCount();
 
-  /**
-   * @return the number of write requests made by user
-   */
+  /** Returns the number of write requests made by user */
   long getWriteRequestCount();
 
   /**
@@ -63,20 +57,14 @@ public interface UserMetrics {
     return getReadRequestCount() + getWriteRequestCount();
   }
 
-  /**
-   * @return the user name as a string
-   */
+  /** Returns the user name as a string */
   default String getNameAsString() {
     return Bytes.toStringBinary(getUserName());
   }
 
-  /**
-   * @return metrics per client(hostname)
-   */
+  /** Returns metrics per client(hostname) */
   Map<String, ClientMetrics> getClientMetrics();
 
-  /**
-   * @return count of filtered read requests for a user
-   */
+  /** Returns count of filtered read requests for a user */
   long getFilteredReadRequests();
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java
index d2b57476128..96923ae8462 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java
@@ -111,9 +111,7 @@ public interface Admin extends Abortable, Closeable {
   @Override
   boolean isAborted();
 
-  /**
-   * @return Connection used by this object.
-   */
+  /** Returns Connection used by this object. */
   Connection getConnection();
 
   /**
@@ -1162,9 +1160,7 @@ public interface Admin extends Abortable, Closeable {
   List<RegionMetrics> getRegionMetrics(ServerName serverName, TableName tableName)
     throws IOException;
 
-  /**
-   * @return Configuration used by the instance.
-   */
+  /** Returns Configuration used by the instance. */
   Configuration getConfiguration();
 
   /**
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java
index 59c90382ab2..76e923d3986 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java
@@ -92,9 +92,7 @@ public class Append extends Mutation {
     return this;
   }
 
-  /**
-   * @return current setting for returnResults
-   */
+  /** Returns current setting for returnResults */
   // This method makes public the superclasses's protected method.
   @Override
   public boolean isReturnResults() {
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/AsyncAdmin.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/AsyncAdmin.java
index e0a254bb2aa..996410d26f5 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/AsyncAdmin.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/AsyncAdmin.java
@@ -1073,34 +1073,24 @@ public interface AsyncAdmin {
   CompletableFuture<Void> recommissionRegionServer(ServerName server,
     List<byte[]> encodedRegionNames);
 
-  /**
-   * @return cluster status wrapped by {@link CompletableFuture}
-   */
+  /** Returns cluster status wrapped by {@link CompletableFuture} */
   CompletableFuture<ClusterMetrics> getClusterMetrics();
 
-  /**
-   * @return cluster status wrapped by {@link CompletableFuture}
-   */
+  /** Returns cluster status wrapped by {@link CompletableFuture} */
   CompletableFuture<ClusterMetrics> getClusterMetrics(EnumSet<Option> options);
 
-  /**
-   * @return current master server name wrapped by {@link CompletableFuture}
-   */
+  /** Returns current master server name wrapped by {@link CompletableFuture} */
   default CompletableFuture<ServerName> getMaster() {
     return getClusterMetrics(EnumSet.of(Option.MASTER)).thenApply(ClusterMetrics::getMasterName);
   }
 
-  /**
-   * @return current backup master list wrapped by {@link CompletableFuture}
-   */
+  /** Returns current backup master list wrapped by {@link CompletableFuture} */
   default CompletableFuture<Collection<ServerName>> getBackupMasters() {
     return getClusterMetrics(EnumSet.of(Option.BACKUP_MASTERS))
       .thenApply(ClusterMetrics::getBackupMasterNames);
   }
 
-  /**
-   * @return current live region servers list wrapped by {@link CompletableFuture}
-   */
+  /** Returns current live region servers list wrapped by {@link CompletableFuture} */
   default CompletableFuture<Collection<ServerName>> getRegionServers() {
     return getClusterMetrics(EnumSet.of(Option.SERVERS_NAME))
       .thenApply(ClusterMetrics::getServersName);
@@ -1132,9 +1122,7 @@ public interface AsyncAdmin {
     return future;
   }
 
-  /**
-   * @return a list of master coprocessors wrapped by {@link CompletableFuture}
-   */
+  /** Returns a list of master coprocessors wrapped by {@link CompletableFuture} */
   default CompletableFuture<List<String>> getMasterCoprocessorNames() {
     return getClusterMetrics(EnumSet.of(Option.MASTER_COPROCESSORS))
       .thenApply(ClusterMetrics::getMasterCoprocessorNames);
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CheckAndMutate.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CheckAndMutate.java
index 67f30177663..56402fb42f8 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CheckAndMutate.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CheckAndMutate.java
@@ -250,66 +250,48 @@ public final class CheckAndMutate implements Row {
     this.action = action;
   }
 
-  /**
-   * @return the row
-   */
+  /** Returns the row */
   @Override
   public byte[] getRow() {
     return row;
   }
 
-  /**
-   * @return the family to check
-   */
+  /** Returns the family to check */
   public byte[] getFamily() {
     return family;
   }
 
-  /**
-   * @return the qualifier to check
-   */
+  /** Returns the qualifier to check */
   public byte[] getQualifier() {
     return qualifier;
   }
 
-  /**
-   * @return the comparison operator
-   */
+  /** Returns the comparison operator */
   public CompareOperator getCompareOp() {
     return op;
   }
 
-  /**
-   * @return the expected value
-   */
+  /** Returns the expected value */
   public byte[] getValue() {
     return value;
   }
 
-  /**
-   * @return the filter to check
-   */
+  /** Returns the filter to check */
   public Filter getFilter() {
     return filter;
   }
 
-  /**
-   * @return whether this has a filter or not
-   */
+  /** Returns whether this has a filter or not */
   public boolean hasFilter() {
     return filter != null;
   }
 
-  /**
-   * @return the time range to check
-   */
+  /** Returns the time range to check */
   public TimeRange getTimeRange() {
     return timeRange;
   }
 
-  /**
-   * @return the action done if check succeeds
-   */
+  /** Returns the action done if check succeeds */
   public Row getAction() {
     return action;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CheckAndMutateResult.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CheckAndMutateResult.java
index 88b438a74a0..8ecb49e3d5f 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CheckAndMutateResult.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CheckAndMutateResult.java
@@ -32,16 +32,12 @@ public class CheckAndMutateResult {
     this.result = result;
   }
 
-  /**
-   * @return Whether the CheckAndMutate operation is successful or not
-   */
+  /** Returns Whether the CheckAndMutate operation is successful or not */
   public boolean isSuccess() {
     return success;
   }
 
-  /**
-   * @return It is used only for CheckAndMutate operations with Increment/Append. Otherwise null
-   */
+  /** Returns It is used only for CheckAndMutate operations with Increment/Append. Otherwise null */
   public Result getResult() {
     return result;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ClientIdGenerator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ClientIdGenerator.java
index 758cf508578..f5bedbe88d2 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ClientIdGenerator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ClientIdGenerator.java
@@ -58,9 +58,7 @@ final class ClientIdGenerator {
     return id;
   }
 
-  /**
-   * @return PID of the current process, if it can be extracted from JVM name, or null.
-   */
+  /** Returns PID of the current process, if it can be extracted from JVM name, or null. */
   public static Long getPid() {
     String name = ManagementFactory.getRuntimeMXBean().getName();
     String[] nameParts = name.split("@");
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ColumnFamilyDescriptor.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ColumnFamilyDescriptor.java
index 5f11f8d258a..b3d8e4fd600 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ColumnFamilyDescriptor.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ColumnFamilyDescriptor.java
@@ -77,39 +77,25 @@ public interface ColumnFamilyDescriptor {
       return lcf.getConfiguration().hashCode() - rcf.getConfiguration().hashCode();
     };
 
-  /**
-   * @return The storefile/hfile blocksize for this column family.
-   */
+  /** Returns The storefile/hfile blocksize for this column family. */
   int getBlocksize();
 
-  /**
-   * @return bloom filter type used for new StoreFiles in ColumnFamily
-   */
+  /** Returns bloom filter type used for new StoreFiles in ColumnFamily */
   BloomType getBloomFilterType();
 
-  /**
-   * @return Compression type setting.
-   */
+  /** Returns Compression type setting. */
   Compression.Algorithm getCompactionCompressionType();
 
-  /**
-   * @return Compression type setting for major compactions.
-   */
+  /** Returns Compression type setting for major compactions. */
   Compression.Algorithm getMajorCompactionCompressionType();
 
-  /**
-   * @return Compression type setting for minor compactions.
-   */
+  /** Returns Compression type setting for minor compactions. */
   Compression.Algorithm getMinorCompactionCompressionType();
 
-  /**
-   * @return Compression type setting.
-   */
+  /** Returns Compression type setting. */
   Compression.Algorithm getCompressionType();
 
-  /**
-   * @return an unmodifiable map.
-   */
+  /** Returns an unmodifiable map. */
   Map<String, String> getConfiguration();
 
   /**
@@ -118,24 +104,16 @@ public interface ColumnFamilyDescriptor {
    */
   String getConfigurationValue(String key);
 
-  /**
-   * @return replication factor set for this CF
-   */
+  /** Returns replication factor set for this CF */
   short getDFSReplication();
 
-  /**
-   * @return the data block encoding algorithm used in block cache and optionally on disk
-   */
+  /** Returns the data block encoding algorithm used in block cache and optionally on disk */
   DataBlockEncoding getDataBlockEncoding();
 
-  /**
-   * @return Return the raw crypto key attribute for the family, or null if not set
-   */
+  /** Returns Return the raw crypto key attribute for the family, or null if not set */
   byte[] getEncryptionKey();
 
-  /**
-   * @return Return the encryption algorithm in use by this family
-   */
+  /** Returns Return the encryption algorithm in use by this family */
   String getEncryptionType();
 
   /**
@@ -144,19 +122,13 @@ public interface ColumnFamilyDescriptor {
    */
   MemoryCompactionPolicy getInMemoryCompaction();
 
-  /**
-   * @return return the KeepDeletedCells
-   */
+  /** Returns return the KeepDeletedCells */
   KeepDeletedCells getKeepDeletedCells();
 
-  /**
-   * @return maximum number of versions
-   */
+  /** Returns maximum number of versions */
   int getMaxVersions();
 
-  /**
-   * @return The minimum number of versions to keep.
-   */
+  /** Returns The minimum number of versions to keep. */
   int getMinVersions();
 
   /**
@@ -171,19 +143,13 @@ public interface ColumnFamilyDescriptor {
    */
   long getMobThreshold();
 
-  /**
-   * @return a copy of Name of this column family
-   */
+  /** Returns a copy of Name of this column family */
   byte[] getName();
 
-  /**
-   * @return Name of this column family
-   */
+  /** Returns Name of this column family */
   String getNameAsString();
 
-  /**
-   * @return the scope tag
-   */
+  /** Returns the scope tag */
   int getScope();
 
   /**
@@ -193,9 +159,7 @@ public interface ColumnFamilyDescriptor {
    */
   String getStoragePolicy();
 
-  /**
-   * @return Time-to-live of cell contents, in seconds.
-   */
+  /** Returns Time-to-live of cell contents, in seconds. */
   int getTimeToLive();
 
   /**
@@ -228,19 +192,13 @@ public interface ColumnFamilyDescriptor {
    */
   boolean isBlockCacheEnabled();
 
-  /**
-   * @return true if we should cache bloomfilter blocks on write
-   */
+  /** Returns true if we should cache bloomfilter blocks on write */
   boolean isCacheBloomsOnWrite();
 
-  /**
-   * @return true if we should cache data blocks on write
-   */
+  /** Returns true if we should cache data blocks on write */
   boolean isCacheDataOnWrite();
 
-  /**
-   * @return true if we should cache index blocks on write
-   */
+  /** Returns true if we should cache index blocks on write */
   boolean isCacheIndexesOnWrite();
 
   /**
@@ -249,9 +207,7 @@ public interface ColumnFamilyDescriptor {
    */
   boolean isCompressTags();
 
-  /**
-   * @return true if we should evict cached blocks from the blockcache on close
-   */
+  /** Returns true if we should evict cached blocks from the blockcache on close */
   boolean isEvictBlocksOnClose();
 
   /**
@@ -266,14 +222,10 @@ public interface ColumnFamilyDescriptor {
    */
   boolean isMobEnabled();
 
-  /**
-   * @return true if we should prefetch blocks into the blockcache on open
-   */
+  /** Returns true if we should prefetch blocks into the blockcache on open */
   boolean isPrefetchBlocksOnOpen();
 
-  /**
-   * @return Column family descriptor with only the customized attributes.
-   */
+  /** Returns Column family descriptor with only the customized attributes. */
   String toStringCustomizedValues();
 
   /**
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Connection.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Connection.java
index 385007703e2..b26e4d1bb43 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Connection.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Connection.java
@@ -59,9 +59,7 @@ public interface Connection extends Abortable, Closeable {
    * general methods.
    */
 
-  /**
-   * @return Configuration instance being used by this Connection instance.
-   */
+  /** Returns Configuration instance being used by this Connection instance. */
   Configuration getConfiguration();
 
   /**
@@ -182,9 +180,7 @@ public interface Connection extends Abortable, Closeable {
    */
   AsyncConnection toAsyncConnection();
 
-  /**
-   * @return the cluster ID unique to this HBase cluster.
-   */
+  /** Returns the cluster ID unique to this HBase cluster. */
   String getClusterId();
 
   /**
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ConnectionRegistryFactory.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ConnectionRegistryFactory.java
index 92c075c0f18..f198c3c2200 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ConnectionRegistryFactory.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ConnectionRegistryFactory.java
@@ -32,9 +32,7 @@ final class ConnectionRegistryFactory {
   private ConnectionRegistryFactory() {
   }
 
-  /**
-   * @return The connection registry implementation to use.
-   */
+  /** Returns The connection registry implementation to use. */
   static ConnectionRegistry getRegistry(Configuration conf) {
     Class<? extends ConnectionRegistry> clazz =
       conf.getClass(CLIENT_CONNECTION_REGISTRY_IMPL_CONF_KEY, RpcConnectionRegistry.class,
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CoprocessorDescriptor.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CoprocessorDescriptor.java
index 3331c810700..40cb5abfa96 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CoprocessorDescriptor.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/CoprocessorDescriptor.java
@@ -28,23 +28,17 @@ import org.apache.yetus.audience.InterfaceAudience;
  */
 @InterfaceAudience.Public
 public interface CoprocessorDescriptor {
-  /**
-   * @return the name of the class or interface represented by this object.
-   */
+  /** Returns the name of the class or interface represented by this object. */
   String getClassName();
 
   /**
-   * @return Path of the jar file. If it's null, the class will be loaded from default classloader.
+   * Returns Path of the jar file. If it's null, the class will be loaded from default classloader.
    */
   Optional<String> getJarPath();
 
-  /**
-   * @return The order to execute this coprocessor
-   */
+  /** Returns The order to execute this coprocessor */
   int getPriority();
 
-  /**
-   * @return Arbitrary key-value parameter pairs passed into the coprocessor.
-   */
+  /** Returns Arbitrary key-value parameter pairs passed into the coprocessor. */
   Map<String, String> getProperties();
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java
index 11da33d8106..dea15cac8d5 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java
@@ -164,9 +164,7 @@ public class Increment extends Mutation {
     return this;
   }
 
-  /**
-   * @return current setting for returnResults
-   */
+  /** Returns current setting for returnResults */
   // This method makes public the superclasses's protected method.
   @Override
   public boolean isReturnResults() {
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/MultiResponse.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/MultiResponse.java
index 97a01e1bb6e..b768b76fdb6 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/MultiResponse.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/MultiResponse.java
@@ -44,9 +44,7 @@ public class MultiResponse extends AbstractResponse {
     super();
   }
 
-  /**
-   * @return Number of pairs in this container
-   */
+  /** Returns Number of pairs in this container */
   public int size() {
     int size = 0;
     for (RegionResult result : results.values()) {
@@ -68,9 +66,7 @@ public class MultiResponse extends AbstractResponse {
     exceptions.put(regionName, ie);
   }
 
-  /**
-   * @return the exception for the region, if any. Null otherwise.
-   */
+  /** Returns the exception for the region, if any. Null otherwise. */
   public Throwable getException(byte[] regionName) {
     return exceptions.get(regionName);
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/MutableRegionInfo.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/MutableRegionInfo.java
index 22114f8f624..7627f8dc0e5 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/MutableRegionInfo.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/MutableRegionInfo.java
@@ -127,14 +127,14 @@ class MutableRegionInfo implements RegionInfo {
   }
 
   /**
-   * @return Return a short, printable name for this region (usually encoded name) for us logging.
+   * Returns Return a short, printable name for this region (usually encoded name) for us logging.
    */
   @Override
   public String getShortNameToLog() {
     return RegionInfo.prettyPrint(this.getEncodedName());
   }
 
-  /** @return the regionId */
+  /** Returns the regionId */
   @Override
   public long getRegionId() {
     return regionId;
@@ -149,15 +149,13 @@ class MutableRegionInfo implements RegionInfo {
     return regionName;
   }
 
-  /**
-   * @return Region name as a String for use in logging, etc.
-   */
+  /** Returns Region name as a String for use in logging, etc. */
   @Override
   public String getRegionNameAsString() {
     return RegionInfo.getRegionNameAsString(this, this.regionName);
   }
 
-  /** @return the encoded region name */
+  /** Returns the encoded region name */
   @Override
   public String getEncodedName() {
     return this.encodedName;
@@ -168,13 +166,13 @@ class MutableRegionInfo implements RegionInfo {
     return this.encodedNameAsBytes;
   }
 
-  /** @return the startKey */
+  /** Returns the startKey */
   @Override
   public byte[] getStartKey() {
     return startKey;
   }
 
-  /** @return the endKey */
+  /** Returns the endKey */
   @Override
   public byte[] getEndKey() {
     return endKey;
@@ -219,15 +217,13 @@ class MutableRegionInfo implements RegionInfo {
         || Bytes.equals(endKey, HConstants.EMPTY_BYTE_ARRAY));
   }
 
-  /** @return true if this region is a meta region */
+  /** Returns true if this region is a meta region */
   @Override
   public boolean isMetaRegion() {
     return tableName.equals(TableName.META_TABLE_NAME);
   }
 
-  /**
-   * @return True if has been split and has daughters.
-   */
+  /** Returns True if has been split and has daughters. */
   @Override
   public boolean isSplit() {
     return this.split;
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Mutation.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Mutation.java
index cecaed3388c..3f82e4110eb 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Mutation.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Mutation.java
@@ -326,9 +326,7 @@ public abstract class Mutation extends OperationWithAttributes
     return this;
   }
 
-  /**
-   * @return the set of clusterIds that have consumed the mutation
-   */
+  /** Returns the set of clusterIds that have consumed the mutation */
   public List<UUID> getClusterIds() {
     List<UUID> clusterIds = new ArrayList<>();
     byte[] bytes = getAttribute(CONSUMED_CLUSTER_IDS);
@@ -351,9 +349,7 @@ public abstract class Mutation extends OperationWithAttributes
     return this;
   }
 
-  /**
-   * @return CellVisibility associated with cells in this Mutation. n
-   */
+  /** Returns CellVisibility associated with cells in this Mutation. n */
   public CellVisibility getCellVisibility() throws DeserializationException {
     byte[] cellVisibilityBytes = this.getAttribute(VisibilityConstants.VISIBILITY_LABELS_ATTR_KEY);
     if (cellVisibilityBytes == null) return null;
@@ -409,16 +405,12 @@ public abstract class Mutation extends OperationWithAttributes
     return size;
   }
 
-  /**
-   * @return the number of different families
-   */
+  /** Returns the number of different families */
   public int numFamilies() {
     return getFamilyCellMap().size();
   }
 
-  /**
-   * @return Calculate what Mutation adds to class heap size.
-   */
+  /** Returns Calculate what Mutation adds to class heap size. */
   @Override
   public long heapSize() {
     long heapsize = MUTATION_OVERHEAD;
@@ -447,9 +439,7 @@ public abstract class Mutation extends OperationWithAttributes
     return ClassSize.align(heapsize);
   }
 
-  /**
-   * @return The serialized ACL for this operation, or null if none
-   */
+  /** Returns The serialized ACL for this operation, or null if none */
   public byte[] getACL() {
     return getAttribute(AccessControlConstants.OP_ATTRIBUTE_ACL);
   }
@@ -499,9 +489,7 @@ public abstract class Mutation extends OperationWithAttributes
     return this;
   }
 
-  /**
-   * @return current value for returnResults
-   */
+  /** Returns current value for returnResults */
   // Used by Increment and Append only.
   @InterfaceAudience.Private
   protected boolean isReturnResults() {
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/NonceGenerator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/NonceGenerator.java
index 3020be22105..83556e7e91a 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/NonceGenerator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/NonceGenerator.java
@@ -29,9 +29,9 @@ public interface NonceGenerator {
 
   static final String CLIENT_NONCES_ENABLED_KEY = "hbase.client.nonces.enabled";
 
-  /** @return the nonce group (client ID) of this client manager. */
+  /** Returns the nonce group (client ID) of this client manager. */
   long getNonceGroup();
 
-  /** @return New nonce. */
+  /** Returns New nonce. */
   long newNonce();
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Query.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Query.java
index ab0d9887df2..750993c1a8a 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Query.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Query.java
@@ -75,18 +75,14 @@ public abstract class Query extends OperationWithAttributes {
     return this;
   }
 
-  /**
-   * @return The authorizations this Query is associated with. n
-   */
+  /** Returns The authorizations this Query is associated with. n */
   public Authorizations getAuthorizations() throws DeserializationException {
     byte[] authorizationsBytes = this.getAttribute(VisibilityConstants.VISIBILITY_LABELS_ATTR_KEY);
     if (authorizationsBytes == null) return null;
     return ProtobufUtil.toAuthorizations(authorizationsBytes);
   }
 
-  /**
-   * @return The serialized ACL for this operation, or null if none
-   */
+  /** Returns The serialized ACL for this operation, or null if none */
   public byte[] getACL() {
     return getAttribute(AccessControlConstants.OP_ATTRIBUTE_ACL);
   }
@@ -220,9 +216,7 @@ public abstract class Query extends OperationWithAttributes {
     return this;
   }
 
-  /**
-   * @return A map of column families to time ranges
-   */
+  /** Returns A map of column families to time ranges */
   public Map<byte[], TimeRange> getColumnFamilyTimeRange() {
     return this.colFamTimeRangeMap;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RegionInfo.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RegionInfo.java
index ca1db64719e..32c7da05887 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RegionInfo.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RegionInfo.java
@@ -152,13 +152,11 @@ public interface RegionInfo extends Comparable<RegionInfo> {
   };
 
   /**
-   * @return Return a short, printable name for this region (usually encoded name) for us logging.
+   * Returns Return a short, printable name for this region (usually encoded name) for us logging.
    */
   String getShortNameToLog();
 
-  /**
-   * @return the regionId.
-   */
+  /** Returns the regionId. */
   long getRegionId();
 
   /**
@@ -167,44 +165,28 @@ public interface RegionInfo extends Comparable<RegionInfo> {
    */
   byte[] getRegionName();
 
-  /**
-   * @return Region name as a String for use in logging, etc.
-   */
+  /** Returns Region name as a String for use in logging, etc. */
   String getRegionNameAsString();
 
-  /**
-   * @return the encoded region name.
-   */
+  /** Returns the encoded region name. */
   String getEncodedName();
 
-  /**
-   * @return the encoded region name as an array of bytes.
-   */
+  /** Returns the encoded region name as an array of bytes. */
   byte[] getEncodedNameAsBytes();
 
-  /**
-   * @return the startKey.
-   */
+  /** Returns the startKey. */
   byte[] getStartKey();
 
-  /**
-   * @return the endKey.
-   */
+  /** Returns the endKey. */
   byte[] getEndKey();
 
-  /**
-   * @return current table name of the region
-   */
+  /** Returns current table name of the region */
   TableName getTable();
 
-  /**
-   * @return returns region replica id
-   */
+  /** Returns returns region replica id */
   int getReplicaId();
 
-  /**
-   * @return True if has been split and has daughters.
-   */
+  /** Returns True if has been split and has daughters. */
   boolean isSplit();
 
   /**
@@ -223,9 +205,7 @@ public interface RegionInfo extends Comparable<RegionInfo> {
   @Deprecated
   boolean isSplitParent();
 
-  /**
-   * @return true if this region is a meta region.
-   */
+  /** Returns true if this region is a meta region. */
   boolean isMetaRegion();
 
   /**
@@ -236,9 +216,7 @@ public interface RegionInfo extends Comparable<RegionInfo> {
    */
   boolean containsRange(byte[] rangeStartKey, byte[] rangeEndKey);
 
-  /**
-   * @return true if the given row falls in this region.
-   */
+  /** Returns true if the given row falls in this region. */
   boolean containsRow(byte[] row);
 
   /**
@@ -253,9 +231,7 @@ public interface RegionInfo extends Comparable<RegionInfo> {
       && (regionName[regionName.length - 1] == RegionInfo.ENC_SEPARATOR);
   }
 
-  /**
-   * @return the encodedName
-   */
+  /** Returns the encodedName */
   @InterfaceAudience.Private
   static String encodeRegionName(final byte[] regionName) {
     String encodedName;
@@ -371,7 +347,7 @@ public interface RegionInfo extends Comparable<RegionInfo> {
   }
 
   /**
-   * @return A deserialized {@link RegionInfo} or null if we failed deserialize or passed bytes null
+   * Returns A deserialized {@link RegionInfo} or null if we failed deserialize or passed bytes null
    */
   @InterfaceAudience.Private
   static RegionInfo parseFromOrNull(final byte[] bytes) {
@@ -380,7 +356,7 @@ public interface RegionInfo extends Comparable<RegionInfo> {
   }
 
   /**
-   * @return A deserialized {@link RegionInfo} or null if we failed deserialize or passed bytes null
+   * Returns A deserialized {@link RegionInfo} or null if we failed deserialize or passed bytes null
    */
   @InterfaceAudience.Private
   static RegionInfo parseFromOrNull(final byte[] bytes, int offset, int len) {
@@ -764,16 +740,12 @@ public interface RegionInfo extends Comparable<RegionInfo> {
     return ris;
   }
 
-  /**
-   * @return True if this is first Region in Table
-   */
+  /** Returns True if this is first Region in Table */
   default boolean isFirst() {
     return Bytes.equals(getStartKey(), HConstants.EMPTY_START_ROW);
   }
 
-  /**
-   * @return True if this is last Region in Table
-   */
+  /** Returns True if this is last Region in Table */
   default boolean isLast() {
     return Bytes.equals(getEndKey(), HConstants.EMPTY_END_ROW);
   }
@@ -795,9 +767,7 @@ public interface RegionInfo extends Comparable<RegionInfo> {
     return getTable().equals(other.getTable()) && areAdjacent(this, other);
   }
 
-  /**
-   * @return True if RegionInfo is degenerate... if startKey > endKey.
-   */
+  /** Returns True if RegionInfo is degenerate... if startKey > endKey. */
   default boolean isDegenerate() {
     return !isLast() && Bytes.compareTo(getStartKey(), getEndKey()) > 0;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RegionReplicaUtil.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RegionReplicaUtil.java
index ea022820950..4475a01c0f9 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RegionReplicaUtil.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RegionReplicaUtil.java
@@ -73,12 +73,12 @@ public class RegionReplicaUtil {
     return getRegionInfoForReplica(regionInfo, DEFAULT_REPLICA_ID);
   }
 
-  /** @return true if this replicaId corresponds to default replica for the region */
+  /** Returns true if this replicaId corresponds to default replica for the region */
   public static boolean isDefaultReplica(int replicaId) {
     return DEFAULT_REPLICA_ID == replicaId;
   }
 
-  /** @return true if this region is a default replica for the region */
+  /** Returns true if this region is a default replica for the region */
   public static boolean isDefaultReplica(RegionInfo hri) {
     return hri.getReplicaId() == DEFAULT_REPLICA_ID;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RequestController.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RequestController.java
index 66d864be7d4..325286fd94c 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RequestController.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RequestController.java
@@ -67,9 +67,7 @@ public interface RequestController {
     void reset() throws InterruptedIOException;
   }
 
-  /**
-   * @return A new checker for evaluating a batch rows.
-   */
+  /** Returns A new checker for evaluating a batch rows. */
   Checker newChecker();
 
   /**
@@ -86,9 +84,7 @@ public interface RequestController {
    */
   void decTaskCounters(Collection<byte[]> regions, ServerName sn);
 
-  /**
-   * @return The number of running task.
-   */
+  /** Returns The number of running task. */
   long getNumberOfTasksInProgress();
 
   /**
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Result.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Result.java
index 46865380f75..1717a9f6964 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Result.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Result.java
@@ -671,9 +671,7 @@ public class Result implements CellScannable, CellScanner {
     return this.cells == null || this.cells.length == 0;
   }
 
-  /**
-   * @return the size of the underlying Cell []
-   */
+  /** Returns the size of the underlying Cell [] */
   public int size() {
     return this.cells == null ? 0 : this.cells.length;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ResultScanner.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ResultScanner.java
index d6017a1e23f..74ff6de6f93 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ResultScanner.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/ResultScanner.java
@@ -113,8 +113,6 @@ public interface ResultScanner extends Closeable, Iterable<Result> {
    */
   boolean renewLease();
 
-  /**
-   * @return the scan metrics, or {@code null} if we do not enable metrics.
-   */
+  /** Returns the scan metrics, or {@code null} if we do not enable metrics. */
   ScanMetrics getScanMetrics();
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Row.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Row.java
index 179903706ca..cc492ba9f48 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Row.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Row.java
@@ -28,8 +28,6 @@ import org.apache.yetus.audience.InterfaceAudience;
 public interface Row {
   Comparator<Row> COMPARATOR = (v1, v2) -> Bytes.compareTo(v1.getRow(), v2.getRow());
 
-  /**
-   * @return The row.
-   */
+  /** Returns The row. */
   byte[] getRow();
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RowAccess.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RowAccess.java
index ba613bb1773..cd1f4756079 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RowAccess.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RowAccess.java
@@ -26,13 +26,9 @@ import org.apache.yetus.audience.InterfaceAudience;
  */
 @InterfaceAudience.Private
 public interface RowAccess<T> extends Iterable<T> {
-  /**
-   * @return true if there are no elements.
-   */
+  /** Returns true if there are no elements. */
   boolean isEmpty();
 
-  /**
-   * @return the number of elements in this list.
-   */
+  /** Returns the number of elements in this list. */
   int size();
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RowMutations.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RowMutations.java
index 9e9d0f1754e..0cf7f69e9b4 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RowMutations.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/RowMutations.java
@@ -98,9 +98,7 @@ public class RowMutations implements Row {
     return row;
   }
 
-  /**
-   * @return An unmodifiable list of the current mutations.
-   */
+  /** Returns An unmodifiable list of the current mutations. */
   public List<Mutation> getMutations() {
     return Collections.unmodifiableList(mutations);
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Scan.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Scan.java
index 51ac7e8d314..7e557fcfdb7 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Scan.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Scan.java
@@ -531,9 +531,7 @@ public class Scan extends Query {
     return this;
   }
 
-  /**
-   * @return the maximum result size in bytes. See {@link #setMaxResultSize(long)}
-   */
+  /** Returns the maximum result size in bytes. See {@link #setMaxResultSize(long)} */
   public long getMaxResultSize() {
     return maxResultSize;
   }
@@ -571,9 +569,7 @@ public class Scan extends Query {
     return this.familyMap;
   }
 
-  /**
-   * @return the number of families in familyMap
-   */
+  /** Returns the number of families in familyMap */
   public int numFamilies() {
     if (hasFamilies()) {
       return this.familyMap.size();
@@ -581,16 +577,12 @@ public class Scan extends Query {
     return 0;
   }
 
-  /**
-   * @return true if familyMap is non empty, false otherwise
-   */
+  /** Returns true if familyMap is non empty, false otherwise */
   public boolean hasFamilies() {
     return !this.familyMap.isEmpty();
   }
 
-  /**
-   * @return the keys of the familyMap
-   */
+  /** Returns the keys of the familyMap */
   public byte[][] getFamilies() {
     if (hasFamilies()) {
       return this.familyMap.keySet().toArray(new byte[0][0]);
@@ -598,51 +590,37 @@ public class Scan extends Query {
     return null;
   }
 
-  /**
-   * @return the startrow
-   */
+  /** Returns the startrow */
   public byte[] getStartRow() {
     return this.startRow;
   }
 
-  /**
-   * @return if we should include start row when scan
-   */
+  /** Returns if we should include start row when scan */
   public boolean includeStartRow() {
     return includeStartRow;
   }
 
-  /**
-   * @return the stoprow
-   */
+  /** Returns the stoprow */
   public byte[] getStopRow() {
     return this.stopRow;
   }
 
-  /**
-   * @return if we should include stop row when scan
-   */
+  /** Returns if we should include stop row when scan */
   public boolean includeStopRow() {
     return includeStopRow;
   }
 
-  /**
-   * @return the max number of versions to fetch
-   */
+  /** Returns the max number of versions to fetch */
   public int getMaxVersions() {
     return this.maxVersions;
   }
 
-  /**
-   * @return maximum number of values to return for a single call to next()
-   */
+  /** Returns maximum number of values to return for a single call to next() */
   public int getBatch() {
     return this.batch;
   }
 
-  /**
-   * @return maximum number of values to return per row per CF
-   */
+  /** Returns maximum number of values to return per row per CF */
   public int getMaxResultsPerColumnFamily() {
     return this.storeLimit;
   }
@@ -655,9 +633,7 @@ public class Scan extends Query {
     return this.storeOffset;
   }
 
-  /**
-   * @return caching the number of rows fetched when calling next on a scanner
-   */
+  /** Returns caching the number of rows fetched when calling next on a scanner */
   public int getCaching() {
     return this.caching;
   }
@@ -677,9 +653,7 @@ public class Scan extends Query {
     return filter;
   }
 
-  /**
-   * @return true is a filter has been specified, false if not
-   */
+  /** Returns true is a filter has been specified, false if not */
   public boolean hasFilter() {
     return filter != null;
   }
@@ -840,9 +814,7 @@ public class Scan extends Query {
     return this;
   }
 
-  /**
-   * @return True if this Scan is in "raw" mode.
-   */
+  /** Returns True if this Scan is in "raw" mode. */
   public boolean isRaw() {
     byte[] attr = getAttribute(RAW_ATTR);
     return attr == null ? false : Bytes.toBoolean(attr);
@@ -902,9 +874,7 @@ public class Scan extends Query {
     return this;
   }
 
-  /**
-   * @return True if collection of scan metrics is enabled. For advanced users.
-   */
+  /** Returns True if collection of scan metrics is enabled. For advanced users. */
   public boolean isScanMetricsEnabled() {
     byte[] attr = getAttribute(Scan.SCAN_ATTRIBUTES_METRICS_ENABLE);
     return attr == null ? false : Bytes.toBoolean(attr);
@@ -924,9 +894,7 @@ public class Scan extends Query {
     return this;
   }
 
-  /**
-   * @return the limit of rows for this scan
-   */
+  /** Returns the limit of rows for this scan */
   public int getLimit() {
     return limit;
   }
@@ -958,9 +926,7 @@ public class Scan extends Query {
     PREAD
   }
 
-  /**
-   * @return the read type for this scan
-   */
+  /** Returns the read type for this scan */
   public ReadType getReadType() {
     return readType;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptor.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptor.java
index ea60b07d63e..f960f1c748c 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptor.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptor.java
@@ -140,9 +140,7 @@ public interface TableDescriptor {
   // those tables with the highest priority (From Yi Liang over on HBASE-18109).
   int getPriority();
 
-  /**
-   * @return Returns the configured replicas per region
-   */
+  /** Returns Returns the configured replicas per region */
   int getRegionReplication();
 
   /**
@@ -187,9 +185,7 @@ public interface TableDescriptor {
    */
   String getValue(String key);
 
-  /**
-   * @return Getter for fetching an unmodifiable map.
-   */
+  /** Returns Getter for fetching an unmodifiable map. */
   Map<Bytes, Bytes> getValues();
 
   /**
@@ -206,9 +202,7 @@ public interface TableDescriptor {
    */
   boolean hasColumnFamily(final byte[] name);
 
-  /**
-   * @return true if the read-replicas memstore replication is enabled.
-   */
+  /** Returns true if the read-replicas memstore replication is enabled. */
   boolean hasRegionMemStoreReplication();
 
   /**
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptorBuilder.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptorBuilder.java
index cf12923326c..3fa39ee8e85 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptorBuilder.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptorBuilder.java
@@ -1058,9 +1058,7 @@ public class TableDescriptorBuilder {
       return families.containsKey(familyName);
     }
 
-    /**
-     * @return Name of this table and then a map of all of the column family descriptors.
-     */
+    /** Returns Name of this table and then a map of all of the column family descriptors. */
     @Override
     public String toString() {
       StringBuilder s = new StringBuilder();
@@ -1083,9 +1081,7 @@ public class TableDescriptorBuilder {
       return s.toString();
     }
 
-    /**
-     * @return map of all table attributes formatted into string.
-     */
+    /** Returns map of all table attributes formatted into string. */
     public String toStringTableAttributes() {
       return getValues(true).toString();
     }
@@ -1195,9 +1191,7 @@ public class TableDescriptorBuilder {
       return false;
     }
 
-    /**
-     * @return hash code
-     */
+    /** Returns hash code */
     @Override
     public int hashCode() {
       int result = this.name.hashCode();
@@ -1245,9 +1239,7 @@ public class TableDescriptorBuilder {
       return setValue(REGION_REPLICATION_KEY, Integer.toString(regionReplication));
     }
 
-    /**
-     * @return true if the read-replicas memstore replication is enabled.
-     */
+    /** Returns true if the read-replicas memstore replication is enabled. */
     @Override
     public boolean hasRegionMemStoreReplication() {
       return getOrDefault(REGION_MEMSTORE_REPLICATION_KEY, Boolean::valueOf,
@@ -1467,9 +1459,7 @@ public class TableDescriptorBuilder {
       }
     }
 
-    /**
-     * @return the bytes in pb format
-     */
+    /** Returns the bytes in pb format */
     private byte[] toByteArray() {
       return ProtobufUtil.prependPBMagic(ProtobufUtil.toTableSchema(this).toByteArray());
     }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableState.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableState.java
index ffd8cf8409d..6ecd97a75c9 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableState.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableState.java
@@ -94,44 +94,32 @@ public class TableState {
   private final TableName tableName;
   private final State state;
 
-  /**
-   * @return True if table is {@link State#ENABLED}.
-   */
+  /** Returns True if table is {@link State#ENABLED}. */
   public boolean isEnabled() {
     return isInStates(State.ENABLED);
   }
 
-  /**
-   * @return True if table is {@link State#ENABLING}.
-   */
+  /** Returns True if table is {@link State#ENABLING}. */
   public boolean isEnabling() {
     return isInStates(State.ENABLING);
   }
 
-  /**
-   * @return True if {@link State#ENABLED} or {@link State#ENABLING}
-   */
+  /** Returns True if {@link State#ENABLED} or {@link State#ENABLING} */
   public boolean isEnabledOrEnabling() {
     return isInStates(State.ENABLED, State.ENABLING);
   }
 
-  /**
-   * @return True if table is disabled.
-   */
+  /** Returns True if table is disabled. */
   public boolean isDisabled() {
     return isInStates(State.DISABLED);
   }
 
-  /**
-   * @return True if table is disabling.
-   */
+  /** Returns True if table is disabling. */
   public boolean isDisabling() {
     return isInStates(State.DISABLING);
   }
 
-  /**
-   * @return True if {@link State#DISABLED} or {@link State#DISABLED}
-   */
+  /** Returns True if {@link State#DISABLED} or {@link State#DISABLED} */
   public boolean isDisabledOrDisabling() {
     return isInStates(State.DISABLED, State.DISABLING);
   }
@@ -146,9 +134,7 @@ public class TableState {
     this.state = state;
   }
 
-  /**
-   * @return table state
-   */
+  /** Returns table state */
   public State getState() {
     return state;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/backoff/ClientBackoffPolicy.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/backoff/ClientBackoffPolicy.java
index ee66bcada1b..1799c27ce2c 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/backoff/ClientBackoffPolicy.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/backoff/ClientBackoffPolicy.java
@@ -32,8 +32,6 @@ public interface ClientBackoffPolicy {
 
   public static final String BACKOFF_POLICY_CLASS = "hbase.client.statistics.backoff-policy";
 
-  /**
-   * @return the number of ms to wait on the client based on the
-   */
+  /** Returns the number of ms to wait on the client based on the */
   public long getBackoffTime(ServerName serverName, byte[] region, ServerStatistics stats);
 }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/exceptions/PreemptiveFastFailException.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/exceptions/PreemptiveFastFailException.java
index 6d28f3288fd..356e90b2992 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/exceptions/PreemptiveFastFailException.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/exceptions/PreemptiveFastFailException.java
@@ -67,37 +67,27 @@ public class PreemptiveFastFailException extends ConnectException {
     this.guaranteedClientSideOnly = guaranteedClientSideOnly;
   }
 
-  /**
-   * @return time of the fist failure
-   */
+  /** Returns time of the fist failure */
   public long getFirstFailureAt() {
     return timeOfFirstFailureMilliSec;
   }
 
-  /**
-   * @return time of the latest attempt
-   */
+  /** Returns time of the latest attempt */
   public long getLastAttemptAt() {
     return timeOfLatestAttemptMilliSec;
   }
 
-  /**
-   * @return failure count
-   */
+  /** Returns failure count */
   public long getFailureCount() {
     return failureCount;
   }
 
-  /**
-   * @return true if operation was attempted by server, false otherwise.
-   */
+  /** Returns true if operation was attempted by server, false otherwise. */
   public boolean wasOperationAttemptedByServer() {
     return false;
   }
 
-  /**
-   * @return true if we know no mutation made it to the server, false otherwise.
-   */
+  /** Returns true if we know no mutation made it to the server, false otherwise. */
   public boolean isGuaranteedClientSideOnly() {
     return guaranteedClientSideOnly;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BigDecimalComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BigDecimalComparator.java
index bfd285975ff..669a591a961 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BigDecimalComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BigDecimalComparator.java
@@ -72,9 +72,7 @@ public class BigDecimalComparator extends ByteArrayComparable {
     return this.bigDecimal.compareTo(that);
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     ComparatorProtos.BigDecimalComparator.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryComparator.java
index 0c8274a8611..7aff979f4c2 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryComparator.java
@@ -54,9 +54,7 @@ public class BinaryComparator extends org.apache.hadoop.hbase.filter.ByteArrayCo
     return ByteBufferUtils.compareTo(this.value, 0, this.value.length, value, offset, length);
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     ComparatorProtos.BinaryComparator.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryComponentComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryComponentComparator.java
index 2546227fce3..8ce0092e750 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryComponentComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryComponentComparator.java
@@ -75,9 +75,7 @@ public class BinaryComponentComparator extends ByteArrayComparable {
     return result;
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     ComparatorProtos.BinaryComponentComparator.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryPrefixComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryPrefixComparator.java
index f97fd070be6..fcf447dcb0c 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryPrefixComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BinaryPrefixComparator.java
@@ -58,9 +58,7 @@ public class BinaryPrefixComparator extends ByteArrayComparable {
     return ByteBufferUtils.compareTo(this.value, 0, this.value.length, value, offset, length);
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     ComparatorProtos.BinaryPrefixComparator.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BitComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BitComparator.java
index 15ca8890aba..8abdcf4e8a6 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BitComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/BitComparator.java
@@ -57,16 +57,12 @@ public class BitComparator extends ByteArrayComparable {
     this.bitOperator = bitOperator;
   }
 
-  /**
-   * @return the bitwise operator
-   */
+  /** Returns the bitwise operator */
   public BitwiseOp getOperator() {
     return bitOperator;
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     ComparatorProtos.BitComparator.Builder builder = ComparatorProtos.BitComparator.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnCountGetFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnCountGetFilter.java
index cfaf8c27993..513f4b1e2db 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnCountGetFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnCountGetFilter.java
@@ -78,9 +78,7 @@ public class ColumnCountGetFilter extends FilterBase {
     return new ColumnCountGetFilter(limit);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.ColumnCountGetFilter.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnPaginationFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnPaginationFilter.java
index 31f607c22cc..94f7d76682c 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnPaginationFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnPaginationFilter.java
@@ -151,9 +151,7 @@ public class ColumnPaginationFilter extends FilterBase {
     return new ColumnPaginationFilter(limit, offset);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.ColumnPaginationFilter.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnPrefixFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnPrefixFilter.java
index d883c449017..5ca97e880ba 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnPrefixFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnPrefixFilter.java
@@ -102,9 +102,7 @@ public class ColumnPrefixFilter extends FilterBase {
     return new ColumnPrefixFilter(columnPrefix);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.ColumnPrefixFilter.Builder builder = FilterProtos.ColumnPrefixFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnRangeFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnRangeFilter.java
index 46465ac6d1f..2aafd300e03 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnRangeFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnRangeFilter.java
@@ -65,44 +65,32 @@ public class ColumnRangeFilter extends FilterBase {
     this.maxColumnInclusive = maxColumnInclusive;
   }
 
-  /**
-   * @return if min column range is inclusive.
-   */
+  /** Returns if min column range is inclusive. */
   public boolean isMinColumnInclusive() {
     return minColumnInclusive;
   }
 
-  /**
-   * @return if max column range is inclusive.
-   */
+  /** Returns if max column range is inclusive. */
   public boolean isMaxColumnInclusive() {
     return maxColumnInclusive;
   }
 
-  /**
-   * @return the min column range for the filter
-   */
+  /** Returns the min column range for the filter */
   public byte[] getMinColumn() {
     return this.minColumn;
   }
 
-  /**
-   * @return true if min column is inclusive, false otherwise
-   */
+  /** Returns true if min column is inclusive, false otherwise */
   public boolean getMinColumnInclusive() {
     return this.minColumnInclusive;
   }
 
-  /**
-   * @return the max column range for the filter
-   */
+  /** Returns the max column range for the filter */
   public byte[] getMaxColumn() {
     return this.maxColumn;
   }
 
-  /**
-   * @return true if max column is inclusive, false otherwise
-   */
+  /** Returns true if max column is inclusive, false otherwise */
   public boolean getMaxColumnInclusive() {
     return this.maxColumnInclusive;
   }
@@ -155,9 +143,7 @@ public class ColumnRangeFilter extends FilterBase {
     return new ColumnRangeFilter(minColumn, minColumnInclusive, maxColumn, maxColumnInclusive);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.ColumnRangeFilter.Builder builder = FilterProtos.ColumnRangeFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnValueFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnValueFilter.java
index 0074fe40a3a..0b3b85dbb47 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnValueFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ColumnValueFilter.java
@@ -75,23 +75,17 @@ public class ColumnValueFilter extends FilterBase {
     return op;
   }
 
-  /**
-   * @return the comparator
-   */
+  /** Returns the comparator */
   public ByteArrayComparable getComparator() {
     return comparator;
   }
 
-  /**
-   * @return the column family
-   */
+  /** Returns the column family */
   public byte[] getFamily() {
     return family;
   }
 
-  /**
-   * @return the qualifier
-   */
+  /** Returns the qualifier */
   public byte[] getQualifier() {
     return qualifier;
   }
@@ -161,9 +155,7 @@ public class ColumnValueFilter extends FilterBase {
     return new ColumnValueFilter(family, qualifier, operator, comparator);
   }
 
-  /**
-   * @return A pb instance to represent this instance.
-   */
+  /** Returns A pb instance to represent this instance. */
   FilterProtos.ColumnValueFilter convert() {
     FilterProtos.ColumnValueFilter.Builder builder = FilterProtos.ColumnValueFilter.newBuilder();
 
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/CompareFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/CompareFilter.java
index 1f55f848045..8e994a9feb5 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/CompareFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/CompareFilter.java
@@ -69,9 +69,7 @@ public abstract class CompareFilter extends FilterBase {
     return op;
   }
 
-  /**
-   * @return the comparator
-   */
+  /** Returns the comparator */
   public ByteArrayComparable getComparator() {
     return comparator;
   }
@@ -158,9 +156,7 @@ public abstract class CompareFilter extends FilterBase {
     return arguments;
   }
 
-  /**
-   * @return A pb instance to represent this instance.
-   */
+  /** Returns A pb instance to represent this instance. */
   FilterProtos.CompareFilter convert() {
     FilterProtos.CompareFilter.Builder builder = FilterProtos.CompareFilter.newBuilder();
     HBaseProtos.CompareType compareOp = CompareType.valueOf(this.op.name());
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/DependentColumnFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/DependentColumnFilter.java
index 1f453c6f678..da613c7f3d0 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/DependentColumnFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/DependentColumnFilter.java
@@ -92,23 +92,17 @@ public class DependentColumnFilter extends CompareFilter {
     this(family, qualifier, dropDependentColumn, CompareOperator.NO_OP, null);
   }
 
-  /**
-   * @return the column family
-   */
+  /** Returns the column family */
   public byte[] getFamily() {
     return this.columnFamily;
   }
 
-  /**
-   * @return the column qualifier
-   */
+  /** Returns the column qualifier */
   public byte[] getQualifier() {
     return this.columnQualifier;
   }
 
-  /**
-   * @return true if we should drop the dependent column, false otherwise
-   */
+  /** Returns true if we should drop the dependent column, false otherwise */
   public boolean dropDependentColumn() {
     return this.dropDependentColumn;
   }
@@ -188,9 +182,7 @@ public class DependentColumnFilter extends CompareFilter {
     }
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.DependentColumnFilter.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FamilyFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FamilyFilter.java
index 4e682eb1d37..96122e84dde 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FamilyFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FamilyFilter.java
@@ -73,9 +73,7 @@ public class FamilyFilter extends CompareFilter {
     return new FamilyFilter(compareOp, comparator);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.FamilyFilter.Builder builder = FilterProtos.FamilyFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FilterList.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FilterList.java
index be3035858f1..8dc66182d8c 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FilterList.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FilterList.java
@@ -181,9 +181,7 @@ final public class FilterList extends FilterBase {
     return filterListBase.filterRow();
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() throws IOException {
     FilterProtos.FilterList.Builder builder = FilterProtos.FilterList.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FirstKeyOnlyFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FirstKeyOnlyFilter.java
index 83f8409facc..d4797aa15e7 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FirstKeyOnlyFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FirstKeyOnlyFilter.java
@@ -65,9 +65,7 @@ public class FirstKeyOnlyFilter extends FilterBase {
     return new FirstKeyOnlyFilter();
   }
 
-  /**
-   * @return true if first KV has been found.
-   */
+  /** Returns true if first KV has been found. */
   protected boolean hasFoundKV() {
     return this.foundKV;
   }
@@ -79,9 +77,7 @@ public class FirstKeyOnlyFilter extends FilterBase {
     this.foundKV = value;
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.FirstKeyOnlyFilter.Builder builder = FilterProtos.FirstKeyOnlyFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FuzzyRowFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FuzzyRowFilter.java
index a41763fcea3..c9d9fd41832 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FuzzyRowFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FuzzyRowFilter.java
@@ -251,9 +251,7 @@ public class FuzzyRowFilter extends FilterBase {
     return done;
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.FuzzyRowFilter.Builder builder = FilterProtos.FuzzyRowFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/InclusiveStopFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/InclusiveStopFilter.java
index 7f42fb633c3..42761712034 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/InclusiveStopFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/InclusiveStopFilter.java
@@ -75,9 +75,7 @@ public class InclusiveStopFilter extends FilterBase {
     return new InclusiveStopFilter(stopRowKey);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.InclusiveStopFilter.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/KeyOnlyFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/KeyOnlyFilter.java
index 6aa410730d8..414818a3afc 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/KeyOnlyFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/KeyOnlyFilter.java
@@ -93,9 +93,7 @@ public class KeyOnlyFilter extends FilterBase {
     return filter;
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.KeyOnlyFilter.Builder builder = FilterProtos.KeyOnlyFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/LongComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/LongComparator.java
index ead0ee10447..8f9a7f1dfc3 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/LongComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/LongComparator.java
@@ -53,9 +53,7 @@ public class LongComparator extends ByteArrayComparable {
     return Long.compare(longValue, that);
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     ComparatorProtos.LongComparator.Builder builder = ComparatorProtos.LongComparator.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/MultiRowRangeFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/MultiRowRangeFilter.java
index 1fc22cfcdf7..c4676910c14 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/MultiRowRangeFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/MultiRowRangeFilter.java
@@ -176,9 +176,7 @@ public class MultiRowRangeFilter extends FilterBase {
     return PrivateCellUtil.createFirstOnRow(comparisonData, 0, (short) comparisonData.length);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.MultiRowRangeFilter.Builder builder =
@@ -469,16 +467,12 @@ public class MultiRowRangeFilter extends FilterBase {
       return stopRow;
     }
 
-    /**
-     * @return if start row is inclusive.
-     */
+    /** Returns if start row is inclusive. */
     public boolean isStartRowInclusive() {
       return startRowInclusive;
     }
 
-    /**
-     * @return if stop row is inclusive.
-     */
+    /** Returns if stop row is inclusive. */
     public boolean isStopRowInclusive() {
       return stopRowInclusive;
     }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/MultipleColumnPrefixFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/MultipleColumnPrefixFilter.java
index 0d75d16bb3b..4a969c0006e 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/MultipleColumnPrefixFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/MultipleColumnPrefixFilter.java
@@ -116,9 +116,7 @@ public class MultipleColumnPrefixFilter extends FilterBase {
     return new MultipleColumnPrefixFilter(prefixes);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.MultipleColumnPrefixFilter.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/NullComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/NullComparator.java
index fc0562ecb3e..6153e1e8080 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/NullComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/NullComparator.java
@@ -63,9 +63,7 @@ public class NullComparator extends ByteArrayComparable {
     return value != null ? 1 : 0;
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     ComparatorProtos.NullComparator.Builder builder = ComparatorProtos.NullComparator.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/PageFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/PageFilter.java
index 445adf2129e..087957fafc6 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/PageFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/PageFilter.java
@@ -91,9 +91,7 @@ public class PageFilter extends FilterBase {
     return new PageFilter(pageSize);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.PageFilter.Builder builder = FilterProtos.PageFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/PrefixFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/PrefixFilter.java
index 3b40388a06f..407b92a8604 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/PrefixFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/PrefixFilter.java
@@ -101,9 +101,7 @@ public class PrefixFilter extends FilterBase {
     return new PrefixFilter(prefix);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.PrefixFilter.Builder builder = FilterProtos.PrefixFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/QualifierFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/QualifierFilter.java
index 2d52b300ff8..f8dc591b19a 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/QualifierFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/QualifierFilter.java
@@ -67,9 +67,7 @@ public class QualifierFilter extends CompareFilter {
     return new QualifierFilter(compareOp, comparator);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.QualifierFilter.Builder builder = FilterProtos.QualifierFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RandomRowFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RandomRowFilter.java
index d54d7575f25..5340ecf3434 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RandomRowFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RandomRowFilter.java
@@ -43,9 +43,7 @@ public class RandomRowFilter extends FilterBase {
     this.chance = chance;
   }
 
-  /**
-   * @return The chance that a row gets included.
-   */
+  /** Returns The chance that a row gets included. */
   public float getChance() {
     return chance;
   }
@@ -100,9 +98,7 @@ public class RandomRowFilter extends FilterBase {
     filterOutRow = false;
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.RandomRowFilter.Builder builder = FilterProtos.RandomRowFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RegexStringComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RegexStringComparator.java
index 75272c5f241..6841c80194a 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RegexStringComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RegexStringComparator.java
@@ -145,9 +145,7 @@ public class RegexStringComparator extends ByteArrayComparable {
     return engine.compareTo(value, offset, length);
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     return engine.toByteArray();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RowFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RowFilter.java
index dee91657f74..c6c0099a9d0 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RowFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/RowFilter.java
@@ -87,9 +87,7 @@ public class RowFilter extends CompareFilter {
     return new RowFilter(compareOp, comparator);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.RowFilter.Builder builder = FilterProtos.RowFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SingleColumnValueExcludeFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SingleColumnValueExcludeFilter.java
index f1b9413718f..f9b80ee72c5 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SingleColumnValueExcludeFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SingleColumnValueExcludeFilter.java
@@ -112,9 +112,7 @@ public class SingleColumnValueExcludeFilter extends SingleColumnValueFilter {
     return filter;
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.SingleColumnValueExcludeFilter.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SingleColumnValueFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SingleColumnValueFilter.java
index 365ee06b904..9806f6387a0 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SingleColumnValueFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SingleColumnValueFilter.java
@@ -125,23 +125,17 @@ public class SingleColumnValueFilter extends FilterBase {
     return op;
   }
 
-  /**
-   * @return the comparator
-   */
+  /** Returns the comparator */
   public org.apache.hadoop.hbase.filter.ByteArrayComparable getComparator() {
     return comparator;
   }
 
-  /**
-   * @return the family
-   */
+  /** Returns the family */
   public byte[] getFamily() {
     return columnFamily;
   }
 
-  /**
-   * @return the qualifier
-   */
+  /** Returns the qualifier */
   public byte[] getQualifier() {
     return columnQualifier;
   }
@@ -283,9 +277,7 @@ public class SingleColumnValueFilter extends FilterBase {
     return builder.build();
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     return convert().toByteArray();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SkipFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SkipFilter.java
index 3aa0ef22c15..08e21fa70c2 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SkipFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SkipFilter.java
@@ -96,9 +96,7 @@ public class SkipFilter extends FilterBase {
     return true;
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() throws IOException {
     FilterProtos.SkipFilter.Builder builder = FilterProtos.SkipFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SubstringComparator.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SubstringComparator.java
index b8e33c438fe..b5fe22dca24 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SubstringComparator.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/SubstringComparator.java
@@ -66,9 +66,7 @@ public class SubstringComparator extends ByteArrayComparable {
     return Bytes.toString(value, offset, length).toLowerCase(Locale.ROOT).contains(substr) ? 0 : 1;
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   @Override
   public byte[] toByteArray() {
     ComparatorProtos.SubstringComparator.Builder builder =
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/TimestampsFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/TimestampsFilter.java
index dfd2f5c537c..853555ef511 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/TimestampsFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/TimestampsFilter.java
@@ -77,9 +77,7 @@ public class TimestampsFilter extends FilterBase {
     init();
   }
 
-  /**
-   * @return the list of timestamps
-   */
+  /** Returns the list of timestamps */
   public List<Long> getTimestamps() {
     List<Long> list = new ArrayList<>(timestamps.size());
     list.addAll(timestamps);
@@ -159,9 +157,7 @@ public class TimestampsFilter extends FilterBase {
     return new TimestampsFilter(timestamps);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.TimestampsFilter.Builder builder = FilterProtos.TimestampsFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ValueFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ValueFilter.java
index 810f71efbd6..90dda21eb52 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ValueFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/ValueFilter.java
@@ -69,9 +69,7 @@ public class ValueFilter extends CompareFilter {
     return new ValueFilter(compareOp, comparator);
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     FilterProtos.ValueFilter.Builder builder = FilterProtos.ValueFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/WhileMatchFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/WhileMatchFilter.java
index 94cdd9794b3..5d6842b15e4 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/WhileMatchFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/filter/WhileMatchFilter.java
@@ -94,9 +94,7 @@ public class WhileMatchFilter extends FilterBase {
     return true;
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() throws IOException {
     FilterProtos.WhileMatchFilter.Builder builder = FilterProtos.WhileMatchFilter.newBuilder();
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/HBaseRpcController.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/HBaseRpcController.java
index b33771e5b58..01412631ef7 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/HBaseRpcController.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/HBaseRpcController.java
@@ -60,9 +60,7 @@ public interface HBaseRpcController extends RpcController, CellScannable {
    */
   void setPriority(final TableName tn);
 
-  /**
-   * @return The priority of this request
-   */
+  /** Returns The priority of this request */
   int getPriority();
 
   int getCallTimeout();
@@ -110,16 +108,12 @@ public interface HBaseRpcController extends RpcController, CellScannable {
    */
   void notifyOnCancel(RpcCallback<Object> callback, CancellationCallback action) throws IOException;
 
-  /**
-   * @return True if this Controller is carrying the RPC target Region's RegionInfo.
-   */
+  /** Returns True if this Controller is carrying the RPC target Region's RegionInfo. */
   default boolean hasRegionInfo() {
     return false;
   }
 
-  /**
-   * @return Target Region's RegionInfo or null if not available or pertinent.
-   */
+  /** Returns Target Region's RegionInfo or null if not available or pertinent. */
   default RegionInfo getRegionInfo() {
     return null;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/HBaseRpcControllerImpl.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/HBaseRpcControllerImpl.java
index 19083c392f9..99ed5c4d48b 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/HBaseRpcControllerImpl.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/HBaseRpcControllerImpl.java
@@ -101,9 +101,7 @@ public class HBaseRpcControllerImpl implements HBaseRpcController {
     return this.regionInfo;
   }
 
-  /**
-   * @return One-shot cell scanner (you cannot back it up and restart)
-   */
+  /** Returns One-shot cell scanner (you cannot back it up and restart) */
   @Override
   public CellScanner cellScanner() {
     return cellScanner;
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/IPCUtil.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/IPCUtil.java
index 57f8da98eff..b509dcbd27b 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/IPCUtil.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/IPCUtil.java
@@ -96,9 +96,7 @@ class IPCUtil {
     return totalSize;
   }
 
-  /**
-   * @return Size on the wire when the two messages are written with writeDelimitedTo
-   */
+  /** Returns Size on the wire when the two messages are written with writeDelimitedTo */
   public static int getTotalSizeWhenWrittenDelimited(Message... messages) {
     int totalSize = 0;
     for (Message m : messages) {
@@ -149,9 +147,7 @@ class IPCUtil {
         serverOverloaded);
   }
 
-  /**
-   * @return True if the exception is a fatal connection exception.
-   */
+  /** Returns True if the exception is a fatal connection exception. */
   static boolean isFatalConnectionException(final ExceptionResponse e) {
     return e.getExceptionClassName().equals(FatalConnectionException.class.getName());
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/RemoteWithExtrasException.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/RemoteWithExtrasException.java
index 62d0bb1d455..a25708fe58e 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/RemoteWithExtrasException.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/ipc/RemoteWithExtrasException.java
@@ -123,30 +123,22 @@ public class RemoteWithExtrasException extends RemoteException {
     return ex;
   }
 
-  /**
-   * @return null if not set
-   */
+  /** Returns null if not set */
   public String getHostname() {
     return this.hostname;
   }
 
-  /**
-   * @return -1 if not set
-   */
+  /** Returns -1 if not set */
   public int getPort() {
     return this.port;
   }
 
-  /**
-   * @return True if origin exception was a do not retry type.
-   */
+  /** Returns True if origin exception was a do not retry type. */
   public boolean isDoNotRetry() {
     return this.doNotRetry;
   }
 
-  /**
-   * @return True if the server was considered overloaded when the exception was thrown.
-   */
+  /** Returns True if the server was considered overloaded when the exception was thrown. */
   public boolean isServerOverloaded() {
     return serverOverloaded;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/protobuf/ProtobufMagic.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/protobuf/ProtobufMagic.java
index 7c6f780e069..15a196cbe5b 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/protobuf/ProtobufMagic.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/protobuf/ProtobufMagic.java
@@ -77,9 +77,7 @@ public class ProtobufMagic {
     return compareTo(PB_MAGIC, 0, PB_MAGIC.length, bytes, offset, PB_MAGIC.length) == 0;
   }
 
-  /**
-   * @return Length of {@link #PB_MAGIC}
-   */
+  /** Returns Length of {@link #PB_MAGIC} */
   public static int lengthOfPBMagic() {
     return PB_MAGIC.length;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/QuotaFilter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/QuotaFilter.java
index 9ddd408f845..9dd44c56d43 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/QuotaFilter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/QuotaFilter.java
@@ -92,32 +92,32 @@ public class QuotaFilter {
     return this;
   }
 
-  /** @return true if the filter is empty */
+  /** Returns true if the filter is empty */
   public boolean isNull() {
     return !hasFilters;
   }
 
-  /** @return the QuotaType types that we want to filter one */
+  /** Returns the QuotaType types that we want to filter one */
   public Set<QuotaType> getTypeFilters() {
     return types;
   }
 
-  /** @return the Namespace filter regex */
+  /** Returns the Namespace filter regex */
   public String getNamespaceFilter() {
     return namespaceRegex;
   }
 
-  /** @return the Table filter regex */
+  /** Returns the Table filter regex */
   public String getTableFilter() {
     return tableRegex;
   }
 
-  /** @return the User filter regex */
+  /** Returns the User filter regex */
   public String getUserFilter() {
     return userRegex;
   }
 
-  /** @return the RegionServer filter regex */
+  /** Returns the RegionServer filter regex */
   public String getRegionServerFilter() {
     return regionServerRegex;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/SpaceQuotaSnapshot.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/SpaceQuotaSnapshot.java
index 4a64a170152..0dd4fd3b7d2 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/SpaceQuotaSnapshot.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/SpaceQuotaSnapshot.java
@@ -74,9 +74,7 @@ public class SpaceQuotaSnapshot implements SpaceQuotaSnapshotView {
       return policy;
     }
 
-    /**
-     * @return {@code true} if the quota is being violated, {@code false} otherwise.
-     */
+    /** Returns {@code true} if the quota is being violated, {@code false} otherwise. */
     @Override
     public boolean isInViolation() {
       return inViolation;
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/SpaceQuotaSnapshotView.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/SpaceQuotaSnapshotView.java
index 4bc47b9cddd..f7acff7a283 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/SpaceQuotaSnapshotView.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/quotas/SpaceQuotaSnapshotView.java
@@ -39,9 +39,7 @@ public interface SpaceQuotaSnapshotView {
      */
     Optional<SpaceViolationPolicy> getPolicy();
 
-    /**
-     * @return {@code true} if the quota is being violated, {@code false} otherwise.
-     */
+    /** Returns {@code true} if the quota is being violated, {@code false} otherwise. */
     boolean isInViolation();
   }
 
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/security/access/Permission.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/security/access/Permission.java
index b3ac386689e..ace6f302a19 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/security/access/Permission.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/security/access/Permission.java
@@ -203,7 +203,7 @@ public class Permission extends VersionedWritable {
     return raw.toString();
   }
 
-  /** @return the object version number */
+  /** Returns the object version number */
   @Override
   public byte getVersion() {
     return VERSION;
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/security/visibility/CellVisibility.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/security/visibility/CellVisibility.java
index 8abaee00509..05b1f6c596d 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/security/visibility/CellVisibility.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/security/visibility/CellVisibility.java
@@ -35,9 +35,7 @@ public class CellVisibility {
     this.expression = expression;
   }
 
-  /**
-   * @return The visibility expression
-   */
+  /** Returns The visibility expression */
   public String getExpression() {
     return this.expression;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/shaded/protobuf/ProtobufUtil.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/shaded/protobuf/ProtobufUtil.java
index 40b32d53c39..27bc29702f8 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/shaded/protobuf/ProtobufUtil.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/shaded/protobuf/ProtobufUtil.java
@@ -339,9 +339,7 @@ public final class ProtobufUtil {
     }
   }
 
-  /**
-   * @return Length of {@link ProtobufMagic#lengthOfPBMagic()}
-   */
+  /** Returns Length of {@link ProtobufMagic#lengthOfPBMagic()} */
   public static int lengthOfPBMagic() {
     return ProtobufMagic.lengthOfPBMagic();
   }
@@ -1689,9 +1687,7 @@ public final class ProtobufUtil {
     }
   }
 
-  /**
-   * @return A GetRegionInfoRequest for the passed in regionName.
-   */
+  /** Returns A GetRegionInfoRequest for the passed in regionName. */
   public static GetRegionInfoRequest getGetRegionInfoRequest(final byte[] regionName)
     throws IOException {
     return org.apache.hadoop.hbase.client.RegionInfo.isEncodedRegionName(regionName)
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/shaded/protobuf/RequestConverter.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/shaded/protobuf/RequestConverter.java
index addda9c5986..79efe9c8fa1 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/shaded/protobuf/RequestConverter.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/shaded/protobuf/RequestConverter.java
@@ -645,9 +645,7 @@ public final class RequestConverter {
       ProtobufUtil.toMutationNoData(MutationType.APPEND, append, mutationBuilder, nonce)));
   }
 
-  /**
-   * @return whether or not the rowMutations has a Increment or Append
-   */
+  /** Returns whether or not the rowMutations has a Increment or Append */
   private static boolean buildNoDataRegionAction(final RowMutations rowMutations,
     final List<CellScannable> cells, long nonce, final RegionAction.Builder regionActionBuilder,
     final ClientProtos.Action.Builder actionBuilder, final MutationProto.Builder mutationBuilder)
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/snapshot/HBaseSnapshotException.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/snapshot/HBaseSnapshotException.java
index 5fd62a86008..65481f7c9f6 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/snapshot/HBaseSnapshotException.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/snapshot/HBaseSnapshotException.java
@@ -69,9 +69,7 @@ public class HBaseSnapshotException extends DoNotRetryIOException {
     super(message, cause);
   }
 
-  /**
-   * @return the description of the snapshot that is being failed
-   */
+  /** Returns the description of the snapshot that is being failed */
   public SnapshotDescription getSnapshotDescription() {
     return this.description;
   }
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/zookeeper/ZNodePaths.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/zookeeper/ZNodePaths.java
index 5d73504164e..97c8302b221 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/zookeeper/ZNodePaths.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/zookeeper/ZNodePaths.java
@@ -133,9 +133,7 @@ public class ZNodePaths {
       .append(snapshotCleanupZNode).append("]").toString();
   }
 
-  /**
-   * @return the znode string corresponding to a replicaId
-   */
+  /** Returns the znode string corresponding to a replicaId */
   public String getZNodeForReplica(int replicaId) {
     if (RegionReplicaUtil.isDefaultReplica(replicaId)) {
       return joinZNode(baseZNode, metaZNodePrefix);
@@ -165,16 +163,12 @@ public class ZNodePaths {
       : Integer.parseInt(znode.substring(metaZNodePrefix.length() + 1));
   }
 
-  /**
-   * @return True if meta znode.
-   */
+  /** Returns True if meta znode. */
   public boolean isMetaZNodePrefix(String znode) {
     return znode != null && znode.startsWith(this.metaZNodePrefix);
   }
 
-  /**
-   * @return True is the fully qualified path is for meta location
-   */
+  /** Returns True is the fully qualified path is for meta location */
   public boolean isMetaZNodePath(String path) {
     int prefixLen = baseZNode.length() + 1;
     return path.length() > prefixLen && isMetaZNodePrefix(path.substring(prefixLen));
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/ArrayBackedTag.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/ArrayBackedTag.java
index 434f731883a..efa64f09e72 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/ArrayBackedTag.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/ArrayBackedTag.java
@@ -91,33 +91,25 @@ public class ArrayBackedTag implements Tag {
     this.type = bytes[offset + TAG_LENGTH_SIZE];
   }
 
-  /**
-   * @return The byte array backing this Tag.
-   */
+  /** Returns The byte array backing this Tag. */
   @Override
   public byte[] getValueArray() {
     return this.bytes;
   }
 
-  /**
-   * @return the tag type
-   */
+  /** Returns the tag type */
   @Override
   public byte getType() {
     return this.type;
   }
 
-  /**
-   * @return Length of actual tag bytes within the backed buffer
-   */
+  /** Returns Length of actual tag bytes within the backed buffer */
   @Override
   public int getValueLength() {
     return this.length - INFRASTRUCTURE_SIZE;
   }
 
-  /**
-   * @return Offset of actual tag bytes within the backed buffer
-   */
+  /** Returns Offset of actual tag bytes within the backed buffer */
   @Override
   public int getValueOffset() {
     return this.offset + INFRASTRUCTURE_SIZE;
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/ByteBufferExtendedCell.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/ByteBufferExtendedCell.java
index 824625074b5..cb3d379849e 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/ByteBufferExtendedCell.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/ByteBufferExtendedCell.java
@@ -60,53 +60,33 @@ import org.apache.yetus.audience.InterfaceAudience;
  */
 @InterfaceAudience.Private
 public abstract class ByteBufferExtendedCell implements ExtendedCell {
-  /**
-   * @return The {@link ByteBuffer} containing the row bytes.
-   */
+  /** Returns The {@link ByteBuffer} containing the row bytes. */
   public abstract ByteBuffer getRowByteBuffer();
 
-  /**
-   * @return Position in the {@link ByteBuffer} where row bytes start
-   */
+  /** Returns Position in the {@link ByteBuffer} where row bytes start */
   public abstract int getRowPosition();
 
-  /**
-   * @return The {@link ByteBuffer} containing the column family bytes.
-   */
+  /** Returns The {@link ByteBuffer} containing the column family bytes. */
   public abstract ByteBuffer getFamilyByteBuffer();
 
-  /**
-   * @return Position in the {@link ByteBuffer} where column family bytes start
-   */
+  /** Returns Position in the {@link ByteBuffer} where column family bytes start */
   public abstract int getFamilyPosition();
 
-  /**
-   * @return The {@link ByteBuffer} containing the column qualifier bytes.
-   */
+  /** Returns The {@link ByteBuffer} containing the column qualifier bytes. */
   public abstract ByteBuffer getQualifierByteBuffer();
 
-  /**
-   * @return Position in the {@link ByteBuffer} where column qualifier bytes start
-   */
+  /** Returns Position in the {@link ByteBuffer} where column qualifier bytes start */
   public abstract int getQualifierPosition();
 
-  /**
-   * @return The {@link ByteBuffer} containing the value bytes.
-   */
+  /** Returns The {@link ByteBuffer} containing the value bytes. */
   public abstract ByteBuffer getValueByteBuffer();
 
-  /**
-   * @return Position in the {@link ByteBuffer} where value bytes start
-   */
+  /** Returns Position in the {@link ByteBuffer} where value bytes start */
   public abstract int getValuePosition();
 
-  /**
-   * @return The {@link ByteBuffer} containing the tag bytes.
-   */
+  /** Returns The {@link ByteBuffer} containing the tag bytes. */
   public abstract ByteBuffer getTagsByteBuffer();
 
-  /**
-   * @return Position in the {@link ByteBuffer} where tag bytes start
-   */
+  /** Returns Position in the {@link ByteBuffer} where tag bytes start */
   public abstract int getTagsPosition();
 }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/Cell.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/Cell.java
index 4b7ab303175..4fb254b35b4 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/Cell.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/Cell.java
@@ -68,14 +68,10 @@ public interface Cell extends HeapSize {
    */
   byte[] getRowArray();
 
-  /**
-   * @return Array index of first row byte
-   */
+  /** Returns Array index of first row byte */
   int getRowOffset();
 
-  /**
-   * @return Number of row bytes. Must be &lt; rowArray.length - offset.
-   */
+  /** Returns Number of row bytes. Must be &lt; rowArray.length - offset. */
   short getRowLength();
 
   // 2) Family
@@ -87,14 +83,10 @@ public interface Cell extends HeapSize {
    */
   byte[] getFamilyArray();
 
-  /**
-   * @return Array index of first family byte
-   */
+  /** Returns Array index of first family byte */
   int getFamilyOffset();
 
-  /**
-   * @return Number of family bytes. Must be &lt; familyArray.length - offset.
-   */
+  /** Returns Number of family bytes. Must be &lt; familyArray.length - offset. */
   byte getFamilyLength();
 
   // 3) Qualifier
@@ -105,14 +97,10 @@ public interface Cell extends HeapSize {
    */
   byte[] getQualifierArray();
 
-  /**
-   * @return Array index of first qualifier byte
-   */
+  /** Returns Array index of first qualifier byte */
   int getQualifierOffset();
 
-  /**
-   * @return Number of qualifier bytes. Must be &lt; qualifierArray.length - offset.
-   */
+  /** Returns Number of qualifier bytes. Must be &lt; qualifierArray.length - offset. */
   int getQualifierLength();
 
   // 4) Timestamp
@@ -154,19 +142,13 @@ public interface Cell extends HeapSize {
    */
   byte[] getValueArray();
 
-  /**
-   * @return Array index of first value byte
-   */
+  /** Returns Array index of first value byte */
   int getValueOffset();
 
-  /**
-   * @return Number of value bytes. Must be &lt; valueArray.length - offset.
-   */
+  /** Returns Number of value bytes. Must be &lt; valueArray.length - offset. */
   int getValueLength();
 
-  /**
-   * @return Serialized size (defaults to include tag length if has some tags).
-   */
+  /** Returns Serialized size (defaults to include tag length if has some tags). */
   int getSerializedSize();
 
   /**
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/CellScannable.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/CellScannable.java
index 454f5be3bee..b194f08d4c2 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/CellScannable.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/CellScannable.java
@@ -26,8 +26,6 @@ import org.apache.yetus.audience.InterfaceAudience;
  */
 @InterfaceAudience.Public
 public interface CellScannable {
-  /**
-   * @return A CellScanner over the contained {@link Cell}s
-   */
+  /** Returns A CellScanner over the contained {@link Cell}s */
   CellScanner cellScanner();
 }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/CellScanner.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/CellScanner.java
index df2f24b5b1b..8d2573765be 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/CellScanner.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/CellScanner.java
@@ -47,9 +47,7 @@ import org.apache.yetus.audience.InterfaceAudience;
  */
 @InterfaceAudience.Public
 public interface CellScanner {
-  /**
-   * @return the current Cell which may be mutable
-   */
+  /** Returns the current Cell which may be mutable */
   Cell current();
 
   /**
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/CellUtil.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/CellUtil.java
index dc2ad3f7a06..c4d8c1aafd7 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/CellUtil.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/CellUtil.java
@@ -501,9 +501,7 @@ public final class CellUtil {
     return matchingFamily(left, fam) && matchingQualifier(left, qual);
   }
 
-  /**
-   * @return True if matching column family and the qualifier starts with <code>qual</code>
-   */
+  /** Returns True if matching column family and the qualifier starts with <code>qual</code> */
   public static boolean matchingColumnFamilyAndQualifierPrefix(final Cell left, final byte[] fam,
     final byte[] qual) {
     return matchingFamily(left, fam) && PrivateCellUtil.qualifierStartsWith(left, qual);
@@ -571,9 +569,7 @@ public final class CellUtil {
     return PrivateCellUtil.isDelete(cell.getTypeByte());
   }
 
-  /**
-   * @return True if this cell is a Put.
-   */
+  /** Returns True if this cell is a Put. */
   @SuppressWarnings("deprecation")
   public static boolean isPut(Cell cell) {
     return cell.getTypeByte() == Type.Put.getCode();
@@ -600,9 +596,7 @@ public final class CellUtil {
     PrivateCellUtil.setTimestamp(cell, Bytes.toLong(ts, tsOffset));
   }
 
-  /**
-   * @return The Key portion of the passed <code>cell</code> as a String.
-   */
+  /** Returns The Key portion of the passed <code>cell</code> as a String. */
   public static String getCellKeyAsString(Cell cell) {
     return getCellKeyAsString(cell,
       c -> Bytes.toStringBinary(c.getRowArray(), c.getRowOffset(), c.getRowLength()));
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/ChoreService.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/ChoreService.java
index 1bba8d49120..b93610f26d0 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/ChoreService.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/ChoreService.java
@@ -228,9 +228,7 @@ public class ChoreService {
     }
   }
 
-  /**
-   * @return true when the chore is scheduled with the implementer of this interface
-   */
+  /** Returns true when the chore is scheduled with the implementer of this interface */
   @InterfaceAudience.Private
   public synchronized boolean isChoreScheduled(ScheduledChore chore) {
     return chore != null && scheduledChores.containsKey(chore)
@@ -248,9 +246,7 @@ public class ChoreService {
     rescheduleChore(chore);
   }
 
-  /**
-   * @return number of chores that this service currently has scheduled
-   */
+  /** Returns number of chores that this service currently has scheduled */
   int getNumberOfScheduledChores() {
     return scheduledChores.size();
   }
@@ -263,9 +259,7 @@ public class ChoreService {
     return choresMissingStartTime.size();
   }
 
-  /**
-   * @return number of threads in the core pool of the underlying ScheduledThreadPoolExecutor
-   */
+  /** Returns number of threads in the core pool of the underlying ScheduledThreadPoolExecutor */
   int getCorePoolSize() {
     return scheduler.getCorePoolSize();
   }
@@ -375,16 +369,12 @@ public class ChoreService {
     choresMissingStartTime.clear();
   }
 
-  /**
-   * @return true when the service is shutdown and thus cannot be used anymore
-   */
+  /** Returns true when the service is shutdown and thus cannot be used anymore */
   public boolean isShutdown() {
     return scheduler.isShutdown();
   }
 
-  /**
-   * @return true when the service is shutdown and all threads have terminated
-   */
+  /** Returns true when the service is shutdown and all threads have terminated */
   public boolean isTerminated() {
     return scheduler.isTerminated();
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/ExtendedCell.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/ExtendedCell.java
index b36e1c90aa5..b3b7a1c5e57 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/ExtendedCell.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/ExtendedCell.java
@@ -86,9 +86,7 @@ public interface ExtendedCell extends RawCell, HeapSize {
       getValueLength(), getTagsLength(), withTags);
   }
 
-  /**
-   * @return Serialized size (defaults to include tag length).
-   */
+  /** Returns Serialized size (defaults to include tag length). */
   @Override
   default int getSerializedSize() {
     return getSerializedSize(true);
@@ -155,9 +153,7 @@ public interface ExtendedCell extends RawCell, HeapSize {
    */
   byte[] getTagsArray();
 
-  /**
-   * @return the first offset where the tags start in the Cell
-   */
+  /** Returns the first offset where the tags start in the Cell */
   int getTagsOffset();
 
   /**
@@ -170,8 +166,6 @@ public interface ExtendedCell extends RawCell, HeapSize {
    */
   int getTagsLength();
 
-  /**
-   * @return The byte representation of the KeyValue.TYPE of this cell: one of Put, Delete, etc
-   */
+  /** Returns The byte representation of the KeyValue.TYPE of this cell: one of Put, Delete, etc */
   byte getTypeByte();
 }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/HBaseConfiguration.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/HBaseConfiguration.java
index 17a4b71020f..59e00481982 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/HBaseConfiguration.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/HBaseConfiguration.java
@@ -158,9 +158,7 @@ public class HBaseConfiguration extends Configuration {
     }
   }
 
-  /**
-   * @return whether to show HBase Configuration in servlet
-   */
+  /** Returns whether to show HBase Configuration in servlet */
   public static boolean isShowConfInServlet() {
     boolean isShowConf = false;
     try {
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/HDFSBlocksDistribution.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/HDFSBlocksDistribution.java
index d4aa962f2b4..dcddb74b71b 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/HDFSBlocksDistribution.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/HDFSBlocksDistribution.java
@@ -71,23 +71,17 @@ public class HDFSBlocksDistribution {
       this.weightForSsd += weightForSsd;
     }
 
-    /**
-     * @return the host name
-     */
+    /** Returns the host name */
     public String getHost() {
       return host;
     }
 
-    /**
-     * @return the weight
-     */
+    /** Returns the weight */
     public long getWeight() {
       return weight;
     }
 
-    /**
-     * @return the weight for ssd
-     */
+    /** Returns the weight for ssd */
     public long getWeightForSsd() {
       return weightForSsd;
     }
@@ -186,9 +180,7 @@ public class HDFSBlocksDistribution {
     }
   }
 
-  /**
-   * @return the hosts and their weights
-   */
+  /** Returns the hosts and their weights */
   public Map<String, HostAndWeight> getHostAndWeights() {
     return this.hostAndWeights;
   }
@@ -209,9 +201,7 @@ public class HDFSBlocksDistribution {
     return weight;
   }
 
-  /**
-   * @return the sum of all unique blocks' weight
-   */
+  /** Returns the sum of all unique blocks' weight */
   public long getUniqueBlocksTotalWeight() {
     return uniqueBlocksTotalWeight;
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/KeyValue.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/KeyValue.java
index 54770da3d2e..835f0f8094c 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/KeyValue.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/KeyValue.java
@@ -1164,16 +1164,12 @@ public class KeyValue implements ExtendedCell, Cloneable {
     return this.bytes;
   }
 
-  /**
-   * @return Offset into {@link #getBuffer()} at which this KeyValue starts.
-   */
+  /** Returns Offset into {@link #getBuffer()} at which this KeyValue starts. */
   public int getOffset() {
     return this.offset;
   }
 
-  /**
-   * @return Length of bytes this KeyValue occupies in {@link #getBuffer()}.
-   */
+  /** Returns Length of bytes this KeyValue occupies in {@link #getBuffer()}. */
   public int getLength() {
     return length;
   }
@@ -1197,9 +1193,7 @@ public class KeyValue implements ExtendedCell, Cloneable {
     return klength + vlength;
   }
 
-  /**
-   * @return Key offset in backing buffer..
-   */
+  /** Returns Key offset in backing buffer.. */
   public int getKeyOffset() {
     return this.offset + ROW_OFFSET;
   }
@@ -1208,33 +1202,27 @@ public class KeyValue implements ExtendedCell, Cloneable {
     return Bytes.toStringBinary(getBuffer(), getKeyOffset(), getKeyLength());
   }
 
-  /**
-   * @return Length of key portion.
-   */
+  /** Returns Length of key portion. */
   public int getKeyLength() {
     return Bytes.toInt(this.bytes, this.offset);
   }
 
   /**
-   * @return the backing array of the entire KeyValue (all KeyValue fields are in a single array)
+   * Returns the backing array of the entire KeyValue (all KeyValue fields are in a single array)
    */
   @Override
   public byte[] getValueArray() {
     return bytes;
   }
 
-  /**
-   * @return the value offset
-   */
+  /** Returns the value offset */
   @Override
   public int getValueOffset() {
     int voffset = getKeyOffset() + getKeyLength();
     return voffset;
   }
 
-  /**
-   * @return Value length
-   */
+  /** Returns Value length */
   @Override
   public int getValueLength() {
     int vlength = Bytes.toInt(this.bytes, this.offset + Bytes.SIZEOF_INT);
@@ -1242,63 +1230,51 @@ public class KeyValue implements ExtendedCell, Cloneable {
   }
 
   /**
-   * @return the backing array of the entire KeyValue (all KeyValue fields are in a single array)
+   * Returns the backing array of the entire KeyValue (all KeyValue fields are in a single array)
    */
   @Override
   public byte[] getRowArray() {
     return bytes;
   }
 
-  /**
-   * @return Row offset
-   */
+  /** Returns Row offset */
   @Override
   public int getRowOffset() {
     return this.offset + ROW_KEY_OFFSET;
   }
 
-  /**
-   * @return Row length
-   */
+  /** Returns Row length */
   @Override
   public short getRowLength() {
     return Bytes.toShort(this.bytes, getKeyOffset());
   }
 
   /**
-   * @return the backing array of the entire KeyValue (all KeyValue fields are in a single array)
+   * Returns the backing array of the entire KeyValue (all KeyValue fields are in a single array)
    */
   @Override
   public byte[] getFamilyArray() {
     return bytes;
   }
 
-  /**
-   * @return Family offset
-   */
+  /** Returns Family offset */
   @Override
   public int getFamilyOffset() {
     return getFamilyOffset(getFamilyLengthPosition(getRowLength()));
   }
 
-  /**
-   * @return Family offset
-   */
+  /** Returns Family offset */
   int getFamilyOffset(int familyLenPosition) {
     return familyLenPosition + Bytes.SIZEOF_BYTE;
   }
 
-  /**
-   * @return Family length
-   */
+  /** Returns Family length */
   @Override
   public byte getFamilyLength() {
     return getFamilyLength(getFamilyLengthPosition(getRowLength()));
   }
 
-  /**
-   * @return Family length
-   */
+  /** Returns Family length */
   public byte getFamilyLength(int famLenPos) {
     return this.bytes[famLenPos];
   }
@@ -1308,60 +1284,46 @@ public class KeyValue implements ExtendedCell, Cloneable {
   }
 
   /**
-   * @return the backing array of the entire KeyValue (all KeyValue fields are in a single array)
+   * Returns the backing array of the entire KeyValue (all KeyValue fields are in a single array)
    */
   @Override
   public byte[] getQualifierArray() {
     return bytes;
   }
 
-  /**
-   * @return Qualifier offset
-   */
+  /** Returns Qualifier offset */
   @Override
   public int getQualifierOffset() {
     return getQualifierOffset(getFamilyOffset());
   }
 
-  /**
-   * @return Qualifier offset
-   */
+  /** Returns Qualifier offset */
   private int getQualifierOffset(int foffset) {
     return getQualifierOffset(foffset, getFamilyLength());
   }
 
-  /**
-   * @return Qualifier offset
-   */
+  /** Returns Qualifier offset */
   int getQualifierOffset(int foffset, int flength) {
     return foffset + flength;
   }
 
-  /**
-   * @return Qualifier length
-   */
+  /** Returns Qualifier length */
   @Override
   public int getQualifierLength() {
     return getQualifierLength(getRowLength(), getFamilyLength());
   }
 
-  /**
-   * @return Qualifier length
-   */
+  /** Returns Qualifier length */
   private int getQualifierLength(int rlength, int flength) {
     return getQualifierLength(getKeyLength(), rlength, flength);
   }
 
-  /**
-   * @return Qualifier length
-   */
+  /** Returns Qualifier length */
   int getQualifierLength(int keyLength, int rlength, int flength) {
     return keyLength - (int) getKeyDataStructureSize(rlength, flength, 0);
   }
 
-  /**
-   * @return Timestamp offset
-   */
+  /** Returns Timestamp offset */
   public int getTimestampOffset() {
     return getTimestampOffset(getKeyLength());
   }
@@ -1374,9 +1336,7 @@ public class KeyValue implements ExtendedCell, Cloneable {
     return getKeyOffset() + keylength - TIMESTAMP_TYPE_SIZE;
   }
 
-  /**
-   * @return True if this KeyValue has a LATEST_TIMESTAMP timestamp.
-   */
+  /** Returns True if this KeyValue has a LATEST_TIMESTAMP timestamp. */
   public boolean isLatestTimestamp() {
     return Bytes.equals(getBuffer(), getTimestampOffset(), Bytes.SIZEOF_LONG,
       HConstants.LATEST_TIMESTAMP_BYTES, 0, Bytes.SIZEOF_LONG);
@@ -1442,9 +1402,7 @@ public class KeyValue implements ExtendedCell, Cloneable {
     return Bytes.toLong(this.bytes, tsOffset);
   }
 
-  /**
-   * @return KeyValue.TYPE byte representation
-   */
+  /** Returns KeyValue.TYPE byte representation */
   @Override
   public byte getTypeByte() {
     return getTypeByte(getKeyLength());
@@ -1481,7 +1439,7 @@ public class KeyValue implements ExtendedCell, Cloneable {
   }
 
   /**
-   * @return the backing array of the entire KeyValue (all KeyValue fields are in a single array)
+   * Returns the backing array of the entire KeyValue (all KeyValue fields are in a single array)
    */
   @Override
   public byte[] getTagsArray() {
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/PrivateCellUtil.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/PrivateCellUtil.java
index 9dddfe916df..ddc89710715 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/PrivateCellUtil.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/PrivateCellUtil.java
@@ -100,16 +100,12 @@ public final class PrivateCellUtil {
     return buffer;
   }
 
-  /**
-   * @return A new cell which is having the extra tags also added to it.
-   */
+  /** Returns A new cell which is having the extra tags also added to it. */
   public static Cell createCell(Cell cell, List<Tag> tags) {
     return createCell(cell, TagUtil.fromList(tags));
   }
 
-  /**
-   * @return A new cell which is having the extra tags also added to it.
-   */
+  /** Returns A new cell which is having the extra tags also added to it. */
   public static Cell createCell(Cell cell, byte[] tags) {
     if (cell instanceof ByteBufferExtendedCell) {
       return new TagRewriteByteBufferExtendedCell((ByteBufferExtendedCell) cell, tags);
@@ -839,9 +835,7 @@ public final class PrivateCellUtil {
     return KeyValue.Type.Delete.getCode() <= type && type <= KeyValue.Type.DeleteFamily.getCode();
   }
 
-  /**
-   * @return True if this cell is a {@link KeyValue.Type#Delete} type.
-   */
+  /** Returns True if this cell is a {@link KeyValue.Type#Delete} type. */
   public static boolean isDeleteType(Cell cell) {
     return cell.getTypeByte() == KeyValue.Type.Delete.getCode();
   }
@@ -862,9 +856,7 @@ public final class PrivateCellUtil {
     return cell.getTypeByte() == KeyValue.Type.Delete.getCode();
   }
 
-  /**
-   * @return True if this cell is a delete family or column type.
-   */
+  /** Returns True if this cell is a delete family or column type. */
   public static boolean isDeleteColumnOrFamily(Cell cell) {
     int t = cell.getTypeByte();
     return t == KeyValue.Type.DeleteColumn.getCode() || t == KeyValue.Type.DeleteFamily.getCode();
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/RawCell.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/RawCell.java
index 3961e565721..b4d26dbfee9 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/RawCell.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/RawCell.java
@@ -69,9 +69,7 @@ public interface RawCell extends Cell {
     }
   }
 
-  /**
-   * @return A new cell which is having the extra tags also added to it.
-   */
+  /** Returns A new cell which is having the extra tags also added to it. */
   public static Cell createCell(Cell cell, List<Tag> tags) {
     return PrivateCellUtil.createCell(cell, tags);
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/RawCellBuilderFactory.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/RawCellBuilderFactory.java
index 50a320b1033..dec7b083e74 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/RawCellBuilderFactory.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/RawCellBuilderFactory.java
@@ -28,9 +28,7 @@ import org.apache.yetus.audience.InterfaceAudience;
 @InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.UNITTEST)
 public final class RawCellBuilderFactory {
 
-  /**
-   * @return the cell that is created
-   */
+  /** Returns the cell that is created */
   public static RawCellBuilder create() {
     return new KeyValueBuilder();
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/ScheduledChore.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/ScheduledChore.java
index 68c8d69410a..f6b6537f5d4 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/ScheduledChore.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/ScheduledChore.java
@@ -200,17 +200,13 @@ public abstract class ScheduledChore implements Runnable {
     return timeOfThisRun - timeOfLastRun;
   }
 
-  /**
-   * @return true when the time between runs exceeds the acceptable threshold
-   */
+  /** Returns true when the time between runs exceeds the acceptable threshold */
   private synchronized boolean missedStartTime() {
     return isValidTime(timeOfLastRun) && isValidTime(timeOfThisRun)
       && getTimeBetweenRuns() > getMaximumAllowedTimeBetweenRuns();
   }
 
-  /**
-   * @return max allowed time in millis between runs.
-   */
+  /** Returns max allowed time in millis between runs. */
   private double getMaximumAllowedTimeBetweenRuns() {
     // Threshold used to determine if the Chore's current run started too late
     return 1.5 * timeUnit.toMillis(period);
@@ -224,9 +220,7 @@ public abstract class ScheduledChore implements Runnable {
     return time > 0 && time <= EnvironmentEdgeManager.currentTime();
   }
 
-  /**
-   * @return false when the Chore is not currently scheduled with a ChoreService
-   */
+  /** Returns false when the Chore is not currently scheduled with a ChoreService */
   public synchronized boolean triggerNow() {
     if (choreService == null) {
       return false;
@@ -261,16 +255,12 @@ public abstract class ScheduledChore implements Runnable {
     return stopper;
   }
 
-  /**
-   * @return period to execute chore in getTimeUnit() units
-   */
+  /** Returns period to execute chore in getTimeUnit() units */
   public int getPeriod() {
     return period;
   }
 
-  /**
-   * @return initial delay before executing chore in getTimeUnit() units
-   */
+  /** Returns initial delay before executing chore in getTimeUnit() units */
   public long getInitialDelay() {
     return initialDelay;
   }
@@ -295,9 +285,7 @@ public abstract class ScheduledChore implements Runnable {
     return timeOfThisRun;
   }
 
-  /**
-   * @return true when this Chore is scheduled with a ChoreService
-   */
+  /** Returns true when this Chore is scheduled with a ChoreService */
   public synchronized boolean isScheduled() {
     return choreService != null && choreService.isChoreScheduled(this);
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/ServerName.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/ServerName.java
index 5ce49933b9a..926c18dafe2 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/ServerName.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/ServerName.java
@@ -316,9 +316,7 @@ public class ServerName implements Comparable<ServerName>, Serializable {
     return SERVERNAME_PATTERN.matcher(str).matches() ? valueOf(str) : valueOf(str, NON_STARTCODE);
   }
 
-  /**
-   * @return true if the String follows the pattern of {@link #toString()}, false otherwise.
-   */
+  /** Returns true if the String follows the pattern of {@link #toString()}, false otherwise. */
   public static boolean isFullServerName(final String str) {
     if (str == null || str.isEmpty()) {
       return false;
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/Stoppable.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/Stoppable.java
index f2d9b6b4ead..5d6b4957298 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/Stoppable.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/Stoppable.java
@@ -30,8 +30,6 @@ public interface Stoppable {
    */
   void stop(String why);
 
-  /**
-   * @return True if {@link #stop(String)} has been closed.
-   */
+  /** Returns True if {@link #stop(String)} has been closed. */
   boolean isStopped();
 }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/TableName.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/TableName.java
index a7c18d437bf..075bc5d1686 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/TableName.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/TableName.java
@@ -85,9 +85,7 @@ public final class TableName implements Comparable<TableName> {
   /** One globally disallowed name */
   public static final String DISALLOWED_TABLE_NAME = "zookeeper";
 
-  /**
-   * @return True if <code>tn</code> is the hbase:meta table name.
-   */
+  /** Returns True if <code>tn</code> is the hbase:meta table name. */
   public static boolean isMetaTableName(final TableName tn) {
     return tn.equals(TableName.META_TABLE_NAME);
   }
@@ -262,9 +260,7 @@ public final class TableName implements Comparable<TableName> {
     return qualifierAsString;
   }
 
-  /**
-   * @return A pointer to TableName as String bytes.
-   */
+  /** Returns A pointer to TableName as String bytes. */
   public byte[] toBytes() {
     return name;
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/Tag.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/Tag.java
index cf8798a0e6b..fd0aa43190b 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/Tag.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/Tag.java
@@ -46,19 +46,13 @@ public interface Tag {
    */
   public static final byte CUSTOM_TAG_TYPE_RANGE = (byte) 64;
 
-  /**
-   * @return the tag type
-   */
+  /** Returns the tag type */
   byte getType();
 
-  /**
-   * @return Offset of tag value within the backed buffer
-   */
+  /** Returns Offset of tag value within the backed buffer */
   int getValueOffset();
 
-  /**
-   * @return Length of tag value within the backed buffer
-   */
+  /** Returns Length of tag value within the backed buffer */
   int getValueLength();
 
   /**
@@ -73,9 +67,7 @@ public interface Tag {
    */
   byte[] getValueArray();
 
-  /**
-   * @return The {@link java.nio.ByteBuffer} containing the value bytes.
-   */
+  /** Returns The {@link java.nio.ByteBuffer} containing the value bytes. */
   ByteBuffer getValueByteBuffer();
 
   /**
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/TagUtil.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/TagUtil.java
index 53158800cfd..c3c49410210 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/TagUtil.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/TagUtil.java
@@ -65,9 +65,7 @@ public final class TagUtil {
     return StreamUtils.readRawVarint32(tag.getValueByteBuffer(), offset);
   }
 
-  /**
-   * @return A List&lt;Tag&gt; of any Tags found in <code>cell</code> else null.
-   */
+  /** Returns A List&lt;Tag&gt; of any Tags found in <code>cell</code> else null. */
   public static List<Tag> carryForwardTags(final Cell cell) {
     return carryForwardTags(null, cell);
   }
@@ -108,9 +106,7 @@ public final class TagUtil {
     return b;
   }
 
-  /**
-   * @return Carry forward the TTL tag.
-   */
+  /** Returns Carry forward the TTL tag. */
   public static List<Tag> carryForwardTTLTag(final List<Tag> tagsOrNull, final long ttl) {
     if (ttl == Long.MAX_VALUE) {
       return tagsOrNull;
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/codec/CellCodec.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/codec/CellCodec.java
index 10a363a5f40..e7facdbfbf2 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/codec/CellCodec.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/codec/CellCodec.java
@@ -97,9 +97,7 @@ public class CellCodec implements Codec {
         .setTimestamp(timestamp).setType(type).setValue(value).setSequenceId(memstoreTS).build();
     }
 
-    /**
-     * @return Byte array read from the stream. n
-     */
+    /** Returns Byte array read from the stream. n */
     private byte[] readByteArray(final InputStream in) throws IOException {
       byte[] intArray = new byte[Bytes.SIZEOF_INT];
       IOUtils.readFully(in, intArray);
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/codec/CellCodecWithTags.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/codec/CellCodecWithTags.java
index fe9417b23c9..75e3d48d9fa 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/codec/CellCodecWithTags.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/codec/CellCodecWithTags.java
@@ -101,9 +101,7 @@ public class CellCodecWithTags implements Codec {
         .setTags(tags).build();
     }
 
-    /**
-     * @return Byte array read from the stream. n
-     */
+    /** Returns Byte array read from the stream. n */
     private byte[] readByteArray(final InputStream in) throws IOException {
       byte[] intArray = new byte[Bytes.SIZEOF_INT];
       IOUtils.readFully(in, intArray);
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/conf/ConfigurationManager.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/conf/ConfigurationManager.java
index ea4df9450bf..3b402b01539 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/conf/ConfigurationManager.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/conf/ConfigurationManager.java
@@ -117,18 +117,14 @@ public class ConfigurationManager {
     }
   }
 
-  /**
-   * @return the number of observers.
-   */
+  /** Returns the number of observers. */
   public int getNumObservers() {
     synchronized (configurationObservers) {
       return configurationObservers.size();
     }
   }
 
-  /**
-   * @return true if contains the observer, for unit test only
-   */
+  /** Returns true if contains the observer, for unit test only */
   public boolean containsObserver(ConfigurationObserver observer) {
     synchronized (configurationObservers) {
       return configurationObservers.contains(observer);
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/filter/ByteArrayComparable.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/filter/ByteArrayComparable.java
index 332d44a84e5..480680b00f3 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/filter/ByteArrayComparable.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/filter/ByteArrayComparable.java
@@ -46,9 +46,7 @@ public abstract class ByteArrayComparable implements Comparable<byte[]> {
     return value;
   }
 
-  /**
-   * @return The comparator serialized using pb
-   */
+  /** Returns The comparator serialized using pb */
   public abstract byte[] toByteArray();
 
   /**
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/ByteArrayOutputStream.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/ByteArrayOutputStream.java
index 64bef1b83dc..d6b4c34aebb 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/ByteArrayOutputStream.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/ByteArrayOutputStream.java
@@ -116,16 +116,12 @@ public class ByteArrayOutputStream extends OutputStream implements ByteBufferWri
     buff.put(buf, 0, pos);
   }
 
-  /**
-   * @return the underlying array where the data gets accumulated
-   */
+  /** Returns the underlying array where the data gets accumulated */
   public byte[] getBuffer() {
     return this.buf;
   }
 
-  /**
-   * @return The current size of the buffer.
-   */
+  /** Returns The current size of the buffer. */
   public int size() {
     return this.pos;
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/ImmutableBytesWritable.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/ImmutableBytesWritable.java
index d5ab3ca7e9e..22b6cc08652 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/ImmutableBytesWritable.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/ImmutableBytesWritable.java
@@ -107,9 +107,7 @@ public class ImmutableBytesWritable implements WritableComparable<ImmutableBytes
     this.length = length;
   }
 
-  /**
-   * @return the number of valid bytes in the buffer
-   */
+  /** Returns the number of valid bytes in the buffer */
   public int getLength() {
     if (this.bytes == null) {
       throw new IllegalStateException(
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/TimeRange.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/TimeRange.java
index d754bc6ffc1..94a0492b5ef 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/TimeRange.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/TimeRange.java
@@ -108,16 +108,12 @@ public final class TimeRange {
     }
   }
 
-  /**
-   * @return the smallest timestamp that should be considered
-   */
+  /** Returns the smallest timestamp that should be considered */
   public long getMin() {
     return minStamp;
   }
 
-  /**
-   * @return the biggest timestamp that should be considered
-   */
+  /** Returns the biggest timestamp that should be considered */
   public long getMax() {
     return maxStamp;
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/BufferedDataBlockEncoder.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/BufferedDataBlockEncoder.java
index 8ab17285d9d..50a79f93130 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/BufferedDataBlockEncoder.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/BufferedDataBlockEncoder.java
@@ -1001,9 +1001,7 @@ abstract class BufferedDataBlockEncoder extends AbstractDataBlockEncoder {
     abstract protected void decodeNext();
   }
 
-  /**
-   * @return unencoded size added
-   */
+  /** Returns unencoded size added */
   protected final int afterEncodingKeyValue(Cell cell, DataOutputStream out,
     HFileBlockDefaultEncodingContext encodingCtx) throws IOException {
     int size = 0;
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/DataBlockEncoder.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/DataBlockEncoder.java
index 266dc26d594..7f13b2c6f66 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/DataBlockEncoder.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/DataBlockEncoder.java
@@ -129,9 +129,7 @@ public interface DataBlockEncoder {
      */
     ByteBuffer getValueShallowCopy();
 
-    /**
-     * @return the Cell at the current position. Includes memstore timestamp.
-     */
+    /** Returns the Cell at the current position. Includes memstore timestamp. */
     Cell getCell();
 
     /** Set position to beginning of given block */
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/DataBlockEncoding.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/DataBlockEncoding.java
index 54d045ba95d..71808adf75d 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/DataBlockEncoding.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/DataBlockEncoding.java
@@ -77,16 +77,12 @@ public enum DataBlockEncoding {
     this.encoderCls = encoderClsName;
   }
 
-  /**
-   * @return name converted to bytes.
-   */
+  /** Returns name converted to bytes. */
   public byte[] getNameInBytes() {
     return Bytes.toBytes(toString());
   }
 
-  /**
-   * @return The id of a data block encoder.
-   */
+  /** Returns The id of a data block encoder. */
   public short getId() {
     return id;
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/EncodedDataBlock.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/EncodedDataBlock.java
index 2c734f7803f..daef027a5ea 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/EncodedDataBlock.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/EncodedDataBlock.java
@@ -225,7 +225,7 @@ public class EncodedDataBlock {
     return getCompressedSize(comprAlgo, compressor, compressedBytes, 0, compressedBytes.length);
   }
 
-  /** @return encoded data with header */
+  /** Returns encoded data with header */
   private byte[] getEncodedData() {
     if (cachedEncodedData != null) {
       return cachedEncodedData;
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/HFileBlockDecodingContext.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/HFileBlockDecodingContext.java
index 16de5fb2669..6835a8bac3c 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/HFileBlockDecodingContext.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/HFileBlockDecodingContext.java
@@ -39,8 +39,6 @@ public interface HFileBlockDecodingContext {
   void prepareDecoding(int onDiskSizeWithoutHeader, int uncompressedSizeWithoutHeader,
     ByteBuff blockBufferWithoutHeader, ByteBuff onDiskBlock) throws IOException;
 
-  /**
-   * @return HFile meta information
-   */
+  /** Returns HFile meta information */
   HFileContext getHFileContext();
 }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/HFileBlockEncodingContext.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/HFileBlockEncodingContext.java
index 15fe5eee5ea..fcac1549b9f 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/HFileBlockEncodingContext.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/encoding/HFileBlockEncodingContext.java
@@ -31,14 +31,10 @@ import org.apache.yetus.audience.InterfaceAudience;
 @InterfaceAudience.Private
 public interface HFileBlockEncodingContext {
 
-  /**
-   * @return the block type after encoding
-   */
+  /** Returns the block type after encoding */
   BlockType getBlockType();
 
-  /**
-   * @return the {@link DataBlockEncoding} encoding used
-   */
+  /** Returns the {@link DataBlockEncoding} encoding used */
   DataBlockEncoding getDataBlockEncoding();
 
   /**
@@ -52,9 +48,7 @@ public interface HFileBlockEncodingContext {
    */
   void close();
 
-  /**
-   * @return HFile context information
-   */
+  /** Returns HFile context information */
   HFileContext getHFileContext();
 
   /**
@@ -62,9 +56,7 @@ public interface HFileBlockEncodingContext {
    */
   void setEncodingState(EncodingState state);
 
-  /**
-   * @return the encoding state
-   */
+  /** Returns the encoding state */
   EncodingState getEncodingState();
 
   /**
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockType.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockType.java
index 5c8c366a228..3bd98e6388c 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockType.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockType.java
@@ -210,9 +210,7 @@ public enum BlockType {
     }
   }
 
-  /**
-   * @return whether this block type is encoded or unencoded data block
-   */
+  /** Returns whether this block type is encoded or unencoded data block */
   public final boolean isData() {
     return this == DATA || this == ENCODED_DATA;
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileContext.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileContext.java
index 843c65a5f41..5064c4a4b8f 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileContext.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileContext.java
@@ -119,9 +119,7 @@ public class HFileContext implements HeapSize, Cloneable {
       : CellComparator.getInstance();
   }
 
-  /**
-   * @return true when on-disk blocks are compressed, and/or encrypted; false otherwise.
-   */
+  /** Returns true when on-disk blocks are compressed, and/or encrypted; false otherwise. */
   public boolean isCompressedOrEncrypted() {
     Compression.Algorithm compressAlgo = getCompression();
     boolean compressed = compressAlgo != null && compressAlgo != Compression.Algorithm.NONE;
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/nio/ByteBuff.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/nio/ByteBuff.java
index 2925fab161b..2285917364f 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/nio/ByteBuff.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/nio/ByteBuff.java
@@ -80,9 +80,7 @@ public abstract class ByteBuff implements HBaseReferenceCounted {
 
   /******************************* Methods for ByteBuff **************************************/
 
-  /**
-   * @return this ByteBuff's current position
-   */
+  /** Returns this ByteBuff's current position */
   public abstract int position();
 
   /**
@@ -102,9 +100,7 @@ public abstract class ByteBuff implements HBaseReferenceCounted {
    */
   public abstract ByteBuff moveBack(int len);
 
-  /**
-   * @return the total capacity of this ByteBuff.
-   */
+  /** Returns the total capacity of this ByteBuff. */
   public abstract int capacity();
 
   /**
@@ -263,19 +259,13 @@ public abstract class ByteBuff implements HBaseReferenceCounted {
    */
   public abstract ByteBuff put(byte[] src);
 
-  /**
-   * @return true or false if the underlying BB support hasArray
-   */
+  /** Returns true or false if the underlying BB support hasArray */
   public abstract boolean hasArray();
 
-  /**
-   * @return the byte[] if the underlying BB has single BB and hasArray true
-   */
+  /** Returns the byte[] if the underlying BB has single BB and hasArray true */
   public abstract byte[] array();
 
-  /**
-   * @return the arrayOffset of the byte[] incase of a single BB backed ByteBuff
-   */
+  /** Returns the arrayOffset of the byte[] incase of a single BB backed ByteBuff */
   public abstract int arrayOffset();
 
   /**
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/nio/MultiByteBuff.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/nio/MultiByteBuff.java
index a3c0b5c528c..042b21f6c00 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/nio/MultiByteBuff.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/nio/MultiByteBuff.java
@@ -131,17 +131,13 @@ public class MultiByteBuff extends ByteBuff {
     throw new UnsupportedOperationException();
   }
 
-  /**
-   * @return false. MBB does not support array based operations
-   */
+  /** Returns false. MBB does not support array based operations */
   @Override
   public boolean hasArray() {
     return false;
   }
 
-  /**
-   * @return the total capacity of this MultiByteBuffer.
-   */
+  /** Returns the total capacity of this MultiByteBuffer. */
   @Override
   public int capacity() {
     checkRefCount();
@@ -384,9 +380,7 @@ public class MultiByteBuff extends ByteBuff {
     return getLong(index, itemIndex);
   }
 
-  /**
-   * @return this MBB's current position
-   */
+  /** Returns this MBB's current position */
   @Override
   public int position() {
     checkRefCount();
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/security/User.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/security/User.java
index a353f11c488..e7d37069ac5 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/security/User.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/security/User.java
@@ -129,9 +129,7 @@ public abstract class User {
     ugi.addToken(token);
   }
 
-  /**
-   * @return true if user credentials are obtained from keytab.
-   */
+  /** Returns true if user credentials are obtained from keytab. */
   public boolean isLoginFromKeytab() {
     return ugi.isFromKeytab();
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/security/UserProvider.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/security/UserProvider.java
index 5f1f65f40ee..f6766bd1f3c 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/security/UserProvider.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/security/UserProvider.java
@@ -149,9 +149,7 @@ public class UserProvider extends BaseConfigurable {
     return user == null ? null : user.getName();
   }
 
-  /**
-   * @return <tt>true</tt> if security is enabled, <tt>false</tt> otherwise
-   */
+  /** Returns <tt>true</tt> if security is enabled, <tt>false</tt> otherwise */
   public boolean isHBaseSecurityEnabled() {
     return User.isHBaseSecurityEnabled(this.getConf());
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/AbstractByteRange.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/AbstractByteRange.java
index f2bf5cfa36d..c5fbf52fd46 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/AbstractByteRange.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/AbstractByteRange.java
@@ -152,9 +152,7 @@ public abstract class AbstractByteRange implements ByteRange {
     return isEmpty(this);
   }
 
-  /**
-   * @return true when {@code range} is of zero length, false otherwise.
-   */
+  /** Returns true when {@code range} is of zero length, false otherwise. */
   public static boolean isEmpty(ByteRange range) {
     return range == null || range.getLength() == 0;
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/ByteRange.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/ByteRange.java
index 129f17d54df..64bd5cb3b6c 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/ByteRange.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/ByteRange.java
@@ -120,9 +120,7 @@ public interface ByteRange extends Comparable<ByteRange> {
    */
   public ByteRange setLength(int length);
 
-  /**
-   * @return true when this range is of zero length, false otherwise.
-   */
+  /** Returns true when this range is of zero length, false otherwise. */
   public boolean isEmpty();
 
   /**
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/Bytes.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/Bytes.java
index 2d5e7f4266d..6fd2b01a078 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/Bytes.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/Bytes.java
@@ -202,9 +202,7 @@ public class Bytes implements Comparable<Bytes> {
     this.length = length;
   }
 
-  /**
-   * @return the number of valid bytes in the buffer
-   */
+  /** Returns the number of valid bytes in the buffer */
   public int getLength() {
     if (this.bytes == null) {
       throw new IllegalStateException(
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/ExceptionUtil.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/ExceptionUtil.java
index 26625a2862e..d3b0e82b1dc 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/ExceptionUtil.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/ExceptionUtil.java
@@ -33,9 +33,7 @@ public final class ExceptionUtil {
   private ExceptionUtil() {
   }
 
-  /**
-   * @return true if the throwable comes an interruption, false otherwise.
-   */
+  /** Returns true if the throwable comes an interruption, false otherwise. */
   public static boolean isInterrupt(Throwable t) {
     if (t instanceof InterruptedException) {
       return true;
@@ -59,9 +57,7 @@ public final class ExceptionUtil {
     }
   }
 
-  /**
-   * @return an InterruptedIOException if t was an interruption, null otherwise
-   */
+  /** Returns an InterruptedIOException if t was an interruption, null otherwise */
   public static InterruptedIOException asInterrupt(Throwable t) {
     if (t instanceof SocketTimeoutException) {
       return null;
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/HashKey.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/HashKey.java
index cf573aa394e..e4e89f7711f 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/HashKey.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/HashKey.java
@@ -36,8 +36,6 @@ public abstract class HashKey<T> {
    */
   public abstract byte get(int pos);
 
-  /**
-   * @return The number of bytes in this HashKey
-   */
+  /** Returns The number of bytes in this HashKey */
   public abstract int length();
 }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/Sleeper.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/Sleeper.java
index 23ca92251c1..8fdcc189ea8 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/Sleeper.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/Sleeper.java
@@ -105,9 +105,7 @@ public class Sleeper {
     }
   }
 
-  /**
-   * @return the sleep period in milliseconds
-   */
+  /** Returns the sleep period in milliseconds */
   public final int getPeriod() {
     return period;
   }
diff --git a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/WindowMovingAverage.java b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/WindowMovingAverage.java
index b79109cc991..b79924a352c 100644
--- a/hbase-common/src/main/java/org/apache/hadoop/hbase/util/WindowMovingAverage.java
+++ b/hbase-common/src/main/java/org/apache/hadoop/hbase/util/WindowMovingAverage.java
@@ -66,9 +66,7 @@ public class WindowMovingAverage extends MovingAverage {
     return oneRound;
   }
 
-  /**
-   * @return number of statistics
-   */
+  /** Returns number of statistics */
   protected int getNumberOfStatistics() {
     return lastN.length;
   }
@@ -85,9 +83,7 @@ public class WindowMovingAverage extends MovingAverage {
     return lastN[index];
   }
 
-  /**
-   * @return index of most recent
-   */
+  /** Returns index of most recent */
   protected int getMostRecentPosistion() {
     return mostRecent;
   }
diff --git a/hbase-common/src/test/java/org/apache/hadoop/hbase/net/BoundSocketMaker.java b/hbase-common/src/test/java/org/apache/hadoop/hbase/net/BoundSocketMaker.java
index 69f072a0c6d..c8eb875ec0e 100644
--- a/hbase-common/src/test/java/org/apache/hadoop/hbase/net/BoundSocketMaker.java
+++ b/hbase-common/src/test/java/org/apache/hadoop/hbase/net/BoundSocketMaker.java
@@ -53,9 +53,7 @@ public final class BoundSocketMaker implements Closeable {
     return this.socket.getLocalPort();
   }
 
-  /**
-   * @return Returns a bound socket; be sure to close when done.
-   */
+  /** Returns Returns a bound socket; be sure to close when done. */
   private ServerSocket get(String hostname, Supplier<Integer> randomPortMaker) {
     ServerSocket ss = null;
     int port = -1;
diff --git a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/master/MetricsAssignmentManagerSource.java b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/master/MetricsAssignmentManagerSource.java
index 76a70edbddf..6870c60838d 100644
--- a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/master/MetricsAssignmentManagerSource.java
+++ b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/master/MetricsAssignmentManagerSource.java
@@ -166,43 +166,27 @@ public interface MetricsAssignmentManagerSource extends BaseSource {
    */
   void incrementOperationCounter();
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for assign region operation
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for assign region operation */
   OperationMetrics getAssignMetrics();
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for unassign region operation
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for unassign region operation */
   OperationMetrics getUnassignMetrics();
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for move region operation
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for move region operation */
   OperationMetrics getMoveMetrics();
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for reopen region operation
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for reopen region operation */
   OperationMetrics getReopenMetrics();
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for open region request
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for open region request */
   OperationMetrics getOpenMetrics();
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for close region request
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for close region request */
   OperationMetrics getCloseMetrics();
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for split operation
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for split operation */
   OperationMetrics getSplitMetrics();
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for merge operation
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for merge operation */
   OperationMetrics getMergeMetrics();
 }
diff --git a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/master/MetricsMasterSource.java b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/master/MetricsMasterSource.java
index 01bf79b5fa1..4a5b97ae66b 100644
--- a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/master/MetricsMasterSource.java
+++ b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/master/MetricsMasterSource.java
@@ -110,8 +110,6 @@ public interface MetricsMasterSource extends BaseSource {
    */
   void incWriteRequests(final long inc);
 
-  /**
-   * @return {@link OperationMetrics} containing common metrics for server crash operation
-   */
+  /** Returns {@link OperationMetrics} containing common metrics for server crash operation */
   OperationMetrics getServerCrashMetrics();
 }
diff --git a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsRegionServerWrapper.java b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsRegionServerWrapper.java
index 7367897711f..8da0843727e 100644
--- a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsRegionServerWrapper.java
+++ b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsRegionServerWrapper.java
@@ -121,24 +121,16 @@ public interface MetricsRegionServerWrapper {
    */
   double getStoreFileSizeGrowthRate();
 
-  /**
-   * @return Max age of store files hosted on this region server
-   */
+  /** Returns Max age of store files hosted on this region server */
   long getMaxStoreFileAge();
 
-  /**
-   * @return Min age of store files hosted on this region server
-   */
+  /** Returns Min age of store files hosted on this region server */
   long getMinStoreFileAge();
 
-  /**
-   * @return Average age of store files hosted on this region server
-   */
+  /** Returns Average age of store files hosted on this region server */
   long getAvgStoreFileAge();
 
-  /**
-   * @return Number of reference files on this region server
-   */
+  /** Returns Number of reference files on this region server */
   long getNumReferenceFiles();
 
   /**
@@ -517,43 +509,29 @@ public interface MetricsRegionServerWrapper {
    */
   double getMobFileCacheHitPercent();
 
-  /**
-   * @return Count of hedged read operations
-   */
+  /** Returns Count of hedged read operations */
   long getHedgedReadOps();
 
-  /**
-   * @return Count of times a hedged read beat out the primary read.
-   */
+  /** Returns Count of times a hedged read beat out the primary read. */
   long getHedgedReadWins();
 
-  /**
-   * @return Count of times a hedged read executes in current thread
-   */
+  /** Returns Count of times a hedged read executes in current thread */
   long getHedgedReadOpsInCurThread();
 
-  /**
-   * @return Number of total bytes read from HDFS.
-   */
+  /** Returns Number of total bytes read from HDFS. */
   long getTotalBytesRead();
 
-  /**
-   * @return Number of bytes read from the local HDFS DataNode.
-   */
+  /** Returns Number of bytes read from the local HDFS DataNode. */
   long getLocalBytesRead();
 
-  /**
-   * @return Number of bytes read locally through HDFS short circuit.
-   */
+  /** Returns Number of bytes read locally through HDFS short circuit. */
   long getShortCircuitBytesRead();
 
-  /**
-   * @return Number of bytes read locally through HDFS zero copy.
-   */
+  /** Returns Number of bytes read locally through HDFS zero copy. */
   long getZeroCopyBytesRead();
 
   /**
-   * @return Count of requests blocked because the memstore size is larger than blockingMemStoreSize
+   * Returns Count of requests blocked because the memstore size is larger than blockingMemStoreSize
    */
   long getBlockedRequestsCount();
 
diff --git a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsRegionWrapper.java b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsRegionWrapper.java
index 5714a054277..35fa4bc942e 100644
--- a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsRegionWrapper.java
+++ b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsRegionWrapper.java
@@ -80,24 +80,16 @@ public interface MetricsRegionWrapper {
    */
   long getFilteredReadRequestCount();
 
-  /**
-   * @return Max age of store files under this region
-   */
+  /** Returns Max age of store files under this region */
   long getMaxStoreFileAge();
 
-  /**
-   * @return Min age of store files under this region
-   */
+  /** Returns Min age of store files under this region */
   long getMinStoreFileAge();
 
-  /**
-   * @return Average age of store files under this region
-   */
+  /** Returns Average age of store files under this region */
   long getAvgStoreFileAge();
 
-  /**
-   * @return Number of reference files under this region
-   */
+  /** Returns Number of reference files under this region */
   long getNumReferenceFiles();
 
   /**
@@ -113,9 +105,7 @@ public interface MetricsRegionWrapper {
 
   long getNumCompactionsCompleted();
 
-  /**
-   * @return Age of the last major compaction
-   */
+  /** Returns Age of the last major compaction */
   long getLastMajorCompactionAge();
 
   /**
@@ -156,9 +146,7 @@ public interface MetricsRegionWrapper {
    */
   int getReplicaId();
 
-  /**
-   * @return the number of references active on the store
-   */
+  /** Returns the number of references active on the store */
   long getStoreRefCount();
 
   /**
@@ -167,14 +155,10 @@ public interface MetricsRegionWrapper {
    */
   long getMaxCompactedStoreFileRefCount();
 
-  /**
-   * @return the number of row reads completely on memstore per store
-   */
+  /** Returns the number of row reads completely on memstore per store */
   Map<String, Long> getMemstoreOnlyRowReadsCount();
 
-  /**
-   * @return the number of row reads on memstore and file per store
-   */
+  /** Returns the number of row reads on memstore and file per store */
   Map<String, Long> getMixedRowReadsCount();
 
 }
diff --git a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsTableWrapperAggregate.java b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsTableWrapperAggregate.java
index 066628f5a74..acbee1d2883 100644
--- a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsTableWrapperAggregate.java
+++ b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsTableWrapperAggregate.java
@@ -93,33 +93,21 @@ public interface MetricsTableWrapperAggregate {
    */
   long getMaxStoreFiles(String table);
 
-  /**
-   * @return Max age of store files for this table
-   */
+  /** Returns Max age of store files for this table */
   long getMaxStoreFileAge(String table);
 
-  /**
-   * @return Min age of store files for this table
-   */
+  /** Returns Min age of store files for this table */
   long getMinStoreFileAge(String table);
 
-  /**
-   * @return Average age of store files for this table
-   */
+  /** Returns Average age of store files for this table */
   long getAvgStoreFileAge(String table);
 
-  /**
-   * @return Number of reference files for this table
-   */
+  /** Returns Number of reference files for this table */
   long getNumReferenceFiles(String table);
 
-  /**
-   * @return number of row reads completely from memstore per store for this table
-   */
+  /** Returns number of row reads completely from memstore per store for this table */
   Map<String, Long> getMemstoreOnlyRowReadsCount(String table);
 
-  /**
-   * @return number of row reads from file and memstore per store for this table
-   */
+  /** Returns number of row reads from file and memstore per store for this table */
   Map<String, Long> getMixedRowReadsCount(String table);
 }
diff --git a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/metrics2/lib/DynamicMetricsRegistry.java b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/metrics2/lib/DynamicMetricsRegistry.java
index 7177f322210..f1b1196cea4 100644
--- a/hbase-hadoop-compat/src/main/java/org/apache/hadoop/metrics2/lib/DynamicMetricsRegistry.java
+++ b/hbase-hadoop-compat/src/main/java/org/apache/hadoop/metrics2/lib/DynamicMetricsRegistry.java
@@ -68,9 +68,7 @@ public class DynamicMetricsRegistry {
     metricsInfo = info;
   }
 
-  /**
-   * @return the info object of the metrics registry
-   */
+  /** Returns the info object of the metrics registry */
   public MetricsInfo info() {
     return metricsInfo;
   }
diff --git a/hbase-http/src/main/java/org/apache/hadoop/hbase/util/JSONBean.java b/hbase-http/src/main/java/org/apache/hadoop/hbase/util/JSONBean.java
index 2360dcb32a2..687b1e34041 100644
--- a/hbase-http/src/main/java/org/apache/hadoop/hbase/util/JSONBean.java
+++ b/hbase-http/src/main/java/org/apache/hadoop/hbase/util/JSONBean.java
@@ -129,9 +129,7 @@ public class JSONBean {
     };
   }
 
-  /**
-   * @return Return non-zero if failed to find bean. 0
-   */
+  /** Returns Return non-zero if failed to find bean. 0 */
   private static int write(JsonWriter writer, MBeanServer mBeanServer, ObjectName qry,
     String attribute, boolean description, ObjectName excluded) throws IOException {
     LOG.debug("Listing beans for {}", qry);
diff --git a/hbase-it/src/test/java/org/apache/hadoop/hbase/IntegrationTestBackupRestore.java b/hbase-it/src/test/java/org/apache/hadoop/hbase/IntegrationTestBackupRestore.java
index e5b00aafdc3..fd360943289 100644
--- a/hbase-it/src/test/java/org/apache/hadoop/hbase/IntegrationTestBackupRestore.java
+++ b/hbase-it/src/test/java/org/apache/hadoop/hbase/IntegrationTestBackupRestore.java
@@ -365,9 +365,7 @@ public class IntegrationTestBackupRestore extends IntegrationTestBase {
     LOG.debug("Done initializing/checking cluster");
   }
 
-  /**
-   * @return status of CLI execution
-   */
+  /** Returns status of CLI execution */
   @Override
   public int runTestFromCommandLine() throws Exception {
     // Check if backup is enabled
diff --git a/hbase-it/src/test/java/org/apache/hadoop/hbase/IntegrationTestMobCompaction.java b/hbase-it/src/test/java/org/apache/hadoop/hbase/IntegrationTestMobCompaction.java
index 5e6a9e4d7c4..0d9d9886db0 100644
--- a/hbase-it/src/test/java/org/apache/hadoop/hbase/IntegrationTestMobCompaction.java
+++ b/hbase-it/src/test/java/org/apache/hadoop/hbase/IntegrationTestMobCompaction.java
@@ -163,9 +163,7 @@ public class IntegrationTestMobCompaction extends IntegrationTestBase {
     LOG.debug("Done initializing/checking cluster");
   }
 
-  /**
-   * @return status of CLI execution
-   */
+  /** Returns status of CLI execution */
   @Override
   public int runTestFromCommandLine() throws Exception {
     testMobCompaction();
diff --git a/hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapred/TableSplit.java b/hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapred/TableSplit.java
index 8cc03b22254..2cb63ba7a6a 100644
--- a/hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapred/TableSplit.java
+++ b/hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapred/TableSplit.java
@@ -56,27 +56,27 @@ public class TableSplit implements InputSplit, Comparable<TableSplit> {
     this(TableName.valueOf(tableName), startRow, endRow, location);
   }
 
-  /** @return table name */
+  /** Returns table name */
   public TableName getTable() {
     return this.m_tableName;
   }
 
-  /** @return table name */
+  /** Returns table name */
   public byte[] getTableName() {
     return this.m_tableName.getName();
   }
 
-  /** @return starting row key */
+  /** Returns starting row key */
   public byte[] getStartRow() {
     return this.m_startRow;
   }
 
-  /** @return end row key */
+  /** Returns end row key */
   public byte[] getEndRow() {
     return this.m_endRow;
   }
 
-  /** @return the region's hostname */
+  /** Returns the region's hostname */
   public String getRegionLocation() {
     return this.m_regionLocation;
   }
diff --git a/hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapreduce/CellCreator.java b/hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapreduce/CellCreator.java
index bc2f8040db1..a48ba49058a 100644
--- a/hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapreduce/CellCreator.java
+++ b/hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapreduce/CellCreator.java
@@ -120,9 +120,7 @@ public class CellCreator {
       qlength, timestamp, KeyValue.Type.Put, value, voffset, vlength, tags);
   }
 
-  /**
-   * @return Visibility expression resolver
-   */
+  /** Returns Visibility expression resolver */
   public VisibilityExpressionResolver getVisibilityExpressionResolver() {
     return this.visExpResolver;
   }
diff --git a/hbase-mapreduce/src/test/java/org/apache/hadoop/hbase/PerformanceEvaluation.java b/hbase-mapreduce/src/test/java/org/apache/hadoop/hbase/PerformanceEvaluation.java
index 1c5553b3d07..93d439f1608 100644
--- a/hbase-mapreduce/src/test/java/org/apache/hadoop/hbase/PerformanceEvaluation.java
+++ b/hbase-mapreduce/src/test/java/org/apache/hadoop/hbase/PerformanceEvaluation.java
@@ -1415,16 +1415,12 @@ public class PerformanceEvaluation extends Configured implements Tool {
       }
     }
 
-    /**
-     * @return Subset of the histograms' calculation.
-     */
+    /** Returns Subset of the histograms' calculation. */
     public String getShortLatencyReport() {
       return YammerHistogramUtils.getShortHistogramReport(this.latencyHistogram);
     }
 
-    /**
-     * @return Subset of the histograms' calculation.
-     */
+    /** Returns Subset of the histograms' calculation. */
     public String getShortValueSizeReport() {
       return YammerHistogramUtils.getShortHistogramReport(this.valueSizeHistogram);
     }
diff --git a/hbase-mapreduce/src/test/java/org/apache/hadoop/hbase/mapreduce/TestRoundRobinTableInputFormat.java b/hbase-mapreduce/src/test/java/org/apache/hadoop/hbase/mapreduce/TestRoundRobinTableInputFormat.java
index df9d1597857..34bd76937d3 100644
--- a/hbase-mapreduce/src/test/java/org/apache/hadoop/hbase/mapreduce/TestRoundRobinTableInputFormat.java
+++ b/hbase-mapreduce/src/test/java/org/apache/hadoop/hbase/mapreduce/TestRoundRobinTableInputFormat.java
@@ -77,9 +77,7 @@ public class TestRoundRobinTableInputFormat {
     }
   }
 
-  /**
-   * @return Splits made out of {@link #KEYS}. Splits are for five Servers. Length is ZERO!
-   */
+  /** Returns Splits made out of {@link #KEYS}. Splits are for five Servers. Length is ZERO! */
   private List<InputSplit> createSplits() {
     List<InputSplit> splits = new ArrayList<>(KEYS.length - 1);
     for (int i = 0; i < KEYS.length - 1; i++) {
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/LockAndQueue.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/LockAndQueue.java
index e6b7d7d0397..fa6c72c490f 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/LockAndQueue.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/LockAndQueue.java
@@ -105,9 +105,7 @@ public class LockAndQueue implements LockStatus {
   // try/release Shared/Exclusive lock
   // ======================================================================
 
-  /**
-   * @return whether we have succesfully acquired the shared lock.
-   */
+  /** Returns whether we have succesfully acquired the shared lock. */
   public boolean trySharedLock(Procedure<?> proc) {
     if (hasExclusiveLock() && !hasLockAccess(proc)) {
       return false;
@@ -119,9 +117,7 @@ public class LockAndQueue implements LockStatus {
     return true;
   }
 
-  /**
-   * @return whether we should wake the procedures waiting on the lock here.
-   */
+  /** Returns whether we should wake the procedures waiting on the lock here. */
   public boolean releaseSharedLock() {
     // hasExclusiveLock could be true, it usually means we acquire shared lock while we or our
     // parent have held the xlock. And since there is still an exclusive lock, we do not need to
@@ -137,9 +133,7 @@ public class LockAndQueue implements LockStatus {
     return true;
   }
 
-  /**
-   * @return whether we should wake the procedures waiting on the lock here.
-   */
+  /** Returns whether we should wake the procedures waiting on the lock here. */
   public boolean releaseExclusiveLock(Procedure<?> proc) {
     if (
       exclusiveLockOwnerProcedure == null
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/Procedure.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/Procedure.java
index 28b2aa87f65..34c74d92c16 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/Procedure.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/Procedure.java
@@ -625,9 +625,7 @@ public abstract class Procedure<TEnvironment> implements Comparable<Procedure<TE
     return timeout != NO_TIMEOUT;
   }
 
-  /**
-   * @return the timeout in msec
-   */
+  /** Returns the timeout in msec */
   public int getTimeout() {
     return timeout;
   }
@@ -662,16 +660,12 @@ public abstract class Procedure<TEnvironment> implements Comparable<Procedure<TE
   // ==========================================================================
   // runtime state
   // ==========================================================================
-  /**
-   * @return the time elapsed between the last update and the start time of the procedure.
-   */
+  /** Returns the time elapsed between the last update and the start time of the procedure. */
   public long elapsedTime() {
     return getLastUpdate() - getSubmittedTime();
   }
 
-  /**
-   * @return the serialized result if any, otherwise null
-   */
+  /** Returns the serialized result if any, otherwise null */
   public byte[] getResult() {
     return result;
   }
@@ -714,9 +708,7 @@ public abstract class Procedure<TEnvironment> implements Comparable<Procedure<TE
   // just because the procedure can get scheduled on different executor threads on each step.
   // ==============================================================================================
 
-  /**
-   * @return true if the procedure is in a RUNNABLE state.
-   */
+  /** Returns true if the procedure is in a RUNNABLE state. */
   public synchronized boolean isRunnable() {
     return state == ProcedureState.RUNNABLE;
   }
@@ -725,16 +717,12 @@ public abstract class Procedure<TEnvironment> implements Comparable<Procedure<TE
     return state == ProcedureState.INITIALIZING;
   }
 
-  /**
-   * @return true if the procedure has failed. It may or may not have rolled back.
-   */
+  /** Returns true if the procedure has failed. It may or may not have rolled back. */
   public synchronized boolean isFailed() {
     return state == ProcedureState.FAILED || state == ProcedureState.ROLLEDBACK;
   }
 
-  /**
-   * @return true if the procedure is finished successfully.
-   */
+  /** Returns true if the procedure is finished successfully. */
   public synchronized boolean isSuccess() {
     return state == ProcedureState.SUCCESS && !hasException();
   }
@@ -747,9 +735,7 @@ public abstract class Procedure<TEnvironment> implements Comparable<Procedure<TE
     return isSuccess() || state == ProcedureState.ROLLEDBACK;
   }
 
-  /**
-   * @return true if the procedure is waiting for a child to finish or for an external event.
-   */
+  /** Returns true if the procedure is waiting for a child to finish or for an external event. */
   public synchronized boolean isWaiting() {
     switch (state) {
       case WAITING:
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureEvent.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureEvent.java
index 667d045e3ac..bee90f78f88 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureEvent.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureEvent.java
@@ -42,7 +42,7 @@ public class ProcedureEvent<T> {
   }
 
   /**
-   * @return true if event is not ready and adds procedure to suspended queue, else returns false.
+   * Returns true if event is not ready and adds procedure to suspended queue, else returns false.
    */
   public synchronized boolean suspendIfNotReady(Procedure proc) {
     if (!ready) {
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureExecutor.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureExecutor.java
index 9cc78212863..f6263a5530b 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureExecutor.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureExecutor.java
@@ -680,16 +680,12 @@ public class ProcedureExecutor<TEnvironment> {
     return running.get();
   }
 
-  /**
-   * @return the current number of worker threads.
-   */
+  /** Returns the current number of worker threads. */
   public int getWorkerThreadCount() {
     return workerThreads.size();
   }
 
-  /**
-   * @return the core pool size settings.
-   */
+  /** Returns the core pool size settings. */
   public int getCorePoolSize() {
     return corePoolSize;
   }
@@ -2006,9 +2002,7 @@ public class ProcedureExecutor<TEnvironment> {
       return getName() + "(pid=" + (p == null ? Procedure.NO_PROC_ID : p.getProcId() + ")");
     }
 
-    /**
-     * @return the time since the current procedure is running
-     */
+    /** Returns the time since the current procedure is running */
     public long getCurrentRunTime() {
       return EnvironmentEdgeManager.currentTime() - executionStartTime.get();
     }
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureMetrics.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureMetrics.java
index f86a2b2d00a..bc82145cfe2 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureMetrics.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureMetrics.java
@@ -33,18 +33,14 @@ import org.apache.yetus.audience.InterfaceAudience;
  */
 @InterfaceAudience.Private
 public interface ProcedureMetrics {
-  /**
-   * @return Total number of instances submitted for a type of a procedure
-   */
+  /** Returns Total number of instances submitted for a type of a procedure */
   Counter getSubmittedCounter();
 
   /**
-   * @return Histogram of runtimes for all successfully completed instances of a type of a procedure
+   * Returns Histogram of runtimes for all successfully completed instances of a type of a procedure
    */
   Histogram getTimeHisto();
 
-  /**
-   * @return Total number of instances failed for a type of a procedure
-   */
+  /** Returns Total number of instances failed for a type of a procedure */
   Counter getFailedCounter();
 }
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureScheduler.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureScheduler.java
index f89cac5137c..c0ef8501f4c 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureScheduler.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/ProcedureScheduler.java
@@ -87,9 +87,7 @@ public interface ProcedureScheduler {
    */
   void completionCleanup(Procedure proc);
 
-  /**
-   * @return true if there are procedures available to process, otherwise false.
-   */
+  /** Returns true if there are procedures available to process, otherwise false. */
   boolean hasRunnables();
 
   /**
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/ProcedureStore.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/ProcedureStore.java
index 7e54cfa9a12..386886d0c8c 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/ProcedureStore.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/ProcedureStore.java
@@ -165,14 +165,10 @@ public interface ProcedureStore {
    */
   void stop(boolean abort);
 
-  /**
-   * @return true if the store is running, otherwise false.
-   */
+  /** Returns true if the store is running, otherwise false. */
   boolean isRunning();
 
-  /**
-   * @return the number of threads/slots passed to start()
-   */
+  /** Returns the number of threads/slots passed to start() */
   int getNumThreads();
 
   /**
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/wal/BitSetNode.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/wal/BitSetNode.java
index fdbf183b19f..e97fe9bfc84 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/wal/BitSetNode.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/wal/BitSetNode.java
@@ -202,9 +202,7 @@ class BitSetNode {
     return (modified[wordIndex] & (1L << bitmapIndex)) != 0;
   }
 
-  /**
-   * @return true, if all the procedures has been modified.
-   */
+  /** Returns true, if all the procedures has been modified. */
   public boolean isAllModified() {
     // TODO: cache the value
     for (int i = 0; i < modified.length; ++i) {
@@ -215,9 +213,7 @@ class BitSetNode {
     return true;
   }
 
-  /**
-   * @return all the active procedure ids in this bit set.
-   */
+  /** Returns all the active procedure ids in this bit set. */
   public long[] getActiveProcIds() {
     List<Long> procIds = new ArrayList<>();
     for (int wordIndex = 0; wordIndex < modified.length; wordIndex++) {
@@ -236,9 +232,7 @@ class BitSetNode {
     return procIds.stream().mapToLong(Long::longValue).toArray();
   }
 
-  /**
-   * @return true, if there are no active procedures in this BitSetNode, else false.
-   */
+  /** Returns true, if there are no active procedures in this BitSetNode, else false. */
   public boolean isEmpty() {
     // TODO: cache the value
     for (int i = 0; i < deleted.length; ++i) {
@@ -429,16 +423,12 @@ class BitSetNode {
   // ========================================================================
   // Helpers
   // ========================================================================
-  /**
-   * @return upper boundary (aligned to multiple of BITS_PER_WORD) of bitmap range x belongs to.
-   */
+  /** Returns upper boundary (aligned to multiple of BITS_PER_WORD) of bitmap range x belongs to. */
   private static long alignUp(final long x) {
     return (x + (BITS_PER_WORD - 1)) & -BITS_PER_WORD;
   }
 
-  /**
-   * @return lower boundary (aligned to multiple of BITS_PER_WORD) of bitmap range x belongs to.
-   */
+  /** Returns lower boundary (aligned to multiple of BITS_PER_WORD) of bitmap range x belongs to. */
   private static long alignDown(final long x) {
     return x & -BITS_PER_WORD;
   }
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/wal/ProcedureStoreTracker.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/wal/ProcedureStoreTracker.java
index eeb5a3a827b..692333ff733 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/wal/ProcedureStoreTracker.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/store/wal/ProcedureStoreTracker.java
@@ -343,9 +343,7 @@ class ProcedureStoreTracker {
     this.partial = isPartial;
   }
 
-  /**
-   * @return true, if no procedure is active, else false.
-   */
+  /** Returns true, if no procedure is active, else false. */
   public boolean isEmpty() {
     for (Map.Entry<Long, BitSetNode> entry : map.entrySet()) {
       if (!entry.getValue().isEmpty()) {
diff --git a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/util/DelayedUtil.java b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/util/DelayedUtil.java
index 19c4f8bcb58..32232ac18e6 100644
--- a/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/util/DelayedUtil.java
+++ b/hbase-procedure/src/main/java/org/apache/hadoop/hbase/procedure2/util/DelayedUtil.java
@@ -74,9 +74,7 @@ public final class DelayedUtil {
     }
   };
 
-  /**
-   * @return null (if an interrupt) or an instance of E; resets interrupt on calling thread.
-   */
+  /** Returns null (if an interrupt) or an instance of E; resets interrupt on calling thread. */
   public static <E extends Delayed> E takeWithoutInterrupt(final DelayQueue<E> queue,
     final long timeout, final TimeUnit timeUnit) {
     try {
@@ -87,9 +85,7 @@ public final class DelayedUtil {
     }
   }
 
-  /**
-   * @return Time remaining as milliseconds.
-   */
+  /** Returns Time remaining as milliseconds. */
   public static long getRemainingTime(final TimeUnit resultUnit, final long timeout) {
     final long currentTime = EnvironmentEdgeManager.currentTime();
     if (currentTime >= timeout) {
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/ProtobufMessageHandler.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/ProtobufMessageHandler.java
index f90354b7ab7..39a7ba71dd6 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/ProtobufMessageHandler.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/ProtobufMessageHandler.java
@@ -26,9 +26,7 @@ import org.apache.yetus.audience.InterfaceAudience;
  */
 @InterfaceAudience.Private
 public interface ProtobufMessageHandler {
-  /**
-   * @return the protobuf represention of the model
-   */
+  /** Returns the protobuf represention of the model */
   byte[] createProtobufOutput();
 
   /**
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/RESTServlet.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/RESTServlet.java
index 10b96ec9284..66834f36176 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/RESTServlet.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/RESTServlet.java
@@ -52,17 +52,13 @@ public class RESTServlet implements Constants {
     return realUser;
   }
 
-  /**
-   * @return the RESTServlet singleton instance
-   */
+  /** Returns the RESTServlet singleton instance */
   public synchronized static RESTServlet getInstance() {
     assert (INSTANCE != null);
     return INSTANCE;
   }
 
-  /**
-   * @return the ConnectionCache instance
-   */
+  /** Returns the ConnectionCache instance */
   public ConnectionCache getConnectionCache() {
     return connectionCache;
   }
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/TableResource.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/TableResource.java
index cb47ae1d278..2fe26deb542 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/TableResource.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/TableResource.java
@@ -53,14 +53,12 @@ public class TableResource extends ResourceBase {
     this.table = table;
   }
 
-  /** @return the table name */
+  /** Returns the table name */
   String getName() {
     return table;
   }
 
-  /**
-   * @return true if the table exists n
-   */
+  /** Returns true if the table exists n */
   boolean exists() throws IOException {
     return servlet.getAdmin().tableExists(TableName.valueOf(table));
   }
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Client.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Client.java
index ff1fe141bb8..85cb2af86a8 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Client.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Client.java
@@ -212,9 +212,7 @@ public class Client {
   public void shutdown() {
   }
 
-  /**
-   * @return the wrapped HttpClient
-   */
+  /** Returns the wrapped HttpClient */
   public HttpClient getHttpClient() {
     return httpClient;
   }
@@ -394,9 +392,7 @@ public class Client {
     }
   }
 
-  /**
-   * @return the cluster definition
-   */
+  /** Returns the cluster definition */
   public Cluster getCluster() {
     return cluster;
   }
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Cluster.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Cluster.java
index dbb30adbc74..9070dfd2800 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Cluster.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Cluster.java
@@ -45,9 +45,7 @@ public class Cluster {
     this.nodes.addAll(nodes);
   }
 
-  /**
-   * @return true if no locations have been added, false otherwise
-   */
+  /** Returns true if no locations have been added, false otherwise */
   public boolean isEmpty() {
     return nodes.isEmpty();
   }
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Response.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Response.java
index cd0ac33dd79..7041d88ce30 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Response.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/client/Response.java
@@ -82,9 +82,7 @@ public class Response {
     this.stream = in;
   }
 
-  /**
-   * @return the HTTP response code
-   */
+  /** Returns the HTTP response code */
   public int getCode() {
     return code;
   }
@@ -97,9 +95,7 @@ public class Response {
     return this.stream;
   }
 
-  /**
-   * @return the HTTP response headers
-   */
+  /** Returns the HTTP response headers */
   public Header[] getHeaders() {
     return headers;
   }
@@ -113,23 +109,17 @@ public class Response {
     return null;
   }
 
-  /**
-   * @return the value of the Location header
-   */
+  /** Returns the value of the Location header */
   public String getLocation() {
     return getHeader("Location");
   }
 
-  /**
-   * @return true if a response body was sent
-   */
+  /** Returns true if a response body was sent */
   public boolean hasBody() {
     return body != null;
   }
 
-  /**
-   * @return the HTTP response body
-   */
+  /** Returns the HTTP response body */
   public byte[] getBody() {
     if (body == null) {
       try {
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/CellModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/CellModel.java
index 3a6e4fa30f9..48c7e12202b 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/CellModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/CellModel.java
@@ -121,9 +121,7 @@ public class CellModel implements ProtobufMessageHandler, Serializable {
     this.value = value;
   }
 
-  /**
-   * @return the column
-   */
+  /** Returns the column */
   public byte[] getColumn() {
     return column;
   }
@@ -135,16 +133,12 @@ public class CellModel implements ProtobufMessageHandler, Serializable {
     this.column = column;
   }
 
-  /**
-   * @return true if the timestamp property has been specified by the user
-   */
+  /** Returns true if the timestamp property has been specified by the user */
   public boolean hasUserTimestamp() {
     return timestamp != HConstants.LATEST_TIMESTAMP;
   }
 
-  /**
-   * @return the timestamp
-   */
+  /** Returns the timestamp */
   public long getTimestamp() {
     return timestamp;
   }
@@ -156,9 +150,7 @@ public class CellModel implements ProtobufMessageHandler, Serializable {
     this.timestamp = timestamp;
   }
 
-  /**
-   * @return the value
-   */
+  /** Returns the value */
   public byte[] getValue() {
     return value;
   }
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/CellSetModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/CellSetModel.java
index b1287284f42..fff96b3486c 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/CellSetModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/CellSetModel.java
@@ -100,9 +100,7 @@ public class CellSetModel implements Serializable, ProtobufMessageHandler {
     rows.add(row);
   }
 
-  /**
-   * @return the rows
-   */
+  /** Returns the rows */
   public List<RowModel> getRows() {
     return rows;
   }
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/ColumnSchemaModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/ColumnSchemaModel.java
index bd0e6f58a77..70926c6aa4c 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/ColumnSchemaModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/ColumnSchemaModel.java
@@ -80,17 +80,13 @@ public class ColumnSchemaModel implements Serializable {
     return o != null ? o.toString() : null;
   }
 
-  /**
-   * @return the column name
-   */
+  /** Returns the column name */
   @XmlAttribute
   public String getName() {
     return name;
   }
 
-  /**
-   * @return the map for holding unspecified (user) attributes
-   */
+  /** Returns the map for holding unspecified (user) attributes */
   @XmlAnyAttribute
   @JsonAnyGetter
   public Map<QName, Object> getAny() {
@@ -130,9 +126,7 @@ public class ColumnSchemaModel implements Serializable {
   // cannot be standard bean type getters and setters, otherwise this would
   // confuse JAXB
 
-  /**
-   * @return true if the BLOCKCACHE attribute is present and true
-   */
+  /** Returns true if the BLOCKCACHE attribute is present and true */
   public boolean __getBlockcache() {
     Object o = attrs.get(BLOCKCACHE);
     return o != null
@@ -140,9 +134,7 @@ public class ColumnSchemaModel implements Serializable {
       : ColumnFamilyDescriptorBuilder.DEFAULT_BLOCKCACHE;
   }
 
-  /**
-   * @return the value of the BLOCKSIZE attribute or its default if it is unset
-   */
+  /** Returns the value of the BLOCKSIZE attribute or its default if it is unset */
   public int __getBlocksize() {
     Object o = attrs.get(BLOCKSIZE);
     return o != null
@@ -150,25 +142,19 @@ public class ColumnSchemaModel implements Serializable {
       : ColumnFamilyDescriptorBuilder.DEFAULT_BLOCKSIZE;
   }
 
-  /**
-   * @return the value of the BLOOMFILTER attribute or its default if unset
-   */
+  /** Returns the value of the BLOOMFILTER attribute or its default if unset */
   public String __getBloomfilter() {
     Object o = attrs.get(BLOOMFILTER);
     return o != null ? o.toString() : ColumnFamilyDescriptorBuilder.DEFAULT_BLOOMFILTER.name();
   }
 
-  /**
-   * @return the value of the COMPRESSION attribute or its default if unset
-   */
+  /** Returns the value of the COMPRESSION attribute or its default if unset */
   public String __getCompression() {
     Object o = attrs.get(COMPRESSION);
     return o != null ? o.toString() : ColumnFamilyDescriptorBuilder.DEFAULT_COMPRESSION.name();
   }
 
-  /**
-   * @return true if the IN_MEMORY attribute is present and true
-   */
+  /** Returns true if the IN_MEMORY attribute is present and true */
   public boolean __getInMemory() {
     Object o = attrs.get(IN_MEMORY);
     return o != null
@@ -176,17 +162,13 @@ public class ColumnSchemaModel implements Serializable {
       : ColumnFamilyDescriptorBuilder.DEFAULT_IN_MEMORY;
   }
 
-  /**
-   * @return the value of the TTL attribute or its default if it is unset
-   */
+  /** Returns the value of the TTL attribute or its default if it is unset */
   public int __getTTL() {
     Object o = attrs.get(TTL);
     return o != null ? Integer.parseInt(o.toString()) : ColumnFamilyDescriptorBuilder.DEFAULT_TTL;
   }
 
-  /**
-   * @return the value of the VERSIONS attribute or its default if it is unset
-   */
+  /** Returns the value of the VERSIONS attribute or its default if it is unset */
   public int __getVersions() {
     Object o = attrs.get(VERSIONS);
     return o != null
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/NamespacesInstanceModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/NamespacesInstanceModel.java
index 358183e5a8b..c45ca38be9f 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/NamespacesInstanceModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/NamespacesInstanceModel.java
@@ -104,9 +104,7 @@ public class NamespacesInstanceModel implements Serializable, ProtobufMessageHan
     properties.put(key, value);
   }
 
-  /**
-   * @return The map of uncategorized namespace properties.
-   */
+  /** Returns The map of uncategorized namespace properties. */
   public Map<String, String> getProperties() {
     if (properties == null) {
       properties = new HashMap<>();
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/NamespacesModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/NamespacesModel.java
index 96457da8267..c9755532c49 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/NamespacesModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/NamespacesModel.java
@@ -68,9 +68,7 @@ public class NamespacesModel implements Serializable, ProtobufMessageHandler {
     }
   }
 
-  /**
-   * @return all namespaces
-   */
+  /** Returns all namespaces */
   public List<String> getNamespaces() {
     return namespaces;
   }
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/RowModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/RowModel.java
index 34f065105d6..f3e892aba0c 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/RowModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/RowModel.java
@@ -112,9 +112,7 @@ public class RowModel implements ProtobufMessageHandler, Serializable {
     cells.add(cell);
   }
 
-  /**
-   * @return the row key
-   */
+  /** Returns the row key */
   public byte[] getKey() {
     return key;
   }
@@ -126,9 +124,7 @@ public class RowModel implements ProtobufMessageHandler, Serializable {
     this.key = key;
   }
 
-  /**
-   * @return the cells
-   */
+  /** Returns the cells */
   public List<CellModel> getCells() {
     return cells;
   }
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/ScannerModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/ScannerModel.java
index 2cd80b2858c..e2b20aaa84e 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/ScannerModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/ScannerModel.java
@@ -649,39 +649,29 @@ public class ScannerModel implements ProtobufMessageHandler, Serializable {
     labels.add(label);
   }
 
-  /**
-   * @return true if a start row was specified
-   */
+  /** Returns true if a start row was specified */
   public boolean hasStartRow() {
     return !Bytes.equals(startRow, HConstants.EMPTY_START_ROW);
   }
 
-  /**
-   * @return start row
-   */
+  /** Returns start row */
   @XmlAttribute
   public byte[] getStartRow() {
     return startRow;
   }
 
-  /**
-   * @return true if an end row was specified
-   */
+  /** Returns true if an end row was specified */
   public boolean hasEndRow() {
     return !Bytes.equals(endRow, HConstants.EMPTY_END_ROW);
   }
 
-  /**
-   * @return end row
-   */
+  /** Returns end row */
   @XmlAttribute
   public byte[] getEndRow() {
     return endRow;
   }
 
-  /**
-   * @return list of columns of interest in column:qualifier format, or empty for all
-   */
+  /** Returns list of columns of interest in column:qualifier format, or empty for all */
   @XmlElement(name = "column")
   public List<byte[]> getColumns() {
     return columns;
@@ -692,65 +682,49 @@ public class ScannerModel implements ProtobufMessageHandler, Serializable {
     return labels;
   }
 
-  /**
-   * @return the number of cells to return in batch
-   */
+  /** Returns the number of cells to return in batch */
   @XmlAttribute
   public int getBatch() {
     return batch;
   }
 
-  /**
-   * @return the number of rows that the scanner to fetch at once
-   */
+  /** Returns the number of rows that the scanner to fetch at once */
   @XmlAttribute
   public int getCaching() {
     return caching;
   }
 
-  /**
-   * @return the limit specification
-   */
+  /** Returns the limit specification */
   @XmlAttribute
   public int getLimit() {
     return limit;
   }
 
-  /**
-   * @return true if HFile blocks should be cached on the servers for this scan, false otherwise
-   */
+  /** Returns true if HFile blocks should be cached on the servers for this scan, false otherwise */
   @XmlAttribute
   public boolean getCacheBlocks() {
     return cacheBlocks;
   }
 
-  /**
-   * @return the lower bound on timestamps of items of interest
-   */
+  /** Returns the lower bound on timestamps of items of interest */
   @XmlAttribute
   public long getStartTime() {
     return startTime;
   }
 
-  /**
-   * @return the upper bound on timestamps of items of interest
-   */
+  /** Returns the upper bound on timestamps of items of interest */
   @XmlAttribute
   public long getEndTime() {
     return endTime;
   }
 
-  /**
-   * @return maximum number of versions to return
-   */
+  /** Returns maximum number of versions to return */
   @XmlAttribute
   public int getMaxVersions() {
     return maxVersions;
   }
 
-  /**
-   * @return the filter specification
-   */
+  /** Returns the filter specification */
   @XmlElement
   public String getFilter() {
     return filter;
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/StorageClusterStatusModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/StorageClusterStatusModel.java
index 16783e95749..e0102811142 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/StorageClusterStatusModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/StorageClusterStatusModel.java
@@ -167,113 +167,85 @@ public class StorageClusterStatusModel implements Serializable, ProtobufMessageH
         this.currentCompactedKVs = currentCompactedKVs;
       }
 
-      /**
-       * @return the region name
-       */
+      /** Returns the region name */
       @XmlAttribute
       public byte[] getName() {
         return name;
       }
 
-      /**
-       * @return the number of stores
-       */
+      /** Returns the number of stores */
       @XmlAttribute
       public int getStores() {
         return stores;
       }
 
-      /**
-       * @return the number of store files
-       */
+      /** Returns the number of store files */
       @XmlAttribute
       public int getStorefiles() {
         return storefiles;
       }
 
-      /**
-       * @return the total size of store files, in MB
-       */
+      /** Returns the total size of store files, in MB */
       @XmlAttribute
       public int getStorefileSizeMB() {
         return storefileSizeMB;
       }
 
-      /**
-       * @return memstore size, in MB
-       */
+      /** Returns memstore size, in MB */
       @XmlAttribute
       public int getMemStoreSizeMB() {
         return memstoreSizeMB;
       }
 
-      /**
-       * @return the total size of store file indexes, in KB
-       */
+      /** Returns the total size of store file indexes, in KB */
       @XmlAttribute
       public long getStorefileIndexSizeKB() {
         return storefileIndexSizeKB;
       }
 
-      /**
-       * @return the current total read requests made to region
-       */
+      /** Returns the current total read requests made to region */
       @XmlAttribute
       public long getReadRequestsCount() {
         return readRequestsCount;
       }
 
-      /**
-       * @return the current total read requests made to region
-       */
+      /** Returns the current total read requests made to region */
       @XmlAttribute
       public long getCpRequestsCount() {
         return cpRequestsCount;
       }
 
-      /**
-       * @return the current total write requests made to region
-       */
+      /** Returns the current total write requests made to region */
       @XmlAttribute
       public long getWriteRequestsCount() {
         return writeRequestsCount;
       }
 
-      /**
-       * @return The current total size of root-level indexes for the region, in KB.
-       */
+      /** Returns The current total size of root-level indexes for the region, in KB. */
       @XmlAttribute
       public int getRootIndexSizeKB() {
         return rootIndexSizeKB;
       }
 
-      /**
-       * @return The total size of static index, in KB
-       */
+      /** Returns The total size of static index, in KB */
       @XmlAttribute
       public int getTotalStaticIndexSizeKB() {
         return totalStaticIndexSizeKB;
       }
 
-      /**
-       * @return The total size of static bloom, in KB
-       */
+      /** Returns The total size of static bloom, in KB */
       @XmlAttribute
       public int getTotalStaticBloomSizeKB() {
         return totalStaticBloomSizeKB;
       }
 
-      /**
-       * @return The total number of compacting key-values
-       */
+      /** Returns The total number of compacting key-values */
       @XmlAttribute
       public long getTotalCompactingKVs() {
         return totalCompactingKVs;
       }
 
-      /**
-       * @return The number of current compacted key-values
-       */
+      /** Returns The number of current compacted key-values */
       @XmlAttribute
       public long getCurrentCompactedKVs() {
         return currentCompactedKVs;
@@ -426,49 +398,37 @@ public class StorageClusterStatusModel implements Serializable, ProtobufMessageH
       this.startCode = startCode;
     }
 
-    /**
-     * @return the region server's name
-     */
+    /** Returns the region server's name */
     @XmlAttribute
     public String getName() {
       return name;
     }
 
-    /**
-     * @return the region server's start code
-     */
+    /** Returns the region server's start code */
     @XmlAttribute
     public long getStartCode() {
       return startCode;
     }
 
-    /**
-     * @return the current heap size, in MB
-     */
+    /** Returns the current heap size, in MB */
     @XmlAttribute
     public int getHeapSizeMB() {
       return heapSizeMB;
     }
 
-    /**
-     * @return the maximum heap size, in MB
-     */
+    /** Returns the maximum heap size, in MB */
     @XmlAttribute
     public int getMaxHeapSizeMB() {
       return maxHeapSizeMB;
     }
 
-    /**
-     * @return the list of regions served by the region server
-     */
+    /** Returns the list of regions served by the region server */
     @XmlElement(name = "Region")
     public List<Region> getRegions() {
       return regions;
     }
 
-    /**
-     * @return the number of requests per second processed by the region server
-     */
+    /** Returns the number of requests per second processed by the region server */
     @XmlAttribute
     public long getRequests() {
       return requests;
@@ -568,9 +528,7 @@ public class StorageClusterStatusModel implements Serializable, ProtobufMessageH
   public StorageClusterStatusModel() {
   }
 
-  /**
-   * @return the list of live nodes
-   */
+  /** Returns the list of live nodes */
   @XmlElement(name = "Node")
   @XmlElementWrapper(name = "LiveNodes")
   // workaround https://github.com/FasterXML/jackson-dataformat-xml/issues/192
@@ -579,9 +537,7 @@ public class StorageClusterStatusModel implements Serializable, ProtobufMessageH
     return liveNodes;
   }
 
-  /**
-   * @return the list of dead nodes
-   */
+  /** Returns the list of dead nodes */
   @XmlElement(name = "Node")
   @XmlElementWrapper(name = "DeadNodes")
   // workaround https://github.com/FasterXML/jackson-dataformat-xml/issues/192
@@ -590,9 +546,7 @@ public class StorageClusterStatusModel implements Serializable, ProtobufMessageH
     return deadNodes;
   }
 
-  /**
-   * @return the total number of regions served by the cluster
-   */
+  /** Returns the total number of regions served by the cluster */
   @XmlAttribute
   public int getRegions() {
     return regions;
@@ -607,9 +561,7 @@ public class StorageClusterStatusModel implements Serializable, ProtobufMessageH
     return requests;
   }
 
-  /**
-   * @return the average load of the region servers in the cluster
-   */
+  /** Returns the average load of the region servers in the cluster */
   @XmlAttribute
   public double getAverageLoad() {
     return averageLoad;
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/StorageClusterVersionModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/StorageClusterVersionModel.java
index e23c6af8177..0125e321f75 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/StorageClusterVersionModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/StorageClusterVersionModel.java
@@ -38,9 +38,7 @@ public class StorageClusterVersionModel implements Serializable {
 
   private String version;
 
-  /**
-   * @return the storage cluster version
-   */
+  /** Returns the storage cluster version */
   @XmlAttribute(name = "Version")
   public String getVersion() {
     return version;
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableInfoModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableInfoModel.java
index 9bb68f962a9..c1023353a70 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableInfoModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableInfoModel.java
@@ -82,17 +82,13 @@ public class TableInfoModel implements Serializable, ProtobufMessageHandler {
     return regions.get(index);
   }
 
-  /**
-   * @return the table name
-   */
+  /** Returns the table name */
   @XmlAttribute
   public String getName() {
     return name;
   }
 
-  /**
-   * @return the regions
-   */
+  /** Returns the regions */
   @XmlElement(name = "Region")
   public List<TableRegionModel> getRegions() {
     return regions;
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableListModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableListModel.java
index a092d179af8..76854acdf6a 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableListModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableListModel.java
@@ -62,9 +62,7 @@ public class TableListModel implements Serializable, ProtobufMessageHandler {
     return tables.get(index);
   }
 
-  /**
-   * @return the tables
-   */
+  /** Returns the tables */
   @XmlElementRef(name = "table")
   public List<TableModel> getTables() {
     return tables;
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableModel.java
index 75513eadbaa..51a2bc567cd 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableModel.java
@@ -55,9 +55,7 @@ public class TableModel implements Serializable {
     this.name = name;
   }
 
-  /**
-   * @return the name
-   */
+  /** Returns the name */
   @XmlAttribute
   public String getName() {
     return name;
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableRegionModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableRegionModel.java
index 32ae708d3e7..b996dd68961 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableRegionModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableRegionModel.java
@@ -83,9 +83,7 @@ public class TableRegionModel implements Serializable {
     this.location = location;
   }
 
-  /**
-   * @return the region name
-   */
+  /** Returns the region name */
   @XmlAttribute
   public String getName() {
     byte[] tableNameAsBytes = Bytes.toBytes(this.table);
@@ -95,33 +93,25 @@ public class TableRegionModel implements Serializable {
     return Bytes.toString(nameAsBytes);
   }
 
-  /**
-   * @return the encoded region id
-   */
+  /** Returns the encoded region id */
   @XmlAttribute
   public long getId() {
     return id;
   }
 
-  /**
-   * @return the start key
-   */
+  /** Returns the start key */
   @XmlAttribute
   public byte[] getStartKey() {
     return startKey;
   }
 
-  /**
-   * @return the end key
-   */
+  /** Returns the end key */
   @XmlAttribute
   public byte[] getEndKey() {
     return endKey;
   }
 
-  /**
-   * @return the name and port of the region server hosting the region
-   */
+  /** Returns the name and port of the region server hosting the region */
   @XmlAttribute
   public String getLocation() {
     return location;
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableSchemaModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableSchemaModel.java
index ba462256f8a..06abe355859 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableSchemaModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/TableSchemaModel.java
@@ -139,26 +139,20 @@ public class TableSchemaModel implements Serializable, ProtobufMessageHandler {
     return columns.get(index);
   }
 
-  /**
-   * @return the table name
-   */
+  /** Returns the table name */
   @XmlAttribute
   public String getName() {
     return name;
   }
 
-  /**
-   * @return the map for holding unspecified (user) attributes
-   */
+  /** Returns the map for holding unspecified (user) attributes */
   @XmlAnyAttribute
   @JsonAnyGetter
   public Map<QName, Object> getAny() {
     return attrs;
   }
 
-  /**
-   * @return the columns
-   */
+  /** Returns the columns */
   @XmlElement(name = "ColumnSchema")
   public List<ColumnSchemaModel> getColumns() {
     return columns;
@@ -214,25 +208,19 @@ public class TableSchemaModel implements Serializable, ProtobufMessageHandler {
   // cannot be standard bean type getters and setters, otherwise this would
   // confuse JAXB
 
-  /**
-   * @return true if IS_META attribute exists and is truel
-   */
+  /** Returns true if IS_META attribute exists and is truel */
   public boolean __getIsMeta() {
     Object o = attrs.get(IS_META);
     return o != null && Boolean.parseBoolean(o.toString());
   }
 
-  /**
-   * @return true if IS_ROOT attribute exists and is truel
-   */
+  /** Returns true if IS_ROOT attribute exists and is truel */
   public boolean __getIsRoot() {
     Object o = attrs.get(IS_ROOT);
     return o != null && Boolean.parseBoolean(o.toString());
   }
 
-  /**
-   * @return true if READONLY attribute exists and is truel
-   */
+  /** Returns true if READONLY attribute exists and is truel */
   public boolean __getReadOnly() {
     Object o = attrs.get(READONLY);
     return o != null ? Boolean.parseBoolean(o.toString()) : TableDescriptorBuilder.DEFAULT_READONLY;
@@ -328,9 +316,7 @@ public class TableSchemaModel implements Serializable, ProtobufMessageHandler {
     return this;
   }
 
-  /**
-   * @return a table descriptor
-   */
+  /** Returns a table descriptor */
   @JsonIgnore
   public TableDescriptor getTableDescriptor() {
     TableDescriptorBuilder tableDescriptorBuilder =
diff --git a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/VersionModel.java b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/VersionModel.java
index ed3949a087a..e5d79af5e55 100644
--- a/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/VersionModel.java
+++ b/hbase-rest/src/main/java/org/apache/hadoop/hbase/rest/model/VersionModel.java
@@ -75,41 +75,31 @@ public class VersionModel implements Serializable, ProtobufMessageHandler {
     if (jerseyVersion == null) jerseyVersion = "";
   }
 
-  /**
-   * @return the REST gateway version
-   */
+  /** Returns the REST gateway version */
   @XmlAttribute(name = "REST")
   public String getRESTVersion() {
     return restVersion;
   }
 
-  /**
-   * @return the JVM vendor and version
-   */
+  /** Returns the JVM vendor and version */
   @XmlAttribute(name = "JVM")
   public String getJVMVersion() {
     return jvmVersion;
   }
 
-  /**
-   * @return the OS name, version, and hardware architecture
-   */
+  /** Returns the OS name, version, and hardware architecture */
   @XmlAttribute(name = "OS")
   public String getOSVersion() {
     return osVersion;
   }
 
-  /**
-   * @return the servlet container version
-   */
+  /** Returns the servlet container version */
   @XmlAttribute(name = "Server")
   public String getServerVersion() {
     return serverVersion;
   }
 
-  /**
-   * @return the version of the embedded Jersey framework
-   */
+  /** Returns the version of the embedded Jersey framework */
   @XmlAttribute(name = "Jersey")
   public String getJerseyVersion() {
     return jerseyVersion;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/HBaseServerBase.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/HBaseServerBase.java
index e148c7da84c..9c21b3f0f55 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/HBaseServerBase.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/HBaseServerBase.java
@@ -504,9 +504,7 @@ public abstract class HBaseServerBase<R extends HBaseRpcServicesBase<?>> extends
     return choreService;
   }
 
-  /**
-   * @return Return table descriptors implementation.
-   */
+  /** Returns Return table descriptors implementation. */
   public TableDescriptors getTableDescriptors() {
     return this.tableDescriptors;
   }
@@ -534,9 +532,7 @@ public abstract class HBaseServerBase<R extends HBaseRpcServicesBase<?>> extends
     return ConnectionFactory.createConnection(conf, null, user);
   }
 
-  /**
-   * @return Return the rootDir.
-   */
+  /** Returns Return the rootDir. */
   public Path getDataRootDir() {
     return dataRootDir;
   }
@@ -546,30 +542,22 @@ public abstract class HBaseServerBase<R extends HBaseRpcServicesBase<?>> extends
     return dataFs;
   }
 
-  /**
-   * @return Return the walRootDir.
-   */
+  /** Returns Return the walRootDir. */
   public Path getWALRootDir() {
     return walRootDir;
   }
 
-  /**
-   * @return Return the walFs.
-   */
+  /** Returns Return the walFs. */
   public FileSystem getWALFileSystem() {
     return walFs;
   }
 
-  /**
-   * @return True if the cluster is up.
-   */
+  /** Returns True if the cluster is up. */
   public boolean isClusterUp() {
     return !clusterMode() || this.clusterStatusTracker.isClusterUp();
   }
 
-  /**
-   * @return time stamp in millis of when this server was started
-   */
+  /** Returns time stamp in millis of when this server was started */
   public long getStartcode() {
     return this.startcode;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/LocalHBaseCluster.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/LocalHBaseCluster.java
index 8fceff2ff4d..38775bf9384 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/LocalHBaseCluster.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/LocalHBaseCluster.java
@@ -249,9 +249,7 @@ public class LocalHBaseCluster {
     return regionThreads.get(serverNumber).getRegionServer();
   }
 
-  /**
-   * @return Read-only list of region server threads.
-   */
+  /** Returns Read-only list of region server threads. */
   public List<JVMClusterUtil.RegionServerThread> getRegionServers() {
     return Collections.unmodifiableList(this.regionThreads);
   }
@@ -270,9 +268,7 @@ public class LocalHBaseCluster {
     return liveServers;
   }
 
-  /**
-   * @return the Configuration used by this LocalHBaseCluster
-   */
+  /** Returns the Configuration used by this LocalHBaseCluster */
   public Configuration getConfiguration() {
     return this.conf;
   }
@@ -308,9 +304,7 @@ public class LocalHBaseCluster {
     return rst.getName();
   }
 
-  /**
-   * @return the HMaster thread
-   */
+  /** Returns the HMaster thread */
   public HMaster getMaster(int serverNumber) {
     return masterThreads.get(serverNumber).getMaster();
   }
@@ -330,9 +324,7 @@ public class LocalHBaseCluster {
     return null;
   }
 
-  /**
-   * @return Read-only list of master threads.
-   */
+  /** Returns Read-only list of master threads. */
   public List<JVMClusterUtil.MasterThread> getMasters() {
     return Collections.unmodifiableList(this.masterThreads);
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/MetaRegionLocationCache.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/MetaRegionLocationCache.java
index c364607e6cc..081f95fdc79 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/MetaRegionLocationCache.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/MetaRegionLocationCache.java
@@ -201,9 +201,7 @@ public class MetaRegionLocationCache extends ZKListener {
     cachedMetaLocations.put(replicaId, location);
   }
 
-  /**
-   * @return Optional list of HRegionLocations for meta replica(s), null if the cache is empty.
-   */
+  /** Returns Optional list of HRegionLocations for meta replica(s), null if the cache is empty. */
   public List<HRegionLocation> getMetaRegionLocations() {
     ConcurrentNavigableMap<Integer, HRegionLocation> snapshot =
       cachedMetaLocations.tailMap(cachedMetaLocations.firstKey());
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/MetaTableAccessor.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/MetaTableAccessor.java
index 87ec4908cae..fc465f0387a 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/MetaTableAccessor.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/MetaTableAccessor.java
@@ -207,9 +207,7 @@ public final class MetaTableAccessor {
       regionInfo, regionInfo.getReplicaId());
   }
 
-  /**
-   * @return Return the {@link HConstants#CATALOG_FAMILY} row from hbase:meta.
-   */
+  /** Returns Return the {@link HConstants#CATALOG_FAMILY} row from hbase:meta. */
   public static Result getCatalogFamilyRow(Connection connection, RegionInfo ri)
     throws IOException {
     Get get = new Get(CatalogFamilyFormat.getMetaKeyForRegion(ri));
@@ -515,9 +513,7 @@ public final class MetaTableAccessor {
     }
   }
 
-  /**
-   * @return Get closest metatable region row to passed <code>row</code>
-   */
+  /** Returns Get closest metatable region row to passed <code>row</code> */
   @NonNull
   private static RegionInfo getClosestRegionInfo(Connection connection,
     @NonNull final TableName tableName, @NonNull final byte[] row) throws IOException {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/Server.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/Server.java
index b5f025f44a2..d99807e46b0 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/Server.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/Server.java
@@ -72,9 +72,7 @@ public interface Server extends Abortable, Stoppable {
    */
   AsyncClusterConnection getAsyncClusterConnection();
 
-  /**
-   * @return The unique server name for this server.
-   */
+  /** Returns The unique server name for this server. */
   ServerName getServerName();
 
   /**
@@ -82,14 +80,10 @@ public interface Server extends Abortable, Stoppable {
    */
   CoordinatedStateManager getCoordinatedStateManager();
 
-  /**
-   * @return The {@link ChoreService} instance for this server
-   */
+  /** Returns The {@link ChoreService} instance for this server */
   ChoreService getChoreService();
 
-  /**
-   * @return Return the FileSystem object used (can return null!).
-   */
+  /** Returns Return the FileSystem object used (can return null!). */
   // TODO: Distinguish between "dataFs" and "walFs".
   default FileSystem getFileSystem() {
     // This default is pretty dodgy!
@@ -105,9 +99,7 @@ public interface Server extends Abortable, Stoppable {
     return fs;
   }
 
-  /**
-   * @return True is the server is Stopping
-   */
+  /** Returns True is the server is Stopping */
   // Note: This method is not part of the Stoppable Interface.
   default boolean isStopping() {
     return false;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/TableDescriptors.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/TableDescriptors.java
index 9ecdf396791..d22e46383d3 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/TableDescriptors.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/TableDescriptors.java
@@ -41,9 +41,7 @@ public interface TableDescriptors extends Closeable {
     // do nothing by default
   }
 
-  /**
-   * @return TableDescriptor for tablename
-   */
+  /** Returns TableDescriptor for tablename */
   TableDescriptor get(TableName tableName) throws IOException;
 
   /**
@@ -78,8 +76,6 @@ public interface TableDescriptors extends Closeable {
    */
   void update(TableDescriptor htd, boolean cacheOnly) throws IOException;
 
-  /**
-   * @return Instance of table descriptor or null if none found.
-   */
+  /** Returns Instance of table descriptor or null if none found. */
   TableDescriptor remove(TableName tablename) throws IOException;
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/backup/HFileArchiver.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/backup/HFileArchiver.java
index 8e666308d4f..68dc87502e0 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/backup/HFileArchiver.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/backup/HFileArchiver.java
@@ -80,9 +80,7 @@ public class HFileArchiver {
     // hidden ctor since this is just a util
   }
 
-  /**
-   * @return True if the Region exits in the filesystem.
-   */
+  /** Returns True if the Region exits in the filesystem. */
   public static boolean exists(Configuration conf, FileSystem fs, RegionInfo info)
     throws IOException {
     Path rootDir = CommonFSUtils.getRootDir(conf);
@@ -703,14 +701,10 @@ public class HFileArchiver {
      */
     abstract void close() throws IOException;
 
-    /**
-     * @return the name of the file (not the full fs path, just the individual file name)
-     */
+    /** Returns the name of the file (not the full fs path, just the individual file name) */
     abstract String getName();
 
-    /**
-     * @return the path to this file
-     */
+    /** Returns the path to this file */
     abstract Path getPath();
 
     /**
@@ -722,9 +716,7 @@ public class HFileArchiver {
       return CommonFSUtils.renameAndSetModifyTime(fs, p, dest);
     }
 
-    /**
-     * @return the {@link FileSystem} on which this file resides
-     */
+    /** Returns the {@link FileSystem} on which this file resides */
     public FileSystem getFileSystem() {
       return this.fs;
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/backup/example/TableHFileArchiveTracker.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/backup/example/TableHFileArchiveTracker.java
index 1896199ede2..9ae06f2840c 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/backup/example/TableHFileArchiveTracker.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/backup/example/TableHFileArchiveTracker.java
@@ -222,9 +222,7 @@ public final class TableHFileArchiveTracker extends ZKListener {
     return getMonitor().shouldArchiveTable(tableName);
   }
 
-  /**
-   * @return the tracker for which tables should be archived.
-   */
+  /** Returns the tracker for which tables should be archived. */
   public final HFileArchiveTableMonitor getMonitor() {
     return this.monitor;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/client/VersionInfoUtil.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/client/VersionInfoUtil.java
index dadb0998ed7..618a5a66524 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/client/VersionInfoUtil.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/client/VersionInfoUtil.java
@@ -86,9 +86,7 @@ public final class VersionInfoUtil {
     }
   }
 
-  /**
-   * @return the versionInfo extracted from the current RpcCallContext
-   */
+  /** Returns the versionInfo extracted from the current RpcCallContext */
   public static HBaseProtos.VersionInfo getCurrentClientVersionInfo() {
     return RpcServer.getCurrentCall().map(RpcCallContext::getClientVersionInfo)
       .orElse(NonCallVersion.get());
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/client/locking/EntityLock.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/client/locking/EntityLock.java
index 50c6dc27657..747ccb54e83 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/client/locking/EntityLock.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/client/locking/EntityLock.java
@@ -208,9 +208,7 @@ public class EntityLock {
       setDaemon(true);
     }
 
-    /**
-     * @return Shuts down the thread clean and quietly.
-     */
+    /** Returns Shuts down the thread clean and quietly. */
     Thread shutdown() {
       shutdown = true;
       interrupt();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/SplitLogManagerCoordination.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/SplitLogManagerCoordination.java
index 324a6f37b99..29aa273b2b3 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/SplitLogManagerCoordination.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/SplitLogManagerCoordination.java
@@ -56,30 +56,22 @@ public interface SplitLogManagerCoordination {
       this.failedDeletions = failedDeletions;
     }
 
-    /**
-     * @return the master value
-     */
+    /** Returns the master value */
     public MasterServices getMaster() {
       return master;
     }
 
-    /**
-     * @return map of tasks
-     */
+    /** Returns map of tasks */
     public ConcurrentMap<String, Task> getTasks() {
       return tasks;
     }
 
-    /**
-     * @return a set of failed deletions
-     */
+    /** Returns a set of failed deletions */
     public Set<String> getFailedDeletions() {
       return failedDeletions;
     }
 
-    /**
-     * @return server name
-     */
+    /** Returns server name */
     public ServerName getServerName() {
       return master.getServerName();
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/SplitLogWorkerCoordination.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/SplitLogWorkerCoordination.java
index ff2fbfbe7e7..3ab8ee83531 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/SplitLogWorkerCoordination.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/SplitLogWorkerCoordination.java
@@ -64,9 +64,7 @@ public interface SplitLogWorkerCoordination {
    */
   void stopProcessingTasks();
 
-  /**
-   * @return the current value of exitWorker
-   */
+  /** Returns the current value of exitWorker */
   boolean isStop();
 
   /**
@@ -123,9 +121,7 @@ public interface SplitLogWorkerCoordination {
    */
   interface SplitTaskDetails {
 
-    /**
-     * @return full file path in HDFS for the WAL file to be split.
-     */
+    /** Returns full file path in HDFS for the WAL file to be split. */
     String getWALFile();
   }
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/ZkSplitLogWorkerCoordination.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/ZkSplitLogWorkerCoordination.java
index 1b255b25e17..7acb0891dbc 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/ZkSplitLogWorkerCoordination.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coordination/ZkSplitLogWorkerCoordination.java
@@ -317,9 +317,7 @@ public class ZkSplitLogWorkerCoordination extends ZKListener implements SplitLog
     server.getExecutorService().submit(hsh);
   }
 
-  /**
-   * @return true if more splitters are available, otherwise false.
-   */
+  /** Returns true if more splitters are available, otherwise false. */
   private boolean areSplittersAvailable() {
     return maxConcurrentTasks - tasksInProgress.get() > 0;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/BaseEnvironment.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/BaseEnvironment.java
index b8cabe8cfed..b5f0809c046 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/BaseEnvironment.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/BaseEnvironment.java
@@ -118,13 +118,13 @@ public class BaseEnvironment<C extends Coprocessor> implements CoprocessorEnviro
     return seq;
   }
 
-  /** @return the coprocessor environment version */
+  /** Returns the coprocessor environment version */
   @Override
   public int getVersion() {
     return Coprocessor.VERSION;
   }
 
-  /** @return the HBase release */
+  /** Returns the HBase release */
   @Override
   public String getHBaseVersion() {
     return VersionInfo.getVersion();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/HasMasterServices.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/HasMasterServices.java
index 2682b78fd51..dd8babf21dd 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/HasMasterServices.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/HasMasterServices.java
@@ -30,8 +30,6 @@ import org.apache.yetus.audience.InterfaceAudience;
 @Deprecated
 @InterfaceAudience.Private
 public interface HasMasterServices {
-  /**
-   * @return An instance of RegionServerServices, an object NOT for Coprocessor consumption.
-   */
+  /** Returns An instance of RegionServerServices, an object NOT for Coprocessor consumption. */
   MasterServices getMasterServices();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/HasRegionServerServices.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/HasRegionServerServices.java
index cef03390acb..21301efeafa 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/HasRegionServerServices.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/HasRegionServerServices.java
@@ -30,8 +30,6 @@ import org.apache.yetus.audience.InterfaceAudience;
 @Deprecated
 @InterfaceAudience.Private
 public interface HasRegionServerServices {
-  /**
-   * @return An instance of RegionServerServices, an object NOT for Coprocessor consumption.
-   */
+  /** Returns An instance of RegionServerServices, an object NOT for Coprocessor consumption. */
   RegionServerServices getRegionServerServices();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/MasterCoprocessorEnvironment.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/MasterCoprocessorEnvironment.java
index c83b9da4308..61c98346887 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/MasterCoprocessorEnvironment.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/MasterCoprocessorEnvironment.java
@@ -30,9 +30,7 @@ import org.apache.yetus.audience.InterfaceStability;
 @InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.COPROC)
 @InterfaceStability.Evolving
 public interface MasterCoprocessorEnvironment extends CoprocessorEnvironment<MasterCoprocessor> {
-  /**
-   * @return Hosting Server's ServerName
-   */
+  /** Returns Hosting Server's ServerName */
   ServerName getServerName();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionCoprocessorEnvironment.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionCoprocessorEnvironment.java
index 44db1350570..e3232db909c 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionCoprocessorEnvironment.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionCoprocessorEnvironment.java
@@ -35,23 +35,19 @@ import org.apache.yetus.audience.InterfaceStability;
 @InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.COPROC)
 @InterfaceStability.Evolving
 public interface RegionCoprocessorEnvironment extends CoprocessorEnvironment<RegionCoprocessor> {
-  /** @return the region associated with this coprocessor */
+  /** Returns the region associated with this coprocessor */
   Region getRegion();
 
-  /** @return region information for the region this coprocessor is running on */
+  /** Returns region information for the region this coprocessor is running on */
   RegionInfo getRegionInfo();
 
-  /**
-   * @return Interface to Map of regions online on this RegionServer {@link #getServerName()}}.
-   */
+  /** Returns Interface to Map of regions online on this RegionServer {@link #getServerName()}}. */
   OnlineRegions getOnlineRegions();
 
-  /** @return shared data between all instances of this coprocessor */
+  /** Returns shared data between all instances of this coprocessor */
   ConcurrentMap<String, Object> getSharedData();
 
-  /**
-   * @return Hosting Server's ServerName
-   */
+  /** Returns Hosting Server's ServerName */
   ServerName getServerName();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionServerCoprocessorEnvironment.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionServerCoprocessorEnvironment.java
index 4b2e8b5791b..39d186aba29 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionServerCoprocessorEnvironment.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionServerCoprocessorEnvironment.java
@@ -32,14 +32,10 @@ import org.apache.yetus.audience.InterfaceStability;
 @InterfaceStability.Evolving
 public interface RegionServerCoprocessorEnvironment
   extends CoprocessorEnvironment<RegionServerCoprocessor> {
-  /**
-   * @return Hosting Server's ServerName
-   */
+  /** Returns Hosting Server's ServerName */
   ServerName getServerName();
 
-  /**
-   * @return Interface to Map of regions online on this RegionServer {@link #getServerName()}}.
-   */
+  /** Returns Interface to Map of regions online on this RegionServer {@link #getServerName()}}. */
   OnlineRegions getOnlineRegions();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/WALCoprocessorEnvironment.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/WALCoprocessorEnvironment.java
index 1774481f210..2d414111db5 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/WALCoprocessorEnvironment.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/WALCoprocessorEnvironment.java
@@ -27,7 +27,7 @@ import org.apache.yetus.audience.InterfaceStability;
 @InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.COPROC)
 @InterfaceStability.Evolving
 public interface WALCoprocessorEnvironment extends CoprocessorEnvironment<WALCoprocessor> {
-  /** @return reference to the region server's WAL */
+  /** Returns reference to the region server's WAL */
   WAL getWAL();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/EventHandler.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/EventHandler.java
index fcb60a35c4c..94418f0c381 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/EventHandler.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/EventHandler.java
@@ -134,9 +134,7 @@ public abstract class EventHandler implements Runnable, Comparable<EventHandler>
     return Integer.MAX_VALUE;
   }
 
-  /**
-   * @return This events' sequence id.
-   */
+  /** Returns This events' sequence id. */
   public long getSeqid() {
     return this.seqid;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/ExecutorService.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/ExecutorService.java
index f89a59a6c2d..c74388e5b92 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/ExecutorService.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/ExecutorService.java
@@ -212,7 +212,7 @@ public class ExecutorService {
     }
 
     /**
-     * @return the executor name inferred from the type and the servername on which this is running.
+     * Returns the executor name inferred from the type and the servername on which this is running.
      */
     public String getName() {
       return getExecutorType().getExecutorName(servername);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/ExecutorType.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/ExecutorType.java
index 0bcd3ee0519..1af70b2c44b 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/ExecutorType.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/executor/ExecutorType.java
@@ -59,9 +59,7 @@ public enum ExecutorType {
   ExecutorType(int value) {
   }
 
-  /**
-   * @return Conflation of the executor type and the passed {@code serverName}.
-   */
+  /** Returns Conflation of the executor type and the passed {@code serverName}. */
   String getExecutorName(String serverName) {
     return this.toString() + "-" + serverName.replace("%", "%%");
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/filter/FilterWrapper.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/filter/FilterWrapper.java
index 7e20bb88187..4fc2257140e 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/filter/FilterWrapper.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/filter/FilterWrapper.java
@@ -47,9 +47,7 @@ final public class FilterWrapper extends Filter {
     this.filter = Objects.requireNonNull(filter, "Cannot create FilterWrapper with null Filter");
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() throws IOException {
     FilterProtos.FilterWrapper.Builder builder = FilterProtos.FilterWrapper.newBuilder();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/FSDataInputStreamWrapper.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/FSDataInputStreamWrapper.java
index 819c5651081..3ad07622a4f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/FSDataInputStreamWrapper.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/FSDataInputStreamWrapper.java
@@ -186,9 +186,7 @@ public class FSDataInputStreamWrapper implements Closeable {
     readahead = 0;
   }
 
-  /**
-   * @return Whether we are presently using HBase checksum.
-   */
+  /** Returns Whether we are presently using HBase checksum. */
   public boolean shouldUseHBaseChecksum() {
     return this.useHBaseChecksum;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/FileLink.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/FileLink.java
index 2d12fd88c11..8fbaa775391 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/FileLink.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/FileLink.java
@@ -335,9 +335,7 @@ public class FileLink {
     this.locations = locations.toArray(new Path[locations.size()]);
   }
 
-  /**
-   * @return the locations to look for the linked file.
-   */
+  /** Returns the locations to look for the linked file. */
   public Path[] getLocations() {
     return locations;
   }
@@ -354,9 +352,7 @@ public class FileLink {
     return str.toString();
   }
 
-  /**
-   * @return true if the file pointed by the link exists
-   */
+  /** Returns true if the file pointed by the link exists */
   public boolean exists(final FileSystem fs) throws IOException {
     for (int i = 0; i < locations.length; ++i) {
       if (fs.exists(locations[i])) {
@@ -366,9 +362,7 @@ public class FileLink {
     return false;
   }
 
-  /**
-   * @return the path of the first available link.
-   */
+  /** Returns the path of the first available link. */
   public Path getAvailablePath(FileSystem fs) throws IOException {
     for (int i = 0; i < locations.length; ++i) {
       if (fs.exists(locations[i])) {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/HFileLink.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/HFileLink.java
index 4cf350004a3..4184d6ca21e 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/HFileLink.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/HFileLink.java
@@ -160,23 +160,17 @@ public class HFileLink extends FileLink {
     return HFileLink.buildFromHFileLinkPattern(conf, createPath(table, region, family, hfile));
   }
 
-  /**
-   * @return the origin path of the hfile.
-   */
+  /** Returns the origin path of the hfile. */
   public Path getOriginPath() {
     return this.originPath;
   }
 
-  /**
-   * @return the path of the archived hfile.
-   */
+  /** Returns the path of the archived hfile. */
   public Path getArchivePath() {
     return this.archivePath;
   }
 
-  /**
-   * @return the path of the mob hfiles.
-   */
+  /** Returns the path of the mob hfiles. */
   public Path getMobPath() {
     return this.mobPath;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCache.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCache.java
index 4c6d438ca8c..7660a42ba5e 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCache.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCache.java
@@ -133,15 +133,11 @@ public interface BlockCache extends Iterable<CachedBlock> {
    */
   long getDataBlockCount();
 
-  /**
-   * @return Iterator over the blocks in the cache.
-   */
+  /** Returns Iterator over the blocks in the cache. */
   @Override
   Iterator<CachedBlock> iterator();
 
-  /**
-   * @return The list of sub blockcaches that make up this one; returns null if no sub caches.
-   */
+  /** Returns The list of sub blockcaches that make up this one; returns null if no sub caches. */
   BlockCache[] getBlockCaches();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCacheKey.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCacheKey.java
index f9c52e4acbc..81da24f9341 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCacheKey.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCacheKey.java
@@ -82,9 +82,7 @@ public class BlockCacheKey implements HeapSize, java.io.Serializable {
   }
 
   // can't avoid this unfortunately
-  /**
-   * @return The hfileName portion of this cache key
-   */
+  /** Returns The hfileName portion of this cache key */
   public String getHfileName() {
     return hfileName;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCacheUtil.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCacheUtil.java
index 2a2faae3eae..1bad6c5023d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCacheUtil.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/BlockCacheUtil.java
@@ -116,9 +116,7 @@ public class BlockCacheUtil {
     }
   }
 
-  /**
-   * @return A JSON String of <code>filename</code> and counts of <code>blocks</code>
-   */
+  /** Returns A JSON String of <code>filename</code> and counts of <code>blocks</code> */
   public static String toJSON(String filename, NavigableSet<CachedBlock> blocks)
     throws IOException {
     CachedBlockCountsPerFile counts = new CachedBlockCountsPerFile(filename);
@@ -134,16 +132,12 @@ public class BlockCacheUtil {
     return GSON.toJson(counts);
   }
 
-  /**
-   * @return JSON string of <code>cbsf</code> aggregated
-   */
+  /** Returns JSON string of <code>cbsf</code> aggregated */
   public static String toJSON(CachedBlocksByFile cbsbf) throws IOException {
     return GSON.toJson(cbsbf);
   }
 
-  /**
-   * @return JSON string of <code>bc</code> content.
-   */
+  /** Returns JSON string of <code>bc</code> content. */
   public static String toJSON(BlockCache bc) throws IOException {
     return GSON.toJson(bc);
   }
@@ -318,9 +312,7 @@ public class BlockCacheUtil {
       return this.cachedBlockByFile;
     }
 
-    /**
-     * @return count of blocks in the cache
-     */
+    /** Returns count of blocks in the cache */
     public int getCount() {
       return count;
     }
@@ -329,16 +321,12 @@ public class BlockCacheUtil {
       return dataBlockCount;
     }
 
-    /**
-     * @return size of blocks in the cache
-     */
+    /** Returns size of blocks in the cache */
     public long getSize() {
       return size;
     }
 
-    /**
-     * @return Size of data.
-     */
+    /** Returns Size of data. */
     public long getDataSize() {
       return dataSize;
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/CacheConfig.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/CacheConfig.java
index 42ddddda800..88e9bf2105d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/CacheConfig.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/CacheConfig.java
@@ -255,9 +255,7 @@ public class CacheConfig {
       || (prefetchOnOpen && (category != BlockCategory.META && category != BlockCategory.UNKNOWN));
   }
 
-  /**
-   * @return true if blocks in this file should be flagged as in-memory
-   */
+  /** Returns true if blocks in this file should be flagged as in-memory */
   public boolean isInMemory() {
     return this.inMemory;
   }
@@ -320,15 +318,13 @@ public class CacheConfig {
     this.evictOnClose = evictOnClose;
   }
 
-  /**
-   * @return true if data blocks should be compressed in the cache, false if not
-   */
+  /** Returns true if data blocks should be compressed in the cache, false if not */
   public boolean shouldCacheDataCompressed() {
     return this.cacheDataOnRead && this.cacheDataCompressed;
   }
 
   /**
-   * @return true if this {@link BlockCategory} should be compressed in blockcache, false otherwise
+   * Returns true if this {@link BlockCategory} should be compressed in blockcache, false otherwise
    */
   public boolean shouldCacheCompressed(BlockCategory category) {
     switch (category) {
@@ -339,23 +335,17 @@ public class CacheConfig {
     }
   }
 
-  /**
-   * @return true if blocks should be prefetched into the cache on open, false if not
-   */
+  /** Returns true if blocks should be prefetched into the cache on open, false if not */
   public boolean shouldPrefetchOnOpen() {
     return this.prefetchOnOpen;
   }
 
-  /**
-   * @return true if blocks should be cached while writing during compaction, false if not
-   */
+  /** Returns true if blocks should be cached while writing during compaction, false if not */
   public boolean shouldCacheCompactedBlocksOnWrite() {
     return this.cacheCompactedDataOnWrite;
   }
 
-  /**
-   * @return total file size in bytes threshold for caching while writing during compaction
-   */
+  /** Returns total file size in bytes threshold for caching while writing during compaction */
   public long getCacheCompactedBlocksOnWriteThreshold() {
     return this.cacheCompactedDataOnWriteThreshold;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/Cacheable.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/Cacheable.java
index 0a41b53a804..43456d7857d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/Cacheable.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/Cacheable.java
@@ -50,9 +50,7 @@ public interface Cacheable extends HeapSize, HBaseReferenceCounted {
    */
   CacheableDeserializer<Cacheable> getDeserializer();
 
-  /**
-   * @return the block type of this cached HFile block
-   */
+  /** Returns the block type of this cached HFile block */
   BlockType getBlockType();
 
   /******************************* ReferenceCounted Interfaces ***********************************/
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFile.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFile.java
index ba7ff84996f..89a407b3389 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFile.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFile.java
@@ -211,7 +211,7 @@ public final class HFile {
     /** Add an element to the file info map. */
     void appendFileInfo(byte[] key, byte[] value) throws IOException;
 
-    /** @return the path to this {@link HFile} */
+    /** Returns the path to this {@link HFile} */
     Path getPath();
 
     /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileBlock.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileBlock.java
index 766002b26f0..fe2e0c7fab9 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileBlock.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileBlock.java
@@ -434,7 +434,7 @@ public class HFileBlock implements Cacheable {
     return this;
   }
 
-  /** @return get data block encoding id that was used to encode this block */
+  /** Returns get data block encoding id that was used to encode this block */
   short getDataBlockEncodingId() {
     if (blockType != BlockType.ENCODED_DATA) {
       throw new IllegalArgumentException("Querying encoder ID of a block " + "of type other than "
@@ -443,30 +443,22 @@ public class HFileBlock implements Cacheable {
     return buf.getShort(headerSize());
   }
 
-  /**
-   * @return the on-disk size of header + data part + checksum.
-   */
+  /** Returns the on-disk size of header + data part + checksum. */
   public int getOnDiskSizeWithHeader() {
     return onDiskSizeWithoutHeader + headerSize();
   }
 
-  /**
-   * @return the on-disk size of the data part + checksum (header excluded).
-   */
+  /** Returns the on-disk size of the data part + checksum (header excluded). */
   int getOnDiskSizeWithoutHeader() {
     return onDiskSizeWithoutHeader;
   }
 
-  /**
-   * @return the uncompressed size of data part (header and checksum excluded).
-   */
+  /** Returns the uncompressed size of data part (header and checksum excluded). */
   int getUncompressedSizeWithoutHeader() {
     return uncompressedSizeWithoutHeader;
   }
 
-  /**
-   * @return the offset of the previous block of the same type in the file, or -1 if unknown
-   */
+  /** Returns the offset of the previous block of the same type in the file, or -1 if unknown */
   long getPrevBlockOffset() {
     return prevBlockOffset;
   }
@@ -692,9 +684,7 @@ public class HFileBlock implements Cacheable {
     return offset;
   }
 
-  /**
-   * @return a byte stream reading the data + checksum of this block
-   */
+  /** Returns a byte stream reading the data + checksum of this block */
   DataInputStream getByteStream() {
     ByteBuff dup = this.buf.duplicate();
     dup.position(this.headerSize());
@@ -1081,7 +1071,7 @@ public class HFileBlock implements Cacheable {
       return baosInMemory.size();
     }
 
-    /** @return true if a block is being written */
+    /** Returns true if a block is being written */
     boolean isWriting() {
       return state == State.WRITING;
     }
@@ -1545,7 +1535,7 @@ public class HFileBlock implements Cacheable {
     }
 
     /**
-     * @return Check <code>onDiskSizeWithHeaderL</code> size is healthy and then return it as an int
+     * Returns Check <code>onDiskSizeWithHeaderL</code> size is healthy and then return it as an int
      */
     private static int checkAndGetSizeAsInt(final long onDiskSizeWithHeaderL, final int hdrSize)
       throws IOException {
@@ -1922,7 +1912,7 @@ public class HFileBlock implements Cacheable {
     return this.fileContext.getBytesPerChecksum();
   }
 
-  /** @return the size of data on disk + header. Excludes checksum. */
+  /** Returns the size of data on disk + header. Excludes checksum. */
   int getOnDiskDataSizeWithHeader() {
     return this.onDiskDataSizeWithHeader;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileBlockIndex.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileBlockIndex.java
index 782383d697b..0e886d9873c 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileBlockIndex.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileBlockIndex.java
@@ -508,9 +508,7 @@ public class HFileBlockIndex {
      */
     protected int searchTreeLevel;
 
-    /**
-     * @return true if the block index is empty.
-     */
+    /** Returns true if the block index is empty. */
     public abstract boolean isEmpty();
 
     /**
@@ -585,9 +583,7 @@ public class HFileBlockIndex {
       return blockDataSizes[i];
     }
 
-    /**
-     * @return the number of root-level blocks in this block index
-     */
+    /** Returns the number of root-level blocks in this block index */
     public int getRootBlockCount() {
       return rootCount;
     }
@@ -1111,16 +1107,12 @@ public class HFileBlockIndex {
       curFirstKey = null;
     }
 
-    /**
-     * @return how many block index entries there are in the root level
-     */
+    /** Returns how many block index entries there are in the root level */
     public final int getNumRootEntries() {
       return rootChunk.getNumEntries();
     }
 
-    /**
-     * @return the number of levels in this block index.
-     */
+    /** Returns the number of levels in this block index. */
     public int getNumLevels() {
       return numLevels;
     }
@@ -1462,9 +1454,7 @@ public class HFileBlockIndex {
       }
     }
 
-    /**
-     * @return the size of this chunk if stored in the non-root index block format
-     */
+    /** Returns the size of this chunk if stored in the non-root index block format */
     int getNonRootSize() {
       return Bytes.SIZEOF_INT // Number of entries
         + Bytes.SIZEOF_INT * (blockKeys.size() + 1) // Secondary index
@@ -1486,16 +1476,12 @@ public class HFileBlockIndex {
       }
     }
 
-    /**
-     * @return the size of this chunk if stored in the root index block format
-     */
+    /** Returns the size of this chunk if stored in the root index block format */
     int getRootSize() {
       return curTotalRootSize;
     }
 
-    /**
-     * @return the number of entries in this block index chunk
-     */
+    /** Returns the number of entries in this block index chunk */
     public int getNumEntries() {
       return blockKeys.size();
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileDataBlockEncoder.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileDataBlockEncoder.java
index cf253e20bd8..cb2d5bbcfb6 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileDataBlockEncoder.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileDataBlockEncoder.java
@@ -70,7 +70,7 @@ public interface HFileDataBlockEncoder {
    */
   void saveMetadata(HFile.Writer writer) throws IOException;
 
-  /** @return the data block encoding */
+  /** Returns the data block encoding */
   DataBlockEncoding getDataBlockEncoding();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileReaderImpl.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileReaderImpl.java
index e7bc6901b2f..1d126f32514 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileReaderImpl.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileReaderImpl.java
@@ -214,13 +214,13 @@ public abstract class HFileReaderImpl implements HFile.Reader, Configurable {
     return getLastKey().map(CellUtil::cloneRow);
   }
 
-  /** @return number of KV entries in this HFile */
+  /** Returns number of KV entries in this HFile */
   @Override
   public long getEntries() {
     return trailer.getEntryCount();
   }
 
-  /** @return comparator */
+  /** Returns comparator */
   @Override
   public CellComparator getComparator() {
     return this.hfileContext.getCellComparator();
@@ -961,16 +961,12 @@ public abstract class HFileReaderImpl implements HFile.Reader, Configurable {
       return blockSeek(key, seekBefore);
     }
 
-    /**
-     * @return True if v &lt;= 0 or v &gt; current block buffer limit.
-     */
+    /** Returns True if v &lt;= 0 or v &gt; current block buffer limit. */
     protected final boolean checkKeyLen(final int v) {
       return v <= 0 || v > this.blockBuffer.limit();
     }
 
-    /**
-     * @return True if v &lt; 0 or v &gt; current block buffer limit.
-     */
+    /** Returns True if v &lt; 0 or v &gt; current block buffer limit. */
     protected final boolean checkLen(final int v) {
       return v < 0 || v > this.blockBuffer.limit();
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileScanner.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileScanner.java
index 3e5ada1442f..e77b133523f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileScanner.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileScanner.java
@@ -101,9 +101,7 @@ public interface HFileScanner extends Shipper, Closeable {
    */
   ByteBuffer getValue();
 
-  /**
-   * @return Instance of {@link org.apache.hadoop.hbase.Cell}.
-   */
+  /** Returns Instance of {@link org.apache.hadoop.hbase.Cell}. */
   Cell getCell();
 
   /**
@@ -124,9 +122,7 @@ public interface HFileScanner extends Shipper, Closeable {
   @Deprecated
   String getValueString();
 
-  /**
-   * @return Reader that underlies this Scanner instance.
-   */
+  /** Returns Reader that underlies this Scanner instance. */
   HFile.Reader getReader();
 
   /**
@@ -135,9 +131,7 @@ public interface HFileScanner extends Shipper, Closeable {
    */
   boolean isSeeked();
 
-  /**
-   * @return the next key in the index (the key to seek to the next block)
-   */
+  /** Returns the next key in the index (the key to seek to the next block) */
   Cell getNextIndexedKey();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileWriterImpl.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileWriterImpl.java
index 9170cbef4e7..a638a443fc4 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileWriterImpl.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/HFileWriterImpl.java
@@ -259,9 +259,7 @@ public class HFileWriterImpl implements HFile.Writer {
     }
   }
 
-  /**
-   * @return Path or null if we were passed a stream rather than a Path.
-   */
+  /** Returns Path or null if we were passed a stream rather than a Path. */
   @Override
   public Path getPath() {
     return path;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/InlineBlockWriter.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/InlineBlockWriter.java
index 040ca6b9164..6b0c913ca1b 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/InlineBlockWriter.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/InlineBlockWriter.java
@@ -58,8 +58,6 @@ public interface InlineBlockWriter {
    */
   BlockType getInlineBlockType();
 
-  /**
-   * @return true if inline blocks produced by this writer should be cached
-   */
+  /** Returns true if inline blocks produced by this writer should be cached */
   boolean getCacheOnWrite();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/LruCachedBlock.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/LruCachedBlock.java
index f60e4300e4e..ddeee207f1f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/LruCachedBlock.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/LruCachedBlock.java
@@ -80,9 +80,7 @@ public class LruCachedBlock implements HeapSize, Comparable<LruCachedBlock> {
     }
   }
 
-  /**
-   * @return Time we were cached at in nano seconds.
-   */
+  /** Returns Time we were cached at in nano seconds. */
   public long getCachedTime() {
     return this.cachedTime;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/LruCachedBlockQueue.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/LruCachedBlockQueue.java
index 8e45cb772d2..272b5b0b0cd 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/LruCachedBlockQueue.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/LruCachedBlockQueue.java
@@ -89,16 +89,12 @@ public class LruCachedBlockQueue implements HeapSize {
     }
   }
 
-  /**
-   * @return The next element in this queue, or {@code null} if the queue is empty.
-   */
+  /** Returns The next element in this queue, or {@code null} if the queue is empty. */
   public LruCachedBlock poll() {
     return queue.poll();
   }
 
-  /**
-   * @return The last element in this queue, or {@code null} if the queue is empty.
-   */
+  /** Returns The last element in this queue, or {@code null} if the queue is empty. */
   public LruCachedBlock pollLast() {
     return queue.pollLast();
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/bucket/CachedEntryQueue.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/bucket/CachedEntryQueue.java
index daa25cee1de..446cea55f14 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/bucket/CachedEntryQueue.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/bucket/CachedEntryQueue.java
@@ -92,16 +92,12 @@ public class CachedEntryQueue {
     }
   }
 
-  /**
-   * @return The next element in this queue, or {@code null} if the queue is empty.
-   */
+  /** Returns The next element in this queue, or {@code null} if the queue is empty. */
   public Map.Entry<BlockCacheKey, BucketEntry> poll() {
     return queue.poll();
   }
 
-  /**
-   * @return The last element in this queue, or {@code null} if the queue is empty.
-   */
+  /** Returns The last element in this queue, or {@code null} if the queue is empty. */
   public Map.Entry<BlockCacheKey, BucketEntry> pollLast() {
     return queue.pollLast();
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/bucket/IOEngine.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/bucket/IOEngine.java
index 62ff19878fc..a7b73a5d886 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/bucket/IOEngine.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/hfile/bucket/IOEngine.java
@@ -28,9 +28,7 @@ import org.apache.yetus.audience.InterfaceAudience;
  */
 @InterfaceAudience.Private
 public interface IOEngine {
-  /**
-   * @return true if persistent storage is supported for the cache when shutdown
-   */
+  /** Returns true if persistent storage is supported for the cache when shutdown */
   boolean isPersistent();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/util/MemorySizeUtil.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/util/MemorySizeUtil.java
index f5f9d760a79..85bcc643558 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/io/util/MemorySizeUtil.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/io/util/MemorySizeUtil.java
@@ -153,9 +153,7 @@ public class MemorySizeUtil {
     return DEFAULT_MEMSTORE_SIZE_LOWER_LIMIT;
   }
 
-  /**
-   * @return Pair of global memstore size and memory type(ie. on heap or off heap).
-   */
+  /** Returns Pair of global memstore size and memory type(ie. on heap or off heap). */
   public static Pair<Long, MemoryType> getGlobalMemStoreSize(Configuration conf) {
     long offheapMSGlobal = conf.getLong(OFFHEAP_MEMSTORE_SIZE_KEY, 0);// Size in MBs
     if (offheapMSGlobal > 0) {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/FastPathBalancedQueueRpcExecutor.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/FastPathBalancedQueueRpcExecutor.java
index 7dcf5c1361a..440f4d3a819 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/FastPathBalancedQueueRpcExecutor.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/FastPathBalancedQueueRpcExecutor.java
@@ -73,9 +73,7 @@ public class FastPathBalancedQueueRpcExecutor extends BalancedQueueRpcExecutor {
     return handler != null ? handler.loadCallRunner(callTask) : super.dispatch(callTask);
   }
 
-  /**
-   * @return Pop a Handler instance if one available ready-to-go or else return null.
-   */
+  /** Returns Pop a Handler instance if one available ready-to-go or else return null. */
   private FastPathRpcHandler popReadyHandler() {
     return this.fastPathHandlerStack.poll();
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/QueueBalancer.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/QueueBalancer.java
index a13f5d85823..2111d5b78ca 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/QueueBalancer.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/QueueBalancer.java
@@ -27,8 +27,6 @@ import org.apache.yetus.audience.InterfaceStability;
 @InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.CONFIG)
 @InterfaceStability.Stable
 public interface QueueBalancer {
-  /**
-   * @return the index of the next queue to which a request should be inserted
-   */
+  /** Returns the index of the next queue to which a request should be inserted */
   int getNextQueue(CallRunner callRunner);
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcCall.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcCall.java
index e12bcf6964f..59008cb08a4 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcCall.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcCall.java
@@ -36,34 +36,22 @@ import org.apache.hadoop.hbase.shaded.protobuf.generated.RPCProtos.RequestHeader
 @InterfaceStability.Evolving
 public interface RpcCall extends RpcCallContext {
 
-  /**
-   * @return The service of this call.
-   */
+  /** Returns The service of this call. */
   BlockingService getService();
 
-  /**
-   * @return The service method.
-   */
+  /** Returns The service method. */
   MethodDescriptor getMethod();
 
-  /**
-   * @return The call parameter message.
-   */
+  /** Returns The call parameter message. */
   Message getParam();
 
-  /**
-   * @return The CellScanner that can carry input and result payload.
-   */
+  /** Returns The CellScanner that can carry input and result payload. */
   CellScanner getCellScanner();
 
-  /**
-   * @return The timestamp when the call is constructed.
-   */
+  /** Returns The timestamp when the call is constructed. */
   long getReceiveTime();
 
-  /**
-   * @return The time when the call starts to be executed.
-   */
+  /** Returns The time when the call starts to be executed. */
   long getStartTime();
 
   /**
@@ -71,14 +59,10 @@ public interface RpcCall extends RpcCallContext {
    */
   void setStartTime(long startTime);
 
-  /**
-   * @return The timeout of this call.
-   */
+  /** Returns The timeout of this call. */
   int getTimeout();
 
-  /**
-   * @return The Priority of this call.
-   */
+  /** Returns The Priority of this call. */
   int getPriority();
 
   /**
@@ -95,14 +79,10 @@ public interface RpcCall extends RpcCallContext {
    */
   long getSize();
 
-  /**
-   * @return The request header of this call.
-   */
+  /** Returns The request header of this call. */
   RequestHeader getHeader();
 
-  /**
-   * @return Port of remote address in this call
-   */
+  /** Returns Port of remote address in this call */
   int getRemotePort();
 
   /**
@@ -125,8 +105,6 @@ public interface RpcCall extends RpcCallContext {
    */
   void cleanup();
 
-  /**
-   * @return A short string format of this call without possibly lengthy params
-   */
+  /** Returns A short string format of this call without possibly lengthy params */
   String toShortString();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcCallContext.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcCallContext.java
index 6f045731ecb..95843652abe 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcCallContext.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcCallContext.java
@@ -55,21 +55,15 @@ public interface RpcCallContext {
    */
   Optional<User> getRequestUser();
 
-  /**
-   * @return Current request's user name or not present if none ongoing.
-   */
+  /** Returns Current request's user name or not present if none ongoing. */
   default Optional<String> getRequestUserName() {
     return getRequestUser().map(User::getShortName);
   }
 
-  /**
-   * @return Address of remote client in this call
-   */
+  /** Returns Address of remote client in this call */
   InetAddress getRemoteAddress();
 
-  /**
-   * @return the client version info, or null if the information is not present
-   */
+  /** Returns the client version info, or null if the information is not present */
   VersionInfo getClientVersionInfo();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcHandler.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcHandler.java
index 8c762b6873a..95dea351847 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcHandler.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcHandler.java
@@ -63,9 +63,7 @@ public class RpcHandler extends Thread {
     this.abortable = abortable;
   }
 
-  /**
-   * @return A {@link CallRunner} n
-   */
+  /** Returns A {@link CallRunner} n */
   protected CallRunner getCallRunner() throws InterruptedException {
     return this.q.take();
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcServer.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcServer.java
index 58d55f73b53..966b13aa869 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcServer.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/ipc/RpcServer.java
@@ -719,9 +719,7 @@ public abstract class RpcServer implements RpcServerInterface, ConfigurationObse
     return getRequestUser().map(User::getShortName);
   }
 
-  /**
-   * @return Address of remote client if a request is ongoing, else null
-   */
+  /** Returns Address of remote client if a request is ongoing, else null */
   public static Optional<InetAddress> getRemoteAddress() {
     return getCurrentCall().map(RpcCall::getRemoteAddress);
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/ActiveMasterManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/ActiveMasterManager.java
index 50628f8717b..3f8d6d2a702 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/ActiveMasterManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/ActiveMasterManager.java
@@ -314,9 +314,7 @@ public class ActiveMasterManager extends ZKListener {
     return false;
   }
 
-  /**
-   * @return True if cluster has an active master.
-   */
+  /** Returns True if cluster has an active master. */
   boolean hasActiveMaster() {
     try {
       if (ZKUtil.checkExists(watcher, watcher.getZNodePaths().masterAddressZNode) >= 0) {
@@ -353,9 +351,7 @@ public class ActiveMasterManager extends ZKListener {
     }
   }
 
-  /**
-   * @return list of registered backup masters.
-   */
+  /** Returns list of registered backup masters. */
   public List<ServerName> getBackupMasters() {
     return backupMasters;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/HMaster.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/HMaster.java
index 2b818d9cc23..816e4497f1f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/HMaster.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/HMaster.java
@@ -1819,9 +1819,7 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     shutdownChore(rollingUpgradeChore);
   }
 
-  /**
-   * @return Get remote side's InetAddress
-   */
+  /** Returns Get remote side's InetAddress */
   InetAddress getRemoteInetAddress(final int port, final long serverStartCode)
     throws UnknownHostException {
     // Do it out here in its own little method so can fake an address when
@@ -1839,9 +1837,7 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     return ia;
   }
 
-  /**
-   * @return Maximum time we should run balancer for
-   */
+  /** Returns Maximum time we should run balancer for */
   private int getMaxBalancingTime() {
     // if max balancing time isn't set, defaulting it to period time
     int maxBalancingTime =
@@ -1850,9 +1846,7 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     return maxBalancingTime;
   }
 
-  /**
-   * @return Maximum number of regions in transition
-   */
+  /** Returns Maximum number of regions in transition */
   private int getMaxRegionsInTransition() {
     int numRegions = this.assignmentManager.getRegionStates().getRegionAssignments().size();
     return Math.max((int) Math.floor(numRegions * this.maxRitPercent), 1);
@@ -2130,9 +2124,7 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     return regionNormalizerManager.normalizeRegions(targetTables, isHighPriority);
   }
 
-  /**
-   * @return Client info for use as prefix on an audit log string; who did an action
-   */
+  /** Returns Client info for use as prefix on an audit log string; who did an action */
   @Override
   public String getClientIdAuditPrefix() {
     return "Client=" + RpcServer.getRequestUserName().orElse(null) + "/"
@@ -2945,9 +2937,7 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     return null;
   }
 
-  /**
-   * @return cluster status
-   */
+  /** Returns cluster status */
   public ClusterMetrics getClusterMetrics() throws IOException {
     return getClusterMetrics(EnumSet.allOf(Option.class));
   }
@@ -2963,9 +2953,7 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     return status;
   }
 
-  /**
-   * @return info port of active master or 0 if any exception occurs.
-   */
+  /** Returns info port of active master or 0 if any exception occurs. */
   public int getActiveMasterInfoPort() {
     return activeMasterManager.getActiveMasterInfoPort();
   }
@@ -2987,23 +2975,17 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     return CoprocessorHost.getLoadedCoprocessors().toString();
   }
 
-  /**
-   * @return timestamp in millis when HMaster was started.
-   */
+  /** Returns timestamp in millis when HMaster was started. */
   public long getMasterStartTime() {
     return startcode;
   }
 
-  /**
-   * @return timestamp in millis when HMaster became the active master.
-   */
+  /** Returns timestamp in millis when HMaster became the active master. */
   public long getMasterActiveTime() {
     return masterActiveTime;
   }
 
-  /**
-   * @return timestamp in millis when HMaster finished becoming the active master
-   */
+  /** Returns timestamp in millis when HMaster finished becoming the active master */
   public long getMasterFinishedInitializationTime() {
     return masterFinishedInitializationTime;
   }
@@ -3035,9 +3017,7 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     assignmentManager.checkIfShouldMoveSystemRegionAsync();
   }
 
-  /**
-   * @return array of coprocessor SimpleNames.
-   */
+  /** Returns array of coprocessor SimpleNames. */
   public String[] getMasterCoprocessors() {
     Set<String> masterCoprocessors = getMasterCoprocessorHost().getCoprocessors();
     return masterCoprocessors.toArray(new String[masterCoprocessors.size()]);
@@ -3305,17 +3285,13 @@ public class HMaster extends HBaseServerBase<MasterRpcServices> implements Maste
     return this.logCleaner;
   }
 
-  /**
-   * @return the underlying snapshot manager
-   */
+  /** Returns the underlying snapshot manager */
   @Override
   public SnapshotManager getSnapshotManager() {
     return this.snapshotManager;
   }
 
-  /**
-   * @return the underlying MasterProcedureManagerHost
-   */
+  /** Returns the underlying MasterProcedureManagerHost */
   @Override
   public MasterProcedureManagerHost getMasterProcedureManagerHost() {
     return mpmHost;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterFileSystem.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterFileSystem.java
index c07ee8bf862..a5a0b5d629f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterFileSystem.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterFileSystem.java
@@ -186,37 +186,27 @@ public class MasterFileSystem {
     return this.conf;
   }
 
-  /**
-   * @return HBase root dir.
-   */
+  /** Returns HBase root dir. */
   public Path getRootDir() {
     return this.rootdir;
   }
 
-  /**
-   * @return HBase root log dir.
-   */
+  /** Returns HBase root log dir. */
   public Path getWALRootDir() {
     return this.walRootDir;
   }
 
-  /**
-   * @return the directory for a give {@code region}.
-   */
+  /** Returns the directory for a give {@code region}. */
   public Path getRegionDir(RegionInfo region) {
     return FSUtils.getRegionDirFromRootDir(getRootDir(), region);
   }
 
-  /**
-   * @return HBase temp dir.
-   */
+  /** Returns HBase temp dir. */
   public Path getTempDir() {
     return this.tempdir;
   }
 
-  /**
-   * @return The unique identifier generated for this cluster
-   */
+  /** Returns The unique identifier generated for this cluster */
   public ClusterId getClusterId() {
     return clusterId;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterRpcServices.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterRpcServices.java
index e209e561f37..e74505fa7fb 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterRpcServices.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterRpcServices.java
@@ -563,9 +563,7 @@ public class MasterRpcServices extends HBaseRpcServicesBase<HMaster>
     return switchBalancer(b, BalanceSwitchMode.SYNC);
   }
 
-  /**
-   * @return list of blocking services and their security info classes that this server supports
-   */
+  /** Returns list of blocking services and their security info classes that this server supports */
   @Override
   protected List<BlockingServiceAndInterface> getServices() {
     List<BlockingServiceAndInterface> bssi = new ArrayList<>(5);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterServices.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterServices.java
index d813b39863e..fbeb155a88b 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterServices.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterServices.java
@@ -66,84 +66,52 @@ import org.apache.hbase.thirdparty.com.google.protobuf.Service;
  */
 @InterfaceAudience.Private
 public interface MasterServices extends Server {
-  /**
-   * @return the underlying snapshot manager
-   */
+  /** Returns the underlying snapshot manager */
   SnapshotManager getSnapshotManager();
 
-  /**
-   * @return the underlying MasterProcedureManagerHost
-   */
+  /** Returns the underlying MasterProcedureManagerHost */
   MasterProcedureManagerHost getMasterProcedureManagerHost();
 
-  /**
-   * @return Master's instance of {@link ClusterSchema}
-   */
+  /** Returns Master's instance of {@link ClusterSchema} */
   ClusterSchema getClusterSchema();
 
-  /**
-   * @return Master's instance of the {@link AssignmentManager}
-   */
+  /** Returns Master's instance of the {@link AssignmentManager} */
   AssignmentManager getAssignmentManager();
 
-  /**
-   * @return Master's filesystem {@link MasterFileSystem} utility class.
-   */
+  /** Returns Master's filesystem {@link MasterFileSystem} utility class. */
   MasterFileSystem getMasterFileSystem();
 
-  /**
-   * @return Master's WALs {@link MasterWalManager} utility class.
-   */
+  /** Returns Master's WALs {@link MasterWalManager} utility class. */
   MasterWalManager getMasterWalManager();
 
-  /**
-   * @return Master's {@link ServerManager} instance.
-   */
+  /** Returns Master's {@link ServerManager} instance. */
   ServerManager getServerManager();
 
-  /**
-   * @return Master's instance of {@link ExecutorService}
-   */
+  /** Returns Master's instance of {@link ExecutorService} */
   ExecutorService getExecutorService();
 
-  /**
-   * @return Master's instance of {@link TableStateManager}
-   */
+  /** Returns Master's instance of {@link TableStateManager} */
   TableStateManager getTableStateManager();
 
-  /**
-   * @return Master's instance of {@link MasterCoprocessorHost}
-   */
+  /** Returns Master's instance of {@link MasterCoprocessorHost} */
   MasterCoprocessorHost getMasterCoprocessorHost();
 
-  /**
-   * @return Master's instance of {@link MasterQuotaManager}
-   */
+  /** Returns Master's instance of {@link MasterQuotaManager} */
   MasterQuotaManager getMasterQuotaManager();
 
-  /**
-   * @return Master's instance of {@link RegionNormalizerManager}
-   */
+  /** Returns Master's instance of {@link RegionNormalizerManager} */
   RegionNormalizerManager getRegionNormalizerManager();
 
-  /**
-   * @return Master's instance of {@link CatalogJanitor}
-   */
+  /** Returns Master's instance of {@link CatalogJanitor} */
   CatalogJanitor getCatalogJanitor();
 
-  /**
-   * @return Master's instance of {@link ProcedureExecutor}
-   */
+  /** Returns Master's instance of {@link ProcedureExecutor} */
   ProcedureExecutor<MasterProcedureEnv> getMasterProcedureExecutor();
 
-  /**
-   * @return Tripped when Master has finished initialization.
-   */
+  /** Returns Tripped when Master has finished initialization. */
   public ProcedureEvent<?> getInitializedEvent();
 
-  /**
-   * @return Master's instance of {@link MetricsMaster}
-   */
+  /** Returns Master's instance of {@link MetricsMaster} */
   MetricsMaster getMasterMetrics();
 
   /**
@@ -264,9 +232,7 @@ public interface MasterServices extends Server {
   long splitRegion(final RegionInfo regionInfo, final byte[] splitRow, final long nonceGroup,
     final long nonce) throws IOException;
 
-  /**
-   * @return Return table descriptors implementation.
-   */
+  /** Returns Return table descriptors implementation. */
   TableDescriptors getTableDescriptors();
 
   /**
@@ -282,14 +248,10 @@ public interface MasterServices extends Server {
    */
   boolean registerService(Service instance);
 
-  /**
-   * @return true if master is the active one
-   */
+  /** Returns true if master is the active one */
   boolean isActiveMaster();
 
-  /**
-   * @return true if master is initialized
-   */
+  /** Returns true if master is initialized */
   boolean isInitialized();
 
   /**
@@ -352,16 +314,12 @@ public interface MasterServices extends Server {
    */
   public long getLastMajorCompactionTimestampForRegion(byte[] regionName) throws IOException;
 
-  /**
-   * @return load balancer
-   */
+  /** Returns load balancer */
   public LoadBalancer getLoadBalancer();
 
   boolean isSplitOrMergeEnabled(MasterSwitchType switchType);
 
-  /**
-   * @return Favored Nodes Manager
-   */
+  /** Returns Favored Nodes Manager */
   public FavoredNodesManager getFavoredNodesManager();
 
   /**
@@ -433,9 +391,7 @@ public interface MasterServices extends Server {
   long transitReplicationPeerSyncReplicationState(String peerId, SyncReplicationState clusterState)
     throws ReplicationException, IOException;
 
-  /**
-   * @return {@link LockManager} to lock namespaces/tables/regions.
-   */
+  /** Returns {@link LockManager} to lock namespaces/tables/regions. */
   LockManager getLockManager();
 
   public String getRegionServerVersion(final ServerName sn);
@@ -448,26 +404,18 @@ public interface MasterServices extends Server {
 
   String getClientIdAuditPrefix();
 
-  /**
-   * @return True if cluster is up; false if cluster is not up (we are shutting down).
-   */
+  /** Returns True if cluster is up; false if cluster is not up (we are shutting down). */
   boolean isClusterUp();
 
-  /**
-   * @return return null if current is zk-based WAL splitting
-   */
+  /** Returns return null if current is zk-based WAL splitting */
   default SplitWALManager getSplitWALManager() {
     return null;
   }
 
-  /**
-   * @return the {@link AccessChecker}
-   */
+  /** Returns the {@link AccessChecker} */
   AccessChecker getAccessChecker();
 
-  /**
-   * @return the {@link ZKPermissionWatcher}
-   */
+  /** Returns the {@link ZKPermissionWatcher} */
   ZKPermissionWatcher getZKPermissionWatcher();
 
   /**
@@ -482,9 +430,7 @@ public interface MasterServices extends Server {
    */
   void runReplicationBarrierCleaner();
 
-  /**
-   * @return the {@link RSGroupInfoManager}
-   */
+  /** Returns the {@link RSGroupInfoManager} */
   RSGroupInfoManager getRSGroupInfoManager();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterWalManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterWalManager.java
index e53a5828487..aca04a8ac83 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterWalManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterWalManager.java
@@ -172,9 +172,7 @@ public class MasterWalManager {
       p -> !p.getName().endsWith(AbstractFSWALProvider.SPLITTING_EXT));
   }
 
-  /**
-   * @return listing of ServerNames found by parsing WAL directory paths in FS.
-   */
+  /** Returns listing of ServerNames found by parsing WAL directory paths in FS. */
   public Set<ServerName> getServerNamesFromWALDirPath(final PathFilter filter) throws IOException {
     FileStatus[] walDirForServerNames = getWALDirPaths(filter);
     return Stream.of(walDirForServerNames).map(s -> {
@@ -190,7 +188,7 @@ public class MasterWalManager {
   }
 
   /**
-   * @return List of all RegionServer WAL dirs; i.e. this.rootDir/HConstants.HREGION_LOGDIR_NAME.
+   * Returns List of all RegionServer WAL dirs; i.e. this.rootDir/HConstants.HREGION_LOGDIR_NAME.
    */
   public FileStatus[] getWALDirPaths(final PathFilter filter) throws IOException {
     Path walDirPath = new Path(CommonFSUtils.getWALRootDir(conf), HConstants.HREGION_LOGDIR_NAME);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MetricsAssignmentManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MetricsAssignmentManager.java
index 41575c5a7bd..eaf335e52ef 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MetricsAssignmentManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MetricsAssignmentManager.java
@@ -127,58 +127,42 @@ public class MetricsAssignmentManager {
     assignmentManagerSource.setEmptyRegionInfoRegions(emptyRegionInfoRegions);
   }
 
-  /**
-   * @return Set of common metrics for assign procedure
-   */
+  /** Returns Set of common metrics for assign procedure */
   public ProcedureMetrics getAssignProcMetrics() {
     return assignProcMetrics;
   }
 
-  /**
-   * @return Set of common metrics for unassign procedure
-   */
+  /** Returns Set of common metrics for unassign procedure */
   public ProcedureMetrics getUnassignProcMetrics() {
     return unassignProcMetrics;
   }
 
-  /**
-   * @return Set of common metrics for move procedure
-   */
+  /** Returns Set of common metrics for move procedure */
   public ProcedureMetrics getMoveProcMetrics() {
     return moveProcMetrics;
   }
 
-  /**
-   * @return Set of common metrics for reopen procedure
-   */
+  /** Returns Set of common metrics for reopen procedure */
   public ProcedureMetrics getReopenProcMetrics() {
     return reopenProcMetrics;
   }
 
-  /**
-   * @return Set of common metrics for OpenRegionProcedure
-   */
+  /** Returns Set of common metrics for OpenRegionProcedure */
   public ProcedureMetrics getOpenProcMetrics() {
     return openProcMetrics;
   }
 
-  /**
-   * @return Set of common metrics for CloseRegionProcedure
-   */
+  /** Returns Set of common metrics for CloseRegionProcedure */
   public ProcedureMetrics getCloseProcMetrics() {
     return closeProcMetrics;
   }
 
-  /**
-   * @return Set of common metrics for split procedure
-   */
+  /** Returns Set of common metrics for split procedure */
   public ProcedureMetrics getSplitProcMetrics() {
     return splitProcMetrics;
   }
 
-  /**
-   * @return Set of common metrics for merge procedure
-   */
+  /** Returns Set of common metrics for merge procedure */
   public ProcedureMetrics getMergeProcMetrics() {
     return mergeProcMetrics;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MetricsMaster.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MetricsMaster.java
index 616e5f67b56..bb5fc7233f1 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MetricsMaster.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/MetricsMaster.java
@@ -130,9 +130,7 @@ public class MetricsMaster {
     masterQuotaSource.incrementSpaceQuotaObserverChoreTime(executionTime);
   }
 
-  /**
-   * @return Set of metrics for assign procedure
-   */
+  /** Returns Set of metrics for assign procedure */
   public ProcedureMetrics getServerCrashProcMetrics() {
     return serverCrashProcMetrics;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/RegionPlacementMaintainer.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/RegionPlacementMaintainer.java
index 162ee11145d..39d21e32032 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/RegionPlacementMaintainer.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/RegionPlacementMaintainer.java
@@ -133,9 +133,7 @@ public class RegionPlacementMaintainer implements Closeable {
     }
   }
 
-  /**
-   * @return the new RegionAssignmentSnapshot
-   */
+  /** Returns the new RegionAssignmentSnapshot */
   public SnapshotOfRegionAssignmentFromMeta getRegionAssignmentSnapshot() throws IOException {
     SnapshotOfRegionAssignmentFromMeta currentAssignmentShapshot =
       new SnapshotOfRegionAssignmentFromMeta(ConnectionFactory.createConnection(conf));
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/ServerManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/ServerManager.java
index ad7455df67c..d39dcc9ddad 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/ServerManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/ServerManager.java
@@ -466,15 +466,13 @@ public class ServerManager {
     return numServers == 0 ? 0 : (double) totalLoad / (double) numServers;
   }
 
-  /** @return the count of active regionservers */
+  /** Returns the count of active regionservers */
   public int countOfRegionServers() {
     // Presumes onlineServers is a concurrent map
     return this.onlineServers.size();
   }
 
-  /**
-   * @return Read-only map of servers to serverinfo
-   */
+  /** Returns Read-only map of servers to serverinfo */
   public Map<ServerName, ServerMetrics> getOnlineServers() {
     // Presumption is that iterating the returned Map is OK.
     synchronized (this.onlineServers) {
@@ -817,9 +815,7 @@ public class ServerManager {
     return max == Integer.MAX_VALUE ? "NO_LIMIT" : Integer.toString(max);
   }
 
-  /**
-   * @return A copy of the internal list of online servers.
-   */
+  /** Returns A copy of the internal list of online servers. */
   public List<ServerName> getOnlineServersList() {
     // TODO: optimize the load balancer call so we don't need to make a new list
     // TODO: FIX. THIS IS POPULAR CALL.
@@ -847,9 +843,7 @@ public class ServerManager {
     return names;
   }
 
-  /**
-   * @return A copy of the internal list of draining servers.
-   */
+  /** Returns A copy of the internal list of draining servers. */
   public List<ServerName> getDrainingServersList() {
     return new ArrayList<>(this.drainingServers);
   }
@@ -864,9 +858,7 @@ public class ServerManager {
     UNKNOWN
   }
 
-  /**
-   * @return whether the server is online, dead, or unknown.
-   */
+  /** Returns whether the server is online, dead, or unknown. */
   public synchronized ServerLiveState isServerKnownAndOnline(ServerName serverName) {
     return onlineServers.containsKey(serverName)
       ? ServerLiveState.LIVE
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/SnapshotSentinel.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/SnapshotSentinel.java
index 0a564b9b9c6..e14027bf173 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/SnapshotSentinel.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/SnapshotSentinel.java
@@ -37,9 +37,7 @@ public interface SnapshotSentinel {
    */
   boolean isFinished();
 
-  /**
-   * @return -1 if the snapshot is in progress, otherwise the completion timestamp.
-   */
+  /** Returns -1 if the snapshot is in progress, otherwise the completion timestamp. */
   long getCompletionTimestamp();
 
   /**
@@ -48,9 +46,7 @@ public interface SnapshotSentinel {
    */
   void cancel(String why);
 
-  /**
-   * @return the description of the snapshot being run
-   */
+  /** Returns the description of the snapshot being run */
   SnapshotDescription getSnapshot();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/AssignmentManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/AssignmentManager.java
index 75803714e69..4301a861bd7 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/AssignmentManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/AssignmentManager.java
@@ -2399,9 +2399,7 @@ public class AssignmentManager {
     return master;
   }
 
-  /**
-   * @return a snapshot of rsReports
-   */
+  /** Returns a snapshot of rsReports */
   public Map<ServerName, Set<byte[]>> getRSReports() {
     Map<ServerName, Set<byte[]>> rsReportsSnapshot = new HashMap<>();
     synchronized (rsReports) {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/MergeTableRegionsProcedure.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/MergeTableRegionsProcedure.java
index cad960e9518..1fe43aba7da 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/MergeTableRegionsProcedure.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/MergeTableRegionsProcedure.java
@@ -742,9 +742,7 @@ public class MergeTableRegionsProcedure
     }
   }
 
-  /**
-   * @return The merged region. Maybe be null if called to early or we failed.
-   */
+  /** Returns The merged region. Maybe be null if called to early or we failed. */
   RegionInfo getMergedRegion() {
     return this.mergedRegion;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/RegionStateStore.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/RegionStateStore.java
index e8a7a3f427f..facaf5d55b9 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/RegionStateStore.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/RegionStateStore.java
@@ -436,7 +436,7 @@ public class RegionStateStore {
   }
 
   /**
-   * @return Return all regioninfos listed in the 'info:merge*' columns of the given {@code region}.
+   * Returns Return all regioninfos listed in the 'info:merge*' columns of the given {@code region}.
    */
   public List<RegionInfo> getMergeRegions(RegionInfo region) throws IOException {
     return CatalogFamilyFormat.getMergeRegions(getRegionCatalogResult(region).rawCells());
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/RegionStates.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/RegionStates.java
index 7a59a00ce73..aa551c825df 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/RegionStates.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/RegionStates.java
@@ -197,12 +197,12 @@ public class RegionStates {
     return regions;
   }
 
-  /** @return A view of region state nodes for all the regions. */
+  /** Returns A view of region state nodes for all the regions. */
   public Collection<RegionStateNode> getRegionStateNodes() {
     return Collections.unmodifiableCollection(regionsMap.values());
   }
 
-  /** @return A snapshot of region state nodes for all the regions. */
+  /** Returns A snapshot of region state nodes for all the regions. */
   public ArrayList<RegionState> getRegionStates() {
     final ArrayList<RegionState> regions = new ArrayList<>(regionsMap.size());
     for (RegionStateNode node : regionsMap.values()) {
@@ -235,9 +235,7 @@ public class RegionStates {
     return !getTableRegionStates(tableName).isEmpty();
   }
 
-  /**
-   * @return Return online regions of table; does not include OFFLINE or SPLITTING regions.
-   */
+  /** Returns Return online regions of table; does not include OFFLINE or SPLITTING regions. */
   public List<RegionInfo> getRegionsOfTable(TableName table) {
     return getRegionsOfTable(table, regionNode -> !regionNode.isInState(State.OFFLINE, State.SPLIT)
       && !regionNode.getRegionInfo().isSplitParent());
@@ -370,9 +368,7 @@ public class RegionStates {
       .collect(Collectors.toList());
   }
 
-  /**
-   * @return Return the regions of the table and filter them.
-   */
+  /** Returns Return the regions of the table and filter them. */
   private List<RegionInfo> getRegionsOfTable(TableName table, Predicate<RegionStateNode> filter) {
     return getTableRegionStateNodes(table).stream().filter(filter).map(n -> n.getRegionInfo())
       .collect(Collectors.toList());
@@ -483,9 +479,7 @@ public class RegionStates {
     return isRegionInState(regionInfo, State.OPEN);
   }
 
-  /**
-   * @return True if region is offline (In OFFLINE or CLOSED state).
-   */
+  /** Returns True if region is offline (In OFFLINE or CLOSED state). */
   public boolean isRegionOffline(final RegionInfo regionInfo) {
     return isRegionInState(regionInfo, State.OFFLINE, State.CLOSED);
   }
@@ -768,9 +762,7 @@ public class RegionStates {
     serverMap.remove(serverName);
   }
 
-  /**
-   * @return Pertinent ServerStateNode or NULL if none found (Do not make modifications).
-   */
+  /** Returns Pertinent ServerStateNode or NULL if none found (Do not make modifications). */
   public ServerStateNode getServerNode(final ServerName serverName) {
     return serverMap.get(serverName);
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/UnassignProcedure.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/UnassignProcedure.java
index 60c9609d3a2..59003412a8d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/UnassignProcedure.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/assignment/UnassignProcedure.java
@@ -130,7 +130,7 @@ public class UnassignProcedure extends RegionTransitionProcedure {
   }
 
   /**
-   * @return If true, we will re-wake up this procedure; if false, the procedure stays suspended.
+   * Returns If true, we will re-wake up this procedure; if false, the procedure stays suspended.
    */
   @Override
   protected boolean remoteCallFailed(final MasterProcedureEnv env, final RegionStateNode regionNode,
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/hbck/HbckChore.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/hbck/HbckChore.java
index c9021236f40..3a0fd15d6ea 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/hbck/HbckChore.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/hbck/HbckChore.java
@@ -82,7 +82,7 @@ public class HbckChore extends ScheduledChore {
   }
 
   /**
-   * @return Returns last published Report that comes of last successful execution of this chore.
+   * Returns Returns last published Report that comes of last successful execution of this chore.
    */
   public HbckReport getLastReport() {
     return lastReport;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/CatalogJanitor.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/CatalogJanitor.java
index 3d196b85374..9c0513b56b9 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/CatalogJanitor.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/CatalogJanitor.java
@@ -238,9 +238,7 @@ public class CatalogJanitor extends ScheduledChore {
     return visitor.getReport();
   }
 
-  /**
-   * @return Returns last published Report that comes of last successful scan of hbase:meta.
-   */
+  /** Returns Returns last published Report that comes of last successful scan of hbase:meta. */
   public CatalogJanitorReport getLastReport() {
     return this.lastReport;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/CatalogJanitorReport.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/CatalogJanitorReport.java
index 6a9eb7e1b4e..57ecb626d1e 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/CatalogJanitorReport.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/CatalogJanitorReport.java
@@ -85,9 +85,7 @@ public class CatalogJanitorReport {
     return emptyRegionInfo;
   }
 
-  /**
-   * @return True if an 'empty' lastReport -- no problems found.
-   */
+  /** Returns True if an 'empty' lastReport -- no problems found. */
   public boolean isEmpty() {
     return this.holes.isEmpty() && this.overlaps.isEmpty() && this.unknownServers.isEmpty()
       && this.emptyRegionInfo.isEmpty();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/ReportMakingVisitor.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/ReportMakingVisitor.java
index 172e9671b2e..8ced538212b 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/ReportMakingVisitor.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/janitor/ReportMakingVisitor.java
@@ -196,9 +196,7 @@ class ReportMakingVisitor implements ClientMetaTableAccessor.CloseableVisitor {
     this.report.holes.add(new Pair<>(a, b));
   }
 
-  /**
-   * @return True if table is disabled or disabling; defaults false!
-   */
+  /** Returns True if table is disabled or disabling; defaults false! */
   boolean isTableDisabled(RegionInfo ri) {
     if (ri == null) {
       return false;
@@ -275,9 +273,7 @@ class ReportMakingVisitor implements ClientMetaTableAccessor.CloseableVisitor {
     }
   }
 
-  /**
-   * @return True iff first row in hbase:meta or if we've broached a new table in hbase:meta
-   */
+  /** Returns True iff first row in hbase:meta or if we've broached a new table in hbase:meta */
   private boolean isTableTransition(RegionInfo ri) {
     return this.previous == null || !this.previous.getTable().equals(ri.getTable());
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/normalizer/NormalizationPlan.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/normalizer/NormalizationPlan.java
index 435553eb8cf..0e0d39d10b1 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/normalizer/NormalizationPlan.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/normalizer/NormalizationPlan.java
@@ -32,8 +32,6 @@ public interface NormalizationPlan {
     NONE
   }
 
-  /**
-   * @return the type of this plan
-   */
+  /** Returns the type of this plan */
   PlanType getType();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/normalizer/SimpleRegionNormalizer.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/normalizer/SimpleRegionNormalizer.java
index 4d0996871c6..c55f9ebdaca 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/normalizer/SimpleRegionNormalizer.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/normalizer/SimpleRegionNormalizer.java
@@ -234,9 +234,7 @@ class SimpleRegionNormalizer implements RegionNormalizer, ConfigurationObserver
     return plans;
   }
 
-  /**
-   * @return size of region in MB and if region is not found than -1
-   */
+  /** Returns size of region in MB and if region is not found than -1 */
   private long getRegionSizeMB(RegionInfo hri) {
     ServerName sn =
       masterServices.getAssignmentManager().getRegionStates().getRegionServerOfRegion(hri);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/AbstractStateMachineRegionProcedure.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/AbstractStateMachineRegionProcedure.java
index a6c2e52aef6..fe98a78b4d7 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/AbstractStateMachineRegionProcedure.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/AbstractStateMachineRegionProcedure.java
@@ -46,9 +46,7 @@ public abstract class AbstractStateMachineRegionProcedure<TState>
     super();
   }
 
-  /**
-   * @return The RegionInfo of the region we are operating on.
-   */
+  /** Returns The RegionInfo of the region we are operating on. */
   public RegionInfo getRegion() {
     return this.hri;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/EnableTableProcedure.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/EnableTableProcedure.java
index b42cc1a2f6f..3466bf68843 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/EnableTableProcedure.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/EnableTableProcedure.java
@@ -342,9 +342,7 @@ public class EnableTableProcedure extends AbstractStateMachineTableProcedure<Ena
     }
   }
 
-  /**
-   * @return Maximum region replica id found in passed list of regions.
-   */
+  /** Returns Maximum region replica id found in passed list of regions. */
   private static int getMaxReplicaId(List<RegionInfo> regions) {
     int max = 0;
     for (RegionInfo regionInfo : regions) {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/ServerCrashProcedure.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/ServerCrashProcedure.java
index 2f242bf000e..0bd0f3ba0c7 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/ServerCrashProcedure.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/ServerCrashProcedure.java
@@ -265,9 +265,7 @@ public class ServerCrashProcedure extends
     return Flow.HAS_MORE_STATE;
   }
 
-  /**
-   * @return List of Regions on crashed server.
-   */
+  /** Returns List of Regions on crashed server. */
   List<RegionInfo> getRegionsOnCrashedServer(MasterProcedureEnv env) {
     return env.getMasterServices().getAssignmentManager().getRegionsOnServer(serverName);
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/ServerProcedureInterface.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/ServerProcedureInterface.java
index 6578754a0db..1d7dcb77e09 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/ServerProcedureInterface.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/ServerProcedureInterface.java
@@ -58,14 +58,10 @@ public interface ServerProcedureInterface {
     VERIFY_SNAPSHOT
   }
 
-  /**
-   * @return Name of this server instance.
-   */
+  /** Returns Name of this server instance. */
   ServerName getServerName();
 
-  /**
-   * @return True if this server has an hbase:meta table region.
-   */
+  /** Returns True if this server has an hbase:meta table region. */
   boolean hasMetaTableRegion();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/TableProcedureInterface.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/TableProcedureInterface.java
index 80e24b68458..c689e52302f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/TableProcedureInterface.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/procedure/TableProcedureInterface.java
@@ -51,9 +51,7 @@ public interface TableProcedureInterface {
     MERGED_REGIONS_GC/* region operations */
   }
 
-  /**
-   * @return the name of the table the procedure is operating on
-   */
+  /** Returns the name of the table the procedure is operating on */
   TableName getTableName();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/replication/ReplicationPeerManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/replication/ReplicationPeerManager.java
index ad37bcc6b09..97fe9689c41 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/replication/ReplicationPeerManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/replication/ReplicationPeerManager.java
@@ -222,9 +222,7 @@ public class ReplicationPeerManager {
     return desc;
   }
 
-  /**
-   * @return the old desciption of the peer
-   */
+  /** Returns the old desciption of the peer */
   ReplicationPeerDescription preTransitPeerSyncReplicationState(String peerId,
     SyncReplicationState state) throws DoNotRetryIOException {
     ReplicationPeerDescription desc = checkPeerExists(peerId);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/snapshot/SnapshotFileCache.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/snapshot/SnapshotFileCache.java
index 5d9701d9bcc..e9a33f6cb28 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/snapshot/SnapshotFileCache.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/snapshot/SnapshotFileCache.java
@@ -349,9 +349,7 @@ public class SnapshotFileCache implements Stoppable {
       this.files = files;
     }
 
-    /**
-     * @return the hfiles in the snapshot when <tt>this</tt> was made.
-     */
+    /** Returns the hfiles in the snapshot when <tt>this</tt> was made. */
     public Collection<String> getFiles() {
       return this.files;
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.java
index 1ddcd2e3408..e9d1830b33d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.java
@@ -824,9 +824,7 @@ public class SnapshotManager extends MasterProcedureManager implements Stoppable
     }
   }
 
-  /**
-   * @return distributed commit coordinator for all running snapshots
-   */
+  /** Returns distributed commit coordinator for all running snapshots */
   ProcedureCoordinator getCoordinator() {
     return coordinator;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/zksyncer/ClientZKSyncer.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/zksyncer/ClientZKSyncer.java
index a9881ef9b64..ed5b78e211d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/master/zksyncer/ClientZKSyncer.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/master/zksyncer/ClientZKSyncer.java
@@ -271,9 +271,7 @@ public abstract class ClientZKSyncer extends ZKListener {
    */
   protected abstract boolean validate(String path);
 
-  /**
-   * @return the zk path(s) to watch
-   */
+  /** Returns the zk path(s) to watch */
   protected abstract Set<String> getPathsToWatch();
 
   protected final void refreshWatchingList() {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/procedure/Procedure.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/procedure/Procedure.java
index cd8ae58e53a..8eb477fb846 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/procedure/Procedure.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/procedure/Procedure.java
@@ -161,7 +161,7 @@ public class Procedure implements Callable<Void>, ForeignExceptionListener {
   }
 
   /**
-   * @return String of the procedure members both trying to enter the barrier and already in barrier
+   * Returns String of the procedure members both trying to enter the barrier and already in barrier
    */
   public String getStatus() {
     String waiting, done;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/procedure/ProcedureCoordinator.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/procedure/ProcedureCoordinator.java
index 116ac02abd4..e02776ecb69 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/procedure/ProcedureCoordinator.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/procedure/ProcedureCoordinator.java
@@ -290,9 +290,7 @@ public class ProcedureCoordinator {
     proc.barrierReleasedByMember(member, dataFromMember);
   }
 
-  /**
-   * @return the rpcs implementation for all current procedures
-   */
+  /** Returns the rpcs implementation for all current procedures */
   ProcedureCoordinatorRpcs getRpcs() {
     return rpcs;
   }
@@ -307,9 +305,7 @@ public class ProcedureCoordinator {
     return procedures.get(name);
   }
 
-  /**
-   * @return Return set of all procedure names.
-   */
+  /** Returns Return set of all procedure names. */
   public Set<String> getProcedureNames() {
     return new HashSet<>(procedures.keySet());
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/MasterQuotaManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/MasterQuotaManager.java
index 81e1ad74481..e310a4e4a45 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/MasterQuotaManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/MasterQuotaManager.java
@@ -523,9 +523,7 @@ public class MasterQuotaManager implements RegionStateListener {
     }
   }
 
-  /**
-   * @return cached region count, or -1 if quota manager is disabled or table status not found
-   */
+  /** Returns cached region count, or -1 if quota manager is disabled or table status not found */
   public int getRegionCountOfTable(TableName tName) throws IOException {
     if (initialized) {
       return namespaceQuotaManager.getRegionCountOfTable(tName);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/OperationQuota.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/OperationQuota.java
index 7ba88e51fd4..aaae64b6184 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/OperationQuota.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/OperationQuota.java
@@ -67,6 +67,6 @@ public interface OperationQuota {
    */
   void addMutation(Mutation mutation);
 
-  /** @return the number of bytes available to read to avoid exceeding the quota */
+  /** Returns the number of bytes available to read to avoid exceeding the quota */
   long getReadAvailable();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/QuotaLimiter.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/QuotaLimiter.java
index bbe2161a327..14326e4e0d2 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/QuotaLimiter.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/QuotaLimiter.java
@@ -70,12 +70,12 @@ public interface QuotaLimiter {
    */
   void consumeRead(long size, long capacityUnit);
 
-  /** @return true if the limiter is a noop */
+  /** Returns true if the limiter is a noop */
   boolean isBypass();
 
-  /** @return the number of bytes available to read to avoid exceeding the quota */
+  /** Returns the number of bytes available to read to avoid exceeding the quota */
   long getReadAvailable();
 
-  /** @return the number of bytes available to write to avoid exceeding the quota */
+  /** Returns the number of bytes available to write to avoid exceeding the quota */
   long getWriteAvailable();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/QuotaState.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/QuotaState.java
index 6f7b351ef09..7c9445e1558 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/QuotaState.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/QuotaState.java
@@ -69,9 +69,7 @@ public class QuotaState {
     return builder.toString();
   }
 
-  /**
-   * @return true if there is no quota information associated to this object
-   */
+  /** Returns true if there is no quota information associated to this object */
   public synchronized boolean isBypass() {
     return globalLimiter == NoopQuotaLimiter.get();
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/RateLimiter.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/RateLimiter.java
index 9e258e70951..b83e45e9407 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/RateLimiter.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/RateLimiter.java
@@ -199,15 +199,13 @@ public abstract class RateLimiter {
     }
   }
 
-  /**
-   * @return estimate of the ms required to wait before being able to provide 1 resource.
-   */
+  /** Returns estimate of the ms required to wait before being able to provide 1 resource. */
   public long waitInterval() {
     return waitInterval(1);
   }
 
   /**
-   * @return estimate of the ms required to wait before being able to provide "amount" resources.
+   * Returns estimate of the ms required to wait before being able to provide "amount" resources.
    */
   public synchronized long waitInterval(final long amount) {
     // TODO Handle over quota?
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/RegionServerSpaceQuotaManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/RegionServerSpaceQuotaManager.java
index 9bf98e777af..e26756529f8 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/RegionServerSpaceQuotaManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/RegionServerSpaceQuotaManager.java
@@ -107,9 +107,7 @@ public class RegionServerSpaceQuotaManager {
     started = false;
   }
 
-  /**
-   * @return if the {@code Chore} has been started.
-   */
+  /** Returns if the {@code Chore} has been started. */
   public boolean isStarted() {
     return started;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/UserQuotaState.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/UserQuotaState.java
index 4759672570e..6078c687d3d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/UserQuotaState.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/quotas/UserQuotaState.java
@@ -83,9 +83,7 @@ public class UserQuotaState extends QuotaState {
     return builder.toString();
   }
 
-  /**
-   * @return true if there is no quota information associated to this object
-   */
+  /** Returns true if there is no quota information associated to this object */
   @Override
   public synchronized boolean isBypass() {
     return !bypassGlobals && getGlobalLimiterWithoutUpdatingLastQuery() == NoopQuotaLimiter.get()
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/AbstractMemStore.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/AbstractMemStore.java
index af954474014..179c617462f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/AbstractMemStore.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/AbstractMemStore.java
@@ -218,9 +218,7 @@ public abstract class AbstractMemStore implements MemStore {
     }
   }
 
-  /**
-   * @return Oldest timestamp of all the Cells in the MemStore
-   */
+  /** Returns Oldest timestamp of all the Cells in the MemStore */
   @Override
   public long timeOfOldestEdit() {
     return timeOfOldestEdit;
@@ -356,7 +354,7 @@ public abstract class AbstractMemStore implements MemStore {
   }
 
   /**
-   * @return The total size of cells in this memstore. We will not consider cells in the snapshot
+   * Returns The total size of cells in this memstore. We will not consider cells in the snapshot
    */
   protected abstract long keySize();
 
@@ -378,9 +376,7 @@ public abstract class AbstractMemStore implements MemStore {
     return snapshot;
   }
 
-  /**
-   * @return an ordered list of segments from most recent to oldest in memstore
-   */
+  /** Returns an ordered list of segments from most recent to oldest in memstore */
   protected abstract List<Segment> getSegments() throws IOException;
 
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ChangedReadersObserver.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ChangedReadersObserver.java
index a7a3dc800ce..d45a8046873 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ChangedReadersObserver.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ChangedReadersObserver.java
@@ -27,9 +27,7 @@ import org.apache.yetus.audience.InterfaceAudience;
 @InterfaceAudience.Private
 public interface ChangedReadersObserver {
 
-  /**
-   * @return the read point of the current scan
-   */
+  /** Returns the read point of the current scan */
   long getReadPoint();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Chunk.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Chunk.java
index eb6282bf163..5e37ce4ee72 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Chunk.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Chunk.java
@@ -171,9 +171,7 @@ public abstract class Chunk {
     }
   }
 
-  /**
-   * @return This chunk's backing data.
-   */
+  /** Returns This chunk's backing data. */
   ByteBuffer getData() {
     return this.data;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/CompactSplit.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/CompactSplit.java
index 6719db72c8c..8a6e806292a 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/CompactSplit.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/CompactSplit.java
@@ -497,9 +497,7 @@ public class CompactSplit implements CompactionRequester, PropagatingConfigurati
     return (regionSplitLimit > server.getNumberOfOnlineRegions());
   }
 
-  /**
-   * @return the regionSplitLimit
-   */
+  /** Returns the regionSplitLimit */
   public int getRegionSplitLimit() {
     return this.regionSplitLimit;
   }
@@ -856,16 +854,12 @@ public class CompactSplit implements CompactionRequester, PropagatingConfigurati
     this.conf.set(HBASE_REGION_SERVER_ENABLE_COMPACTION, String.valueOf(compactionsEnabled));
   }
 
-  /**
-   * @return the longCompactions thread pool executor
-   */
+  /** Returns the longCompactions thread pool executor */
   ThreadPoolExecutor getLongCompactions() {
     return longCompactions;
   }
 
-  /**
-   * @return the shortCompactions thread pool executor
-   */
+  /** Returns the shortCompactions thread pool executor */
   ThreadPoolExecutor getShortCompactions() {
     return shortCompactions;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/CompositeImmutableSegment.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/CompositeImmutableSegment.java
index 57cc0c6f21a..f955eb5d582 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/CompositeImmutableSegment.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/CompositeImmutableSegment.java
@@ -58,9 +58,7 @@ public class CompositeImmutableSegment extends ImmutableSegment {
     return segments.size();
   }
 
-  /**
-   * @return whether the segment has any cells
-   */
+  /** Returns whether the segment has any cells */
   @Override
   public boolean isEmpty() {
     for (ImmutableSegment s : segments) {
@@ -69,9 +67,7 @@ public class CompositeImmutableSegment extends ImmutableSegment {
     return true;
   }
 
-  /**
-   * @return number of cells in segment
-   */
+  /** Returns number of cells in segment */
   @Override
   public int getCellsCount() {
     int result = 0;
@@ -160,17 +156,13 @@ public class CompositeImmutableSegment extends ImmutableSegment {
     return false;
   }
 
-  /**
-   * @return Sum of all cell sizes.
-   */
+  /** Returns Sum of all cell sizes. */
   @Override
   public long getDataSize() {
     return this.keySize;
   }
 
-  /**
-   * @return The heap size of this segment.
-   */
+  /** Returns The heap size of this segment. */
   @Override
   public long getHeapSize() {
     long result = 0;
@@ -224,9 +216,7 @@ public class CompositeImmutableSegment extends ImmutableSegment {
     throw new IllegalStateException("Not supported by CompositeImmutableScanner");
   }
 
-  /**
-   * @return a set of all cells in the segment
-   */
+  /** Returns a set of all cells in the segment */
   @Override
   protected CellSet getCellSet() {
     throw new IllegalStateException("Not supported by CompositeImmutableScanner");
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ConstantSizeRegionSplitPolicy.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ConstantSizeRegionSplitPolicy.java
index e0d7627a929..be8fbb1b320 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ConstantSizeRegionSplitPolicy.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ConstantSizeRegionSplitPolicy.java
@@ -90,9 +90,7 @@ public class ConstantSizeRegionSplitPolicy extends RegionSplitPolicy {
     return this.jitterRate > 0;
   }
 
-  /**
-   * @return true if region size exceed the sizeToCheck
-   */
+  /** Returns true if region size exceed the sizeToCheck */
   protected final boolean isExceedSize(long sizeToCheck) {
     if (overallHRegionFiles) {
       long sumSize = 0;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/FlushNonSloppyStoresFirstPolicy.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/FlushNonSloppyStoresFirstPolicy.java
index 75277fdcab6..b130373ab74 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/FlushNonSloppyStoresFirstPolicy.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/FlushNonSloppyStoresFirstPolicy.java
@@ -33,9 +33,7 @@ public class FlushNonSloppyStoresFirstPolicy extends FlushLargeStoresPolicy {
   private Collection<HStore> regularStores = new HashSet<>();
   private Collection<HStore> sloppyStores = new HashSet<>();
 
-  /**
-   * @return the stores need to be flushed.
-   */
+  /** Returns the stores need to be flushed. */
   @Override
   public Collection<HStore> selectStoresToFlush() {
     Collection<HStore> specificStoresToFlush = new HashSet<>();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/FlushPolicy.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/FlushPolicy.java
index fb9f8c8cb7a..401f79ce383 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/FlushPolicy.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/FlushPolicy.java
@@ -40,8 +40,6 @@ public abstract class FlushPolicy extends Configured {
     this.region = region;
   }
 
-  /**
-   * @return the stores need to be flushed.
-   */
+  /** Returns the stores need to be flushed. */
   public abstract Collection<HStore> selectStoresToFlush();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegion.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegion.java
index c9340bb59fc..0857ace1f66 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegion.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegion.java
@@ -629,9 +629,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     private boolean failedSanityCheck = false;
     private boolean wrongFamily = false;
 
-    /**
-     * @return If a {@link WrongRegionException} has been observed.
-     */
+    /** Returns If a {@link WrongRegionException} has been observed. */
     boolean hasSeenWrongRegion() {
       return wrongRegion;
     }
@@ -643,9 +641,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
       wrongRegion = true;
     }
 
-    /**
-     * @return If a {@link FailedSanityCheckException} has been observed.
-     */
+    /** Returns If a {@link FailedSanityCheckException} has been observed. */
     boolean hasSeenFailedSanityCheck() {
       return failedSanityCheck;
     }
@@ -657,9 +653,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
       failedSanityCheck = true;
     }
 
-    /**
-     * @return If a {@link NoSuchColumnFamilyException} has been observed.
-     */
+    /** Returns If a {@link NoSuchColumnFamilyException} has been observed. */
     boolean hasSeenNoSuchFamily() {
       return wrongFamily;
     }
@@ -1205,9 +1199,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     }
   }
 
-  /**
-   * @return Map of StoreFiles by column family
-   */
+  /** Returns Map of StoreFiles by column family */
   private NavigableMap<byte[], List<Path>> getStoreFiles() {
     NavigableMap<byte[], List<Path>> allStoreFiles = new TreeMap<>(Bytes.BYTES_COMPARATOR);
     for (HStore store : stores.values()) {
@@ -1252,9 +1244,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     }
   }
 
-  /**
-   * @return True if this region has references.
-   */
+  /** Returns True if this region has references. */
   public boolean hasReferences() {
     return stores.values().stream().anyMatch(HStore::hasReferences);
   }
@@ -1377,9 +1367,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     return this.fs.getRegionInfo();
   }
 
-  /**
-   * @return Instance of {@link RegionServerServices} used by this HRegion. Can be null.
-   */
+  /** Returns Instance of {@link RegionServerServices} used by this HRegion. Can be null. */
   RegionServerServices getRegionServerServices() {
     return this.rsServices;
   }
@@ -1419,7 +1407,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     return memStoreSizing.getOffHeapSize();
   }
 
-  /** @return store services for this region, to access services required by store level needs */
+  /** Returns store services for this region, to access services required by store level needs */
   public RegionServicesForStores getRegionServicesForStores() {
     return regionServicesForStores;
   }
@@ -1510,9 +1498,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     return maxFlushedSeqId;
   }
 
-  /**
-   * @return readpoint considering given IsolationLevel. Pass {@code null} for default
-   */
+  /** Returns readpoint considering given IsolationLevel. Pass {@code null} for default */
   public long getReadPoint(IsolationLevel isolationLevel) {
     if (isolationLevel != null && isolationLevel == IsolationLevel.READ_UNCOMMITTED) {
       // This scan can read even uncommitted transactions
@@ -2009,9 +1995,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
       });
   }
 
-  /**
-   * @return True if its worth doing a flush before we put up the close flag.
-   */
+  /** Returns True if its worth doing a flush before we put up the close flag. */
   private boolean worthPreFlushing() {
     return this.memStoreSizing.getDataSize()
         > this.conf.getLong("hbase.hregion.preclose.flush.size", 1024 * 1024 * 5);
@@ -2030,7 +2014,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     htableDescriptor = desc;
   }
 
-  /** @return WAL in use for this region */
+  /** Returns WAL in use for this region */
   public WAL getWAL() {
     return this.wal;
   }
@@ -2057,9 +2041,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     this.mobFileCache = mobFileCache;
   }
 
-  /**
-   * @return split policy for this region.
-   */
+  /** Returns split policy for this region. */
   RegionSplitPolicy getSplitPolicy() {
     return this.splitPolicy;
   }
@@ -2075,23 +2057,23 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     return this.baseConf;
   }
 
-  /** @return {@link FileSystem} being used by this region */
+  /** Returns {@link FileSystem} being used by this region */
   public FileSystem getFilesystem() {
     return fs.getFileSystem();
   }
 
-  /** @return the {@link HRegionFileSystem} used by this region */
+  /** Returns the {@link HRegionFileSystem} used by this region */
   public HRegionFileSystem getRegionFileSystem() {
     return this.fs;
   }
 
-  /** @return the WAL {@link HRegionFileSystem} used by this region */
+  /** Returns the WAL {@link HRegionFileSystem} used by this region */
   HRegionWALFileSystem getRegionWALFileSystem() throws IOException {
     return new HRegionWALFileSystem(conf, getWalFileSystem(),
       CommonFSUtils.getWALTableDir(conf, htableDescriptor.getTableName()), fs.getRegionInfo());
   }
 
-  /** @return the WAL {@link FileSystem} being used by this region */
+  /** Returns the WAL {@link FileSystem} being used by this region */
   FileSystem getWalFileSystem() throws IOException {
     if (walFS == null) {
       walFS = CommonFSUtils.getWALFileSystem(conf);
@@ -2404,13 +2386,13 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
       CANNOT_FLUSH
     }
 
-    /** @return the detailed result code */
+    /** Returns the detailed result code */
     Result getResult();
 
-    /** @return true if the memstores were flushed, else false */
+    /** Returns true if the memstores were flushed, else false */
     boolean isFlushSucceeded();
 
-    /** @return True if the flush requested a compaction, else false */
+    /** Returns True if the flush requested a compaction, else false */
     boolean isCompactionNeeded();
   }
 
@@ -2861,9 +2843,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     }
   }
 
-  /**
-   * @return True if passed Set is all families in the region.
-   */
+  /** Returns True if passed Set is all families in the region. */
   private boolean isAllFamilies(Collection<HStore> families) {
     return families == null || this.stores.size() == families.size();
   }
@@ -4136,9 +4116,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
       }
     }
 
-    /**
-     * @return Get the long out of the passed in Cell
-     */
+    /** Returns Get the long out of the passed in Cell */
     private static long getLongValue(final Cell cell) throws DoNotRetryIOException {
       int len = cell.getValueLength();
       if (len != Bytes.SIZEOF_LONG) {
@@ -7963,9 +7941,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     });
   }
 
-  /**
-   * @return statistics about the current load of the region
-   */
+  /** Returns statistics about the current load of the region */
   public ClientProtos.RegionLoadStats getLoadStatistics() {
     if (!regionStatsEnabled) {
       return null;
@@ -8042,9 +8018,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     return walKey;
   }
 
-  /**
-   * @return writeEntry associated with this append
-   */
+  /** Returns writeEntry associated with this append */
   private WriteEntry doWALAppend(WALEdit walEdit, BatchOperation<?> batchOp,
     MiniBatchOperationInProgress<Mutation> miniBatchOp, long now, NonceKey nonceKey)
     throws IOException {
@@ -8280,9 +8254,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     }
   }
 
-  /**
-   * @return The priority that this region should have in the compaction queue
-   */
+  /** Returns The priority that this region should have in the compaction queue */
   public int getCompactPriority() {
     if (checkSplit().isPresent() && conf.getBoolean(SPLIT_IGNORE_BLOCKING_ENABLED_KEY, false)) {
       // if a region should split, split it before compact
@@ -8292,7 +8264,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
       .orElse(Store.NO_PRIORITY);
   }
 
-  /** @return the coprocessor host */
+  /** Returns the coprocessor host */
   public RegionCoprocessorHost getCoprocessorHost() {
     return coprocessorHost;
   }
@@ -8521,7 +8493,7 @@ public class HRegion implements HeapSize, PropagatingConfigurationObserver, Regi
     return regionDurability.ordinal() > Durability.ASYNC_WAL.ordinal();
   }
 
-  /** @return the latest sequence number that was read from storage when this region was opened */
+  /** Returns the latest sequence number that was read from storage when this region was opened */
   public long getOpenSeqNum() {
     return this.openSeqNum;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionFileSystem.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionFileSystem.java
index 663e2b73ae2..2d2965d7237 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionFileSystem.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionFileSystem.java
@@ -124,12 +124,12 @@ public class HRegionFileSystem {
       conf.getInt("hdfs.client.sleep.before.retries", DEFAULT_BASE_SLEEP_BEFORE_RETRIES);
   }
 
-  /** @return the underlying {@link FileSystem} */
+  /** Returns the underlying {@link FileSystem} */
   public FileSystem getFileSystem() {
     return this.fs;
   }
 
-  /** @return the {@link RegionInfo} that describe this on-disk region view */
+  /** Returns the {@link RegionInfo} that describe this on-disk region view */
   public RegionInfo getRegionInfo() {
     return this.regionInfo;
   }
@@ -138,12 +138,12 @@ public class HRegionFileSystem {
     return this.regionInfoForFs;
   }
 
-  /** @return {@link Path} to the region's root directory. */
+  /** Returns {@link Path} to the region's root directory. */
   public Path getTableDir() {
     return this.tableDir;
   }
 
-  /** @return {@link Path} to the region directory. */
+  /** Returns {@link Path} to the region directory. */
   public Path getRegionDir() {
     return regionDir;
   }
@@ -151,7 +151,7 @@ public class HRegionFileSystem {
   // ===========================================================================
   // Temp Helpers
   // ===========================================================================
-  /** @return {@link Path} to the region's temp directory, used for file creations */
+  /** Returns {@link Path} to the region's temp directory, used for file creations */
   public Path getTempDir() {
     return new Path(getRegionDir(), REGION_TEMP_DIR);
   }
@@ -379,9 +379,7 @@ public class HRegionFileSystem {
     return false;
   }
 
-  /**
-   * @return the set of families present on disk n
-   */
+  /** Returns the set of families present on disk n */
   public Collection<String> getFamilies() throws IOException {
     FileStatus[] fds =
       CommonFSUtils.listStatus(fs, getRegionDir(), new FSUtils.FamilyDirFilter(fs));
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionServer.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionServer.java
index e79f4bec612..c18b7e73cdf 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionServer.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionServer.java
@@ -746,9 +746,7 @@ public class HRegionServer extends HBaseServerBase<RSRpcServices>
     }
   }
 
-  /**
-   * @return True if the cluster is up.
-   */
+  /** Returns True if the cluster is up. */
   @Override
   public boolean isClusterUp() {
     return this.masterless
@@ -1006,9 +1004,7 @@ public class HRegionServer extends HBaseServerBase<RSRpcServices>
     return allUserRegionsOffline;
   }
 
-  /**
-   * @return Current write count for all online regions.
-   */
+  /** Returns Current write count for all online regions. */
   private long getWriteRequestCount() {
     long writeCount = 0;
     for (Map.Entry<String, HRegion> e : this.onlineRegions.entrySet()) {
@@ -1741,9 +1737,7 @@ public class HRegionServer extends HBaseServerBase<RSRpcServices>
     }
   }
 
-  /**
-   * @return Master address tracker instance.
-   */
+  /** Returns Master address tracker instance. */
   public MasterAddressTracker getMasterAddressTracker() {
     return this.masterAddressTracker;
   }
@@ -2410,17 +2404,13 @@ public class HRegionServer extends HBaseServerBase<RSRpcServices>
     }
   }
 
-  /**
-   * @return Return the object that implements the replication source executorService.
-   */
+  /** Returns Return the object that implements the replication source executorService. */
   @Override
   public ReplicationSourceService getReplicationSourceService() {
     return replicationSourceHandler;
   }
 
-  /**
-   * @return Return the object that implements the replication sink executorService.
-   */
+  /** Returns Return the object that implements the replication sink executorService. */
   public ReplicationSinkService getReplicationSinkService() {
     return replicationSinkHandler;
   }
@@ -2692,7 +2682,7 @@ public class HRegionServer extends HBaseServerBase<RSRpcServices>
     return sortedRegions;
   }
 
-  /** @return reference to FlushRequester */
+  /** Returns reference to FlushRequester */
   @Override
   public FlushRequester getFlushRequester() {
     return this.cacheFlusher;
@@ -2708,9 +2698,7 @@ public class HRegionServer extends HBaseServerBase<RSRpcServices>
     return leaseManager;
   }
 
-  /**
-   * @return {@code true} when the data file system is available, {@code false} otherwise.
-   */
+  /** Returns {@code true} when the data file system is available, {@code false} otherwise. */
   boolean isDataFileSystemOk() {
     return this.dataFsOk;
   }
@@ -3198,9 +3186,7 @@ public class HRegionServer extends HBaseServerBase<RSRpcServices>
     return org.apache.commons.lang3.StringUtils.isNotBlank(healthScriptLocation);
   }
 
-  /**
-   * @return the underlying {@link CompactSplit} for the servers
-   */
+  /** Returns the underlying {@link CompactSplit} for the servers */
   public CompactSplit getCompactSplitThread() {
     return this.compactSplitThread;
   }
@@ -3262,9 +3248,7 @@ public class HRegionServer extends HBaseServerBase<RSRpcServices>
     return Optional.ofNullable(this.mobFileCache);
   }
 
-  /**
-   * @return : Returns the ConfigurationManager object for testing purposes.
-   */
+  /** Returns : Returns the ConfigurationManager object for testing purposes. */
   ConfigurationManager getConfigurationManager() {
     return configurationManager;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HStore.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HStore.java
index 33c2910fcea..54e18d61982 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HStore.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HStore.java
@@ -344,9 +344,7 @@ public class HStore
     return favoredNodes;
   }
 
-  /**
-   * @return MemStore Instance to use in this store.
-   */
+  /** Returns MemStore Instance to use in this store. */
   private MemStore getMemstore() {
     MemStore ms = null;
     // Check if in-memory-compaction configured. Note MemoryCompactionPolicy is an enum!
@@ -405,9 +403,7 @@ public class HStore
     return StoreEngine.create(store, conf, kvComparator);
   }
 
-  /**
-   * @return TTL in seconds of the specified family
-   */
+  /** Returns TTL in seconds of the specified family */
   public static long determineTTLFromFamily(final ColumnFamilyDescriptor family) {
     // HCD.getTimeToLive returns ttl in seconds. Convert to milliseconds.
     long ttl = family.getTimeToLive();
@@ -495,9 +491,7 @@ public class HStore
     return StoreUtils.getMaxMemStoreTSInList(this.getStorefiles());
   }
 
-  /**
-   * @return the data block encoder
-   */
+  /** Returns the data block encoder */
   public HFileDataBlockEncoder getDataBlockEncoder() {
     return dataBlockEncoder;
   }
@@ -587,9 +581,7 @@ public class HStore
     return memstore.timeOfOldestEdit();
   }
 
-  /**
-   * @return All store files.
-   */
+  /** Returns All store files. */
   @Override
   public Collection<HStoreFile> getStorefiles() {
     return this.storeEngine.getStoreFileManager().getStorefiles();
@@ -2394,9 +2386,7 @@ public class HStore
       .mapToInt(HStoreFile::getRefCount).sum();
   }
 
-  /**
-   * @return get maximum ref count of storeFile among all compacted HStore Files for the HStore
-   */
+  /** Returns get maximum ref count of storeFile among all compacted HStore Files for the HStore */
   public int getMaxCompactedStoreFileRefCount() {
     OptionalInt maxCompactedStoreFileRefCount = this.storeEngine.getStoreFileManager()
       .getCompactedfiles().stream().filter(sf -> sf.getReader() != null).filter(HStoreFile::isHFile)
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HStoreFile.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HStoreFile.java
index 641a500d069..510614cca27 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HStoreFile.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HStoreFile.java
@@ -324,9 +324,7 @@ public class HStoreFile implements StoreFile {
     return fileInfo.refCount.get();
   }
 
-  /**
-   * @return true if the file is still used in reads
-   */
+  /** Returns true if the file is still used in reads */
   public boolean isReferencedInReads() {
     int rc = fileInfo.refCount.get();
     assert rc >= 0; // we should not go negative.
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HeapMemoryManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HeapMemoryManager.java
index 4d8b6a97704..7a72b9af41c 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HeapMemoryManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HeapMemoryManager.java
@@ -230,9 +230,7 @@ public class HeapMemoryManager {
     return this.tunerOn;
   }
 
-  /**
-   * @return heap occupancy percentage, 0 &lt;= n &lt;= 1. or -0.0 for error asking JVM
-   */
+  /** Returns heap occupancy percentage, 0 &lt;= n &lt;= 1. or -0.0 for error asking JVM */
   public float getHeapOccupancyPercent() {
     return this.heapOccupancyPercent == Float.MAX_VALUE
       ? HEAP_OCCUPANCY_ERROR_VALUE
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/IncreasingToUpperBoundRegionSplitPolicy.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/IncreasingToUpperBoundRegionSplitPolicy.java
index 9e4933ab489..7a0393fc0ae 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/IncreasingToUpperBoundRegionSplitPolicy.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/IncreasingToUpperBoundRegionSplitPolicy.java
@@ -86,9 +86,7 @@ public class IncreasingToUpperBoundRegionSplitPolicy extends ConstantSizeRegionS
     return shouldSplit;
   }
 
-  /**
-   * @return Count of regions on this server that share the table this.region belongs to
-   */
+  /** Returns Count of regions on this server that share the table this.region belongs to */
   private int getCountOfCommonTableRegions() {
     RegionServerServices rss = region.getRegionServerServices();
     // Can be null in tests
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/KeyValueHeap.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/KeyValueHeap.java
index 7f07bf3490a..7041e6c7914 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/KeyValueHeap.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/KeyValueHeap.java
@@ -390,9 +390,7 @@ public class KeyValueHeap extends NonReversedNonLazyKeyValueScanner
     return kvScanner;
   }
 
-  /**
-   * @return the current Heap
-   */
+  /** Returns the current Heap */
   public PriorityQueue<KeyValueScanner> getHeap() {
     return this.heap;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/KeyValueScanner.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/KeyValueScanner.java
index 74f8bdc9d3a..ac2cb7aef12 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/KeyValueScanner.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/KeyValueScanner.java
@@ -122,9 +122,7 @@ public interface KeyValueScanner extends Shipper, Closeable {
    */
   void enforceSeek() throws IOException;
 
-  /**
-   * @return true if this is a file scanner. Otherwise a memory scanner is assumed.
-   */
+  /** Returns true if this is a file scanner. Otherwise a memory scanner is assumed. */
   boolean isFileScanner();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/LeaseManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/LeaseManager.java
index 216275f2072..9193829ebfc 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/LeaseManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/LeaseManager.java
@@ -209,7 +209,7 @@ public class LeaseManager extends Thread {
       this.leaseName = name;
     }
 
-    /** @return name of lease */
+    /** Returns name of lease */
     public String getName() {
       return this.leaseName;
     }
@@ -229,12 +229,12 @@ public class LeaseManager extends Thread {
       this.expirationTime = 0;
     }
 
-    /** @return the lease name */
+    /** Returns the lease name */
     public String getLeaseName() {
       return leaseName;
     }
 
-    /** @return listener */
+    /** Returns listener */
     public LeaseListener getListener() {
       return this.listener;
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStore.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStore.java
index ba2775c7429..164615c089e 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStore.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStore.java
@@ -70,9 +70,7 @@ public interface MemStore {
    */
   void add(Iterable<Cell> cells, MemStoreSizing memstoreSizing);
 
-  /**
-   * @return Oldest timestamp of all the Cells in the MemStore
-   */
+  /** Returns Oldest timestamp of all the Cells in the MemStore */
   long timeOfOldestEdit();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreFlusher.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreFlusher.java
index cc66bdde594..d976917c656 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreFlusher.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreFlusher.java
@@ -289,23 +289,17 @@ public class MemStoreFlusher implements FlushRequester {
     return true;
   }
 
-  /**
-   * @return Return memstore offheap size or null if <code>r</code> is null
-   */
+  /** Returns Return memstore offheap size or null if <code>r</code> is null */
   private static long getMemStoreOffHeapSize(HRegion r) {
     return r == null ? 0 : r.getMemStoreOffHeapSize();
   }
 
-  /**
-   * @return Return memstore heap size or null if <code>r</code> is null
-   */
+  /** Returns Return memstore heap size or null if <code>r</code> is null */
   private static long getMemStoreHeapSize(HRegion r) {
     return r == null ? 0 : r.getMemStoreHeapSize();
   }
 
-  /**
-   * @return Return memstore data size or null if <code>r</code> is null
-   */
+  /** Returns Return memstore data size or null if <code>r</code> is null */
   private static long getMemStoreDataSize(HRegion r) {
     return r == null ? 0 : r.getMemStoreDataSize();
   }
@@ -856,9 +850,7 @@ public class MemStoreFlusher implements FlushRequester {
       return (EnvironmentEdgeManager.currentTime() - this.createTime) > maximumWait;
     }
 
-    /**
-     * @return True if the entry is a delay flush task
-     */
+    /** Returns True if the entry is a delay flush task */
     protected boolean isDelay() {
       return this.whenToExpire > this.createTime;
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreSizing.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreSizing.java
index 73e2e30a20c..3d05fc942ee 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreSizing.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreSizing.java
@@ -88,9 +88,7 @@ public interface MemStoreSizing {
     }
   };
 
-  /**
-   * @return The new dataSize ONLY as a convenience
-   */
+  /** Returns The new dataSize ONLY as a convenience */
   long incMemStoreSize(long dataSizeDelta, long heapSizeDelta, long offHeapSizeDelta,
     int cellsCountDelta);
 
@@ -99,9 +97,7 @@ public interface MemStoreSizing {
       delta.getCellsCount());
   }
 
-  /**
-   * @return The new dataSize ONLY as a convenience
-   */
+  /** Returns The new dataSize ONLY as a convenience */
   default long decMemStoreSize(long dataSizeDelta, long heapSizeDelta, long offHeapSizeDelta,
     int cellsCountDelta) {
     return incMemStoreSize(-dataSizeDelta, -heapSizeDelta, -offHeapSizeDelta, -cellsCountDelta);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreSnapshot.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreSnapshot.java
index cfd9b8098ec..315e761556c 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreSnapshot.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MemStoreSnapshot.java
@@ -50,16 +50,12 @@ public class MemStoreSnapshot {
     this.snapshotImmutableSegment = snapshot;
   }
 
-  /**
-   * @return snapshot's identifier.
-   */
+  /** Returns snapshot's identifier. */
   public long getId() {
     return id;
   }
 
-  /**
-   * @return Number of Cells in this snapshot.
-   */
+  /** Returns Number of Cells in this snapshot. */
   public int getCellsCount() {
     return cellsCount;
   }
@@ -72,9 +68,7 @@ public class MemStoreSnapshot {
     return memStoreSize;
   }
 
-  /**
-   * @return {@link TimeRangeTracker} for all the Cells in the snapshot.
-   */
+  /** Returns {@link TimeRangeTracker} for all the Cells in the snapshot. */
   public TimeRangeTracker getTimeRangeTracker() {
     return timeRangeTracker;
   }
@@ -92,9 +86,7 @@ public class MemStoreSnapshot {
     return snapshotImmutableSegment.getSnapshotScanners();
   }
 
-  /**
-   * @return true if tags are present in this snapshot
-   */
+  /** Returns true if tags are present in this snapshot */
   public boolean isTagsPresent() {
     return this.tagsPresent;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsUserAggregate.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsUserAggregate.java
index 44414496ac2..14de79da67c 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsUserAggregate.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MetricsUserAggregate.java
@@ -22,9 +22,7 @@ import org.apache.yetus.audience.InterfaceAudience;
 @InterfaceAudience.Private
 public interface MetricsUserAggregate {
 
-  /**
-   * @return return a singleton instance of MetricsUserAggregateSource or null in case of NoOp
-   */
+  /** Returns return a singleton instance of MetricsUserAggregateSource or null in case of NoOp */
   MetricsUserAggregateSource getSource();
 
   void updatePut(long t);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MiniBatchOperationInProgress.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MiniBatchOperationInProgress.java
index 69fb426f394..0152d1db38d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MiniBatchOperationInProgress.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/MiniBatchOperationInProgress.java
@@ -68,9 +68,7 @@ public class MiniBatchOperationInProgress<T> {
     this.readyToWriteCount = readyToWriteCount;
   }
 
-  /**
-   * @return The number of operations(Mutations) involved in this batch.
-   */
+  /** Returns The number of operations(Mutations) involved in this batch. */
   public int size() {
     return this.lastIndexExclusive - this.firstIndex;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RSRpcServices.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RSRpcServices.java
index ab4ff1ec5ee..9f2a6eef520 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RSRpcServices.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RSRpcServices.java
@@ -1241,17 +1241,13 @@ public class RSRpcServices extends HBaseRpcServicesBase<HRegionServer>
     return scanners.size();
   }
 
-  /**
-   * @return The outstanding RegionScanner for <code>scannerId</code> or null if none found.
-   */
+  /** Returns The outstanding RegionScanner for <code>scannerId</code> or null if none found. */
   RegionScanner getScanner(long scannerId) {
     RegionScannerHolder rsh = getRegionScannerHolder(scannerId);
     return rsh == null ? null : rsh.s;
   }
 
-  /**
-   * @return The associated RegionScannerHolder for <code>scannerId</code> or null.
-   */
+  /** Returns The associated RegionScannerHolder for <code>scannerId</code> or null. */
   private RegionScannerHolder getRegionScannerHolder(long scannerId) {
     return scanners.get(toScannerName(scannerId));
   }
@@ -1338,9 +1334,7 @@ public class RSRpcServices extends HBaseRpcServicesBase<HRegionServer>
     return lastBlock;
   }
 
-  /**
-   * @return Remote client's ip and port else null if can't be determined.
-   */
+  /** Returns Remote client's ip and port else null if can't be determined. */
   @RestrictedApi(explanation = "Should only be called in TestRSRpcServices and RSRpcServices",
       link = "", allowedOnPath = ".*(TestRSRpcServices|RSRpcServices).java")
   static String getRemoteClientIpAndPort() {
@@ -1358,9 +1352,7 @@ public class RSRpcServices extends HBaseRpcServicesBase<HRegionServer>
     return Address.fromParts(address.getHostAddress(), rpcCall.getRemotePort()).toString();
   }
 
-  /**
-   * @return Remote client's username.
-   */
+  /** Returns Remote client's username. */
   @RestrictedApi(explanation = "Should only be called in TestRSRpcServices and RSRpcServices",
       link = "", allowedOnPath = ".*(TestRSRpcServices|RSRpcServices).java")
   static String getUserName() {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Region.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Region.java
index e30489c9479..156d4054055 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Region.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Region.java
@@ -61,30 +61,28 @@ public interface Region extends ConfigurationObserver {
   ///////////////////////////////////////////////////////////////////////////
   // Region state
 
-  /** @return region information for this region */
+  /** Returns region information for this region */
   RegionInfo getRegionInfo();
 
-  /** @return table descriptor for this region */
+  /** Returns table descriptor for this region */
   TableDescriptor getTableDescriptor();
 
-  /** @return true if region is available (not closed and not closing) */
+  /** Returns true if region is available (not closed and not closing) */
   boolean isAvailable();
 
-  /** @return true if region is closed */
+  /** Returns true if region is closed */
   boolean isClosed();
 
-  /** @return True if closing process has started */
+  /** Returns True if closing process has started */
   boolean isClosing();
 
-  /** @return True if region is read only */
+  /** Returns True if region is read only */
   boolean isReadOnly();
 
-  /** @return true if region is splittable */
+  /** Returns true if region is splittable */
   boolean isSplittable();
 
-  /**
-   * @return true if region is mergeable
-   */
+  /** Returns true if region is mergeable */
   boolean isMergeable();
 
   /**
@@ -103,7 +101,7 @@ public interface Region extends ConfigurationObserver {
    */
   Store getStore(byte[] family);
 
-  /** @return list of store file names for the given families */
+  /** Returns list of store file names for the given families */
   List<String> getStoreFileList(byte[][] columns);
 
   /**
@@ -140,16 +138,16 @@ public interface Region extends ConfigurationObserver {
   ///////////////////////////////////////////////////////////////////////////
   // Metrics
 
-  /** @return read requests count for this region */
+  /** Returns read requests count for this region */
   long getReadRequestsCount();
 
-  /** @return coprocessor requests count for this region */
+  /** Returns coprocessor requests count for this region */
   long getCpRequestsCount();
 
-  /** @return filtered read requests count for this region */
+  /** Returns filtered read requests count for this region */
   long getFilteredReadRequestsCount();
 
-  /** @return write request count for this region */
+  /** Returns write request count for this region */
   long getWriteRequestsCount();
 
   /**
@@ -173,19 +171,19 @@ public interface Region extends ConfigurationObserver {
    */
   long getMemStoreOffHeapSize();
 
-  /** @return the number of mutations processed bypassing the WAL */
+  /** Returns the number of mutations processed bypassing the WAL */
   long getNumMutationsWithoutWAL();
 
-  /** @return the size of data processed bypassing the WAL, in bytes */
+  /** Returns the size of data processed bypassing the WAL, in bytes */
   long getDataInMemoryWithoutWAL();
 
-  /** @return the number of blocked requests */
+  /** Returns the number of blocked requests */
   long getBlockedRequestsCount();
 
-  /** @return the number of checkAndMutate guards that passed */
+  /** Returns the number of checkAndMutate guards that passed */
   long getCheckAndMutateChecksPassed();
 
-  /** @return the number of failed checkAndMutate guards */
+  /** Returns the number of failed checkAndMutate guards */
   long getCheckAndMutateChecksFailed();
 
   ///////////////////////////////////////////////////////////////////////////
@@ -537,9 +535,7 @@ public interface Region extends ConfigurationObserver {
   // Flushes, compactions, splits, etc.
   // Wizards only, please
 
-  /**
-   * @return if a given region is in compaction now.
-   */
+  /** Returns if a given region is in compaction now. */
   CompactionState getCompactionState();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionCoprocessorHost.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionCoprocessorHost.java
index 118b42241c3..42e1eaa886b 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionCoprocessorHost.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionCoprocessorHost.java
@@ -133,7 +133,7 @@ public class RegionCoprocessorHost
         MetricsCoprocessor.createRegistryForRegionCoprocessor(impl.getClass().getName());
     }
 
-    /** @return the region */
+    /** Returns the region */
     @Override
     public Region getRegion() {
       return region;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionScanner.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionScanner.java
index 52bdad26210..693da0312fc 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionScanner.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionScanner.java
@@ -31,9 +31,7 @@ import org.apache.yetus.audience.InterfaceStability;
 @InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.COPROC)
 @InterfaceStability.Evolving
 public interface RegionScanner extends InternalScanner {
-  /**
-   * @return The RegionInfo for this scanner.
-   */
+  /** Returns The RegionInfo for this scanner. */
   RegionInfo getRegionInfo();
 
   /**
@@ -54,9 +52,7 @@ public interface RegionScanner extends InternalScanner {
    */
   long getMaxResultSize();
 
-  /**
-   * @return The Scanner's MVCC readPt see {@link MultiVersionConcurrencyControl}
-   */
+  /** Returns The Scanner's MVCC readPt see {@link MultiVersionConcurrencyControl} */
   long getMvccReadPoint();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionScannerImpl.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionScannerImpl.java
index 9a4b58c66c0..d010d71f6cf 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionScannerImpl.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionScannerImpl.java
@@ -297,9 +297,7 @@ class RegionScannerImpl implements RegionScanner, Shipper, RpcCallback {
     return moreValues;
   }
 
-  /**
-   * @return true if more cells exist after this batch, false if scanner is done
-   */
+  /** Returns true if more cells exist after this batch, false if scanner is done */
   private boolean populateFromJoinedHeap(List<Cell> results, ScannerContext scannerContext)
     throws IOException {
     assert joinedContinuationRow != null;
@@ -371,9 +369,7 @@ class RegionScannerImpl implements RegionScanner, Shipper, RpcCallback {
     return nextKv != null && CellUtil.matchingRows(nextKv, currentRowCell);
   }
 
-  /**
-   * @return True if a filter rules the scanner is over, done.
-   */
+  /** Returns True if a filter rules the scanner is over, done. */
   @Override
   public synchronized boolean isFilterDone() throws IOException {
     return isFilterDoneInternal();
@@ -642,9 +638,7 @@ class RegionScannerImpl implements RegionScanner, Shipper, RpcCallback {
     scannerContext.getMetrics().countOfRowsScanned.incrementAndGet();
   }
 
-  /**
-   * @return true when the joined heap may have data for the current row
-   */
+  /** Returns true when the joined heap may have data for the current row */
   private boolean joinedHeapMayHaveData(Cell currentRowCell) throws IOException {
     Cell nextJoinedKv = joinedHeap.peek();
     boolean matchCurrentRow =
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionServerAccounting.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionServerAccounting.java
index fb13cd82ae8..c1706c995e7 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionServerAccounting.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionServerAccounting.java
@@ -116,30 +116,22 @@ public class RegionServerAccounting {
     return this.globalMemStoreLimitLowMarkPercent;
   }
 
-  /**
-   * @return the global Memstore data size in the RegionServer
-   */
+  /** Returns the global Memstore data size in the RegionServer */
   public long getGlobalMemStoreDataSize() {
     return globalMemStoreDataSize.sum();
   }
 
-  /**
-   * @return the global memstore heap size in the RegionServer
-   */
+  /** Returns the global memstore heap size in the RegionServer */
   public long getGlobalMemStoreHeapSize() {
     return this.globalMemStoreHeapSize.sum();
   }
 
-  /**
-   * @return the global memstore heap size in the RegionServer
-   */
+  /** Returns the global memstore heap size in the RegionServer */
   public long getGlobalMemStoreOffHeapSize() {
     return this.globalMemStoreOffHeapSize.sum();
   }
 
-  /**
-   * @return the retained metrics of region's read and write requests count
-   */
+  /** Returns the retained metrics of region's read and write requests count */
   protected ConcurrentMap<String, Pair<Long, Long>> getRetainedRegionRWRequestsCnt() {
     return this.retainedRegionRWRequestsCnt;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionServerServices.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionServerServices.java
index 2a69d76480c..9c849ebf957 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionServerServices.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionServerServices.java
@@ -56,14 +56,10 @@ import org.apache.hadoop.hbase.shaded.protobuf.generated.RegionServerStatusProto
 @InterfaceAudience.Private
 public interface RegionServerServices extends Server, MutableOnlineRegions, FavoredNodesForRegion {
 
-  /**
-   * @return the WAL for a particular region. Pass null for getting the default (common) WAL
-   */
+  /** Returns the WAL for a particular region. Pass null for getting the default (common) WAL */
   WAL getWAL(RegionInfo regionInfo) throws IOException;
 
-  /**
-   * @return the List of WALs that are used by this server Doesn't include the meta WAL
-   */
+  /** Returns the List of WALs that are used by this server Doesn't include the meta WAL */
   List<WAL> getWALs() throws IOException;
 
   /**
@@ -78,24 +74,16 @@ public interface RegionServerServices extends Server, MutableOnlineRegions, Favo
    */
   CompactionRequester getCompactionRequestor();
 
-  /**
-   * @return the RegionServerAccounting for this Region Server
-   */
+  /** Returns the RegionServerAccounting for this Region Server */
   RegionServerAccounting getRegionServerAccounting();
 
-  /**
-   * @return RegionServer's instance of {@link RegionServerRpcQuotaManager}
-   */
+  /** Returns RegionServer's instance of {@link RegionServerRpcQuotaManager} */
   RegionServerRpcQuotaManager getRegionServerRpcQuotaManager();
 
-  /**
-   * @return RegionServer's instance of {@link SecureBulkLoadManager}
-   */
+  /** Returns RegionServer's instance of {@link SecureBulkLoadManager} */
   SecureBulkLoadManager getSecureBulkLoadManager();
 
-  /**
-   * @return RegionServer's instance of {@link RegionServerSpaceQuotaManager}
-   */
+  /** Returns RegionServer's instance of {@link RegionServerSpaceQuotaManager} */
   RegionServerSpaceQuotaManager getRegionServerSpaceQuotaManager();
 
   /**
@@ -193,14 +181,10 @@ public interface RegionServerServices extends Server, MutableOnlineRegions, Favo
    */
   ConcurrentMap<byte[], Boolean> getRegionsInTransitionInRS();
 
-  /**
-   * @return The RegionServer's "Leases" service
-   */
+  /** Returns The RegionServer's "Leases" service */
   LeaseManager getLeaseManager();
 
-  /**
-   * @return hbase executor service
-   */
+  /** Returns hbase executor service */
   ExecutorService getExecutorService();
 
   /**
@@ -217,9 +201,7 @@ public interface RegionServerServices extends Server, MutableOnlineRegions, Favo
    */
   boolean registerService(Service service);
 
-  /**
-   * @return heap memory manager instance
-   */
+  /** Returns heap memory manager instance */
   HeapMemoryManager getHeapMemoryManager();
 
   /**
@@ -230,9 +212,7 @@ public interface RegionServerServices extends Server, MutableOnlineRegions, Favo
    */
   double getCompactionPressure();
 
-  /**
-   * @return the controller to avoid flush too fast
-   */
+  /** Returns the controller to avoid flush too fast */
   ThroughputController getFlushThroughputController();
 
   /**
@@ -243,9 +223,7 @@ public interface RegionServerServices extends Server, MutableOnlineRegions, Favo
   @Deprecated
   double getFlushPressure();
 
-  /**
-   * @return the metrics tracker for the region server
-   */
+  /** Returns the metrics tracker for the region server */
   MetricsRegionServer getMetrics();
 
   /**
@@ -281,39 +259,25 @@ public interface RegionServerServices extends Server, MutableOnlineRegions, Favo
   boolean reportFileArchivalForQuotas(TableName tableName,
     Collection<Entry<String, Long>> archivedFiles);
 
-  /**
-   * @return True if cluster is up; false if cluster is not up (we are shutting down).
-   */
+  /** Returns True if cluster is up; false if cluster is not up (we are shutting down). */
   boolean isClusterUp();
 
-  /**
-   * @return Return the object that implements the replication source executorService.
-   */
+  /** Returns Return the object that implements the replication source executorService. */
   ReplicationSourceService getReplicationSourceService();
 
-  /**
-   * @return Return table descriptors implementation.
-   */
+  /** Returns Return table descriptors implementation. */
   TableDescriptors getTableDescriptors();
 
-  /**
-   * @return The block cache instance.
-   */
+  /** Returns The block cache instance. */
   Optional<BlockCache> getBlockCache();
 
-  /**
-   * @return The cache for mob files.
-   */
+  /** Returns The cache for mob files. */
   Optional<MobFileCache> getMobFileCache();
 
-  /**
-   * @return the {@link AccessChecker}
-   */
+  /** Returns the {@link AccessChecker} */
   AccessChecker getAccessChecker();
 
-  /**
-   * @return {@link ZKPermissionWatcher}
-   */
+  /** Returns {@link ZKPermissionWatcher} */
   ZKPermissionWatcher getZKPermissionWatcher();
 
   RegionReplicationBufferManager getRegionReplicationBufferManager();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionSplitPolicy.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionSplitPolicy.java
index 5ac965e6900..6dd2980fdca 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionSplitPolicy.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RegionSplitPolicy.java
@@ -59,14 +59,10 @@ public abstract class RegionSplitPolicy extends Configured {
     this.region = region;
   }
 
-  /**
-   * @return true if the specified region should be split.
-   */
+  /** Returns true if the specified region should be split. */
   protected abstract boolean shouldSplit();
 
-  /**
-   * @return {@code true} if the specified region can be split.
-   */
+  /** Returns {@code true} if the specified region can be split. */
   protected boolean canSplit() {
     return !region.getRegionInfo().isMetaRegion() && region.isAvailable()
       && region.getStores().stream().allMatch(HStore::canSplit);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ScannerContext.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ScannerContext.java
index 41772fc3b42..2de6dfb8819 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ScannerContext.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/ScannerContext.java
@@ -452,9 +452,7 @@ public class ScannerContext {
       return this.moreValues;
     }
 
-    /**
-     * @return true when the state indicates that a limit has been reached and scan should stop
-     */
+    /** Returns true when the state indicates that a limit has been reached and scan should stop */
     public boolean limitReached() {
       return this.limitReached;
     }
@@ -603,9 +601,7 @@ public class ScannerContext {
       this.heapSize = heapSize;
     }
 
-    /**
-     * @return {@link LimitScope} indicating scope in which the size limit is enforced
-     */
+    /** Returns {@link LimitScope} indicating scope in which the size limit is enforced */
     LimitScope getSizeScope() {
       return this.sizeScope;
     }
@@ -632,9 +628,7 @@ public class ScannerContext {
       this.time = time;
     }
 
-    /**
-     * @return {@link LimitScope} indicating scope in which the time limit is enforced
-     */
+    /** Returns {@link LimitScope} indicating scope in which the time limit is enforced */
     LimitScope getTimeScope() {
       return this.timeScope;
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Segment.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Segment.java
index 63c8492c951..272dd406962 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Segment.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Segment.java
@@ -130,9 +130,7 @@ public abstract class Segment implements MemStoreSizing {
     return Collections.singletonList(new SegmentScanner(this, readPoint));
   }
 
-  /**
-   * @return whether the segment has any cells
-   */
+  /** Returns whether the segment has any cells */
   public boolean isEmpty() {
     return getCellSet().isEmpty();
   }
@@ -287,9 +285,7 @@ public abstract class Segment implements MemStoreSizing {
     return getComparator().compareRows(left, right);
   }
 
-  /**
-   * @return a set of all cells in the segment
-   */
+  /** Returns a set of all cells in the segment */
   protected CellSet getCellSet() {
     return cellSet.get();
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SegmentScanner.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SegmentScanner.java
index 7781e5e3c52..c5dbca6b6e2 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SegmentScanner.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SegmentScanner.java
@@ -280,9 +280,7 @@ public class SegmentScanner implements KeyValueScanner {
     throw new NotImplementedException("enforceSeek cannot be called on a SegmentScanner");
   }
 
-  /**
-   * @return true if this is a file scanner. Otherwise a memory scanner is assumed.
-   */
+  /** Returns true if this is a file scanner. Otherwise a memory scanner is assumed. */
   @Override
   public boolean isFileScanner() {
     return false;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SplitLogWorker.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SplitLogWorker.java
index 5b1aec6df47..c5ef49be203 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SplitLogWorker.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SplitLogWorker.java
@@ -158,9 +158,7 @@ public class SplitLogWorker implements Runnable {
     return true;
   }
 
-  /**
-   * @return Result either DONE, RESIGNED, or ERR.
-   */
+  /** Returns Result either DONE, RESIGNED, or ERR. */
   static Status splitLog(String filename, CancelableProgressable p, Configuration conf,
     RegionServerServices server, LastSequenceId sequenceIdChecker, WALFactory factory) {
     Path walDir;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Store.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Store.java
index f54a0c5d964..5f9cfc09432 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Store.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/Store.java
@@ -81,14 +81,10 @@ public interface Store {
    */
   boolean canSplit();
 
-  /**
-   * @return <code>true</code> if the store has any underlying reference files to older HFiles
-   */
+  /** Returns <code>true</code> if the store has any underlying reference files to older HFiles */
   boolean hasReferences();
 
-  /**
-   * @return The size of this store's memstore.
-   */
+  /** Returns The size of this store's memstore. */
   MemStoreSize getMemStoreSize();
 
   /**
@@ -98,82 +94,54 @@ public interface Store {
    */
   MemStoreSize getFlushableSize();
 
-  /**
-   * @return size of the memstore snapshot
-   */
+  /** Returns size of the memstore snapshot */
   MemStoreSize getSnapshotSize();
 
   ColumnFamilyDescriptor getColumnFamilyDescriptor();
 
-  /**
-   * @return The maximum sequence id in all store files.
-   */
+  /** Returns The maximum sequence id in all store files. */
   OptionalLong getMaxSequenceId();
 
-  /**
-   * @return The maximum memstoreTS in all store files.
-   */
+  /** Returns The maximum memstoreTS in all store files. */
   OptionalLong getMaxMemStoreTS();
 
-  /** @return aggregate size of all HStores used in the last compaction */
+  /** Returns aggregate size of all HStores used in the last compaction */
   long getLastCompactSize();
 
-  /** @return aggregate size of HStore */
+  /** Returns aggregate size of HStore */
   long getSize();
 
-  /**
-   * @return Count of store files
-   */
+  /** Returns Count of store files */
   int getStorefilesCount();
 
-  /**
-   * @return Count of compacted store files
-   */
+  /** Returns Count of compacted store files */
   int getCompactedFilesCount();
 
-  /**
-   * @return Max age of store files in this store
-   */
+  /** Returns Max age of store files in this store */
   OptionalLong getMaxStoreFileAge();
 
-  /**
-   * @return Min age of store files in this store
-   */
+  /** Returns Min age of store files in this store */
   OptionalLong getMinStoreFileAge();
 
-  /**
-   * @return Average age of store files in this store
-   */
+  /** Returns Average age of store files in this store */
   OptionalDouble getAvgStoreFileAge();
 
-  /**
-   * @return Number of reference files in this store
-   */
+  /** Returns Number of reference files in this store */
   long getNumReferenceFiles();
 
-  /**
-   * @return Number of HFiles in this store
-   */
+  /** Returns Number of HFiles in this store */
   long getNumHFiles();
 
-  /**
-   * @return The size of the store files, in bytes, uncompressed.
-   */
+  /** Returns The size of the store files, in bytes, uncompressed. */
   long getStoreSizeUncompressed();
 
-  /**
-   * @return The size of the store files, in bytes.
-   */
+  /** Returns The size of the store files, in bytes. */
   long getStorefilesSize();
 
-  /**
-   * @return The size of only the store files which are HFiles, in bytes.
-   */
+  /** Returns The size of only the store files which are HFiles, in bytes. */
   long getHFilesSize();
 
-  /**
-   * @return The size of the store file root-level indexes, in bytes.
-   */
+  /** Returns The size of the store file root-level indexes, in bytes. */
   long getStorefilesRootLevelIndexSize();
 
   /**
@@ -191,9 +159,7 @@ public interface Store {
    */
   long getTotalStaticBloomSize();
 
-  /**
-   * @return the parent region info hosting this store
-   */
+  /** Returns the parent region info hosting this store */
   RegionInfo getRegionInfo();
 
   boolean areWritesEnabled();
@@ -208,44 +174,28 @@ public interface Store {
 
   TableName getTableName();
 
-  /**
-   * @return The number of cells flushed to disk
-   */
+  /** Returns The number of cells flushed to disk */
   long getFlushedCellsCount();
 
-  /**
-   * @return The total size of data flushed to disk, in bytes
-   */
+  /** Returns The total size of data flushed to disk, in bytes */
   long getFlushedCellsSize();
 
-  /**
-   * @return The total size of out output files on disk, in bytes
-   */
+  /** Returns The total size of out output files on disk, in bytes */
   long getFlushedOutputFileSize();
 
-  /**
-   * @return The number of cells processed during minor compactions
-   */
+  /** Returns The number of cells processed during minor compactions */
   long getCompactedCellsCount();
 
-  /**
-   * @return The total amount of data processed during minor compactions, in bytes
-   */
+  /** Returns The total amount of data processed during minor compactions, in bytes */
   long getCompactedCellsSize();
 
-  /**
-   * @return The number of cells processed during major compactions
-   */
+  /** Returns The number of cells processed during major compactions */
   long getMajorCompactedCellsCount();
 
-  /**
-   * @return The total amount of data processed during major compactions, in bytes
-   */
+  /** Returns The total amount of data processed during major compactions, in bytes */
   long getMajorCompactedCellsSize();
 
-  /**
-   * @return Whether this store has too many store files.
-   */
+  /** Returns Whether this store has too many store files. */
   boolean hasTooManyStoreFiles();
 
   /**
@@ -274,21 +224,15 @@ public interface Store {
 
   boolean isPrimaryReplicaStore();
 
-  /**
-   * @return true if the memstore may need some extra memory space
-   */
+  /** Returns true if the memstore may need some extra memory space */
   boolean isSloppyMemStore();
 
   int getCurrentParallelPutCount();
 
-  /**
-   * @return the number of read requests purely from the memstore.
-   */
+  /** Returns the number of read requests purely from the memstore. */
   long getMemstoreOnlyRowReadsCount();
 
-  /**
-   * @return the number of read requests from the files under this store.
-   */
+  /** Returns the number of read requests from the files under this store. */
   long getMixedRowReadsCount();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreConfigInformation.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreConfigInformation.java
index 982e107b921..61debb3b902 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreConfigInformation.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreConfigInformation.java
@@ -29,16 +29,12 @@ import org.apache.yetus.audience.InterfaceStability;
 @InterfaceAudience.Private
 @InterfaceStability.Unstable
 public interface StoreConfigInformation {
-  /**
-   * @return Gets the Memstore flush size for the region that this store works with.
-   */
+  /** Returns Gets the Memstore flush size for the region that this store works with. */
   // TODO: Why is this in here? It should be in Store and it should return the Store flush size,
   // not the Regions. St.Ack
   long getMemStoreFlushSize();
 
-  /**
-   * @return Gets the cf-specific time-to-live for store files.
-   */
+  /** Returns Gets the cf-specific time-to-live for store files. */
   long getStoreFileTtl();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreEngine.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreEngine.java
index ab1f56fb772..3edbf21bb82 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreEngine.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreEngine.java
@@ -143,30 +143,22 @@ public abstract class StoreEngine<SF extends StoreFlusher, CP extends Compaction
     storeLock.writeLock().unlock();
   }
 
-  /**
-   * @return Compaction policy to use.
-   */
+  /** Returns Compaction policy to use. */
   public CompactionPolicy getCompactionPolicy() {
     return this.compactionPolicy;
   }
 
-  /**
-   * @return Compactor to use.
-   */
+  /** Returns Compactor to use. */
   public Compactor<?> getCompactor() {
     return this.compactor;
   }
 
-  /**
-   * @return Store file manager to use.
-   */
+  /** Returns Store file manager to use. */
   public StoreFileManager getStoreFileManager() {
     return this.storeFileManager;
   }
 
-  /**
-   * @return Store flusher to use.
-   */
+  /** Returns Store flusher to use. */
   public StoreFlusher getStoreFlusher() {
     return this.storeFlusher;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFile.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFile.java
index 6cc5060b179..70edc5a8224 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFile.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFile.java
@@ -59,44 +59,28 @@ public interface StoreFile {
    */
   long getMaxMemStoreTS();
 
-  /**
-   * @return Path or null if this StoreFile was made with a Stream.
-   */
+  /** Returns Path or null if this StoreFile was made with a Stream. */
   Path getPath();
 
-  /**
-   * @return Encoded Path if this StoreFile was made with a Stream.
-   */
+  /** Returns Encoded Path if this StoreFile was made with a Stream. */
   Path getEncodedPath();
 
-  /**
-   * @return Returns the qualified path of this StoreFile
-   */
+  /** Returns Returns the qualified path of this StoreFile */
   Path getQualifiedPath();
 
-  /**
-   * @return True if this is a StoreFile Reference.
-   */
+  /** Returns True if this is a StoreFile Reference. */
   boolean isReference();
 
-  /**
-   * @return True if this is HFile.
-   */
+  /** Returns True if this is HFile. */
   boolean isHFile();
 
-  /**
-   * @return True if this file was made by a major compaction.
-   */
+  /** Returns True if this file was made by a major compaction. */
   boolean isMajorCompactionResult();
 
-  /**
-   * @return True if this file should not be part of a minor compaction.
-   */
+  /** Returns True if this file should not be part of a minor compaction. */
   boolean excludeFromMinorCompaction();
 
-  /**
-   * @return This files maximum edit sequence id.
-   */
+  /** Returns This files maximum edit sequence id. */
   long getMaxSequenceId();
 
   /**
@@ -120,9 +104,7 @@ public interface StoreFile {
    */
   OptionalLong getBulkLoadTimestamp();
 
-  /**
-   * @return a length description of this StoreFile, suitable for debug output
-   */
+  /** Returns a length description of this StoreFile, suitable for debug output */
   String toStringDetailed();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileInfo.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileInfo.java
index 093b6879d9c..5c915e6b177 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileInfo.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileInfo.java
@@ -255,22 +255,22 @@ public class StoreFileInfo implements Configurable {
     return this.reference;
   }
 
-  /** @return True if the store file is a Reference */
+  /** Returns True if the store file is a Reference */
   public boolean isReference() {
     return this.reference != null;
   }
 
-  /** @return True if the store file is a top Reference */
+  /** Returns True if the store file is a top Reference */
   public boolean isTopReference() {
     return this.reference != null && Reference.isTopFileRegion(this.reference.getFileRegion());
   }
 
-  /** @return True if the store file is a link */
+  /** Returns True if the store file is a link */
   public boolean isLink() {
     return this.link != null && this.reference == null;
   }
 
-  /** @return the HDFS block distribution */
+  /** Returns the HDFS block distribution */
   public HDFSBlocksDistribution getHDFSBlockDistribution() {
     return this.hdfsBlocksDistribution;
   }
@@ -401,17 +401,17 @@ public class StoreFileInfo implements Configurable {
     return status;
   }
 
-  /** @return The {@link Path} of the file */
+  /** Returns The {@link Path} of the file */
   public Path getPath() {
     return initialPath;
   }
 
-  /** @return The {@link FileStatus} of the file */
+  /** Returns The {@link FileStatus} of the file */
   public FileStatus getFileStatus() throws IOException {
     return getReferencedFileStatus(fs);
   }
 
-  /** @return Get the modification time of the file. */
+  /** Returns Get the modification time of the file. */
   public long getModificationTime() throws IOException {
     return getFileStatus().getModificationTime();
   }
@@ -487,9 +487,7 @@ public class StoreFileInfo implements Configurable {
     return m.matches() && m.groupCount() > 1;
   }
 
-  /**
-   * @return timestamp when this file was created (as returned by filesystem)
-   */
+  /** Returns timestamp when this file was created (as returned by filesystem) */
   public long getCreatedTimestamp() {
     return createdTimestamp;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileManager.java
index f276f5d76a4..387fa559dcd 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileManager.java
@@ -154,9 +154,7 @@ public interface StoreFileManager {
    */
   Optional<byte[]> getSplitPoint() throws IOException;
 
-  /**
-   * @return The store compaction priority.
-   */
+  /** Returns The store compaction priority. */
   int getStoreCompactionPriority();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFlushContext.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFlushContext.java
index 07db4427641..c750167d2ae 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFlushContext.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFlushContext.java
@@ -70,8 +70,6 @@ interface StoreFlushContext {
    */
   List<Path> getCommittedFiles();
 
-  /**
-   * @return the total file size for flush output files, in bytes
-   */
+  /** Returns the total file size for flush output files, in bytes */
   long getOutputFileSize();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreScanner.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreScanner.java
index 2990c42b623..2cf9fe04cf3 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreScanner.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreScanner.java
@@ -987,9 +987,7 @@ public class StoreScanner extends NonReversedNonLazyKeyValueScanner
     // Let the next() call handle re-creating and seeking
   }
 
-  /**
-   * @return if top of heap has changed (and KeyValueHeap has to try the next KV)
-   */
+  /** Returns if top of heap has changed (and KeyValueHeap has to try the next KV) */
   protected final boolean reopenAfterFlush() throws IOException {
     // here we can make sure that we have a Store instance so no null check on store.
     Cell lastTop = heap.peek();
@@ -1208,9 +1206,7 @@ public class StoreScanner extends NonReversedNonLazyKeyValueScanner
     lazySeekEnabledGlobally = enable;
   }
 
-  /**
-   * @return The estimated number of KVs seen by this scanner (includes some skipped KVs).
-   */
+  /** Returns The estimated number of KVs seen by this scanner (includes some skipped KVs). */
   public long getEstimatedNumberOfKvsScanned() {
     return this.kvsScanned;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StripeStoreFileManager.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StripeStoreFileManager.java
index f494ab7ee82..85f61a029ad 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StripeStoreFileManager.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StripeStoreFileManager.java
@@ -815,9 +815,7 @@ public class StripeStoreFileManager
       return result;
     }
 
-    /**
-     * @return A lazy L0 copy from current state.
-     */
+    /** Returns A lazy L0 copy from current state. */
     private final ArrayList<HStoreFile> getLevel0Copy() {
       if (this.level0Files == null) {
         this.level0Files = new ArrayList<>(StripeStoreFileManager.this.state.level0Files);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/TimeRangeTracker.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/TimeRangeTracker.java
index e3ce2083933..3f4f27380ff 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/TimeRangeTracker.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/TimeRangeTracker.java
@@ -169,14 +169,10 @@ public abstract class TimeRangeTracker {
     return (getMin() < tr.getMax() && getMax() >= tr.getMin());
   }
 
-  /**
-   * @return the minimumTimestamp
-   */
+  /** Returns the minimumTimestamp */
   public abstract long getMin();
 
-  /**
-   * @return the maximumTimestamp
-   */
+  /** Returns the maximumTimestamp */
   public abstract long getMax();
 
   @Override
@@ -227,9 +223,7 @@ public abstract class TimeRangeTracker {
     }
   }
 
-  /**
-   * @return Make a TimeRange from current state of <code>this</code>.
-   */
+  /** Returns Make a TimeRange from current state of <code>this</code>. */
   TimeRange toTimeRange() {
     long min = getMin();
     long max = getMax();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionConfiguration.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionConfiguration.java
index eea5e219d29..251c8227da0 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionConfiguration.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionConfiguration.java
@@ -195,23 +195,17 @@ public class CompactionConfiguration {
       storeConfigInfo.getColumnFamilyName());
   }
 
-  /**
-   * @return lower bound below which compaction is selected without ratio test
-   */
+  /** Returns lower bound below which compaction is selected without ratio test */
   public long getMinCompactSize() {
     return minCompactSize;
   }
 
-  /**
-   * @return upper bound on file size to be included in minor compactions
-   */
+  /** Returns upper bound on file size to be included in minor compactions */
   public long getMaxCompactSize() {
     return maxCompactSize;
   }
 
-  /**
-   * @return lower bound on number of files to be included in minor compactions
-   */
+  /** Returns lower bound on number of files to be included in minor compactions */
   public int getMinFilesToCompact() {
     return minFilesToCompact;
   }
@@ -224,30 +218,22 @@ public class CompactionConfiguration {
     minFilesToCompact = threshold;
   }
 
-  /**
-   * @return upper bound on number of files to be included in minor compactions
-   */
+  /** Returns upper bound on number of files to be included in minor compactions */
   public int getMaxFilesToCompact() {
     return maxFilesToCompact;
   }
 
-  /**
-   * @return Ratio used for compaction
-   */
+  /** Returns Ratio used for compaction */
   public double getCompactionRatio() {
     return compactionRatio;
   }
 
-  /**
-   * @return Off peak Ratio used for compaction
-   */
+  /** Returns Off peak Ratio used for compaction */
   public double getCompactionRatioOffPeak() {
     return offPeakCompactionRatio;
   }
 
-  /**
-   * @return ThrottlePoint used for classifying small and large compactions
-   */
+  /** Returns ThrottlePoint used for classifying small and large compactions */
   public long getThrottlePoint() {
     return throttlePoint;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionPolicy.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionPolicy.java
index 772e21f0424..83df21a55e9 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionPolicy.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionPolicy.java
@@ -59,9 +59,7 @@ public abstract class CompactionPolicy {
     this.comConf = new CompactionConfiguration(conf, this.storeConfigInfo);
   }
 
-  /**
-   * @return The current compaction configuration settings.
-   */
+  /** Returns The current compaction configuration settings. */
   public CompactionConfiguration getConf() {
     return this.comConf;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionProgress.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionProgress.java
index 72634bbf2ce..13bc27c7abc 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionProgress.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionProgress.java
@@ -68,9 +68,7 @@ public class CompactionProgress {
     this.totalCompactingKVs = this.currentCompactedKVs;
   }
 
-  /**
-   * @return the total compacting key values in currently running compaction
-   */
+  /** Returns the total compacting key values in currently running compaction */
   public long getTotalCompactingKVs() {
     if (totalCompactingKVs < currentCompactedKVs) {
       LOG.debug("totalCompactingKVs={} less than currentCompactedKVs={}", totalCompactingKVs,
@@ -80,16 +78,12 @@ public class CompactionProgress {
     return totalCompactingKVs;
   }
 
-  /**
-   * @return the completed count of key values in currently running compaction
-   */
+  /** Returns the completed count of key values in currently running compaction */
   public long getCurrentCompactedKvs() {
     return currentCompactedKVs;
   }
 
-  /**
-   * @return the total data size processed by the currently running compaction, in bytes
-   */
+  /** Returns the total data size processed by the currently running compaction, in bytes */
   public long getTotalCompactedSize() {
     return totalCompactedSize;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionRequest.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionRequest.java
index 723cefb73d7..142c62624a8 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionRequest.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/CompactionRequest.java
@@ -28,39 +28,25 @@ import org.apache.yetus.audience.InterfaceAudience;
 @InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.COPROC)
 public interface CompactionRequest {
 
-  /**
-   * @return unmodifiable collection of StoreFiles in compaction
-   */
+  /** Returns unmodifiable collection of StoreFiles in compaction */
   Collection<? extends StoreFile> getFiles();
 
-  /**
-   * @return total size of all StoreFiles in compaction
-   */
+  /** Returns total size of all StoreFiles in compaction */
   long getSize();
 
-  /**
-   * @return <code>true</code> if major compaction or all files are compacted
-   */
+  /** Returns <code>true</code> if major compaction or all files are compacted */
   boolean isAllFiles();
 
-  /**
-   * @return <code>true</code> if major compaction
-   */
+  /** Returns <code>true</code> if major compaction */
   boolean isMajor();
 
-  /**
-   * @return priority of compaction request
-   */
+  /** Returns priority of compaction request */
   int getPriority();
 
-  /**
-   * @return <code>true</code> if compaction is Off-peak
-   */
+  /** Returns <code>true</code> if compaction is Off-peak */
   boolean isOffPeak();
 
-  /**
-   * @return compaction request creation time in milliseconds
-   */
+  /** Returns compaction request creation time in milliseconds */
   long getSelectionTime();
 
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/DateTieredCompactionPolicy.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/DateTieredCompactionPolicy.java
index c083628f60b..9dbe9aae9cf 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/DateTieredCompactionPolicy.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/DateTieredCompactionPolicy.java
@@ -313,7 +313,7 @@ public class DateTieredCompactionPolicy extends SortedCompactionPolicy {
   }
 
   /**
-   * @return a list of boundaries for multiple compaction output from minTimestamp to maxTimestamp.
+   * Returns a list of boundaries for multiple compaction output from minTimestamp to maxTimestamp.
    */
   private static List<Long> getCompactionBoundariesForMinor(CompactionWindow window,
     boolean singleOutput) {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/OffPeakHours.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/OffPeakHours.java
index 979ec368cc4..426514aacb9 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/OffPeakHours.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/OffPeakHours.java
@@ -72,14 +72,10 @@ public abstract class OffPeakHours {
     return 0 <= hour && hour <= 23;
   }
 
-  /**
-   * @return whether {@code targetHour} is off-peak hour
-   */
+  /** Returns whether {@code targetHour} is off-peak hour */
   public abstract boolean isOffPeakHour(int targetHour);
 
-  /**
-   * @return whether it is off-peak hour
-   */
+  /** Returns whether it is off-peak hour */
   public abstract boolean isOffPeakHour();
 
   private static class OffPeakHoursImpl extends OffPeakHours {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/StripeCompactionPolicy.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/StripeCompactionPolicy.java
index 575b7c352ea..adcd41f3e26 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/StripeCompactionPolicy.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/compactions/StripeCompactionPolicy.java
@@ -588,24 +588,16 @@ public class StripeCompactionPolicy extends CompactionPolicy {
      */
     public byte[] getEndRow(int stripeIndex);
 
-    /**
-     * @return Level 0 files.
-     */
+    /** Returns Level 0 files. */
     public List<HStoreFile> getLevel0Files();
 
-    /**
-     * @return All stripe boundaries; including the open ones on both ends.
-     */
+    /** Returns All stripe boundaries; including the open ones on both ends. */
     public List<byte[]> getStripeBoundaries();
 
-    /**
-     * @return The stripes.
-     */
+    /** Returns The stripes. */
     public ArrayList<ImmutableList<HStoreFile>> getStripes();
 
-    /**
-     * @return Stripe count.
-     */
+    /** Returns Stripe count. */
     public int getStripeCount();
   }
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/OpenRegionHandler.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/OpenRegionHandler.java
index bde771f6ab8..24d47dfbcec 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/OpenRegionHandler.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/OpenRegionHandler.java
@@ -268,17 +268,13 @@ public class OpenRegionHandler extends EventHandler {
       }
     }
 
-    /**
-     * @return Null or the run exception; call this method after thread is done.
-     */
+    /** Returns Null or the run exception; call this method after thread is done. */
     Throwable getException() {
       return this.exception;
     }
   }
 
-  /**
-   * @return Instance of HRegion if successful open else null.
-   */
+  /** Returns Instance of HRegion if successful open else null. */
   private HRegion openRegion() {
     HRegion region = null;
     try {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ColumnCount.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ColumnCount.java
index b23a016c964..71a73069bcd 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ColumnCount.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ColumnCount.java
@@ -62,23 +62,17 @@ class ColumnCount {
     this.count = count;
   }
 
-  /**
-   * @return the buffer
-   */
+  /** Returns the buffer */
   public byte[] getBuffer() {
     return this.bytes;
   }
 
-  /**
-   * @return the offset
-   */
+  /** Returns the offset */
   public int getOffset() {
     return this.offset;
   }
 
-  /**
-   * @return the length
-   */
+  /** Returns the length */
   public int getLength() {
     return this.length;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ColumnTracker.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ColumnTracker.java
index 1fd47888986..af02d71788f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ColumnTracker.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ColumnTracker.java
@@ -90,9 +90,7 @@ public interface ColumnTracker extends ShipperListener {
    */
   void reset();
 
-  /**
-   * @return <code>true</code> when done.
-   */
+  /** Returns <code>true</code> when done. */
   boolean done();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/DeleteTracker.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/DeleteTracker.java
index 0b48e1ca3b0..56ac265dd18 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/DeleteTracker.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/DeleteTracker.java
@@ -51,9 +51,7 @@ public interface DeleteTracker extends ShipperListener {
    */
   DeleteResult isDeleted(Cell cell);
 
-  /**
-   * @return true if there are no current delete, false otherwise
-   */
+  /** Returns true if there are no current delete, false otherwise */
   boolean isEmpty();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ScanQueryMatcher.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ScanQueryMatcher.java
index 17008e2941a..120b01cca3a 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ScanQueryMatcher.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/querymatcher/ScanQueryMatcher.java
@@ -239,21 +239,15 @@ public abstract class ScanQueryMatcher implements ShipperListener {
    */
   public abstract MatchCode match(Cell cell) throws IOException;
 
-  /**
-   * @return the start key
-   */
+  /** Returns the start key */
   public Cell getStartKey() {
     return startKey;
   }
 
-  /**
-   * @return whether there is an null column in the query
-   */
+  /** Returns whether there is an null column in the query */
   public abstract boolean hasNullColumnInQuery();
 
-  /**
-   * @return a cell represent the current row
-   */
+  /** Returns a cell represent the current row */
   public Cell currentRow() {
     return currentRow;
   }
@@ -337,9 +331,7 @@ public abstract class ScanQueryMatcher implements ShipperListener {
     }
   }
 
-  /**
-   * @return the Filter
-   */
+  /** Returns the Filter */
   public abstract Filter getFilter();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/AbstractFSWAL.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/AbstractFSWAL.java
index 13f4eb00c2e..c05f7101172 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/AbstractFSWAL.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/AbstractFSWAL.java
@@ -674,13 +674,13 @@ public abstract class AbstractFSWAL<W extends WriterBase> implements WAL {
   }
 
   // public only until class moves to o.a.h.h.wal
-  /** @return the number of rolled log files */
+  /** Returns the number of rolled log files */
   public int getNumRolledLogFiles() {
     return walFile2Props.size();
   }
 
   // public only until class moves to o.a.h.h.wal
-  /** @return the number of log files in use */
+  /** Returns the number of log files in use */
   public int getNumLogFiles() {
     // +1 for current use log
     return getNumRolledLogFiles() + 1;
@@ -952,7 +952,7 @@ public abstract class AbstractFSWAL<W extends WriterBase> implements WAL {
   }
 
   // public only until class moves to o.a.h.h.wal
-  /** @return the size of log files in use */
+  /** Returns the size of log files in use */
   public long getLogFileSize() {
     return this.totalLogSize.get();
   }
@@ -1060,9 +1060,7 @@ public abstract class AbstractFSWAL<W extends WriterBase> implements WAL {
     LOG.info("Closed WAL: " + toString());
   }
 
-  /**
-   * @return number of WALs currently in the process of closing.
-   */
+  /** Returns number of WALs currently in the process of closing. */
   public int getInflightWALCloseCount() {
     return inflightWALClosures.size();
   }
@@ -1311,9 +1309,7 @@ public abstract class AbstractFSWAL<W extends WriterBase> implements WAL {
 
   protected abstract boolean doCheckLogLowReplication();
 
-  /**
-   * @return true if we exceeded the slow sync roll threshold over the last check interval
-   */
+  /** Returns true if we exceeded the slow sync roll threshold over the last check interval */
   protected boolean doCheckSlowSync() {
     boolean result = false;
     long now = EnvironmentEdgeManager.currentTime();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/FSHLog.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/FSHLog.java
index 25a2974ea96..10bae1312d6 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/FSHLog.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/FSHLog.java
@@ -720,9 +720,7 @@ public class FSHLog extends AbstractFSWAL<Writer> {
     return false;
   }
 
-  /**
-   * @return true if number of replicas for the WAL is lower than threshold
-   */
+  /** Returns true if number of replicas for the WAL is lower than threshold */
   @Override
   protected boolean doCheckLogLowReplication() {
     boolean logRollNeeded = false;
@@ -896,9 +894,7 @@ public class FSHLog extends AbstractFSWAL<Writer> {
       return syncFuture;
     }
 
-    /**
-     * @return if the safepoint has been attained.
-     */
+    /** Returns if the safepoint has been attained. */
     @InterfaceAudience.Private
     boolean isSafePointAttained() {
       return this.safePointAttainedLatch.getCount() == 0;
@@ -922,9 +918,7 @@ public class FSHLog extends AbstractFSWAL<Writer> {
       this.safePointReleasedLatch.countDown();
     }
 
-    /**
-     * @return True is this is a 'cocked', fresh instance, and not one that has already fired.
-     */
+    /** Returns True is this is a 'cocked', fresh instance, and not one that has already fired. */
     boolean isCocked() {
       return this.safePointAttainedLatch.getCount() > 0
         && this.safePointReleasedLatch.getCount() > 0;
@@ -1003,9 +997,7 @@ public class FSHLog extends AbstractFSWAL<Writer> {
       this.syncFuturesCount.set(0);
     }
 
-    /**
-     * @return True if outstanding sync futures still
-     */
+    /** Returns True if outstanding sync futures still */
     private boolean isOutstandingSyncs() {
       // Look at SyncFutures in the EventHandler
       for (int i = 0; i < this.syncFuturesCount.get(); i++) {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/FSWALEntry.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/FSWALEntry.java
index 24043ab504d..502e04e05b0 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/FSWALEntry.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/FSWALEntry.java
@@ -121,9 +121,7 @@ class FSWALEntry extends Entry {
     return this.regionInfo;
   }
 
-  /**
-   * @return The transaction id of this edit.
-   */
+  /** Returns The transaction id of this edit. */
   long getTxid() {
     return this.txid;
   }
@@ -145,9 +143,7 @@ class FSWALEntry extends Entry {
     return regionSequenceId;
   }
 
-  /**
-   * @return the family names which are effected by this edit.
-   */
+  /** Returns the family names which are effected by this edit. */
   Set<byte[]> getFamilyNames() {
     return familyNames;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/ReaderBase.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/ReaderBase.java
index 8e84169a7a2..5e14c475ae3 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/ReaderBase.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/ReaderBase.java
@@ -148,24 +148,16 @@ public abstract class ReaderBase implements AbstractFSWALProvider.Reader {
    */
   protected abstract void initAfterCompression(String cellCodecClsName) throws IOException;
 
-  /**
-   * @return Whether compression is enabled for this log.
-   */
+  /** Returns Whether compression is enabled for this log. */
   protected abstract boolean hasCompression();
 
-  /**
-   * @return Whether tag compression is enabled for this log.
-   */
+  /** Returns Whether tag compression is enabled for this log. */
   protected abstract boolean hasTagCompression();
 
-  /**
-   * @return Whether value compression is enabled for this log.
-   */
+  /** Returns Whether value compression is enabled for this log. */
   protected abstract boolean hasValueCompression();
 
-  /**
-   * @return Value compression algorithm for this log.
-   */
+  /** Returns Value compression algorithm for this log. */
   protected abstract Compression.Algorithm getValueCompressionAlgorithm();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/RingBufferTruck.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/RingBufferTruck.java
index b03540dcd88..00a55a48903 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/RingBufferTruck.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/wal/RingBufferTruck.java
@@ -58,9 +58,7 @@ final class RingBufferTruck {
     this.type = Type.SYNC;
   }
 
-  /**
-   * @return the type of this truck's payload.
-   */
+  /** Returns the type of this truck's payload. */
   Type type() {
     return type;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/ReplicationEndpoint.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/ReplicationEndpoint.java
index a0b55049507..5edd5b3e8c9 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/ReplicationEndpoint.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/ReplicationEndpoint.java
@@ -221,9 +221,7 @@ public interface ReplicationEndpoint extends ReplicationPeerConfigListener {
    */
   boolean isRunning();
 
-  /**
-   * @return Return {@code true} is this service is STARTING (but not yet RUNNING).
-   */
+  /** Returns Return {@code true} is this service is STARTING (but not yet RUNNING). */
   boolean isStarting();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSink.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSink.java
index e40f4bbf21b..997e303d583 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSink.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSink.java
@@ -354,9 +354,7 @@ public class ReplicationSink {
       .append(Bytes.toString(family)).append(Path.SEPARATOR).append(storeFile).toString();
   }
 
-  /**
-   * @return True if we have crossed over onto a new row or type
-   */
+  /** Returns True if we have crossed over onto a new row or type */
   private boolean isNewRowOrType(final Cell previousCell, final Cell cell) {
     return previousCell == null || previousCell.getTypeByte() != cell.getTypeByte()
       || !CellUtil.matchingRows(previousCell, cell);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSourceInterface.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSourceInterface.java
index 6b09e8a1de9..02e7a7ac532 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSourceInterface.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSourceInterface.java
@@ -128,43 +128,29 @@ public interface ReplicationSourceInterface {
    */
   String getStats();
 
-  /**
-   * @return peer enabled or not
-   */
+  /** Returns peer enabled or not */
   default boolean isPeerEnabled() {
     return getPeer().isPeerEnabled();
   }
 
-  /**
-   * @return whether this is sync replication peer.
-   */
+  /** Returns whether this is sync replication peer. */
   default boolean isSyncReplication() {
     return getPeer().getPeerConfig().isSyncReplication();
   }
 
-  /**
-   * @return active or not
-   */
+  /** Returns active or not */
   boolean isSourceActive();
 
-  /**
-   * @return metrics of this replication source
-   */
+  /** Returns metrics of this replication source */
   MetricsSource getSourceMetrics();
 
-  /**
-   * @return the replication endpoint used by this replication source
-   */
+  /** Returns the replication endpoint used by this replication source */
   ReplicationEndpoint getReplicationEndpoint();
 
-  /**
-   * @return the replication source manager
-   */
+  /** Returns the replication source manager */
   ReplicationSourceManager getSourceManager();
 
-  /**
-   * @return the wal file length provider
-   */
+  /** Returns the wal file length provider */
   WALFileLengthProvider getWALFileLengthProvider();
 
   /**
@@ -195,16 +181,12 @@ public interface ReplicationSourceInterface {
     return new HashMap<>();
   }
 
-  /**
-   * @return whether this is a replication source for recovery.
-   */
+  /** Returns whether this is a replication source for recovery. */
   default boolean isRecovered() {
     return false;
   }
 
-  /**
-   * @return The instance of queueStorage used by this ReplicationSource.
-   */
+  /** Returns The instance of queueStorage used by this ReplicationSource. */
   ReplicationQueueStorage getReplicationQueueStorage();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSourceWALReader.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSourceWALReader.java
index ef550fe6978..28768679fb6 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSourceWALReader.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/ReplicationSourceWALReader.java
@@ -462,9 +462,7 @@ class ReplicationSourceWALReader extends Thread {
     return newBufferUsed >= totalBufferQuota;
   }
 
-  /**
-   * @return whether the reader thread is running
-   */
+  /** Returns whether the reader thread is running */
   public boolean isReaderRunning() {
     return isReaderRunning && !isInterrupted();
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/WALEntryBatch.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/WALEntryBatch.java
index 65575aba5a6..b5ef0f92bcc 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/WALEntryBatch.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/WALEntryBatch.java
@@ -72,23 +72,17 @@ class WALEntryBatch {
     walEntriesWithSize.add(new Pair<>(entry, entrySize));
   }
 
-  /**
-   * @return the WAL Entries.
-   */
+  /** Returns the WAL Entries. */
   public List<Entry> getWalEntries() {
     return walEntriesWithSize.stream().map(Pair::getFirst).collect(Collectors.toList());
   }
 
-  /**
-   * @return the WAL Entries.
-   */
+  /** Returns the WAL Entries. */
   public List<Pair<Entry, Long>> getWalEntriesWithSize() {
     return walEntriesWithSize;
   }
 
-  /**
-   * @return the path of the last WAL that was read.
-   */
+  /** Returns the path of the last WAL that was read. */
   public Path getLastWalPath() {
     return lastWalPath;
   }
@@ -97,9 +91,7 @@ class WALEntryBatch {
     this.lastWalPath = lastWalPath;
   }
 
-  /**
-   * @return the position in the last WAL that was read.
-   */
+  /** Returns the position in the last WAL that was read. */
   public long getLastWalPosition() {
     return lastWalPosition;
   }
@@ -112,37 +104,27 @@ class WALEntryBatch {
     return walEntriesWithSize.size();
   }
 
-  /**
-   * @return the number of distinct row keys in this batch
-   */
+  /** Returns the number of distinct row keys in this batch */
   public int getNbRowKeys() {
     return nbRowKeys;
   }
 
-  /**
-   * @return the number of HFiles in this batch
-   */
+  /** Returns the number of HFiles in this batch */
   public int getNbHFiles() {
     return nbHFiles;
   }
 
-  /**
-   * @return total number of operations in this batch
-   */
+  /** Returns total number of operations in this batch */
   public int getNbOperations() {
     return getNbRowKeys() + getNbHFiles();
   }
 
-  /**
-   * @return the heap size of this batch
-   */
+  /** Returns the heap size of this batch */
   public long getHeapSize() {
     return heapSize;
   }
 
-  /**
-   * @return the last sequenceid for each region if the table has serial-replication scope
-   */
+  /** Returns the last sequenceid for each region if the table has serial-replication scope */
   public Map<String, Long> getLastSeqIds() {
     return lastSeqIds;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.java
index 041a10b8f31..1d9f868e52f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.java
@@ -95,9 +95,7 @@ class WALEntryStream implements Closeable {
     this.walGroupId = walGroupId;
   }
 
-  /**
-   * @return true if there is another WAL {@link Entry}
-   */
+  /** Returns true if there is another WAL {@link Entry} */
   public boolean hasNext() throws IOException {
     if (currentEntry == null) {
       tryAdvanceEntry();
@@ -130,16 +128,12 @@ class WALEntryStream implements Closeable {
     closeReader();
   }
 
-  /**
-   * @return the position of the last Entry returned by next()
-   */
+  /** Returns the position of the last Entry returned by next() */
   public long getPosition() {
     return currentPositionOfEntry;
   }
 
-  /**
-   * @return the {@link Path} of the current WAL
-   */
+  /** Returns the {@link Path} of the current WAL */
   public Path getCurrentPath() {
     return currentPath;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManagerImpl.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManagerImpl.java
index f01e482a2aa..3b7c30ddb01 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManagerImpl.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManagerImpl.java
@@ -316,9 +316,7 @@ final class RSGroupInfoManagerImpl implements RSGroupInfoManager {
     return rsGroupInfo;
   }
 
-  /**
-   * @return Set of online Servers named for their hostname and port (not ServerName).
-   */
+  /** Returns Set of online Servers named for their hostname and port (not ServerName). */
   private Set<Address> getOnlineServers() {
     return masterServices.getServerManager().getOnlineServers().keySet().stream()
       .map(ServerName::getAddress).collect(Collectors.toSet());
@@ -941,9 +939,7 @@ final class RSGroupInfoManagerImpl implements RSGroupInfoManager {
     }
   }
 
-  /**
-   * @return List of Regions associated with this <code>server</code>.
-   */
+  /** Returns List of Regions associated with this <code>server</code>. */
   private List<RegionInfo> getRegions(final Address server) {
     LinkedList<RegionInfo> regions = new LinkedList<>();
     for (Map.Entry<RegionInfo, ServerName> el : masterServices.getAssignmentManager()
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AccessControlFilter.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AccessControlFilter.java
index 47dc654bebd..9555092e720 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AccessControlFilter.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AccessControlFilter.java
@@ -151,9 +151,7 @@ class AccessControlFilter extends FilterBase {
     this.currentVersions = 0;
   }
 
-  /**
-   * @return The filter serialized using pb
-   */
+  /** Returns The filter serialized using pb */
   @Override
   public byte[] toByteArray() {
     // no implementation, server-side use only
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AuthResult.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AuthResult.java
index 5842d583437..b3e1c146aac 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AuthResult.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AuthResult.java
@@ -288,9 +288,7 @@ public class AuthResult {
       return Joiner.on(",").skipNulls().join(params);
     }
 
-    /**
-     * @return extra parameter key/value string
-     */
+    /** Returns extra parameter key/value string */
     private String concatenateExtraParams() {
       final StringBuilder sb = new StringBuilder();
       boolean first = true;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/security/token/FsDelegationToken.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/security/token/FsDelegationToken.java
index 64b889cd066..1eb88a3d12f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/security/token/FsDelegationToken.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/security/token/FsDelegationToken.java
@@ -132,16 +132,12 @@ public class FsDelegationToken {
     return userProvider;
   }
 
-  /**
-   * @return the account name that is allowed to renew the token.
-   */
+  /** Returns the account name that is allowed to renew the token. */
   public String getRenewer() {
     return renewer;
   }
 
-  /**
-   * @return the delegation token acquired, or null in case it was not acquired
-   */
+  /** Returns the delegation token acquired, or null in case it was not acquired */
   public Token<?> getUserToken() {
     return userToken;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/security/visibility/VisibilityLabelsCache.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/security/visibility/VisibilityLabelsCache.java
index 5e004f8c6b0..22168c5513f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/security/visibility/VisibilityLabelsCache.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/security/visibility/VisibilityLabelsCache.java
@@ -186,9 +186,7 @@ public class VisibilityLabelsCache implements VisibilityLabelOrdinalProvider {
     }
   }
 
-  /**
-   * @return The total number of visibility labels.
-   */
+  /** Returns The total number of visibility labels. */
   public int getLabelsCount() {
     this.lock.readLock().lock();
     try {
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/snapshot/RestoreSnapshotHelper.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/snapshot/RestoreSnapshotHelper.java
index 73408a7edb7..fbbd704b0ae 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/snapshot/RestoreSnapshotHelper.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/snapshot/RestoreSnapshotHelper.java
@@ -300,9 +300,7 @@ public class RestoreSnapshotHelper {
       return this.parentsMap;
     }
 
-    /**
-     * @return true if there're new regions
-     */
+    /** Returns true if there're new regions */
     public boolean hasRegionsToAdd() {
       return this.regionsToAdd != null && this.regionsToAdd.size() > 0;
     }
@@ -316,9 +314,7 @@ public class RestoreSnapshotHelper {
       return this.regionsToAdd;
     }
 
-    /**
-     * @return true if there're regions to restore
-     */
+    /** Returns true if there're regions to restore */
     public boolean hasRegionsToRestore() {
       return this.regionsToRestore != null && this.regionsToRestore.size() > 0;
     }
@@ -332,9 +328,7 @@ public class RestoreSnapshotHelper {
       return this.regionsToRestore;
     }
 
-    /**
-     * @return true if there're regions to remove
-     */
+    /** Returns true if there're regions to remove */
     public boolean hasRegionsToRemove() {
       return this.regionsToRemove != null && this.regionsToRemove.size() > 0;
     }
@@ -581,9 +575,7 @@ public class RestoreSnapshotHelper {
     }
   }
 
-  /**
-   * @return The set of files in the specified family directory.
-   */
+  /** Returns The set of files in the specified family directory. */
   private Set<String> getTableRegionFamilyFiles(final Path familyDir) throws IOException {
     FileStatus[] hfiles = CommonFSUtils.listStatus(fs, familyDir);
     if (hfiles == null) {
@@ -849,9 +841,7 @@ public class RestoreSnapshotHelper {
       .build();
   }
 
-  /**
-   * @return the set of the regions contained in the table
-   */
+  /** Returns the set of the regions contained in the table */
   private List<RegionInfo> getTableRegions() throws IOException {
     LOG.debug("get table regions: " + tableDir);
     FileStatus[] regionDirs =
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/snapshot/SnapshotInfo.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/snapshot/SnapshotInfo.java
index 29dbeacda8e..25e7f3ebd33 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/snapshot/SnapshotInfo.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/snapshot/SnapshotInfo.java
@@ -114,22 +114,22 @@ public final class SnapshotInfo extends AbstractHBaseTool {
         this.size = size;
       }
 
-      /** @return true if the file is in the archive */
+      /** Returns true if the file is in the archive */
       public boolean inArchive() {
         return this.inArchive;
       }
 
-      /** @return true if the file is corrupted */
+      /** Returns true if the file is corrupted */
       public boolean isCorrupted() {
         return this.corrupted;
       }
 
-      /** @return true if the file is missing */
+      /** Returns true if the file is missing */
       public boolean isMissing() {
         return this.size < 0;
       }
 
-      /** @return the file size */
+      /** Returns the file size */
       public long getSize() {
         return this.size;
       }
@@ -176,67 +176,67 @@ public final class SnapshotInfo extends AbstractHBaseTool {
       this.fs = fs;
     }
 
-    /** @return the snapshot descriptor */
+    /** Returns the snapshot descriptor */
     public SnapshotDescription getSnapshotDescription() {
       return ProtobufUtil.createSnapshotDesc(this.snapshot);
     }
 
-    /** @return true if the snapshot is corrupted */
+    /** Returns true if the snapshot is corrupted */
     public boolean isSnapshotCorrupted() {
       return hfilesMissing.get() > 0 || logsMissing.get() > 0 || hfilesCorrupted.get() > 0;
     }
 
-    /** @return the number of available store files */
+    /** Returns the number of available store files */
     public int getStoreFilesCount() {
       return hfilesCount.get() + hfilesArchiveCount.get() + hfilesMobCount.get();
     }
 
-    /** @return the number of available store files in the archive */
+    /** Returns the number of available store files in the archive */
     public int getArchivedStoreFilesCount() {
       return hfilesArchiveCount.get();
     }
 
-    /** @return the number of available store files in the mob dir */
+    /** Returns the number of available store files in the mob dir */
     public int getMobStoreFilesCount() {
       return hfilesMobCount.get();
     }
 
-    /** @return the number of available log files */
+    /** Returns the number of available log files */
     public int getLogsCount() {
       return logsCount.get();
     }
 
-    /** @return the number of missing store files */
+    /** Returns the number of missing store files */
     public int getMissingStoreFilesCount() {
       return hfilesMissing.get();
     }
 
-    /** @return the number of corrupted store files */
+    /** Returns the number of corrupted store files */
     public int getCorruptedStoreFilesCount() {
       return hfilesCorrupted.get();
     }
 
-    /** @return the number of missing log files */
+    /** Returns the number of missing log files */
     public int getMissingLogsCount() {
       return logsMissing.get();
     }
 
-    /** @return the total size of the store files referenced by the snapshot */
+    /** Returns the total size of the store files referenced by the snapshot */
     public long getStoreFilesSize() {
       return hfilesSize.get() + hfilesArchiveSize.get() + hfilesMobSize.get();
     }
 
-    /** @return the total size of the store files shared */
+    /** Returns the total size of the store files shared */
     public long getSharedStoreFilesSize() {
       return hfilesSize.get();
     }
 
-    /** @return the total size of the store files in the archive */
+    /** Returns the total size of the store files in the archive */
     public long getArchivedStoreFileSize() {
       return hfilesArchiveSize.get();
     }
 
-    /** @return the total size of the store files in the mob store */
+    /** Returns the total size of the store files in the mob store */
     public long getMobStoreFilesSize() {
       return hfilesMobSize.get();
     }
@@ -251,17 +251,17 @@ public final class SnapshotInfo extends AbstractHBaseTool {
       return nonSharedHfilesArchiveSize.get();
     }
 
-    /** @return the percentage of the shared store files */
+    /** Returns the percentage of the shared store files */
     public float getSharedStoreFilePercentage() {
       return ((float) hfilesSize.get() / (getStoreFilesSize())) * 100;
     }
 
-    /** @return the percentage of the mob store files */
+    /** Returns the percentage of the mob store files */
     public float getMobStoreFilePercentage() {
       return ((float) hfilesMobSize.get() / (getStoreFilesSize())) * 100;
     }
 
-    /** @return the total log size */
+    /** Returns the total log size */
     public long getLogsSize() {
       return logSize.get();
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/tool/BulkLoadHFiles.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/tool/BulkLoadHFiles.java
index 9c222183328..8c282ec84b4 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/tool/BulkLoadHFiles.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/tool/BulkLoadHFiles.java
@@ -90,9 +90,7 @@ public interface BulkLoadHFiles {
    */
   void disableReplication();
 
-  /**
-   * @return true if replication has been disabled.
-   */
+  /** Returns true if replication has been disabled. */
   boolean isReplicationDisabled();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/tool/CanaryTool.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/tool/CanaryTool.java
index ed7f474106c..12cb90c08e6 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/tool/CanaryTool.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/tool/CanaryTool.java
@@ -1517,9 +1517,7 @@ public class CanaryTool implements Tool, Canary {
       this.done = true;
     }
 
-    /**
-     * @return List of tables to use in test.
-     */
+    /** Returns List of tables to use in test. */
     private String[] generateMonitorTables(String[] monitorTargets) throws IOException {
       String[] returnTables = null;
 
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/BloomFilterBase.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/BloomFilterBase.java
index 142a36c35f8..fc5393ed49d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/BloomFilterBase.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/BloomFilterBase.java
@@ -25,18 +25,12 @@ import org.apache.yetus.audience.InterfaceAudience;
 @InterfaceAudience.Private
 public interface BloomFilterBase {
 
-  /**
-   * @return The number of keys added to the bloom
-   */
+  /** Returns The number of keys added to the bloom */
   long getKeyCount();
 
-  /**
-   * @return The max number of keys that can be inserted to maintain the desired error rate
-   */
+  /** Returns The max number of keys that can be inserted to maintain the desired error rate */
   long getMaxKeys();
 
-  /**
-   * @return Size of the bloom, in bytes
-   */
+  /** Returns Size of the bloom, in bytes */
   long getByteSize();
 }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/BloomFilterFactory.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/BloomFilterFactory.java
index 7bcbf98dad4..41311969207 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/BloomFilterFactory.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/BloomFilterFactory.java
@@ -96,41 +96,33 @@ public final class BloomFilterFactory {
   }
 
   /**
-   * @return true if general Bloom (Row or RowCol) filters are enabled in the given configuration
+   * Returns true if general Bloom (Row or RowCol) filters are enabled in the given configuration
    */
   public static boolean isGeneralBloomEnabled(Configuration conf) {
     return conf.getBoolean(IO_STOREFILE_BLOOM_ENABLED, true);
   }
 
-  /**
-   * @return true if Delete Family Bloom filters are enabled in the given configuration
-   */
+  /** Returns true if Delete Family Bloom filters are enabled in the given configuration */
   public static boolean isDeleteFamilyBloomEnabled(Configuration conf) {
     return conf.getBoolean(IO_STOREFILE_DELETEFAMILY_BLOOM_ENABLED, true);
   }
 
-  /**
-   * @return the Bloom filter error rate in the given configuration
-   */
+  /** Returns the Bloom filter error rate in the given configuration */
   public static float getErrorRate(Configuration conf) {
     return conf.getFloat(IO_STOREFILE_BLOOM_ERROR_RATE, (float) 0.01);
   }
 
-  /**
-   * @return the value for Bloom filter max fold in the given configuration
-   */
+  /** Returns the value for Bloom filter max fold in the given configuration */
   public static int getMaxFold(Configuration conf) {
     return conf.getInt(IO_STOREFILE_BLOOM_MAX_FOLD, MAX_ALLOWED_FOLD_FACTOR);
   }
 
-  /** @return the compound Bloom filter block size from the configuration */
+  /** Returns the compound Bloom filter block size from the configuration */
   public static int getBloomBlockSize(Configuration conf) {
     return conf.getInt(IO_STOREFILE_BLOOM_BLOCK_SIZE, 128 * 1024);
   }
 
-  /**
-   * @return max key for the Bloom filter from the configuration
-   */
+  /** Returns max key for the Bloom filter from the configuration */
   public static int getMaxKeys(Configuration conf) {
     return conf.getInt(IO_STOREFILE_BLOOM_MAX_KEYS, 128 * 1000 * 1000);
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/ConnectionCache.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/ConnectionCache.java
index 4a0111b0ac9..0a366157c8e 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/ConnectionCache.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/ConnectionCache.java
@@ -203,9 +203,7 @@ public class ConnectionCache {
     return false;
   }
 
-  /**
-   * @return Cluster ID for the HBase cluster or null if there is an err making the connection.
-   */
+  /** Returns Cluster ID for the HBase cluster or null if there is an err making the connection. */
   public String getClusterId() {
     try {
       ConnectionInfo connInfo = getCurrentConnection();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/DirectMemoryUtils.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/DirectMemoryUtils.java
index 66e3c332657..15f94ecc46b 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/DirectMemoryUtils.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/DirectMemoryUtils.java
@@ -109,9 +109,7 @@ public class DirectMemoryUtils {
     return 0;
   }
 
-  /**
-   * @return the current amount of direct memory used.
-   */
+  /** Returns the current amount of direct memory used. */
   public static long getDirectMemoryUsage() {
     if (BEAN_SERVER == null || NIO_DIRECT_POOL == null || !HAS_MEMORY_USED_ATTRIBUTE) return 0;
     try {
@@ -123,9 +121,7 @@ public class DirectMemoryUtils {
     }
   }
 
-  /**
-   * @return the current amount of direct memory used by netty module.
-   */
+  /** Returns the current amount of direct memory used by netty module. */
   public static long getNettyDirectMemoryUsage() {
 
     ByteBufAllocatorMetric metric =
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/FSUtils.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/FSUtils.java
index 274db97098c..59c5c032567 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/FSUtils.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/FSUtils.java
@@ -116,9 +116,7 @@ public final class FSUtils {
   private FSUtils() {
   }
 
-  /**
-   * @return True is <code>fs</code> is instance of DistributedFileSystem n
-   */
+  /** Returns True is <code>fs</code> is instance of DistributedFileSystem n */
   public static boolean isDistributedFileSystem(final FileSystem fs) throws IOException {
     FileSystem fileSystem = fs;
     // If passed an instance of HFileSystem, it fails instanceof DistributedFileSystem.
@@ -1781,9 +1779,7 @@ public final class FSUtils {
     return traversedPaths;
   }
 
-  /**
-   * @return A set containing all namenode addresses of fs
-   */
+  /** Returns A set containing all namenode addresses of fs */
   private static Set<InetSocketAddress> getNNAddresses(DistributedFileSystem fs,
     Configuration conf) {
     Set<InetSocketAddress> addresses = new HashSet<>();
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/HBaseFsck.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/HBaseFsck.java
index 3261b829697..41505b92c6a 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/HBaseFsck.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/HBaseFsck.java
@@ -354,9 +354,7 @@ public class HBaseFsck extends Configured implements Closeable {
     zkw = createZooKeeperWatcher();
   }
 
-  /**
-   * @return A retry counter factory configured for retrying lock file creation.
-   */
+  /** Returns A retry counter factory configured for retrying lock file creation. */
   public static RetryCounterFactory createLockRetryCounterFactory(Configuration conf) {
     return new RetryCounterFactory(
       conf.getInt("hbase.hbck.lockfile.attempts", DEFAULT_MAX_LOCK_FILE_ATTEMPTS),
@@ -366,9 +364,7 @@ public class HBaseFsck extends Configured implements Closeable {
         DEFAULT_LOCK_FILE_ATTEMPT_MAX_SLEEP_TIME));
   }
 
-  /**
-   * @return A retry counter factory configured for retrying znode creation.
-   */
+  /** Returns A retry counter factory configured for retrying znode creation. */
   private static RetryCounterFactory createZnodeRetryCounterFactory(Configuration conf) {
     return new RetryCounterFactory(
       conf.getInt("hbase.hbck.createznode.attempts", DEFAULT_MAX_CREATE_ZNODE_ATTEMPTS),
@@ -378,9 +374,7 @@ public class HBaseFsck extends Configured implements Closeable {
         DEFAULT_CREATE_ZNODE_ATTEMPT_MAX_SLEEP_TIME));
   }
 
-  /**
-   * @return Return the tmp dir this tool writes too.
-   */
+  /** Returns Return the tmp dir this tool writes too. */
   @InterfaceAudience.Private
   public static Path getTmpDir(Configuration conf) throws IOException {
     return new Path(CommonFSUtils.getRootDir(conf), HConstants.HBASE_TEMP_DIRECTORY);
@@ -396,9 +390,7 @@ public class HBaseFsck extends Configured implements Closeable {
       this.conf = conf;
     }
 
-    /**
-     * @return Will be <code>null</code> unless you call {@link #call()}
-     */
+    /** Returns Will be <code>null</code> unless you call {@link #call()} */
     Path getHbckLockPath() {
       return this.hbckLockPath;
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/HbckTableInfo.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/HbckTableInfo.java
index 5a709619d8f..5d95e196314 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/HbckTableInfo.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/HbckTableInfo.java
@@ -96,9 +96,7 @@ public class HbckTableInfo {
     deployedOn = new TreeSet<>();
   }
 
-  /**
-   * @return descriptor common to all regions. null if are none or multiple!
-   */
+  /** Returns descriptor common to all regions. null if are none or multiple! */
   TableDescriptor getTableDescriptor() {
     if (htds.size() == 1) {
       return (TableDescriptor) htds.toArray()[0];
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/JVMClusterUtil.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/JVMClusterUtil.java
index a9f9443d4bf..25eab87a08a 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/JVMClusterUtil.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/JVMClusterUtil.java
@@ -52,7 +52,7 @@ public class JVMClusterUtil {
       this.regionServer = r;
     }
 
-    /** @return the region server */
+    /** Returns the region server */
     public HRegionServer getRegionServer() {
       return this.regionServer;
     }
@@ -103,7 +103,7 @@ public class JVMClusterUtil {
       this.master = m;
     }
 
-    /** @return the master */
+    /** Returns the master */
     public HMaster getMaster() {
       return this.master;
     }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/RegionSplitter.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/RegionSplitter.java
index f248d6b9e5b..2f56426f68b 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/RegionSplitter.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/RegionSplitter.java
@@ -212,9 +212,7 @@ public class RegionSplitter {
      */
     String rowToStr(byte[] row);
 
-    /**
-     * @return the separator character to use when storing / printing the row
-     */
+    /** Returns the separator character to use when storing / printing the row */
     String separator();
 
     /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/RollingStatCalculator.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/RollingStatCalculator.java
index 1fd17be600f..4eedfe083e1 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/RollingStatCalculator.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/RollingStatCalculator.java
@@ -79,16 +79,12 @@ public class RollingStatCalculator {
     numberOfDataValues--;
   }
 
-  /**
-   * @return mean of the data values that are in the current list of data values
-   */
+  /** Returns mean of the data values that are in the current list of data values */
   public double getMean() {
     return this.currentSum / (double) numberOfDataValues;
   }
 
-  /**
-   * @return deviation of the data values that are in the current list of data values
-   */
+  /** Returns deviation of the data values that are in the current list of data values */
   public double getDeviation() {
     double variance = (currentSqrSum - (currentSum * currentSum) / (double) (numberOfDataValues))
       / numberOfDataValues;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/ServerRegionReplicaUtil.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/ServerRegionReplicaUtil.java
index bb37aa159bf..ae539db9dbb 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/ServerRegionReplicaUtil.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/ServerRegionReplicaUtil.java
@@ -159,32 +159,24 @@ public class ServerRegionReplicaUtil extends RegionReplicaUtil {
       || isRegionReplicaReplicationEnabled(conf);
   }
 
-  /**
-   * @return True if Region Read Replica is enabled for user-space tables.
-   */
+  /** Returns True if Region Read Replica is enabled for user-space tables. */
   private static boolean isRegionReplicaReplicationEnabled(Configuration conf) {
     return conf.getBoolean(REGION_REPLICA_REPLICATION_CONF_KEY, DEFAULT_REGION_REPLICA_REPLICATION);
   }
 
-  /**
-   * @return True if hbase:meta Region Read Replica is enabled.
-   */
+  /** Returns True if hbase:meta Region Read Replica is enabled. */
   public static boolean isMetaRegionReplicaReplicationEnabled(Configuration conf, TableName tn) {
     return TableName.isMetaTableName(tn) && conf.getBoolean(
       REGION_REPLICA_REPLICATION_CATALOG_CONF_KEY, DEFAULT_REGION_REPLICA_REPLICATION_CATALOG);
   }
 
-  /**
-   * @return True if wait for primary to flush is enabled for user-space tables.
-   */
+  /** Returns True if wait for primary to flush is enabled for user-space tables. */
   public static boolean isRegionReplicaWaitForPrimaryFlushEnabled(Configuration conf) {
     return conf.getBoolean(REGION_REPLICA_WAIT_FOR_PRIMARY_FLUSH_CONF_KEY,
       DEFAULT_REGION_REPLICA_WAIT_FOR_PRIMARY_FLUSH);
   }
 
-  /**
-   * @return True if we are to refresh user-space hfiles in Region Read Replicas.
-   */
+  /** Returns True if we are to refresh user-space hfiles in Region Read Replicas. */
   public static boolean isRegionReplicaStoreFileRefreshEnabled(Configuration conf) {
     return conf.getBoolean(REGION_REPLICA_STORE_FILE_REFRESH,
       DEFAULT_REGION_REPLICA_STORE_FILE_REFRESH);
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/YammerHistogramUtils.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/YammerHistogramUtils.java
index 72f874fe7a2..9e277723f44 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/YammerHistogramUtils.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/YammerHistogramUtils.java
@@ -51,7 +51,7 @@ public final class YammerHistogramUtils {
     }
   }
 
-  /** @return an abbreviated summary of {@code hist}. */
+  /** Returns an abbreviated summary of {@code hist}. */
   public static String getShortHistogramReport(final Histogram hist) {
     Snapshot sn = hist.getSnapshot();
     return "mean=" + DOUBLE_FORMAT.format(sn.getMean()) + ", min="
@@ -61,7 +61,7 @@ public final class YammerHistogramUtils {
       + DOUBLE_FORMAT.format(sn.get99thPercentile());
   }
 
-  /** @return a summary of {@code hist}. */
+  /** Returns a summary of {@code hist}. */
   public static String getHistogramReport(final Histogram hist) {
     Snapshot sn = hist.getSnapshot();
     return "mean=" + DOUBLE_FORMAT.format(sn.getMean()) + ", min="
@@ -76,7 +76,7 @@ public final class YammerHistogramUtils {
       + DOUBLE_FORMAT.format(sn.getValue(0.99999));
   }
 
-  /** @return pretty summary of {@code hist}. */
+  /** Returns pretty summary of {@code hist}. */
   public static String getPrettyHistogramReport(final Histogram h) {
     Snapshot sn = h.getSnapshot();
     return "Mean      = " + DOUBLE_FORMAT.format(sn.getMean()) + "\n" + "Min       = "
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/hbck/HFileCorruptionChecker.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/hbck/HFileCorruptionChecker.java
index 99bbb2af544..479a2425c4b 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/util/hbck/HFileCorruptionChecker.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/util/hbck/HFileCorruptionChecker.java
@@ -431,30 +431,22 @@ public class HFileCorruptionChecker {
     }
   }
 
-  /**
-   * @return the set of check failure file paths after checkTables is called.
-   */
+  /** Returns the set of check failure file paths after checkTables is called. */
   public Collection<Path> getFailures() {
     return new HashSet<>(failures);
   }
 
-  /**
-   * @return the set of corrupted file paths after checkTables is called.
-   */
+  /** Returns the set of corrupted file paths after checkTables is called. */
   public Collection<Path> getCorrupted() {
     return new HashSet<>(corrupted);
   }
 
-  /**
-   * @return number of hfiles checked in the last HfileCorruptionChecker run
-   */
+  /** Returns number of hfiles checked in the last HfileCorruptionChecker run */
   public int getHFilesChecked() {
     return hfilesChecked.get();
   }
 
-  /**
-   * @return the set of successfully quarantined paths after checkTables is called.
-   */
+  /** Returns the set of successfully quarantined paths after checkTables is called. */
   public Collection<Path> getQuarantined() {
     return new HashSet<>(quarantined);
   }
@@ -467,30 +459,22 @@ public class HFileCorruptionChecker {
     return new HashSet<>(missing);
   }
 
-  /**
-   * @return the set of check failure mob file paths after checkTables is called.
-   */
+  /** Returns the set of check failure mob file paths after checkTables is called. */
   public Collection<Path> getFailureMobFiles() {
     return new HashSet<>(failureMobFiles);
   }
 
-  /**
-   * @return the set of corrupted mob file paths after checkTables is called.
-   */
+  /** Returns the set of corrupted mob file paths after checkTables is called. */
   public Collection<Path> getCorruptedMobFiles() {
     return new HashSet<>(corruptedMobFiles);
   }
 
-  /**
-   * @return number of mob files checked in the last HfileCorruptionChecker run
-   */
+  /** Returns number of mob files checked in the last HfileCorruptionChecker run */
   public int getMobFilesChecked() {
     return mobFilesChecked.get();
   }
 
-  /**
-   * @return the set of successfully quarantined paths after checkTables is called.
-   */
+  /** Returns the set of successfully quarantined paths after checkTables is called. */
   public Collection<Path> getQuarantinedMobFiles() {
     return new HashSet<>(quarantinedMobFiles);
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractFSWALProvider.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractFSWALProvider.java
index 5b642d98fd3..be9fb23fa3c 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractFSWALProvider.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractFSWALProvider.java
@@ -431,9 +431,7 @@ public abstract class AbstractFSWALProvider<T extends AbstractFSWAL<?>> implemen
     return isMetaFile(p.getName());
   }
 
-  /**
-   * @return True if String ends in {@link #META_WAL_PROVIDER_ID}
-   */
+  /** Returns True if String ends in {@link #META_WAL_PROVIDER_ID} */
   public static boolean isMetaFile(String p) {
     return p != null && p.endsWith(META_WAL_PROVIDER_ID);
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractRecoveredEditsOutputSink.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractRecoveredEditsOutputSink.java
index 1b559dcce20..56e137e725f 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractRecoveredEditsOutputSink.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractRecoveredEditsOutputSink.java
@@ -52,9 +52,7 @@ abstract class AbstractRecoveredEditsOutputSink extends OutputSink {
     this.walSplitter = walSplitter;
   }
 
-  /**
-   * @return a writer that wraps a {@link WALProvider.Writer} and its Path. Caller should close.
-   */
+  /** Returns a writer that wraps a {@link WALProvider.Writer} and its Path. Caller should close. */
   protected RecoveredEditsWriter createRecoveredEditsWriter(TableName tableName, byte[] region,
     long seqId) throws IOException {
     Path regionEditsPath = getRegionSplitEditsPath(tableName, region, seqId,
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractWALRoller.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractWALRoller.java
index 031648dba82..c900333af9e 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractWALRoller.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/AbstractWALRoller.java
@@ -263,9 +263,7 @@ public abstract class AbstractWALRoller<T extends Abortable> extends Thread impl
     return state == Thread.State.WAITING || state == Thread.State.TIMED_WAITING;
   }
 
-  /**
-   * @return true if all WAL roll finished
-   */
+  /** Returns true if all WAL roll finished */
   public boolean walRollFinished() {
     // TODO add a status field of roll in RollController
     return wals.values().stream()
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/EntryBuffers.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/EntryBuffers.java
index 17a93ea4b99..5594f49aed8 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/EntryBuffers.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/EntryBuffers.java
@@ -89,9 +89,7 @@ class EntryBuffers {
     controller.checkForErrors();
   }
 
-  /**
-   * @return RegionEntryBuffer a buffer of edits to be written.
-   */
+  /** Returns RegionEntryBuffer a buffer of edits to be written. */
   synchronized RegionEntryBuffer getChunkToWrite() {
     long biggestSize = 0;
     byte[] biggestBufferKey = null;
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/OutputSink.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/OutputSink.java
index cdd571b4cc3..c3df5e4ee6a 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/OutputSink.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/OutputSink.java
@@ -134,9 +134,7 @@ abstract class OutputSink {
     return this.totalSkippedEdits.get();
   }
 
-  /**
-   * @return the number of currently opened writers
-   */
+  /** Returns the number of currently opened writers */
   abstract int getNumOpenWriters();
 
   /**
@@ -147,14 +145,10 @@ abstract class OutputSink {
 
   abstract List<Path> close() throws IOException;
 
-  /**
-   * @return a map from encoded region ID to the number of edits written out for that region.
-   */
+  /** Returns a map from encoded region ID to the number of edits written out for that region. */
   abstract Map<String, Long> getOutputCounts();
 
-  /**
-   * @return number of regions we've recovered
-   */
+  /** Returns number of regions we've recovered */
   abstract int getNumberOfRecoveredRegions();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WAL.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WAL.java
index fb1f17a7b57..390a9251751 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WAL.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WAL.java
@@ -198,9 +198,7 @@ public interface WAL extends Closeable, WALFileLengthProvider {
    */
   void abortCacheFlush(byte[] encodedRegionName);
 
-  /**
-   * @return Coprocessor host.
-   */
+  /** Returns Coprocessor host. */
   WALCoprocessorHost getCoprocessorHost();
 
   /**
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALEdit.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALEdit.java
index c688f6b1de5..7ea77b2036d 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALEdit.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALEdit.java
@@ -391,9 +391,7 @@ public class WALEdit implements HeapSize {
       : null;
   }
 
-  /**
-   * @return A Marker WALEdit that has <code>c</code> serialized as its value
-   */
+  /** Returns A Marker WALEdit that has <code>c</code> serialized as its value */
   public static WALEdit createCompaction(final RegionInfo hri, final CompactionDescriptor c) {
     byte[] pbbytes = c.toByteArray();
     KeyValue kv = new KeyValue(getRowForRegion(hri), METAFAMILY, COMPACTION,
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALKey.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALKey.java
index 2c6ae83f63d..0b2ba44d3b9 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALKey.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALKey.java
@@ -45,31 +45,21 @@ public interface WALKey extends SequenceId, Comparable<WALKey> {
     return 0;
   }
 
-  /**
-   * @return encoded region name
-   */
+  /** Returns encoded region name */
   byte[] getEncodedRegionName();
 
-  /**
-   * @return table name
-   */
+  /** Returns table name */
   TableName getTableName();
 
-  /**
-   * @return the write time
-   */
+  /** Returns the write time */
   long getWriteTime();
 
-  /**
-   * @return The nonce group
-   */
+  /** Returns The nonce group */
   default long getNonceGroup() {
     return HConstants.NO_NONCE;
   }
 
-  /**
-   * @return The nonce
-   */
+  /** Returns The nonce */
   default long getNonce() {
     return HConstants.NO_NONCE;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALKeyImpl.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALKeyImpl.java
index 3ca1b1589fe..146013ce1a9 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALKeyImpl.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALKeyImpl.java
@@ -328,13 +328,13 @@ public class WALKeyImpl implements WALKey {
     this.sequenceId = sequenceId;
   }
 
-  /** @return encoded region name */
+  /** Returns encoded region name */
   @Override
   public byte[] getEncodedRegionName() {
     return encodedRegionName;
   }
 
-  /** @return table name */
+  /** Returns table name */
   @Override
   public TableName getTableName() {
     return tablename;
@@ -368,9 +368,7 @@ public class WALKeyImpl implements WALKey {
     return this.sequenceId;
   }
 
-  /**
-   * @return the write time
-   */
+  /** Returns the write time */
   @Override
   public long getWriteTime() {
     return this.writeTime;
@@ -380,13 +378,13 @@ public class WALKeyImpl implements WALKey {
     return replicationScope;
   }
 
-  /** @return The nonce group */
+  /** Returns The nonce group */
   @Override
   public long getNonceGroup() {
     return nonceGroup;
   }
 
-  /** @return The nonce */
+  /** Returns The nonce */
   @Override
   public long getNonce() {
     return nonce;
@@ -409,9 +407,7 @@ public class WALKeyImpl implements WALKey {
     }
   }
 
-  /**
-   * @return the set of cluster Ids that have consumed the change
-   */
+  /** Returns the set of cluster Ids that have consumed the change */
   public List<UUID> getClusterIds() {
     return clusterIds;
   }
diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALProvider.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALProvider.java
index 91b397df070..06e445607cb 100644
--- a/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALProvider.java
+++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALProvider.java
@@ -55,9 +55,7 @@ public interface WALProvider {
    */
   WAL getWAL(RegionInfo region) throws IOException;
 
-  /**
-   * @return the List of WALs that are used by this server
-   */
+  /** Returns the List of WALs that are used by this server */
   List<WAL> getWALs();
 
   /**
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/io/hfile/TestHFileDataBlockEncoder.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/io/hfile/TestHFileDataBlockEncoder.java
index 8e6a7188065..b9f00899975 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/io/hfile/TestHFileDataBlockEncoder.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/io/hfile/TestHFileDataBlockEncoder.java
@@ -228,9 +228,7 @@ public class TestHFileDataBlockEncoder {
     }
   }
 
-  /**
-   * @return All possible data block encoding configurations
-   */
+  /** Returns All possible data block encoding configurations */
   @Parameters
   public static Collection<Object[]> getAllConfigurations() {
     List<Object[]> configurations = new ArrayList<>();
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/master/assignment/TestRaceBetweenSCPAndDTP.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/master/assignment/TestRaceBetweenSCPAndDTP.java
index 4da18c4bdbf..e6a40b74e89 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/master/assignment/TestRaceBetweenSCPAndDTP.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/master/assignment/TestRaceBetweenSCPAndDTP.java
@@ -149,9 +149,7 @@ public class TestRaceBetweenSCPAndDTP {
     UTIL.waitFor(60000, () -> procExec.isFinished(dtpProcId));
   }
 
-  /**
-   * @return Returns {@link Procedure#NO_PROC_ID} if no SCP found else actual pid.
-   */
+  /** Returns Returns {@link Procedure#NO_PROC_ID} if no SCP found else actual pid. */
   private long getSCPPID(ProcedureExecutor<?> e) {
     Optional<ServerCrashProcedure> optional = e.getProcedures().stream()
       .filter(p -> p instanceof ServerCrashProcedure).map(p -> (ServerCrashProcedure) p).findAny();
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/master/procedure/TestHBCKSCP.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/master/procedure/TestHBCKSCP.java
index b3897db5580..66353e03f6c 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/master/procedure/TestHBCKSCP.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/master/procedure/TestHBCKSCP.java
@@ -159,9 +159,7 @@ public class TestHBCKSCP extends TestSCPBase {
     return pid;
   }
 
-  /**
-   * @return True if we find reference to <code>sn</code> in meta table.
-   */
+  /** Returns True if we find reference to <code>sn</code> in meta table. */
   private boolean searchMeta(HMaster master, ServerName sn) throws IOException {
     List<Pair<RegionInfo, ServerName>> ps =
       MetaTableAccessor.getTableRegionsAndLocations(master.getConnection(), null);
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/TestHRegion.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/TestHRegion.java
index 8a7bda2160b..4147f46f4ee 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/TestHRegion.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/TestHRegion.java
@@ -1734,9 +1734,7 @@ public class TestHRegion {
     metricsAssertHelper.assertCounter("syncTimeNumOps", syncs, source);
   }
 
-  /**
-   * @return syncs initial syncTimeNumOps
-   */
+  /** Returns syncs initial syncTimeNumOps */
   private long prepareRegionForBachPut(final Put[] puts, final MetricsWALSource source,
     boolean slop) throws IOException {
     this.region = initHRegion(tableName, method, CONF, COLUMN_FAMILY_BYTES);
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/TestRecoveredEdits.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/TestRecoveredEdits.java
index 38ccd6386aa..96cd1057ba5 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/TestRecoveredEdits.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/TestRecoveredEdits.java
@@ -172,9 +172,7 @@ public class TestRecoveredEdits {
     LOG.info("Checked " + count + " edits made it in");
   }
 
-  /**
-   * @return Return how many edits seen.
-   */
+  /** Returns Return how many edits seen. */
   // Used by TestWALPlayer over in hbase-mapreduce too.
   public static int verifyAllEditsMadeItIn(final FileSystem fs, final Configuration conf,
     final Path edits, final HRegion region) throws IOException {
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/wal/TestLogRollingNoCluster.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/wal/TestLogRollingNoCluster.java
index 6c301b33008..bdc343181f0 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/wal/TestLogRollingNoCluster.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/wal/TestLogRollingNoCluster.java
@@ -141,9 +141,7 @@ public class TestLogRollingNoCluster {
       this.log = LoggerFactory.getLogger("Appender:" + getName());
     }
 
-    /**
-     * @return Call when the thread is done.
-     */
+    /** Returns Call when the thread is done. */
     boolean isException() {
       return !isAlive() && this.e != null;
     }
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/replication/regionserver/TestMetaRegionReplicaReplication.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/replication/regionserver/TestMetaRegionReplicaReplication.java
index 572148be6ad..ab7935ddad4 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/replication/regionserver/TestMetaRegionReplicaReplication.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/replication/regionserver/TestMetaRegionReplicaReplication.java
@@ -254,9 +254,7 @@ public class TestMetaRegionReplicaReplication {
     return results;
   }
 
-  /**
-   * @return All Regions for tableName including Replicas.
-   */
+  /** Returns All Regions for tableName including Replicas. */
   private Region[] getAllRegions(TableName tableName, int replication) {
     final Region[] regions = new Region[replication];
     for (int i = 0; i < NB_SERVERS; i++) {
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/replication/regionserver/TestReplicationSourceManager.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/replication/regionserver/TestReplicationSourceManager.java
index 75a5597744c..82856e550d4 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/replication/regionserver/TestReplicationSourceManager.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/replication/regionserver/TestReplicationSourceManager.java
@@ -770,9 +770,7 @@ public abstract class TestReplicationSourceManager {
       }
     }
 
-    /**
-     * @return 1 when the map is not empty.
-     */
+    /** Returns 1 when the map is not empty. */
     private int isLogZnodesMapPopulated() {
       Collection<Set<String>> sets = logZnodesMap.values();
       if (sets.size() > 1) {
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/util/HFileArchiveTestingUtil.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/util/HFileArchiveTestingUtil.java
index bfc0e149df5..ae0754c0802 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/util/HFileArchiveTestingUtil.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/util/HFileArchiveTestingUtil.java
@@ -136,9 +136,7 @@ public class HFileArchiveTestingUtil {
     return null;
   }
 
-  /**
-   * @return &lt;expected, gotten, backup&gt;, where each is sorted
-   */
+  /** Returns &lt;expected, gotten, backup&gt;, where each is sorted */
   private static List<List<String>> getFileLists(FileStatus[] previous, FileStatus[] archived) {
     List<List<String>> files = new ArrayList<>(3);
 
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/util/MultiThreadedAction.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/util/MultiThreadedAction.java
index a75ff7ead54..2476fb38808 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/util/MultiThreadedAction.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/util/MultiThreadedAction.java
@@ -267,7 +267,7 @@ public abstract class MultiThreadedAction {
     }
   }
 
-  /** @return the end key of the key range, exclusive */
+  /** Returns the end key of the key range, exclusive */
   public long getEndKey() {
     return endKey;
   }
diff --git a/hbase-server/src/test/java/org/apache/hadoop/hbase/util/test/LoadTestDataGenerator.java b/hbase-server/src/test/java/org/apache/hadoop/hbase/util/test/LoadTestDataGenerator.java
index 621b1ba2b9e..e7283d2d9aa 100644
--- a/hbase-server/src/test/java/org/apache/hadoop/hbase/util/test/LoadTestDataGenerator.java
+++ b/hbase-server/src/test/java/org/apache/hadoop/hbase/util/test/LoadTestDataGenerator.java
@@ -155,9 +155,7 @@ public abstract class LoadTestDataGenerator {
     return get;
   }
 
-  /**
-   * @return the arguments passed to the generator as a list of objects.
-   */
+  /** Returns the arguments passed to the generator as a list of objects. */
   public String[] getArgs() {
     return this.args;
   }
diff --git a/hbase-shell/src/test/java/org/apache/hadoop/hbase/client/AbstractTestShell.java b/hbase-shell/src/test/java/org/apache/hadoop/hbase/client/AbstractTestShell.java
index 20aa8ed0b00..58ce051930d 100644
--- a/hbase-shell/src/test/java/org/apache/hadoop/hbase/client/AbstractTestShell.java
+++ b/hbase-shell/src/test/java/org/apache/hadoop/hbase/client/AbstractTestShell.java
@@ -70,16 +70,12 @@ public abstract class AbstractTestShell {
     System.setProperty("jruby.native.verbose", "true");
   }
 
-  /**
-   * @return comma separated list of ruby script names for tests
-   */
+  /** Returns comma separated list of ruby script names for tests */
   protected String getIncludeList() {
     return "";
   }
 
-  /**
-   * @return comma separated list of ruby script names for tests to skip
-   */
+  /** Returns comma separated list of ruby script names for tests to skip */
   protected String getExcludeList() {
     return "";
   }
diff --git a/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/HBaseCommonTestingUtility.java b/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/HBaseCommonTestingUtility.java
index 972b3b61faa..e847f18f4f1 100644
--- a/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/HBaseCommonTestingUtility.java
+++ b/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/HBaseCommonTestingUtility.java
@@ -163,18 +163,14 @@ public class HBaseCommonTestingUtility {
     conf.set(propertyName, newDir.getAbsolutePath());
   }
 
-  /**
-   * @return True if we should delete testing dirs on exit.
-   */
+  /** Returns True if we should delete testing dirs on exit. */
   boolean deleteOnExit() {
     String v = System.getProperty("hbase.testing.preserve.testdir");
     // Let default be true, to delete on exit.
     return v == null ? true : !Boolean.parseBoolean(v);
   }
 
-  /**
-   * @return True if we removed the test dirs
-   */
+  /** Returns True if we removed the test dirs */
   public boolean cleanupTestDir() {
     if (deleteDir(this.dataTestDir)) {
       this.dataTestDir = null;
diff --git a/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/HBaseZKTestingUtility.java b/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/HBaseZKTestingUtility.java
index 0498acdc30b..14ddc7cf12b 100644
--- a/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/HBaseZKTestingUtility.java
+++ b/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/HBaseZKTestingUtility.java
@@ -197,9 +197,7 @@ public class HBaseZKTestingUtility extends HBaseCommonTestingUtility {
     });
   }
 
-  /**
-   * @return True if we removed the test dirs
-   */
+  /** Returns True if we removed the test dirs */
   @Override
   public boolean cleanupTestDir() {
     boolean ret = super.cleanupTestDir();
diff --git a/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/MiniHBaseCluster.java b/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/MiniHBaseCluster.java
index 0f65b9f438b..8e66c94e33b 100644
--- a/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/MiniHBaseCluster.java
+++ b/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/MiniHBaseCluster.java
@@ -636,16 +636,12 @@ public class MiniHBaseCluster extends HBaseCluster {
     return false;
   }
 
-  /**
-   * @return List of master threads.
-   */
+  /** Returns List of master threads. */
   public List<JVMClusterUtil.MasterThread> getMasterThreads() {
     return this.hbaseCluster.getMasters();
   }
 
-  /**
-   * @return List of live master threads (skips the aborted and the killed)
-   */
+  /** Returns List of live master threads (skips the aborted and the killed) */
   public List<JVMClusterUtil.MasterThread> getLiveMasterThreads() {
     return this.hbaseCluster.getLiveMasters();
   }
@@ -743,9 +739,7 @@ public class MiniHBaseCluster extends HBaseCluster {
     }
   }
 
-  /**
-   * @return Number of live region servers in the cluster currently.
-   */
+  /** Returns Number of live region servers in the cluster currently. */
   public int getNumLiveRegionServers() {
     return this.hbaseCluster.getLiveRegionServers().size();
   }
@@ -758,9 +752,7 @@ public class MiniHBaseCluster extends HBaseCluster {
     return this.hbaseCluster.getRegionServers();
   }
 
-  /**
-   * @return List of live region server threads (skips the aborted and the killed)
-   */
+  /** Returns List of live region server threads (skips the aborted and the killed) */
   public List<JVMClusterUtil.RegionServerThread> getLiveRegionServerThreads() {
     return this.hbaseCluster.getLiveRegionServers();
   }
diff --git a/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/StartMiniClusterOption.java b/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/StartMiniClusterOption.java
index 66e456bfdb6..5db0178d660 100644
--- a/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/StartMiniClusterOption.java
+++ b/hbase-testing-util/src/main/java/org/apache/hadoop/hbase/StartMiniClusterOption.java
@@ -176,9 +176,7 @@ public final class StartMiniClusterOption {
       + createRootDir + ", createWALDir=" + createWALDir + '}';
   }
 
-  /**
-   * @return a new builder.
-   */
+  /** Returns a new builder. */
   public static Builder builder() {
     return new Builder();
   }
diff --git a/hbase-thrift/src/main/java/org/apache/hadoop/hbase/thrift/ImplType.java b/hbase-thrift/src/main/java/org/apache/hadoop/hbase/thrift/ImplType.java
index 85d8e700dc7..fb6668430c7 100644
--- a/hbase-thrift/src/main/java/org/apache/hadoop/hbase/thrift/ImplType.java
+++ b/hbase-thrift/src/main/java/org/apache/hadoop/hbase/thrift/ImplType.java
@@ -59,9 +59,7 @@ public enum ImplType {
     this.canSpecifyBindIP = canSpecifyBindIP;
   }
 
-  /**
-   * @return <code>-option</code>
-   */
+  /** Returns <code>-option</code> */
   @Override
   public String toString() {
     return "-" + option;
diff --git a/hbase-thrift/src/main/java/org/apache/hadoop/hbase/thrift/ThriftHBaseServiceHandler.java b/hbase-thrift/src/main/java/org/apache/hadoop/hbase/thrift/ThriftHBaseServiceHandler.java
index d7085c61e84..1900c6c0f8d 100644
--- a/hbase-thrift/src/main/java/org/apache/hadoop/hbase/thrift/ThriftHBaseServiceHandler.java
+++ b/hbase-thrift/src/main/java/org/apache/hadoop/hbase/thrift/ThriftHBaseServiceHandler.java
@@ -258,7 +258,7 @@ public class ThriftHBaseServiceHandler extends HBaseServiceHandler implements Hb
   }
 
   /**
-   * @return the list of regions in the given table, or an empty list if the table does not exist
+   * Returns the list of regions in the given table, or an empty list if the table does not exist
    */
   @Override
   public List<TRegionInfo> getTableRegions(ByteBuffer tableName) throws IOError {
diff --git a/hbase-thrift/src/test/java/org/apache/hadoop/hbase/thrift/TestThriftServer.java b/hbase-thrift/src/test/java/org/apache/hadoop/hbase/thrift/TestThriftServer.java
index 8059b0998eb..46f60710e36 100644
--- a/hbase-thrift/src/test/java/org/apache/hadoop/hbase/thrift/TestThriftServer.java
+++ b/hbase-thrift/src/test/java/org/apache/hadoop/hbase/thrift/TestThriftServer.java
@@ -845,9 +845,7 @@ public class TestThriftServer {
     return columnList;
   }
 
-  /**
-   * @return a List of Mutations for a row, with columnA having valueA and columnB having valueB
-   */
+  /** Returns a List of Mutations for a row, with columnA having valueA and columnB having valueB */
   private static List<Mutation> getMutations() {
     List<Mutation> mutations = new ArrayList<>(2);
     mutations.add(new Mutation(false, columnAname, valueAname, true));
diff --git a/hbase-thrift/src/test/java/org/apache/hadoop/hbase/thrift/ThriftServerRunner.java b/hbase-thrift/src/test/java/org/apache/hadoop/hbase/thrift/ThriftServerRunner.java
index 701daeb5852..410112554b3 100644
--- a/hbase-thrift/src/test/java/org/apache/hadoop/hbase/thrift/ThriftServerRunner.java
+++ b/hbase-thrift/src/test/java/org/apache/hadoop/hbase/thrift/ThriftServerRunner.java
@@ -43,9 +43,7 @@ class ThriftServerRunner extends Thread implements Closeable {
     return this.thriftServer;
   }
 
-  /**
-   * @return Empty unless {@link #run()} threw an exception; if it did, access it here.
-   */
+  /** Returns Empty unless {@link #run()} threw an exception; if it did, access it here. */
   Exception getRunException() {
     return this.exception;
   }
diff --git a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ClusterStatusTracker.java b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ClusterStatusTracker.java
index c4c53d4eafb..26ccd2c9c0e 100644
--- a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ClusterStatusTracker.java
+++ b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ClusterStatusTracker.java
@@ -83,9 +83,7 @@ public class ClusterStatusTracker extends ZKNodeTracker {
     }
   }
 
-  /**
-   * @return Content of the clusterup znode as a serialized pb with the pb magic as prefix.
-   */
+  /** Returns Content of the clusterup znode as a serialized pb with the pb magic as prefix. */
   static byte[] toByteArray() {
     ZooKeeperProtos.ClusterUp.Builder builder = ZooKeeperProtos.ClusterUp.newBuilder();
     builder.setStartDate(new java.util.Date().toString());
diff --git a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/MiniZooKeeperCluster.java b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/MiniZooKeeperCluster.java
index cf5eb2c9c69..6d21fb57588 100644
--- a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/MiniZooKeeperCluster.java
+++ b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/MiniZooKeeperCluster.java
@@ -472,9 +472,7 @@ public class MiniZooKeeperCluster {
       : clientPortList.get(activeZKServerIndex);
   }
 
-  /**
-   * @return Address for this cluster instance.
-   */
+  /** Returns Address for this cluster instance. */
   public Address getAddress() {
     return Address.fromParts(HOST, getClientPort());
   }
diff --git a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKListener.java b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKListener.java
index f42781a8caa..7d4be11d197 100644
--- a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKListener.java
+++ b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKListener.java
@@ -71,9 +71,7 @@ public abstract class ZKListener {
     // no-op
   }
 
-  /**
-   * @return The watcher associated with this listener
-   */
+  /** Returns The watcher associated with this listener */
   public ZKWatcher getWatcher() {
     return this.watcher;
   }
diff --git a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKUtil.java b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKUtil.java
index 79b0e49f607..d84062656cd 100644
--- a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKUtil.java
+++ b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKUtil.java
@@ -1115,37 +1115,27 @@ public final class ZKUtil {
       this.path = path;
     }
 
-    /**
-     * @return a createAndFailSilent ZKUtilOp
-     */
+    /** Returns a createAndFailSilent ZKUtilOp */
     public static ZKUtilOp createAndFailSilent(String path, byte[] data) {
       return new CreateAndFailSilent(path, data);
     }
 
-    /**
-     * @return a deleteNodeFailSilent ZKUtilOP
-     */
+    /** Returns a deleteNodeFailSilent ZKUtilOP */
     public static ZKUtilOp deleteNodeFailSilent(String path) {
       return new DeleteNodeFailSilent(path);
     }
 
-    /**
-     * @return a setData ZKUtilOp
-     */
+    /** Returns a setData ZKUtilOp */
     public static ZKUtilOp setData(String path, byte[] data) {
       return new SetData(path, data);
     }
 
-    /**
-     * @return a setData ZKUtilOp
-     */
+    /** Returns a setData ZKUtilOp */
     public static ZKUtilOp setData(String path, byte[] data, int version) {
       return new SetData(path, data, version);
     }
 
-    /**
-     * @return path to znode where the ZKOp will occur
-     */
+    /** Returns path to znode where the ZKOp will occur */
     public String getPath() {
       return path;
     }
diff --git a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKWatcher.java b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKWatcher.java
index feaa62fd77b..786c78d5614 100644
--- a/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKWatcher.java
+++ b/hbase-zookeeper/src/main/java/org/apache/hadoop/hbase/zookeeper/ZKWatcher.java
@@ -516,9 +516,7 @@ public class ZKWatcher implements Watcher, Abortable, Closeable {
     return new ArrayList<>(listeners);
   }
 
-  /**
-   * @return The number of currently registered listeners
-   */
+  /** Returns The number of currently registered listeners */
   public int getNumberOfListeners() {
     return listeners.size();
   }