documentation & function tweaks