[
https://issues.apache.org/jira/browse/IO-778?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17575977#comment-17575977
]
Rainer Hochreiter commented on IO-778:
--------------------------------------
The referenced article says:
_Unchecked exceptions represent programming errors so it is wise to document
them so programmers get familiar with all the errors so they can avoid it._
For my understanding these means, that unchecked exceptions should be
documented to avoid programming errors!
> FileUtils.copyFile(File srcFile, File destFile): Missing
> IllegalArgumentException in Javadoc
> --------------------------------------------------------------------------------------------
>
> Key: IO-778
> URL: https://issues.apache.org/jira/browse/IO-778
> Project: Commons IO
> Issue Type: Wish
> Components: Utilities
> Affects Versions: 2.11.0
> Reporter: Rainer Hochreiter
> Priority: Trivial
>
> Method {{FileUtils.copyFile(File srcFile, File destFile)}} throwsÂ
> {{{}IllegalArgumentException{}}}, when called with identical files. This is
> not documented in Javadoc.
> The {{IllegalArgumentException}} is thrown by
> {{FileUtils.requireCanonicalPathsNotEquals(File file1, File file2)}} in
> {{FileUtils.copyFile(File srcFile, File destFile, final CopyOption...
> copyOptions).}}
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
