Mention that this is a lower-level class, a users should probably use some yet-to-be FitFile class, that wraps up the calls to this one.

Implement this method.

Document how the caller should distinguish errors, from more-data-needed.