auto merge of #13070 : huonw/rust/share-doc, r=alexcrichton
auto merge of #13070 : huonw/rust/share-doc, r=alexcrichton

std: expand the `Share` docs to make them more precise.

And give some examples about exactly what's `Share` and what's not.

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