Thanks that helps me understand a bit better. Being a newbie I'd suggest just having the one example. When looking I didn't really know what the files were or that they are competing methods to do the same thing. Even if the naming is better like you suggest, it would still make me wonder what the difference is. I'd probably just randomly try one of the examples and use whatever worked first. I think to make things easier for the user you should only have the example for the preferred method.
Just my 2 cents though. Thanks again for the help.