Document length/size parameters of all string functions
Submitted by Eric Gregory
Link to original bug (#676690)
Description
Many of Vala's string functions here have little to no documentation. Some of these functions don't correspond exactly with GLib functions so the programmer (me!) has to figure out how these all work by trial and error.
This is most frustrating when it comes to working with the length of a string; few of the function specify whether they accept/return the length in bytes or the length in characters.
The substring() function is the perfect example -- most substring functions expect the number of characters, but Vala's expects the number of bytes. That's the sort of tiny gotcha that makes documentation a necessity.
Version: 0.17.x