std: Improve docs for atomics. Fix two bugs
std: Improve docs for atomics. Fix two bugs

This adds lots of docs to the atomics module. Two of the examples
are using the future atomics API and are ignored temporarily.
I discovered a bug in the way AtomicBool's fetch_nand method is
implemented and fixed it by using the correct value for `true`.
I also fixed the implementation of AcqRel fences (it was only doing
a release barrier), and made a "relaxed" fence a failure.

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