You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "Gary D. Gregory (Jira)" <ji...@apache.org> on 2022/06/14 21:35:00 UTC

[jira] [Resolved] (IO-722) Improve FileUtils.touch() Javadoc to clarify it does not behave like GNU touch

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

Gary D. Gregory resolved IO-722.
--------------------------------
    Fix Version/s: 2.12.0
       Resolution: Fixed

Javadoc updated.

> Improve FileUtils.touch() Javadoc to clarify it does not behave like GNU touch
> ------------------------------------------------------------------------------
>
>                 Key: IO-722
>                 URL: https://issues.apache.org/jira/browse/IO-722
>             Project: Commons IO
>          Issue Type: Improvement
>            Reporter: Thib Guicherd-Callin
>            Priority: Minor
>             Fix For: 2.12.0
>
>
> The Javadoc of FileUtils.touch() says it behaves like the Unix touch utility. I'm not sure about the Unix one, but the GNU one does not create intermediate directories (e.g. touch /tmp/foo/bar/baz does not succeed if /tmp/foo/bar/ does not already exist). Currently there is a paragraph further down in the Javadoc that says 'Also, as from v1.3 this method creates parent directories if they do not exist', but the implication in the leading sentence that it behaves like Unix touch is misleading.



--
This message was sent by Atlassian Jira
(v8.20.7#820007)