fixing bad examples and bad perl doc examples
prepping for release