shortened some function names, etc
added tentative 1.5.x documentation