Add documentation for libstd/bool.rs.

There was some before, but now we have a big header, as well as
lots of individual bits of documentation.
auto merge of #6748 : steveklabnik/rust/bool_docs, r=thestinger

There was some before, but now we have a big header, as well as
lots of individual bits of documentation.