updated perldoc to reflect new methods