Thib Guicherd-Callin created IO-722:
---------------------------------------
Summary: 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
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.3.4#803005)