Improve rustdocs for Rc, add examples
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.
Guide: functions

Just a few words about functions and defining them.