libcore: make spawn_supervised documentation reflect its behaviour.
auto merge of #5928 : huonw/rust/core-task-spawn-supervised-doc, r=thestinger

The doc-comment didn't reflect the [tasks tutorial](http://static.rust-lang.org/doc/tutorial-tasks.html#failure-modes), or how it works in practice.