clojure.java.io/delete-file docstring takes an optional second arg `silently` and says:
This is confusing. The intent is that in the case of a failure, it will by default throw an exception. Or if the optional second arg is supplied and truthy, it will be returned instead.
Initially reported: https://groups.google.com/d/msg/clojure/T9Kvr0IL0kg/wcKBfR9w_1sJ
Approach: Make docstring sentence clearer per Stu's suggestion in comments: