renamed a few functions, updated examples