Clean up sdl.go

Various clean-ups to docs and such for sdl.go.  There's a slight breaking change for callers of Init (returns an error instead of an int), but otherwise, no API change.