JavaDoc not clear as it could be, e.g. Datastore.add vs. Datastore.put #1339

What's the difference between Datastore.add and Datastore.put?

Am I right in assuming that "add" will not clobber existing entities?

Maybe a quick update to the javadoc to clarify--would be much appreciated!!!