MRG describe SVM probability calibration

After I caught a colleague using `SVC.predict_proba` where `decision_function` would have been fine, answering some SO/MO questions, and reading a bunch of stuff on how SVM probabilities work, I tried to improve the docs accordingly.

I'd like a quick check to see if I'm not saying anything stupid here.