doc/api.html: Explain sf_read_XXX behaviour
doc/api.html: Explain sf_read_XXX behaviour

Closes #454.

libsndfile/libsndfile,evpobr/libsndfile,erikd/libsndfile,evpobr/libsndfile,libsndfile/libsndfile,evpobr/libsndfile,erikd/libsndfile,evpobr/libsndfile,libsndfile/libsndfile,erikd/libsndfile,erikd/libsndfile,evpobr/libsndfile,erikd/libsndfile,libsndfile/libsndfile,libsndfile/libsndfile