Improve documentation for the SVM classes/functions

Add better documentation for the SVM classes/functions (e.g. `svm_ptr`, `svm_alloc()`).

From the review:

```
I can't guess what svm_ptr is for. Later I discovered svm_alloc and
svm_free. Is there an RAII way to manage these things?
```
##