Hello,
I have been trying to use the Wire library and have found the documentation lacking. So I am putting up a detailed reference here:
http://arduino.cc/playground/Main/WireLibraryDetailedReference
It is a work in progress. Release early and often, as they say. Let me know if you see any issues, problems, or joys.
-GreyGnome