auto merge of #15251 : AlisdairO/rust/master, r=alexcrichton
auto merge of #15251 : AlisdairO/rust/master, r=alexcrichton

I've seen quite a bit of confusion around regarding the use of Rc, so I thought I'd take a stab at adding some examples.

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