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

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 2.12.0
• Assignee: Unassigned
• Reporter: Thib Guicherd-Callin
• Created: 14/Mar/21 01:03
• Updated: 14/Jun/22 21:34
• Resolved: 14/Jun/22 21:34

Description

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.