From: sto.mar@... Date: 2017-03-01T08:57:35+00:00 Subject: [ruby-core:79839] [Ruby trunk Misc#12365] [DOC] Suggestion to change FileUtils.compare_file Issue #12365 has been updated by Marcus Stollsteimer. I used `/dev/urandom` in the example because `/dev/random` might block. ---------------------------------------- Misc #12365: [DOC] Suggestion to change FileUtils.compare_file https://bugs.ruby-lang.org/issues/12365#change-63274 * Author: Robert A. Heiler * Status: Open * Priority: Normal * Assignee: ---------------------------------------- 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. -- https://bugs.ruby-lang.org/ Unsubscribe: