auto merge of #5673 : steveklabnik/rust/improve_io_docs, r=catamorphism
auto merge of #5673 : steveklabnik/rust/improve_io_docs, r=catamorphism

When I submitted #5659, it apparently caused some test failures. Then, because I left it in my incoming rather than making a new branch, I deleted my commit.

Let's try this again, this time, with its own branch so that I don't screw it up.

r?

nham/rust,zubron/rust,carols10cents/rust,untitaker/rust,ruud-v-a/rust,fabricedesre/rust,dwillmer/rust,robertg/rust,AerialX/rust-rt-minimal,jashank/rust,victorvde/rust,sae-bom/rust,servo/rust,ktossell/rust,ruud-v-a/rust,sarojaba/rust-doc-korean,stepancheg/rust-ide-rust,servo/rust,zubron/rust,robertg/rust,jashank/rust,kmcallister/rust,Ryman/rust,j16r/rust,reem/rust,shepmaster/rand,j16r/rust,dwillmer/rust,erickt/rust,carols10cents/rust,P1start/rust,sarojaba/rust-doc-korean,mitsuhiko/rust,KokaKiwi/rust,jashank/rust,Ryman/rust,mitsuhiko/rust,zaeleus/rust,aidancully/rust,mdinger/rust,KokaKiwi/rust,j16r/rust,vhbit/rust,mihneadb/rust,avdi/rust,gifnksm/rust,dinfuehr/rust,ebfull/rust,P1start/rust,aepsil0n/rust,avdi/rust,vhbit/rust,jbclements/rust,cllns/rust,aneeshusa/rust,Ryman/rust,LeoTestard/rust,krzysz00/rust,bhickey/rand,emk/rust,nwin/rust,graydon/rust,0x73/rust,sae-bom/rust,aepsil0n/rust,jroesch/rust,Ryman/rust,aepsil0n/rust,mihneadb/rust,mdinger/rust,erickt/rust,barosl/rust,dwillmer/rust,P1start/rust,mahkoh/rust,AerialX/rust,rprichard/rust,nham/rust,zachwick/rust,l0kod/rust,rohitjoshi/rust,jashank/rust,zaeleus/rust,ruud-v-a/rust,waynenilsen/rand,erickt/rust,ruud-v-a/rust,robertg/rust,jbclements/rust,sarojaba/rust-doc-korean,richo/rust,hauleth/rust,mahkoh/rust,bombless/rust,philyoon/rust,jbclements/rust,servo/rust,barosl/rust,pczarn/rust,michaelballantyne/rust-gpu,miniupnp/rust,mihneadb/rust,defuz/rust,rprichard/rust,pythonesque/rust,sae-bom/rust,zubron/rust,aidancully/rust,untitaker/rust,cllns/rust,mvdnes/rust,andars/rust,erickt/rust,zachwick/rust,Ryman/rust,bombless/rust,philyoon/rust,ebfull/rust,SiegeLord/rust,andars/rust,LeoTestard/rust,SiegeLord/rust,l0kod/rust,pczarn/rust,reem/rust,victorvde/rust,ktossell/rust,pelmers/rust,ktossell/rust,KokaKiwi/rust,erickt/rust,servo/rust,kwantam/rust,bombless/rust,zachwick/rust,ejjeong/rust,defuz/rust,richo/rust,servo/rust,XMPPwocky/rust,pythonesque/rust,l0kod/rust,aturon/rust,emk/rust,XMPPwocky/rust,sae-bom/rust,vhbit/rust,kimroen/rust,sae-bom/rust,AerialX/rust,jashank/rust,krzysz00/rust,ktossell/rust,jroesch/rust,pelmers/rust,0x73/rust,untitaker/rust,kmcallister/rust,kimroen/rust,mahkoh/rust,fabricedesre/rust,pythonesque/rust,emk/rust,AerialX/rust-rt-minimal,0x73/rust,jbclements/rust,krzysz00/rust,XMPPwocky/rust,stepancheg/rust-ide-rust,emk/rust,l0kod/rust,nwin/rust,untitaker/rust,defuz/rust,l0kod/rust,zachwick/rust,ebfull/rust,sarojaba/rust-doc-korean,michaelballantyne/rust-gpu,pshc/rust,robertg/rust,KokaKiwi/rust,j16r/rust,kwantam/rust,0x73/rust,reem/rust,aturon/rust,miniupnp/rust,victorvde/rust,emk/rust,mahkoh/rust,TheNeikos/rust,carols10cents/rust,victorvde/rust,zaeleus/rust,vhbit/rust,pshc/rust,dwillmer/rust,quornian/rust,michaelballantyne/rust-gpu,AerialX/rust-rt-minimal,omasanori/rust,quornian/rust,vhbit/rust,zaeleus/rust,vhbit/rust,kwantam/rust,graydon/rust,barosl/rust,stepancheg/rust-ide-rust,jbclements/rust,mdinger/rust,zaeleus/rust,mvdnes/rust,barosl/rust,stepancheg/rust-ide-rust,mihneadb/rust,ruud-v-a/rust,dinfuehr/rust,aturon/rust,huonw/rand,quornian/rust,philyoon/rust,LeoTestard/rust,cllns/rust,emk/rust,kimroen/rust,jroesch/rust,mihneadb/rust,aneeshusa/rust,avdi/rust,fabricedesre/rust,pelmers/rust,0x73/rust,andars/rust,KokaKiwi/rust,richo/rust,P1start/rust,rohitjoshi/rust,nwin/rust,barosl/rust,aturon/rust,seanrivera/rust,miniupnp/rust,miniupnp/rust,zubron/rust,aepsil0n/rust,omasanori/rust,fabricedesre/rust,TheNeikos/rust,SiegeLord/rust,reem/rust,dinfuehr/rust,TheNeikos/rust,stepancheg/rust-ide-rust,mvdnes/rust,vhbit/rust,jashank/rust,stepancheg/rust-ide-rust,philyoon/rust,achanda/rand,pshc/rust,defuz/rust,AerialX/rust,pythonesque/rust,nham/rust,andars/rust,aneeshusa/rust,jroesch/rust,kimroen/rust,philyoon/rust,mitsuhiko/rust,jbclements/rust,pshc/rust,aneeshusa/rust,rprichard/rust,cllns/rust,richo/rust,quornian/rust,dinfuehr/rust,rohitjoshi/rust,hauleth/rust,GrahamDennis/rand,LeoTestard/rust,ktossell/rust,kwantam/rust,bombless/rust,seanrivera/rust,carols10cents/rust,mdinger/rust,bombless/rust,kwantam/rust,servo/rust,jroesch/rust,jbclements/rust,kimroen/rust,graydon/rust,cllns/rust,mitsuhiko/rust,pczarn/rust,zubron/rust,ktossell/rust,pythonesque/rust,avdi/rust,bombless/rust,GBGamer/rust,dwillmer/rust,LeoTestard/rust,SiegeLord/rust,sarojaba/rust-doc-korean,mdinger/rust,Ryman/rust,untitaker/rust,bombless/rust-docs-chinese,ejjeong/rust,arthurprs/rand,aepsil0n/rust,mvdnes/rust,AerialX/rust-rt-minimal,pshc/rust,hauleth/rust,GBGamer/rust,pshc/rust,mitsuhiko/rust,aidancully/rust,fabricedesre/rust,avdi/rust,pelmers/rust,erickt/rust,hauleth/rust,mitsuhiko/rust,pythonesque/rust,j16r/rust,nwin/rust,nwin/rust,pythonesque/rust,rprichard/rust,pczarn/rust,nwin/rust,untitaker/rust,pczarn/rust,zachwick/rust,krzysz00/rust,nham/rust,miniupnp/rust,kmcallister/rust,victorvde/rust,vhbit/rust,jroesch/rust,rohitjoshi/rust,l0kod/rust,aturon/rust,graydon/rust,robertg/rust,victorvde/rust,reem/rust,SiegeLord/rust,jashank/rust,stepancheg/rust-ide-rust,krzysz00/rust,l0kod/rust,SiegeLord/rust,aidancully/rust,nwin/rust,barosl/rust,P1start/rust,kmcallister/rust,P1start/rust,erickt/rust,kmcallister/rust,barosl/rust,mvdnes/rust,sarojaba/rust-doc-korean,hauleth/rust,pelmers/rust,0x73/rust,pshc/rust,seanrivera/rust,omasanori/rust,avdi/rust,mitsuhiko/rust,LeoTestard/rust,dinfuehr/rust,carols10cents/rust,emk/rust,dinfuehr/rust,bluss/rand,ejjeong/rust,omasanori/rust,jbclements/rust,aneeshusa/rust,servo/rust,TheNeikos/rust,nham/rust,sae-bom/rust,KokaKiwi/rust,jashank/rust,ebfull/rand,richo/rust,GBGamer/rust,retep998/rand,AerialX/rust,l0kod/rust,ebfull/rust,GBGamer/rust,gifnksm/rust,philyoon/rust,andars/rust,TheNeikos/rust,pczarn/rust,ejjeong/rust,gifnksm/rust,miniupnp/rust,andars/rust,SiegeLord/rust,GBGamer/rust,krzysz00/rust,GBGamer/rust,miniupnp/rust,zubron/rust,mihneadb/rust,rprichard/rust,quornian/rust,GBGamer/rust,seanrivera/rust,ruud-v-a/rust,pczarn/rust,kmcallister/rust,zaeleus/rust,fabricedesre/rust,quornian/rust,nham/rust,0x73/rust,fabricedesre/rust,XMPPwocky/rust,ejjeong/rust,mahkoh/rust,mvdnes/rust,kimroen/rust,aturon/rust,omasanori/rust,nwin/rust,defuz/rust,kimroen/rust,aturon/rust,rohitjoshi/rust,AerialX/rust-rt-minimal,michaelballantyne/rust-gpu,kmcallister/rust,mdinger/rust,kwantam/rust,Ryman/rust,rprichard/rust,zubron/rust,michaelballantyne/rust-gpu,LeoTestard/rust,rohitjoshi/rust,jbclements/rust,cllns/rust,XMPPwocky/rust,TheNeikos/rust,gifnksm/rust,aneeshusa/rust,j16r/rust,defuz/rust,aidancully/rust,michaelballantyne/rust-gpu,GBGamer/rust,ebfull/rust,XMPPwocky/rust,ejjeong/rust,richo/rust,dwillmer/rust,dwillmer/rust,seanrivera/rust,gifnksm/rust,AerialX/rust,omasanori/rust,P1start/rust,aidancully/rust,michaelballantyne/rust-gpu,jroesch/rust,ktossell/rust,quornian/rust,sarojaba/rust-doc-korean,reem/rust,aepsil0n/rust,pshc/rust,dwillmer/rust,AerialX/rust-rt-minimal,zachwick/rust,robertg/rust,jroesch/rust,zubron/rust,miniupnp/rust,graydon/rust,j16r/rust,pelmers/rust,hauleth/rust,mahkoh/rust,seanrivera/rust,nham/rust,carols10cents/rust,gifnksm/rust,ebfull/rust,graydon/rust,AerialX/rust