updated documentation . lists as keyword arguments