Yesterday I had a late night updating a sketch using EthernetClient to Arduino version 1.0 - I couldn't get it to connect as I was following the online version of the Ethernet Library documentation which seems to be a mixture of old and new syntax, for example this page shows how to instantiate an EthernetClient http://arduino.cc/en/Reference/EthernetClient
but contains a reference to the old client.connect() method which has no parameters http://arduino.cc/en/Reference/ClientConnect
. There are also other confusing links in the Ethernet library pages.
I managed to get everything working in the end by following the local documentation included with download which seems to be consistent.
It looks like the online version needs bringing inline with the bundled docs or the version differences need pointing out so it's clearer.
I really like being able to use DNS and DHCP so easily