added some documentation for the remove list function