fixed some holes in API, wrote pop[skip] docs