ok doc is now complete (i hope...)