updated docs; small method relocation change

as requested!