[ 
https://issues.apache.org/jira/browse/HDFS-16803?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

JiangHua Zhu updated HDFS-16803:
--------------------------------
    Description: 
In hdfs module, some annotations are out of date. E.g:
{code:java}
  FSDirRenameOp: 
  /**
   * @see {@link #unprotectedRenameTo(FSDirectory, String, String, INodesInPath,
   * INodesInPath, long, BlocksMapUpdateInfo, Options.Rename...)}
   */
  static RenameResult renameTo(FSDirectory fsd, FSPermissionChecker pc,
      String src, String dst, BlocksMapUpdateInfo collectedBlocks,
      boolean logRetryCache,Options.Rename... options)
          throws IOException {
{code}

We should try to improve these annotations to make the documentation look more 
comfortable.

  was:
In FSDirRenameOp, some annotations are out of date. E.g:
{code:java}
  /**
   * @see {@link #unprotectedRenameTo(FSDirectory, String, String, INodesInPath,
   * INodesInPath, long, BlocksMapUpdateInfo, Options.Rename...)}
   */
  static RenameResult renameTo(FSDirectory fsd, FSPermissionChecker pc,
      String src, String dst, BlocksMapUpdateInfo collectedBlocks,
      boolean logRetryCache,Options.Rename... options)
          throws IOException {
{code}

We should try to improve these annotations to make the documentation look more 
comfortable.


> Improve some annotations in hdfs module
> ---------------------------------------
>
>                 Key: HDFS-16803
>                 URL: https://issues.apache.org/jira/browse/HDFS-16803
>             Project: Hadoop HDFS
>          Issue Type: Improvement
>          Components: documentation, namenode
>    Affects Versions: 2.9.2, 3.3.4
>            Reporter: JiangHua Zhu
>            Assignee: JiangHua Zhu
>            Priority: Major
>              Labels: pull-request-available
>
> In hdfs module, some annotations are out of date. E.g:
> {code:java}
>   FSDirRenameOp: 
>   /**
>    * @see {@link #unprotectedRenameTo(FSDirectory, String, String, 
> INodesInPath,
>    * INodesInPath, long, BlocksMapUpdateInfo, Options.Rename...)}
>    */
>   static RenameResult renameTo(FSDirectory fsd, FSPermissionChecker pc,
>       String src, String dst, BlocksMapUpdateInfo collectedBlocks,
>       boolean logRetryCache,Options.Rename... options)
>           throws IOException {
> {code}
> We should try to improve these annotations to make the documentation look 
> more comfortable.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to