Add unfinished documentation for VapourSynth.h

Firesledge's work[1] served as starting point. Most (all?) of it got
rewritten.

[1] http://pastebin.com/raw.php?i=wQqCETGM