book: Change "Failures" to "Errors" in doc special sections chapter

[kamalmarhubi]

This matches the usage in the standard library's documentation.

[rust-highfive]

Thanks for the pull request, and welcome! The Rust team is excited to review your changes, and you should hear from @steveklabnik (or someone else) soon.

If any changes to this PR are deemed necessary, please add them as extra commits. This ensures that the reviewer can see what has changed since they last reviewed the code. Due to the way GitHub handles out-of-date commits, this should also make it reasonably obvious what issues have or haven't been addressed. Large or tricky changes may require several passes of review and changes.

Please see the contribution instructions for more information.

[steveklabnik]

Hmmm, I would like to hear what @rust-lang/libs has to say about this. "Failures" is the term we agreed upon when we changed fail! to panic!, so I'm inclined to believe that the standard library is wrong.

However, we may want to change that convention to Errors, as well, it's about Result::Err<E>.

[kamalmarhubi]

Eep, I certainly wasn't expecting to be reporting a doc bug for the entire stdlib!

[aturon]

I think the book should be consistent with std's docs, which do indeed seem to use Errors (at least looking at IO). And the fact that it hooks into std::error terminology as well is a nice plus.

[brson]

I think Errors is clearer.

[steveklabnik]

Great, let's do it!

@kamalmarhubi would you like to also double-check std for any headings that say this and change them as well? If not, we can go ahead and merge this and I can do that separately.

[kamalmarhubi]

@steveklabnik:

$ git grep '# Failures'
src/doc/book/documentation.md:/// # Failures

:-)

[kamalmarhubi]

And just in case:

$ git grep '#.*Failures'
src/doc/book/documentation.md:/// # Failures

[steveklabnik]

What about just "failure" without the s?

On Feb 1, 2016, 21:23 -0500, Kamal Marhubinotifications@github.com, wrote:

And just in case:

$ git grep '#.*Failures' src/doc/book/documentation.md:/// # Failures

—
Reply to this email directly orview it on GitHub(#31345 (comment)).

[kamalmarhubi]

Urg, a bunch in std::sync. On it!

[kamalmarhubi]

There you go!

[steveklabnik]

@bors: r+ rollup

thanks so much!

[bors]

📌 Commit 129a623 has been approved by steveklabnik