Actions
Misc #12365
closed[DOC] Suggestion to change FileUtils.compare_file
Status:
Closed
Assignee:
-
Description
Hello.
The documentation at:
http://ruby-doc.org/stdlib-2.3.1/libdoc/fileutils/rdoc/FileUtils.html#method-c-compare_file
shows the "return" value in the second example to be:
#=> maybe false
I am not sure what this means, so my suggestion would be to instead, get
rid of the "maybe" part there and stick just to "false". And to instead
document above the method definition, under which circumstance can the
second check return false, e. g. via examples or just by explanation.
I found a return value of "maybe false" confusing.
Updated by naruse (Yui NARUSE) almost 8 years ago
I think the author considered BusyBox.
Therefore it is not a good example.
I think /dev/null and /dev/random is better...
Updated by stomar (Marcus Stollsteimer) about 7 years ago
I used /dev/urandom
in the example because /dev/random
might block.
Updated by stomar (Marcus Stollsteimer) about 7 years ago
- Status changed from Open to Closed
Actions
Like0
Like0Like0Like0