Added information on common failure causes to the perldoc.