[ 
https://issues.apache.org/jira/browse/HADOOP-13946?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15897890#comment-15897890
 ] 

Chris Nauroth commented on HADOOP-13946:
----------------------------------------

The content looks great.  I have a few minor copy editing comments.

{code}
* When a file is renamed, it's modification time is not changed, *but the source
  and destination directories have their modification times updated.
{code}

Replace with "its modification time".  I think you were going for italics with 
that '\*', but it's unclosed and rendering the actual '\*' into the page when I 
build the site.

{code}
  the default granularity is 1 houre. If the precision set to zero, access times
{code}

Change to "hours" and "precision is set to zero".

{code}
  `create()` call, or the actual the time which the PUT request was initiated.
{code}

Remove the extra "the".

{code}
 * `FileSystem.chmod()` may update modification times (example: Azure wasb://).
{code}

Markdown is rendering an actualy hyperlink that targets "wasb://)", which does 
nothing when clicked.  Can this be suppressed or changed to a link to our WASB 
document?

After that, this patch will be ready to go.


> Document how HDFS updates timestamps in the FS spec; compare with object 
> stores
> -------------------------------------------------------------------------------
>
>                 Key: HADOOP-13946
>                 URL: https://issues.apache.org/jira/browse/HADOOP-13946
>             Project: Hadoop Common
>          Issue Type: Improvement
>          Components: documentation, fs
>    Affects Versions: 2.7.3
>            Reporter: Steve Loughran
>            Assignee: Steve Loughran
>            Priority: Minor
>         Attachments: HADOOP-13946-001.patch, HADOOP-13946-002.patch, 
> HADOOP-13946-003.patch, HADOOP-13946-004.patch
>
>
> SPARK-17159 shows that the behavior of when HDFS updates timestamps isn't 
> well documented. Document these in the FS spec.
> I'm not going to add tests for this, as it is so very dependent on FS 
> implementations, as in "POSIX filesystems may behave differently from HDFS". 
> If someone knows what happens there, their contribution is welcome.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

---------------------------------------------------------------------
To unsubscribe, e-mail: common-issues-unsubscr...@hadoop.apache.org
For additional commands, e-mail: common-issues-h...@hadoop.apache.org

Reply via email to