tweaked API doc a bit